OBJECTDUMP_de.md

Wie man einen Objekt-Dump erstellt

Diese Datei beschreibt, wie man einen Dump der Objektstruktur eines Adapters erstellt. Dieser JSON-basierte Dump kann zur Analyse korrekter Objektdefinitionen und zur Überprüfung der verwendeten Typen und Rollen genutzt werden.

Vorbereitung

• Installiere die neueste Version des Adapters und konfiguriere ihn gemäß seiner Beschreibung.
• Starte den Adapter und stelle sicher, dass er wie erwartet funktioniert. Vergewissere dich, dass er mit einem Gerät verbunden ist (sofern vom Adapter verwendet) und dass alle typischen Daten abgerufen werden.
• Überprüfe im Admin -> Objektbrowser, dass alle üblicherweise von diesem Adapter angelegten Zustände vorhanden sind.

Dump erstellen

• Öffne die Admin-Oberfläche
• Aktiviere den Expertenmodus – das Gesichtssymbol sollte grün sein
  
• Öffne den Objektbrowser und klappe den Adapter auf, den du analysieren möchtest
• Wähle die Instanz des Adapters aus (üblicherweise 0)
  
• Klicke auf die Schaltfläche „Herunterladen"
  
• Behalte die Standardeinstellungen (wie unten gezeigt) und klicke auf „Nur ausgewählte" (es sei denn, deine Zustände enthalten sensible Daten) Achtung:
  Falls deine Zustandswerte sensible Daten oder Daten enthalten, die du privat halten möchtest, aktiviere gerne die Option „Werte der Zustände nicht exportieren".

Es erscheint ein Dateiauswahl-Dialog, in dem du den Dateinamen für den Download festlegen kannst. Der Standarddateiname lautet adapter.instance#.json. Du kannst den Namen beibehalten oder die Datei nach eigenen Wünschen benennen.

Ergebnis

Die resultierende Datei sollte wie folgt aussehen:

