Funktionsblok HTTP_REQUEST

Funktionsblokken HTTP_REQUEST opretter en RAW-hentning til HTTP-grænsefladen.

Vigtigt: Den variable, der skal sendes fra grænsefladen HTTP, skal have datatypen RAW.

URI'en defineres som en variable på højre side under Kommunikation. Hvis denne starter med et /, fjernes det første /. Skal der foretages en hentning til den nederste mappe, kan variablen / kun defineres.

Nogle webservere kræver User-Agent-overskriften. Ellers indlæses siden ikke. Dette er ikke en fejl i Antcas Control, men en beskyttelsesmekanisme for den anførte webbrowser. Brug indgangen Header med følgende indhold:

User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13

Indgang Method

Indgangen definerer metoden til overførslen som en streng. Denne kan f.eks. være "GET", "POST", "PUT" osv. Hvis der ikke defineres en metode, vælges GET som standard.

Indgang Type

Indgangen definerer overskriften Content-Type som en streng. Er indgangen ikke defineret, tilføjes posten ikke til overskriften.

Indgang Header

Definerer yderligere overskriftsindgange som en streng. Flere overskrifter adskilles med et linjeskift. Overskriften Content-Length defineres automatisk, og overskriften Content-Type defineres med værdien på indgangen Type.

Indgang Query

Indgangen definerer query'en som en streng. Query'en er værdien efter spørgsmålstegnet og bruges typisk ved GET-hentninger.

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, anbefales det at kodificere de enkelte værdier med funktionsblokken URL_ENCODE eller QUERY_ENCODE, da dataene måske ikke fuldstændigt overføres.

Note: 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 send query'en som indhold.

Indgang Content

Indgangen Content er ligesom fra indgangen Query. Dog overføres dataene efter overskriften, og der understøttes større datamængder. Afhængigt af anvendelsen kan typen for Content også ikke have en query-metode.

Note: Der understøttes kun data i overensstemmelse med UTF-8. Ved overførslen af binære data anbefales det at kodificere disse med funktionsblokken BASE64_ENCODE.

Indgang Timeout

Indgangen definerer timeout for hentningen som tid i formatet T#30s i sekunder. Det anbefales at bruge et højt timeout. Små værdier kan føre til, at hentninger ikke udføres fuldstændigt. På grund af Keep-Alive-proceduren kan det tage lidt tid, før hentningerne igen behandles normalt.

Indgang DIS

Er indgangen sand, gives værdien på udgangen Request lig med NULL.

Indgang SET

Er indgangen sand, tvinger denne genereringen af udgangen Request. Denne indgang har prioritet over indgangen DIS.

Udgang Request

Udgangen returnerer en streng i JSON-format. Hvis den er deaktiveret, returneres værdien NULL. Den bruges typisk direkte med udgangsvariablen for grænsefladen.

Udgang Length

Udgangen returnerer længden af indgangen Content i bytes.

Udgang ID

Returnerer ID'en for den sidst oprettede hentning. Dette er nyttigt til at verificere svaret med funktionsblokken HTTP_RESPONSE.