Übersicht Netzwerk JSON/XML


Mit diesem Funktionsbaustein können Netzwerk Geräte ausgelesen werden welche über http Abfrage ein JSON Objekt zurück liefern.





Eingänge

TR
Trigger
Optionaler Trigger. Mit steigender Flanke wird die Leseabfrage ausgeführt. Dieser Eingang kann alternativ zum Parameter Intervall verwendet werden. Ist der Parameter Intervall auf 0, wird die Abfrage ausschließlich über diesen Eingang ausgeführt.



Ausgänge

WT
Wert
Werte aus JSON Objekt

Parameter

Intervall
Abfrageintervall. Ist dieser Parameter auf 0, wird die Abfrage ausschließlich über den Eingang Trigger ausgeführt.
Server Adresse des Servers
Port Portnummer
HTTP URL
Angabe einer URL, es wird der Pfad hinter dem Servernamen eingegeben, beispielsweise "/verzeichnis", die gesamte URL wird dann aus "http://" + Server + diesem Parameter gebildet.
HTTP Benutzer
Optional Benutzer
HTTP Passwort
Optional Passwort
Typ Daten Daten sind im Format JSON oder XML
Daten Daten welche an der Ausgängen ausgegeben werden.

Typ JSON:

Die Daten werden in der Form: "key:key:data" definiert. Der letzte Eintrag ist der Name der Variable, davor ein oder mehrere Bereiche.

Beispiel: {"status":{"connected":true,"current":22}}

Um die beiden Parameter connected und current auszulesen muss folgendes definiert werden:

status:connected
status:current

Arrays werden nicht direkt unterstützt, können aber über mehrere keys angegeben werden:

"meters":[
    {"power":304.13},
    {"power":0.00},
    {"power":0.00}
]

Die Einträge lauten dann:

meters:power
meters:power:power
meters:power:power:power

Typ XML:

Die Daten werden in der Form: "<tag1>:<tag2>:id" definiert. Der letzte Eintrag ist der Name der Variable, davor ein oder mehrere Bereiche.

Beispiel 1: <current><city id="8010" name="Graz"/><country>AT</country></current>

Um die beiden Parameter city id und name auszulesen muss folgendes definiert werden:

<current>:<city:id
<current>:<city:name

um den Wert von Country auszulesen muss folgendes definiert werden:

<current>:<country>


Fehlerausgang verwenden Mit dieser Option wird bei Fehlern der Ausgang auf den Wert aus Parameter "Ausgang bei Fehler" gesetzt. Z.B. Fehlt die Variable im JSON String, wird dieser Wert am Ausgang ausgegeben. Bei allgemeinen Fehlern, z.B. wenn der Server nicht erreichbar ist, wird nur der erste Ausgang auf diesen Wert gesetzt. Der Erste Ausgang kann daher als Fehlerausgang verwendet werden.
Ausgang bei Fehler Wert der am Ausgang bei Fehler ausgegeben wird.






Siehe auch allgemeine Parameter aller Funktionsbausteine.