{
  "airquality.0.DEBY200": {
    "type": "folder",
    "common": {
      "name": {
        "en": "Measurements from station",
        "de": "Messungen von Station",
        "ru": "Измерения на станции",
        "pt": "Medições da estação",
        "nl": "Metingen vanaf het station",
        "fr": "Mesures de la station",
        "it": "Misure dalla stazione",
        "es": "Medidas desde la estación",
        "pl": "Pomiary ze stacji",
        "uk": "Вимірювання з станції",
        "zh-cn": "从车站测量"
      },
      "desc": "Passau> Angerstr.",
      "role": "info"
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "user": "system.user.admin",
    "ts": 1737404497711,
    "_id": "airquality.0.DEBY200",
    "acl": {
      "object": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    }
  },
  "airquality.0.DEBY200.CO": {
    "type": "state",
    "common": {
      "name": "Kohlenmonoxid",
      "type": "number",
      "role": "value",
      "unit": "mg/m³",
      "read": true,
      "write": false
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "user": "system.user.admin",
    "ts": 1737404498285,
    "_id": "airquality.0.DEBY200.CO",
    "acl": {
      "object": 1636,
      "state": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    },
    "val": 0.57,
    "ack": true
  },
  "airquality.0.DEBY200.NO2": {
    "type": "state",
    "common": {
      "name": "Stickstoffdioxid",
      "type": "number",
      "role": "value",
      "unit": "µg/m³",
      "read": true,
      "write": false
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "user": "system.user.admin",
    "ts": 1737404497720,
    "_id": "airquality.0.DEBY200.NO2",
    "acl": {
      "object": 1636,
      "state": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    },
    "val": 25,
    "ack": true
  },
  "airquality.0.DEBY200.Number_of_measurement_types": {
    "type": "state",
    "common": {
      "name": {
        "en": "Number of measurement types",
        "de": "Anzahl der Messarten",
        "ru": "Число типов измерений",
        "pt": "Número de tipos de medição",
        "nl": "Aantal meettypes",
        "fr": "Nombre de types de mesure",
        "it": "Numero di tipi di misura",
        "es": "Número de tipos de medición",
        "pl": "Liczba typów pomiarów",
        "uk": "Кількість типів вимірювання",
        "zh-cn": "计量类型数目"
      },
      "type": "number",
      "role": "value",
      "unit": "",
      "read": true,
      "write": false
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "user": "system.user.admin",
    "ts": 1737404497751,
    "_id": "airquality.0.DEBY200.Number_of_measurement_types",
    "acl": {
      "object": 1636,
      "state": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    },
    "val": 4,
    "ack": true
  },
  "airquality.0.DEBY200.PM10": {
    "type": "state",
    "common": {
      "name": "Feinstaub",
      "type": "number",
      "role": "value",
      "unit": "µg/m³",
      "read": true,
      "write": false
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "user": "system.user.admin",
    "ts": 1737404497728,
    "_id": "airquality.0.DEBY200.PM10",
    "acl": {
      "object": 1636,
      "state": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    },
    "val": 46,
    "ack": true
  },
  "airquality.0.DEBY200.PM2": {
    "type": "state",
    "common": {
      "name": "Feinstaub",
      "type": "number",
      "role": "value",
      "unit": "µg/m³",
      "read": true,
      "write": false
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "user": "system.user.admin",
    "ts": 1737404497735,
    "_id": "airquality.0.DEBY200.PM2",
    "acl": {
      "object": 1636,
      "state": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    },
    "val": 29,
    "ack": true
  },
  "airquality.0.DEBY200.Time_of_the_last_measurement": {
    "type": "state",
    "common": {
      "name": {
        "en": "Time of the last measurement",
        "de": "Zeit der letzten Messung",
        "ru": "Время последнего измерения",
        "pt": "Tempo da última medição",
        "nl": "Tijd van de laatste meting",
        "fr": "Durée de la dernière mesure",
        "it": "Tempo dell' ultima misura",
        "es": "Tiempo de la última medición",
        "pl": "Czas ostatniego pomiaru",
        "uk": "Час останнього вимірювання",
        "zh-cn": "上次测量的时间"
      },
      "type": "string",
      "role": "text",
      "unit": "",
      "read": true,
      "write": false
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "user": "system.user.admin",
    "ts": 1737404497742,
    "_id": "airquality.0.DEBY200.Time_of_the_last_measurement",
    "acl": {
      "object": 1636,
      "state": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    },
    "val": "22.01.2025 10:00",
    "ack": true
  },
  "airquality.0.info": {
    "_id": "airquality.0.info",
    "type": "channel",
    "common": {
      "name": {
        "en": "Information",
        "de": "Informationen",
        "ru": "Информация",
        "pt": "Informação",
        "nl": "Informatie",
        "fr": "Informations",
        "it": "Informazioni",
        "es": "Información",
        "pl": "Informacje",
        "uk": "Інформація",
        "zh-cn": "资料"
      }
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "ts": 1737547798507,
    "acl": {
      "object": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    },
    "user": "system.user.admin"
  },
  "airquality.0.info.lastUpdate": {
    "_id": "airquality.0.info.lastUpdate",
    "type": "state",
    "common": {
      "role": "date.end",
      "name": {
        "en": "Last update",
        "de": "Letzte Aktualisierung",
        "ru": "Последнее обновление",
        "pt": "Última atualização",
        "nl": "Laatste update",
        "fr": "Dernière mise à jour",
        "it": "Ultimo aggiornamento",
        "es": "Última actualización",
        "pl": "Ostatnia aktualizacja",
        "uk": "Останнє оновлення",
        "zh-cn": "上次更新"
      },
      "type": "number",
      "read": true,
      "write": false,
      "def": 0
    },
    "native": {},
    "from": "system.adapter.airquality.0",
    "ts": 1737547798509,
    "acl": {
      "object": 1636,
      "state": 1636,
      "owner": "system.user.admin",
      "ownerGroup": "system.group.administrator"
    },
    "user": "system.user.admin",
    "val": 1737541619871,
    "ack": true
  }
}

Diese Datei kann zur Überprüfung z. B. als Anhang an ein GitHub-Issue weitergegeben werden. Falls die Datei sensible Daten enthält, kontaktiere den Anforderer, um zu klären, wie eine nicht-öffentliche Übertragung erfolgen kann.