Datentransfer

Verwalten
- Kopieren
Aktionen
Ansichten
- Quellcode

Inhaltsverzeichnis

Export von Daten
Import von Daten
Zeilen und Spalten der CSV-Datei
Weiterführende Informationen
Zugehörige Aufgaben
Verfügbarkeit und Sichtbarkeit

Der Export und Import von Zählerständen per CSV-Dateien ist über diese Aufgabe möglich. Es können sowohl Zählerstände von Kombi- als auch von Echtzeitzählwerken ex- und importiert werden. Durch das gleiche Datenformat ist es möglich, Daten aus einem Kombi- in ein Echtzeitzählwerk zu importieren und umgekehrt. Hierbei muss beachtet werden, dass manche Inhalte nur exklusiv für eine bestimmte Zählwerksart zur Verfügung stehen, siehe in Abschnitt 3.

Hinweis: Das Zählwerk wird bei diesem Import analog zum automatischen Import direkt berechnet, dies gilt auch für Kombi-Zählwerke. Bei der manuellen Dateneingabe in ein Kombi-Zählwerk, direkt über die Aufgabe Werte anzeigen, über Rechnungen oder Ableselisten, findet die Berechnung erst im Rahmen der Energieliegenschaftsberechnung statt.

Export von Daten

Die Dateien können entweder importsicher oder länderspezifisch exportiert werden. Für den länderspezifischen Import muss die Länderkonfiguration gewählt werde, sodass die Formatierung der Daten der jeweiligen Konvention in den Ländern entspricht (Datumsformat, Dezimaltrenner "." oder "," usw.).

Wichtig: Soll die Datei geöffnet oder bearbeitet werden (z.B. in Excel), so ist immer der Typ "länderspezifisch" zu wählen. Das Format "importsicher" garantiert, dass die Werte unverändert wieder importiert werden können, weswegen dies nach dem Öffnen und Speichern nicht mehr möglich ist.

Es kann festgelegt werden, ob alle Daten aus dem verfügbaren Gesamtzeitraum, oder nur aus einem kleineren Zeitabschnitt exportiert werden sollen.

Durch Klick auf "Exportieren" wird der Export der Zählerstände des gewählten Zeitraums in eine CSV-Datei durchgeführt.

Es erfolgt eine Benachrichtigung über den erfolgreichen Start des Exports. Die CSV-Datei wird heruntergeladen und kann dann auf dem PC gespeichert werden. Die Dateibezeichnung besteht aus der Zählwerksbezeichnung. Handelt es sich im einen länderspezifischen Export, so wird die Länderkennung an die Zählwerksbezeichnung gehangen, z.B. "de-DE" für Deutsch und "de-CH" für Deutsch (Schweiz).

Eine solche Datei kann dann z.B. in ein anderes Zählwerk oder mit korrigierten/ergänzten Werten in das gleiche Zählwerk wieder importiert werden.

Hinweis: Es werden stets Zählerstände mit zugeordneten Zeiten exportiert (bei Echtzeitzählwerken die linke Spalte der zweiteiligen Tabelle), nicht die Zählwerksverbräuche. Letztere entsprechen bei Echtzeitzählwerken dem rechten Tabellenteil, siehe Beispiel unten.

Beispiel: Folgende Abbildung zeigt die Messwerte in einem Zählwerk.

ZählMesswerte_Datentransfer_EZZW_ExportStände.PNG

Bei "importsicherem" Export hat die erzeugte CSV-Datei folgende Form. Diese Form eignet sich in jedem Fall für den Re-Import in ein Echtzeit-Zählwerk.

ZählMesswerte_Datentransfer_Export_CSV_importsicher.PNG

Bei "länderspezifischem" Export hat die CSV bei Länderkonfiguration "deutsch" folgende Form. Man erkennt deutlich den Unterschied der Formate für Zeitangaben und Werte. Dieses Format eignet sich besonders für einen Transfer in andere Applikationen, z.B. Excel. ZählMesswerte_Datentransfer_Export_CSV_de-DE.PNG

Import von Daten

Mit "Durchsuchen" wählt man zunächst die zu importierende Datei. Der "Typ" hängt von der Form ab, wie die Import-Datei erzeugt wurde, hier gibt es insbesondere noch länderspezifische Varianten (Österreich, Schweiz). Der Name der zu importierenden Exportdatei enthält, falls vorhanden, die Angabe der verwendeten Länderkonfiguration. Da Echtzeitzählwerke der automatischen Datenerfassung dienen, werden alle durchgeführten Aktionen und CSV-Importe in der Aufgabe Historie dokumentiert. Deshalb ist bei jedem Import ein Kommentar zum Grund des Imports anzugeben, der die manuelle Änderung begründet.

Wichtig:

