Funktionsblock HTTP_RESPONSE
Der Funktionsblock HTTP_RESPONSE dekodiert eine RAW-Antwort von der HTTP-Schnittstelle.
Wichtig: Die Empfangs-Variable von der Schnittstelle HTTP muss den Datentyp RAW besitzen.
Eingang Response
Der Eingang erwartet eine Zeichenkette im Format JSON. Er wird üblicherweise direkt mit der Rückmelde- oder Empfangs-Variable der Schnittstelle verbunden.
Eingang ID
Der Eingang definiert die ID der Abfrage. Die ID wird bei der Abfrage am Funktionsblock HTTP_REQUEST erzeugt. So wird sichergestellt, dass nur die Antwort der Anfrage mit der entsprechenden ID bearbeitet wird. Ist der Eingang nicht definiert, wird jede Antwort ausgewertet.
Eingang Reset
Ist der Eingang wahr, so werden alle Ausgänge auf NULL zurückgesetzt. Solange dieser Eingang wahr ist, werden die Werte für die Ausgänge nicht berechnet.
Ausgang Method
Der Ausgang gibt die Methode der Übertragung als Zeichenkette zurück. Diese kann z.B. "GET", "POST", "PUT" o.a. sein.
Ausgang Type
Der Ausgang gibt den Header Content-Type als Zeichenkette zurück.
Ausgang Header
Der Ausgang gibt alle Header-Einträge als Zeichenkette zurück. Mehrere Header werden mit einem Zeilenumbruch getrennt.
Ausgang Query
Der Ausgang gibt das Query als Zeichenkette zurück. Das Query ist der Wert nach dem Fragezeichen und wird üblicherweise bei GET-Anfragen verwendet.
http://server/uri?query
Der Aufbau eines Querys sieht dann so aus:
var1=wert1&var2=wert2&va...
Damit die Werte korrekt übertragen werden können, ist es ratsam, die einzelnen Werte mit dem Funktionsblock URL_DECODE oder QUERY_DECODE zu dekodieren, da die Daten möglicherweise unvollständig übertragen werden.
Hinweis: Beachten Sie die maximale Länge eines URL's, falls grössere Datenmengen übertragen werden müssen. Verwenden Sie ggf. die POST-Methode und empfangen das Query als Content.
Ausgang Content
Der Ausgang Content ist ähnlich wie der vom Ausgang Query. Jedoch werden die Daten nach dem Header übertragen und es werden grössere Datenmengen unterstützt. Je nach Anwendung kann der Typ von Content auch keine Query-Methode aufweisen.
Hinweis: Es werden nur UTF-8 konforme Daten unterstützt. Beim Übertragen von Binärdaten wird empfohlen, diese mit dem Funktionsblock BASE64_ENCODE zu kodieren.
Ausgang Length
Der Ausgang gibt die Länge des Eingangs Content in Bytes zurück.
Ausgang Status
Der Ausgang gibt den HTTP-Status als Zahl zurück. Z.B. 200, 404 o.a. Wurde kein Status empfangen, wird der Wert NULL zurückgegeben.
Ausgang Error
Der Ausgang ist wahr, wenn ein der Eingang Status nicht 200 oder NULL zurückgibt.
Ausgang ErrNum
Der Ausgang gibt die cURL-Fehlernummer zurück. Ist diese 0, liegt kein Fehler bei der Übertragung vor.
Ausgang ErrStr
Der Ausgang gibt den Fehlertext zur cURL-Abfrage zurück.