Customizing Vorlagen für Einbaugeräte

Vorlagen für Einbaugeräte anlegen

Anlegen der Extension DEVICE_TEMPLATES

Mittels der Extension DEVICE_TEMPLATES ist es möglich, Vorlagen für neue Einbaugeräte anzulegen. Diese Vorlagen werden dann genutzt um die Oberfläche zur Eingabe neuer Gerätedaten vorzubefüllen. Die Extension enthält dabei beliebig viele Einträge nach folgendem Schema:

Eigene ILN.Titel_der_Vorlage=Schlüssel einer Extension mit der Vorlage;Beschreibung der Vorlage

Ein Beispiel für den Inhalt dieser Extension:

9912345678999.Standard=DEVICE_TEMPLATE_TESTMSB_DEFAULT;Dies ist eine Vorlage mit den von uns standardmäßig verbauten Geräten
9912345678999.Standard_mit_Wandler=DEVICE_TEMPLATE_TESTMSB_DEFAULT_WITH_TRANSFORMER;Dies ist eine Vorlage mit den von uns standardmäßig verbauten Geräten. Außerdem ist hier ein Blockstromwandler dabei.

Zu Beachten: der Titel darf keine Leerzeichen und kein “=” enthalten, auch weitere Sonderzeichen könnten zu Problemen führen. Die einzelnen Einträge werden einfach durch neue Zeilen getrennt.

Anlegen der Sub-Extensions für die einzelnen Vorlagen

Für jeden Eintrag in der Extension DEVICE_TEMPLATES muss eine weitere Extension angelegt werden, deren Name dem Schlüssel aus dem Eintrag entsprechen muss. So müsste für den ersten Eintrag aus o.g. Beispiel-Extension die Extension DEVICE_TEMPLATE_TESTMSB_DEFAULT angelegt werden. Als Inhalt dieser Datei muss eine JSON-Repräsentation der Gerätedaten-Segmente aus der UTILMD hinterlegt werden. Folgend ein Maximalbeispiel für dieses JSON:

{
    "deviceDirectionDatas": [
        {
            "deviceNumber": "Z1",
            "meterType": "AHZ",
            "tarifeCount": "ETZ",
            "energyDirection": "ERZ",
            "measurementValueLogging": "MMR",
            "meterTypeDetail": null,
            "mountingType": "BKE",
            "remoteControl": "Z07",
            "meterSize": null,
            "volumeMeasurementType": null
        }
    ],
    "obisMeters": [
        {
            "meterRef": "Z1",
            "obisNumber": "1-0:1.28.0",
            "registerNumbersBeforeComma": "6",
            "registerNumbersAfterComma": "3",
            "identificationOnDevice": "HT",
            "lightLoadAble": "Z60",
            "valueGranularity": "ZD9"
        },
        {
            "meterRef": "Z1",
            "obisNumber": "1-0:1.29.0",
            "registerNumbersBeforeComma": "6",
            "registerNumbersAfterComma": "3",
            "identificationOnDevice": "NT",
            "lightLoadAble": "Z60",
            "valueGranularity": "ZE8"
        }
    ],
    "transformerDatas": [
        {
            "meterNumberRefs": [
                "Z1"
            ],
            "transformerFactor": "200",
            "transformerType": "MBW"
        }
    ],
    "communicationDeviceDatas": [
        {
            "meterNumberRefs": [
                "Z1"
            ],
            "attributeValueCode": "DSL"
        }
    ],
    "controlDeviceDatas": [
        {
            "meterNumberRefs": [
                "Z1"
            ],
            "attributeValueCode": "RSU"
        }
    ]
}

Erklärung:

“deviceDirectionDatas” enthält eine Liste der Zähleinrichtungen
- “deviceNumber” enthält einen Alias für die Zählernummer, der für die Zuordnung der Zählerreferenz an den anderen Geräten und den Obis-Daten benötigt wird
- “meterType” entält den Zählertyp (laut aktuellem Anwendungshandbuch bspw. “AHZ”, “WSZ”, “LAZ”, “MAZ”, “MME”, “EHZ”, “IVA”, …)
- “tarifeCount” enthält die Angabe zur Registeranzahl (laut aktuellem Anwendungshandbuch “ETZ”, “ZTZ” oder “NTZ”)
- “energyDirection” enthält die Angabe zur Energierichtung (laut aktuellem Anwendungshandbuch “ERZ” oder “ZRZ”)
- “measurementValueLogging” enthält die Angabe zur Messwerterfassung (laut aktuellem Anwendungshandbuch “AMR” oder “MMR”)
- “meterTypeDetail” enthält Detail-Angaben zum Zählertyp (laut aktuellem Anwendungshandbuch “Z01”, “Z02”, “Z03”, “Z04” oder “Z05) und muss nur für den “meterType” MME oder EHZ angegeben werden
- “mountingType” enthält die Angabe zur Befestigungseinrichtung (laut aktuellem Anwendungshandbuch “BKE”, “DPA”, “HUT”, “Z31” oder “Z32”)
- “remoteControl” enthält die Angabe zur Fernschaltung der Zähleinrichtung (laut aktuellem Anwendungshandbuch “Z06” oder “Z07”)
- “meterSize” enthält die Angabe zur Zählergröße (z.B. “G10”, “G100”, …) und ist nur für Gas-Zähler anzugeben
- “volumeMeasurementType” enthält die Angabe zur Art der Volumenerfassung (laut aktuellem Anwendungshandbuch “Z17” oder “Z18”) und ist nur für Gas-Zähler anzugeben, wenn vorhanden (ab 01.10.2022)
“obisMeters” enthält eine Liste der Obis-Daten der Zähleinrichtungen (ein Eintrag entspricht einem Obis-Register eines Zählers)
- “meterRef” enthält eine Referenz auf die Alias-Zählernummer des zu referenzierenden Zählers
- “obisNumber” enthält die Obis-Kennzahl des Registers
- “registerNumbersBeforeComma”: Anzahl Vorkommastellen des Zählwerks
- “registerNumbersAfterComma”: Anzahl Nachkommastellen des Zählwerks
- “identificationOnDevice”: Bezeichnung des Zählwerks auf dem Gerät
- “lightLoadAble” enthält die Angabe zur Schwachlastfähigkeit (laut aktuellem Anwendungshandbuch “Z59” oder “Z60”)
- “valueGranularity” enthält die Angabe zur Wertegranularität (laut aktuellem Anwendungshandbuch “ZD9”, “ZE8”, “ZE9”, “ZB7”), die ab 01.10.2022 für bestimmte OBIS angegeben werden muss
“transformerDatas” enthält eine Liste der Wandler
- “meterNumberRefs” enthält eine Liste von Referenzen auf Alias-Zählernummern der zu referenzierenden Zähler
- “transformerFactor” enthält den Wandlerfaktor
- “transformerType” enthält den Wandlertyp (laut aktuellem Anwendungshandbuch “MIW”, “MPW”, “MBW” oder “MUW”)
“communicationDeviceDatas” enthält eine Liste der Kommunikationseinrichtungen
- “meterNumberRefs” enthält eine Liste von Referenzen auf Alias-Zählernummern der zu referenzierenden Zähler
- “attributeValueCode” enthält den Typ der Kommunikationseinrichtung (laut aktuellem Anwendungshandbuch “GSM”, “ETH”, “PLC”, “PST”, “DSL” oder “LTE”)
“controlDeviceDatas” enthält eine Liste der technischen Steuereinrichtungen
- “meterNumberRefs” enthält eine Liste von Referenzen auf Alias-Zählernummern der zu referenzierenden Zähler
- “attributeValueCode” enthält den Typ der Steuereinrichtungen (laut aktuellem Anwendungshandbuch “RSU”, oder “TSU”)

Zu beachten:

Steuerboxen und Smartmeter-Gateways können in den Vorlagen aktuell nicht mit angegeben werden
Es werden aktuell maximal drei Zähler in einer Vorlage unterstützt
Von allen anderen o.g. Geräten und den Obis-Registern können beliebig viele angegeben werden
Es müssen für jedes aufgelistete Gerät/Obis-Register alle Attribute angegeben werden, die nach AHB-Bedingungen in der UTILMD erforderlich sind. Nicht angegeben werden muss die Gerätenummer, mit Ausnahme der Alias-Gerätenummer beim Zähler
Es muss für jeden Zähler eine Alias-Zählernummer (im Beispiel oben “Z1”) eingegeben und von den anderen Geräten und den Obis-Registern in den Feldern “meterRef” bzw. “meterNumberRefs” referenziert werden
Die Einträge müssen valides JSON sein