Es wird davon ausgegangen, dass die zu importierenden Daten für Echtzeitzählwerke der Auflösung der jeweiligen Zählwerke entsprechen. Standardmäßig wird eine Abweichung von weniger als einer Minute toleriert. *Beispiel: * Für ein Zählwerk mit Viertelstundenauflösung und einer Toleranz von 1 Minute werden eingehende Werte mit Uhrzeiten zwischen 08:59: 01 Uhr bis 09:00: 59 Uhr dem Regel-Zeitpunkt 09:00: 00 Uhr zugeordnet. Danach werden erst wieder Werte ab 09:14: 01 Uhr dem nächsten Regel-Zeitpunkt 09:15: 00 zugeordnet. Werte mit Uhrzeiten von 09:01: 00 bis 09:14: 00 Uhr werden bei einer Toleranz von 1 Minute ignoriert.
In Kombizählwerke werden die Daten entsprechend den Zeitstempeln der Importdatei übernommen. Importdaten zum selben Zeitstempel mit derselben Herkunft werden überschrieben. Somit wird verhindert, dass Werte mehrfach importiert werden, was zwangsweise zu automatischen Zählerstandsignorierungen führt.
Bezüglich einer Datei wird durch den ältesten und den jüngsten Zeitstempel ein Zeitraum für das zu importierende Zählwerk aufgespannt, indem alle Zählerstände mit Herkunft „DABO" gelöscht und mit den Zählerständen aus der Importdatei überschrieben werden. Importierte Daten erhalten die Herkunft "DABO".
A nalog werden vorhandene Zählerwechsel gelöscht und mit dem ggf. in der Importdatei vorhandenen Zählerwechsel überschrieben
Es werden keine Daten mit einem Zeitstempel importiert, welcher mehr als 7 Tage in der Zukunft liegt.
Es werden nur Daten aus folgenden Spalten importiert:
- DatumLokal (länderspezifisch), DatumUTC (importsicher)
- Wert
- ZaehlerNrNeu, falls ausgefüllt wird Zählerwechsel importiert mit Daten aus Spalten WertNeu (Einbaustand), WandlerFaktorNeu, ImpulswertigkeitNeu und MaximalstandNeu

Der Abschluss des Imports wird über eine Benachrichtigung angezeigt.

Beispieldatei für den Import in ein Kombi-Zählwerk mit der Einstellung "länderspezifisch, Deutschland"

Um Daten in ein Zählwerk zu importieren, muss zunächst eine csv-Datei vorliegen, die in entsprechender Formatierung ausgefüllt werden kann. Unten finden Sie eine Beispieldatei, die mit der Einstellung "Länderspezifisch (deutsch)" wieder in das System in ein Kombi-Zählwerk importiert werden kann. Durch die Kopfzeile 4 "Lokalisierung, de_DE" wird sichergestellt, dass diese Datei nur mit der korrekten Auswahl "länderspezifisch, Deutschland" importiert werden kann. D ie Informationen der übrigen Kopfzeilen (Zeile 1-5 und 7-10) müssen nicht ausgefüllt werden, da sie beim Import nicht beachtet werden.

Für den Datenimport sind die Spalten "DatumLokal" und "Wert" auszufüllen. Es ist möglich auch Zählerwechsel zu importieren, indem die Spalte "ZaehlerNrNeu" angegeben wird. In diesem Fall werden die Werte aus den Spalten "WertNeu" (Einbaustand), "WandlerFaktorNeu", "ImpulswertigkeitNeu", MaximalstandNeu" über den Zählerwechsel übernommen. Die Spalte UTC wird beim länderspezifischen Import nicht beachtet. Etwaige Einträge in weiteren Spalten werden ignoriert. Als Herkunft wird im Kombi-Zählwerk nach dem Import "DABO" (also Datenabonnement) angegeben.

zw_Datentransfer_Beispieldatei für KZW Import.csv

Zeilen und Spalten der CSV-Datei

Folgende Spalten sind sowohl für Echtzeit- als auch für Kombi-Zählwerke von Bedeutung.

"DatumLokal" gibt den Zeitstempel des Zählerstands in der Lokalzeit an, welche lt. Einstellung auf der Organisationseinheit gültig ist, siehe Erweiterte Einstellungen.

Hinweis: Diese Spalte wird für den länderspezifischen CSV-Import beachtet.

