Fröschl GmbH ZFA-F (Soap-Schnittstelle)
Inhaltsverzeichnis
Abruf von Daten einer Fröschl ZFA-F-Schnittstelle via Webservice
Zum Import von Daten aus einer Fröschl ZFA-Schnittstelle kann ein Datenabonnement eingerichtet werden.
Informationen zum Datenformat
Hierbei handelt es sich um ein SOAP-Datenformat. Informationen werden per Webservice an den Server der Software übertragen.
Interpretation der Daten
Der ZFA-Webservice bietet die Möglichkeit Daten einzelner Zähler/Zählwerke über eine Kombination aus Zählpunktbezeichnung und Obis-Kennzahl abzufragen.
Der Import basiert auf der Funktionalität der Whitelist eines Datenabonnements.
Wie wird ein Eintrag in der Whitelist interpretiert
Im Gegensatz zu anderen Importen macht bei dieser Schnittstelle eine Blacklist, also das Ausschließen bestimmter Zählpunkte keinen Sinn.
Die Konfiguration der zu importierenden Zählpunkte kann aber über die Whitelist vorgenommen werden.
In diese Liste werden alle zu importierenden Zählpunktsbezeichnungen eingetragen.
Beim Import werden dann alle Zählwerke der zugehörigen Zählpunkte unterhalb der automatisch angelegten Zähler erstellt.
Welche Zählwerke angelegt werden hängt von den im ZFA-System hinterlegten Daten ab. Es wird nach einer Liste von Obis-Kennzahlen gesucht und ein Zählwerk angelegt, sofern Daten abgerufen werden können.
Dabei wird sowohl nach Energieverbrauch als auch nach Leistung gesucht.
Eindeutige Zuordnung der Daten zu einem Zählpunkt
Um die Daten eindeutig einem Zählpunkt zuzuordnen wird ein Schlüssel aus "Zählpunktbezeichnung", "Obis-Kennzahl" und der Information, ob es sich um eine Energiemenge ("energie") oder um eine Leistung ("leistung") handelt, gebildet. Getrennt werden die drei Informationen durch ein "@".
Bezeichnung automatisch angelegter Zähler und Zählwerke
Ein automatisch angelegter Zähler erhält als Bezeichnung seine Zählpunktsbezeichnung (Beispiel: "CH99EXAMPLE0000000000000EXAMPLE02").
Ein automatisch angelegtes Zählwerk erhält als Bezeichnung seine "Obis-Kennziffer".