Funktionsblok HTTP_RESPONSE

Funktionsblokken HTTP_RESPONSE dekoderer en RAW-svar fra HTTP-grænsefladen.

Vigtigt: Modtager-variablen fra HTTP-grænsefladen skal have datatypen RAW.

Indgang Response

Indgangen forventer en streng i JSON-format. Den forbindes normalt direkte med tilbagemeldings- eller modtagevariabelen fra grænsefladen.

Indgang ID

Indgangen definerer ID'en for henvendelsen. ID'en oprettes ved henvendelse til funktionsblokken HTTP_REQUEST. På den måde sikres det, at kun svaret på henvendelsen med den tilsvarende ID behandles. Hvis indgangen ikke er defineret, evalueres ethvert svar.

Indgang Reset

Hvis indgangen er sand, nulstilles alle udgange til NULL. Så længe denne indgang er sand, beregnes værdierne for udgangene ikke.

Udgang Method

Udgangen returnerer overførselens metode som en streng. Denne kan f.eks. være "GET", "POST", "PUT" osv.

Udgang Type

Udgangen returnerer header Content-Type som en streng.

Udgang Header

Udgangen returnerer alle headerelementer som en streng. Flere headers adskilles med et linjeskift.

Udgang Query

Udgangen returnerer query'en som en streng. Query'en er værdien efter spørgsmålstegnet og bruges normalt ved GET-henvendelser.

http://server/uri?query

Opbygningen af et query ser sådan ud:

var1=wert1&var2=wert2&va...

For at værdierne kan overføres korrekt, er det rådgivende at dekodere de enkelte værdier med funktionsblokken URL_DECODE eller QUERY_DECODE, da dataene måske overføres ufuldstændigt.

Bemærk: Vær opmærksom på den maksimale længde af en URL, hvis større datamængder skal overføres. Brug eventuelt POST-metoden og modtag query'en som indhold.

Udgang Content

Udgangen Content er ligesom den fra udgangen Query. Dog overføres dataene efter headeren, og større datamængder understøttes. Afhængigt af anvendelsen kan typen af indhold også ikke have en query-metode.

Bemærk: Der understøttes kun UTF-8-konforme data. Ved overførsel af binære data anbefales det at kodere dem med funktionsblokken BASE64_ENCODE.

Udgang Length

Udgangen returnerer længden af indgangsindholdet i bytes.

Udgang Status

Udgangen returnerer HTTP-status som et tal. F.eks. 200, 404 osv. Hvis ingen status er modtaget, returneres værdien NULL.

Udgang Error

Udgangen er sand, hvis indgangen Status ikke returnerer 200 eller NULL.

Udgang ErrNum

Udgangen returnerer cURL-fejlnummeret. Hvis dette er 0, foreligger der ingen fejl ved overførslen.

Udgang ErrStr

Udgangen returnerer fejleteksten til cURL-henvendelsen.