"Wert" gibt den zugehörigen Zählerstand an. Für Zählerwechsel wird hier der Ausbauzählerstand erfasst.
"Status" gibt den Messstatus des Zählerstandes an. In der Regel gibt es hier nur zwei Möglichkeiten "W" für "wahrer Wert" oder "N" für "nicht existent", siehe Messstatus
"ZaehlerNrNeu" dient der Erfassung der neuen Zählernummer bei Zählerwechseln. Da für einen Zählerwechsel immer die neue Zählernummer angegeben werden muss, markiert die Befüllung dieser Spalte diese Zeile als Zählerwechsel.
"WertNeu" entspricht bei einem Zählerwechsel für kumulative Zählwerke dem Einbauzählerstand und für non-kumulative dem zusätzlichen Verbrauch.
"WandlerFaktorNeu" dient der Erfassung des neuen Wandlerfaktors bei Zählerwechseln.
"ImpulswertigkeitNeu" dient der Erfassung der neuen Impulswertigkeit bei Zählerwechseln
"DatumUTC" gibt den Zeitstempel des Zählerstands in UTC-Zeit an.

Hinweis: Diese Spalte wird für den importsicheren CSV-Import beachtet.

"Kommentar" entspricht bei Kombi-Zählwerken den Einträgen aus der Spalte "Kommentar", siehe Werte anzeigen. Für Echtzeitzählwerke können Kommentare ausschließlich zu Zählerwechseln erfasst werden.

Hinweis: Wird ein Kombi-Zählwerk exportiert und diese Datei anschließend in ein Echtzeitzählwerk importiert, so werden die Kommentare zu Zählerständen ohne Zählerwechsel beim Import ignoriert.

Wichtig: Excel nutzt eine windowseigene Formatierung, sodass Umlaute und Sonderzeichen anders interpretiert werden als im UTF-8 Format, welches das Programm verwendet. Deshalb wird empfohlen Umlaute durch die übliche Form (z.B. "ae" statt "ä") zu ersetzen.

Folgende Spalten bilden Inhalte ab, die ausschließlich in Echtzeitzählwerken zur Verfügung stehen und somit auch nur in diese importiert werden können. Bei Import in Kombi-Zählwerke werden diese Werte ignoriert.

"MaximalstandNeu" für Echtzeitzählwerke kann bei einem Zählerwechsel ein neuer Maximalstand des Zählwerks erfasst werden.
"BearbeitetAm" dient der Historisierung (siehe Aufgabe Historie) von Zählerwechseln, sollten bei einem Import diese Spalte zu einem Zählerwechsel nicht befüllt sein, so wird hier der Importzeitpunkt als Bearbeitet am gespeichert.
"BearbeitetPersonID" dient der Historisierung (siehe Aufgabe Historie) von Zählerwechseln, sollten bei einem Import diese Spalte zu einem Zählerwechsel nicht befüllt sein, so wird hier die interne PersonID des aktuell angemeldeten Anwenders, der den Import durchführt, gespeichert.
"BearbeitetVorname" dient der Historisierung (siehe Aufgabe Historie) von Zählerwechseln, sollten bei einem Import diese Spalte zu einem Zählerwechsel nicht befüllt sein, so wird hier der Vorname des aktuell angemeldeten Anwenders, der den Import durchführt, gespeichert.
"BearbeitetNachname" dient der Historisierung (siehe Aufgabe Historie) von Zählerwechseln, sollten bei einem Import diese Spalte zu einem Zählerwechsel nicht befüllt sein, so wird hier der Nachname des aktuell angemeldeten Anwenders, der den Import durchführt, gespeichert.

Hinweis: Übrige Änderungen werden durch den Eintrag des Imports in die Historie dokumentiert.

Folgende Spalten bilden Inhalte ab, die ausschließlich in Kombi-Zählwerken zur Verfügung stehen und somit auch nur in Kombi-Zählwerke importiert werden können. Bei Import in Echtzeitzählwerke werden diese Werte ignoriert.

"Herkunft" kennzeichnet wie der Zählerstand erfasst wurde (z.B. "MAN" für manueller Eintrag über die Aufgabe Werte anzeigen)
"Systemhinweis" betrifft nur den Export. Systemhinweise werden bei der Aufbereitung der Zählerstände automatisch vom System erzeugt und bilden somit nur die Situation im Moment des Exports ab. Dementsprechend werden Systemhinweise nicht importiert.
"WertIgnoriert" hat den Wert "TRUE" (engl. für "wahr"), falls der Wert manuell durch den Anwender ignoriert wurde, andernfalls hat diese Spalte den Wert "FALSE".
. Ein automatisches Ignorieren eines Zählerstands durch das System wird ausschließlich in der Spalte "Systemhinweis" erfasst.
"WertGeschätzt" dient der Kennzeichnung eines bestimmten Zählerstands innerhalb der Übersichtsmaske der Zählerstände und bezieht sich auf die Spalte "Wert".
"NeuerWertGeschätzt" dient der Kennzeichnung eines bestimmten Zählerstands innerhalb der Übersichtsmaske der Zählerstände und bezieht sich auf die Spalte "WertNeu".