Planon verwaltet
Für einen von Planon verwalteten Anschluss muss das Sensorsystem des Partners eine (Restful) API basierend auf den Planon-Spezifikationen veröffentlichen.
Das Planon SWI-System sendet Anfragen an diese API in einem Zeitintervall (Polling, Standard alle 60 Sekunden).
Um Daten abzurufen, verwendet ein von Planon verwalteter Connector Polling.
Es gibt zwei mögliche Anfragen an die API:
• Synchronisierung
Während der Synchronisation wird die gesamte Liste mit Messpunkten und zugehörigen Sensoren an das Sensorsystem veröffentlicht. Diese Synchronisation ist nur erforderlich, wenn sich an der Messstelle und/oder Sensoren etwas geändert hat.
Dies können neu hinzugefügte Messpunkte oder Sensoren sein, aber auch Änderungen der Messpunkt-ID oder Sensor-IDs. Gleiches gilt, wenn Messpunkte oder Sensoren gelöscht werden.Während der Synchronisation werden alle Messpunkte veröffentlicht, die einen gültigen Sensor verknüpft haben. Es spielt keine Rolle, ob der Sensor Aktiv oder nicht. Das Auslösen der Synchronisation ist ein manueller Vorgang, der am Verbinder Tab. Wenn dieses Ereignis ausgelöst wird, wird der Connector zur Synchronisierung gekennzeichnet.
Die eigentliche Synchronisation erfolgt beim nächsten Polling.• Messaktualisierung
Bei einem Messupdate wird eine Anfrage für alle aktiven Messpunkte gesendet. Liegen neue Messdaten vor, werden diese zur weiteren Verarbeitung an Planon weitergeleitet.
Die meisten Felder, die ausgefüllt werden müssen, beziehen sich auf die Identifizierung und Authentifizierung der externen API.