Dateiformat für Veröffentlichungen

Einführung

Das Dateiformat veröffentlichter Dateien hängt von der ausgewählten Veröffentlichungsmethode ab:

Schneider Cloud Service: 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 einem Tag der Erfassung

In eine Veröffentlichung können maximal 200 Dateien exportiert werden. Zusätzliche Dateien werden nicht veröffentlicht.

HINWEIS: Wenn der Veröffentlichungszeitraum auf Wöchentlich eingestellt ist, kann die Anzahl der Dateien 200 überschreiten. Um die fehlenden Dateien zu veröffentlichen, ändern Sie den Veröffentlichungszeitraum zu „Täglich“ und starten Sie die Veröffentlichung.

Der Name der exportierten CSV-Dateien entspricht der Namenskonvention ReducedID_DeviceName_DateTime.csv, wobei Folgendes 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.
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_20221104084830994.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 20221104084830994, was bedeutet, dass die Datei am 4. November 2022 um 8:48:30.994 veröffentlicht wurde.

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 einem Tag der Erfassung.

In eine Veröffentlichung können maximal 200 Dateien exportiert werden. Zusätzliche Dateien werden nicht veröffentlicht.

HINWEIS: Wenn der Veröffentlichungszeitraum auf „Wöchentlich“ eingestellt ist, kann die Anzahl der Dateien 200 überschreiten. Um die fehlenden Dateien zu veröffentlichen, ändern Sie den Veröffentlichungszeitraum zu „Täglich“ und starten Sie die Veröffentlichung.

Der Name der exportierten JSON-Datei entspricht der Namenskonvention DateTime.json, wobei DateTime der Zeitstempel ist, der dem Datum entspricht, an dem die Datei veröffentlicht wurde. Er wird bis auf Millisekunden im Format JJJJMMTThhmmssSSS ausgedrückt.

Für ein Beispiel für eine .json-Datei siehe Anhang D: Dateiformate für die SFTP- und HTTPS-Veröffentlichung.