Dateiformat für Veröffentlichungen
Einführung
Das Dateiformat veröffentlichter Dateien hängt von der ausgewählten Veröffentlichungsmethode ab:
-
Schneider Cloud Services: json-Dateiformat
-
SFTP und HTTPS: Auswahl des json- oder csv-Dateiformats auf den Panel Server-Webseiten
Dateiformat für CSV-Veröffentlichungen
Eine .csv-Datei enthält:
-
Daten zu einem einzelnen nachgeschalteten Gerät
-
Alle mit demselben Erfassungszeitraum für das Gerät konfigurierte Messungen
-
Daten von maximal 24 Stunden Datenerfassung
Der Name der exportierten CSV-Dateien entspricht der Namenskonvention ReducedID_DeviceName_DateTime_IndexNumber.csv. Hierbei gilt:
-
ReducedID
ist die interne Kennung des Geräts, die gewährleistet, dass die erstellten Dateien für Geräte mit demselben Namen eindeutig sind (z. B. 10_mb, 21_zd). -
DeviceName ist der Name des nachgeschalteten Geräts.
-
DateTime ist der Zeitstempel, der dem Datum entspricht, an dem die Datei veröffentlicht wurde. Er wird bis auf Millisekunden im Format JJJJMMTThhmmssSSS ausgedrückt.
-
IndexNumber im Format _<nn> gibt die Nummer der Datei in der Gesamtzahl der Dateien für eine einzelne Veröffentlichung an (gleiche ID, gleicher Gerätename und gleicher Zeitstempel). Wenn die Veröffentlichung 20 Dateien enthält, sind diese mit _1 bis _20 nummeriert.
-
Im CSV-Dateinamen sind nur die folgenden Zeichen zulässig: UTF-8 und Basis-ASCII (32 bis 7F, außer \ / : * ? " < > |). Alle nicht unterstützten Zeichen werden durch ~ ersetzt.
Beispiel: Für den Dateinamen
11_mb_F160 3P 3P+N_202412161020_19.csv gilt:
-
ReducedID ist 11_mb.
-
Gerätename ist F160 3P 3P+N, Name des Geräts.
HINWEIS: Dieser Name ist der Standardwert (Produktmodell), sofern er vom Benutzer nicht aktualisiert wurde. -
DateTime ist 202412161020, was bedeutet, dass die Datei am 16. Dezember 2024 um 10:20 Uhr veröffentlicht wurde.
-
Indexnummer ist _19, was bedeutet, dass die Datei die 19. Datei in der Publikation ist.
Der CSV-Dateiinhalt unterstützt nur die UTF-8-Standardzeichenkodierung für Gerätename, Ereignisname, Messungsname und Dateiname.
Anführungszeichen in allen Datenfeldern der CSV-Datei tragen zur Gewährleistung der Kompatibilität mit Sonderzeichen bei.
Ausführliche Informationen und Beispiele für die .csv-Datei finden Sie in Anhang D: Dateiformate für die SFTP- und HTTPS-Veröffentlichung.
Dateiformat für JSON-Veröffentlichungen
Eine .json-Datei enthält Messwerte mehrerer nachgeschalteter Geräte, die mit demselben Erfassungszeitraum konfiguriert sind.
Jede Datei enthält die Daten von 24 Erfassungsstunden bis zu einer Datengrenze von 256 KB.
Der Name der exportierten JSON-Datei entspricht der Namenskonvention. DateTime_IndexNumber.json. Hierbei gilt:
-
DateTime ist der Zeitstempel, der dem Datum entspricht, an dem die Datei veröffentlicht wurde. Er wird bis auf Millisekunden im Format JJJJMMTThhmmssSSS ausgedrückt.
-
IndexNumber im Format _<nn> gibt die Nummer der Datei in der Gesamtzahl der Dateien für eine einzelne Veröffentlichung an (gleiche ID, gleicher Gerätename und gleicher Zeitstempel). Wenn die Veröffentlichung 20 Dateien enthält, sind diese mit _1 bis _20 nummeriert.
Ein Beispiel für eine .json-Datei finden Sie in Anhang D: Dateiformate für die SFTP- und HTTPS-Veröffentlichung.