ComfortOnline Eingang

Inhaltsverzeichnis

Beschreibung
Eingänge
Ausgänge
Beispiele

Beschreibung

Dieser Baustein ist in der Lage Daten aus dem Comfort Online-Portal des Herstellers für Biomassekessel abzurufen. Die abgerufenen Werte werden als auswertbare Struktur bereitgestellt.

Eingänge

Um Daten abzurufen, muss der Trigger-Eingang geschaltet werden. Weitere Eingänge sind:

Bezeichnung	Porttyp	Beschreibung
Trigger	Bool	Triggert das abrufen der Daten
PlantId	Text	Die ID der abzufragenden Anlage (siehe nachfolgende Beschreibung)
PlantSection	Text	Die ID des abzufragenden Anlagenteils (siehe nachfolgende Beschreibung)
UserName	Text	Benutzername (E-Mail-Adresse) für Comfort Online
Password	Text	Password für Comfort Online

Die PlantId sowie PlantSection kann im Comfort Online-Portal abgerufen werden. Um an die erforderlichen Werte zu kommen, bitte das Comfort Online-Portal im Browser öffnen und anmelden. In der Navigationsleiste erscheint nun eine Adresse wie folgt:
https://www.comfort-online.com/de-DE/Measurand/Values?plant=KWB%20EF2-10458&name=KWB%20EF2-96_0
Hier wird nun der Teil nach dem letzten Bindestrich (-) der URL-Parameter plant und name benötigt. In diesem Beispiel also 10458 für die PlantId und 96_0 für PlantSection.

Ausgänge

Bezeichnung	Porttyp	Beschreibung
Data	Text	Gibt alle erkannten Werte des Anlagenteils als JSON-Struktur aus. Diese Struktur kann nachfolgend weiter ausgewertet werden. Hinweise: Die Schlüssel der Struktur entsprechend den Schlüsseln aus Comfort Online mit val_ -Prefix. Zahlenwerte o.Ä. werden i.d.R. im internationalen Format ausgegeben.
Diagnostics	Text	Kurztext zur Diagnose. Bekannte Werte: Ok: Baustein arbeitet wie erwartet. InitialRequestFailed: Initiale Anfrage an Comfort Online ist fehlgeschlagen. Mögliche Ursachen: Allgemeine Netzwerkfehler. MissingRequestVerificationToken: Extraktion des Anfrage-Tokens aus Initialanfrage fehlgeschlagen. Mögliche Ursachen: Umstellung seitens KWB oder Fehler im Baustein. InvalidCredentials: UserName oder Password ist fehlerhaft. LoginFailed: Allgemeiner Anmeldefehler. Mögliche Ursachen: Fehler im Baustein. UnexpectedError: Detailtext: Allgemeiner, unerwarteter Fehler. Anstelle von Detailtext werden detaillierte Informationen ausgegeben. Mögliche Ursachen: Fehler im Baustein.

Bezeichnung

Porttyp

Beschreibung

Data

Text

Gibt alle erkannten Werte des Anlagenteils als JSON-Struktur aus. Diese Struktur kann nachfolgend weiter ausgewertet werden.

Hinweise:

Die Schlüssel der Struktur entsprechend den Schlüsseln aus Comfort Online mit val_ -Prefix.
Zahlenwerte o.Ä. werden i.d.R. im internationalen Format ausgegeben.

Diagnostics

Text

Kurztext zur Diagnose.

Bekannte Werte:

Ok: Baustein arbeitet wie erwartet.
InitialRequestFailed: Initiale Anfrage an Comfort Online ist fehlgeschlagen. Mögliche Ursachen: Allgemeine Netzwerkfehler.
MissingRequestVerificationToken: Extraktion des Anfrage-Tokens aus Initialanfrage fehlgeschlagen. Mögliche Ursachen: Umstellung seitens KWB oder Fehler im Baustein.
InvalidCredentials: UserName oder Password ist fehlerhaft.
LoginFailed: Allgemeiner Anmeldefehler. Mögliche Ursachen: Fehler im Baustein.
UnexpectedError: Detailtext: Allgemeiner, unerwarteter Fehler. Anstelle von Detailtext werden detaillierte Informationen ausgegeben. Mögliche Ursachen: Fehler im Baustein.

Beispiele

In diesem Beispiel werden die Daten mit einem zyklischen Trigger aus der KWB-Comfort-Online Plattform abgerufen un im Anschluss mit einem JSON-Parser extrahiert.

Die extrahierten Daten können im Anschluss weiter verwertet werden.