Funktionsblock JSON_DECODE
Der Funktionsblock JSON_DECODE dekodiert eine JSON-Zeichenkette.
Hinweis: Dieser Funktionsblock kann mehr als zwei Eingänge oder Ausgänge besitzen. Sie können mit der rechten Maustaste auf den Funktionsblock klicken, um einen weiteren Eingang oder Ausgang hinzufügen.
Eingang JSON
Der Eingang erwartet eine Zeichenkette im Format JSON. Es wird dabei ein Objekt erwartet, beginnend mit { und endend mit } oder beginnend mit [ und endend mit ].
Eingänge VAR1..VAR#
Die Eingänge definieren die Variable bzw. den Schlüssel, nachdem im Objekt gesucht wird. Müssen Unterobjekte extrahiert werden, so kann dies mit einer neuen Zeile deklariert werden:
Sensor↵OG↵Status
Wird der Eingang nicht definiert oder ist dieser gleich NULL, so werden keine Daten extrahiert.
Es ist möglich ein Array abzufragen. Der entsprechende Index kann als Zahl abgefragt werden.
Das Resultat wird an den gegenüberliegenden Ausgang ausgegeben.
Ausgang ERR
Der Ausgang ist im Fehlerfall wahr. Dies ist auch der Fall, wenn kein Wert am Eingang JSON anliegt.
Ausgänge VALUE1..VALUE#
Ein Ausgang gibt die extrahierten Daten der gegenüberliegenden Variable zurück. Existieren keine Daten oder ist der JSON-Wert gleich NULL, wird der Wert NULL zurückgegeben.
Sind Daten oder das gesuchte Objekt nicht vorhanden, wird NULL zurückgegeben. Falls es sich um ein Objekt oder ein Array handelt, wird die Zeichenkette Array zurückgegeben.
Tipp: Um zu erkennen, ob ein Wert definiert wurde kann der Funktionsblock IS_NULL verwendet werden.