Gesamtes Konto exportieren und der Aufbau der Dateien

Mit Gesamtes Konto exportieren laden Sie alle Daten Ihrer Organisation in einer ZIP-Datei herunter. Sie enthält die Einstellungen, Gateways, Modbus-Geräte, Register, Alarme, Automatisierungen, Dashboards, Berichte, Kunden und Mitglieder sowie die Messwerte innerhalb der Aufbewahrungsfrist von 365 Tagen. Der Export ist kostenlos und nutzt offene Formate, die Software lesen kann (CSV und JSON).

Diese Seite beschreibt auch, wie die Dateien aufgebaut sind. Das ist die Übersicht der Exportformate, die der europäische Data Act für den Wechsel zu einem anderen Anbieter verlangt.

Export anfordern

1. Einstellungen öffnen

   Öffnen Sie Einstellungen und wählen Sie Datenexport.

2. Export anfordern

   Klicken Sie auf Export anfordern. Das Fenster Gesamtes Konto exportieren öffnet sich.

3. Inhalt wählen

   Wählen Sie das Dateiformat (CSV für Excel oder JSON), das Detail der Messwerte (jeder Messwert, pro 15 Minuten, pro Stunde oder pro Tag) und den Zeitraum (alles innerhalb der Aufbewahrungsfrist oder selbst wählen). Haben Sie Kunden, wählen Sie unter Kunden das gesamte Konto oder einen Kunden.

4. Export starten

   Klicken Sie auf Export starten. Die Datei wird im Hintergrund erstellt. Sie erhalten eine E-Mail, sobald sie fertig ist.

5. Datei herunterladen

   Die Schaltfläche in der E-Mail öffnet Datenexport im Portal. Klicken Sie dort beim Export auf Herunterladen.

Inhalt der ZIP-Datei

Jede Datei in config/ ist eine JSON-Liste mit einem Objekt pro Zeile. IDs sind UUIDs und verbinden die Dateien. device_id verweist auf ein Gateway, modbus_dev_id auf ein Modbus-Gerät und register_id auf ein Register.

Bewusst nicht im Export stehen Geheimnisse (Tokens, API-Schlüssel und ihr Hash, Passwörter, das Webhook-Geheimnis und die Werte eigener Header, die Codes von Freigabelinks und Einladungen), interne Daten der automatischen Überwachung und IP-Adressen im Verwaltungsprotokoll.

Messwerte als CSV

Alle CSV-Dateien sind UTF-8 mit BOM, damit Excel Zeichen wie °C richtig anzeigt. Auf Deutsch und Niederländisch trennt ein Semikolon die Spalten und Zahlen haben ein Dezimalkomma. Auf Englisch trennt ein Komma die Spalten und Zahlen haben einen Punkt. Zeiten sind Ortszeit der Organisation als JJJJ-MM-TT HH:MM:SS. Werte sind mit dem Skalierungsfaktor des Registers umgerechnet, wie das Portal sie zeigt.

Jeder Messwert

Eine Zeile pro Zeitpunkt und eine Spalte pro Register. Der Spaltenkopf ist Modbus-Gerät / Register (Einheit), mit [entfernt] bei einem gelöschten Register. manifest.json nennt für jede Datei, welches Register in welcher Spalte steht. Hat ein Register zwei Messwerte zum selben Zeitpunkt, steht der erste in der Datei.

Pro 15 Minuten, Stunde oder Tag

Eine Zeile pro Zeitraum pro Register mit diesen Spalten.

Zeiträume von 15 Minuten und einer Stunde folgen der Uhr. Ein Tag läuft von Mitternacht bis Mitternacht in der Zeitzone der Organisation, also 23 oder 25 Stunden bei der Zeitumstellung.

Messwerte als JSON

JSON-Dateien folgen dem Format modbuscloud.readings, Version 1. Zuerst die Angaben zum Export und die Register, danach die Werte. Zeiten in JSON sind UTC nach ISO 8601.

{
  "format": "modbuscloud.readings",
  "format_version": 1,
  "generated_at": "2026-10-15T09:00:00.000Z",
  "gateway": { "serial": "6008123409", "name": "Schrank 1" },
  "timezone": "Europe/Amsterdam",
  "resolution": "day",
  "from": "2026-09-30T22:00:00.000Z",
  "to": "2026-10-15T09:00:00.000Z",
  "truncated": false,
  "row_limit": null,
  "complete_from": null,
  "values_scaled": true,
  "registers": [
    { "id": "53e8429e-...", "name": "Energie Bezug", "unit": "kWh", "modbus_device": "kWh-Zähler 1",
      "slave_id": 1, "address": 30001, "data_type": "uint32", "scale_factor": 0.1, "counter": true, "retired": false }
  ],
  "buckets": [
    { "start": "2026-09-30T22:00:00.000Z", "end": "2026-10-01T22:00:00.000Z", "register_id": "53e8429e-...",
      "count": 96, "avg": 1452.3, "min": 1447.1, "max": 1457.6, "first": 1447.1, "last": 1457.6, "delta": 10.5, "delta_reset": false }
  ]
}

Verbrauch bei Zählern

Ein Register ist ein Zähler, wenn es so eingestellt oder erkannt ist, etwa ein kWh-Zählerstand, ein Volumen oder Betriebsstunden. Der Verbrauch eines Zeitraums ist der letzte Stand dieses Zeitraums minus der letzte Stand des vorigen Zeitraums mit Messwerten. Für den ersten Zeitraum zählt der letzte Stand aus den 7 Tagen davor. Sinkt der Stand, weil der Zähler zurückgesetzt oder ausgetauscht wurde, ist der Verbrauch dieses Zeitraums leer und Zähler zurückgesetzt steht auf ja (delta_reset: true in JSON). Dieselbe Regel nutzt das Balkendiagramm mit Verbrauch in einem Dashboard.

Messwerte eines Gateways

Messwerte herunterladen im Menü eines Gateways bietet dieselben Formate und dasselbe Detail. Eine solche Datei enthält höchstens 500 000 Messwerte. Sind es mehr, erhalten Sie die neuesten und die erste Zeile der CSV (oder complete_from in JSON) sagt, ab welchem Zeitpunkt die Datei vollständig ist. Siehe Messwerte herunterladen.