Funktionsblock HTTP_REQUEST

Funktionsblocket HTTP_REQUEST skapar en RAW-förfrågan för HTTP-gränssnittet.

Viktigt: Variabeln som ska skickas från gränssnittet HTTP måste ha datatypen RAW.

URI definieras som en variabel på höger sida under Kommunikation. Om den börjar med ett /, tas det första / bort. För att göra en förfrågan till det lägsta katalogen kan endast variabeln / definieras.

Vissa webbservrar kräver User-Agent-Header. Annars laddas sidan inte. Detta är inte ett fel i Antcas Control, utan ett skyddsmekanism hos den begärda webbläsaren. Använd ingången Header med innehållet:

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

Ingång Method

Ingången definierar överföringsmetoden som en sträng. Denna kan till exempel vara "GET", "POST", "PUT" eller andra. Om ingen metod definieras, väljs GET som standard.

Ingång Type

Ingången definierar Header Content-Type som en sträng. Om ingången inte är definierad, läggs inte posten till i Headern.

Ingång Header

Definierar ytterligare Header-poster som en sträng. Flera Header separeras med ett radbyte. Header Content-Length definieras automatiskt och Header Content-Type definieras med värdet på ingången Type.

Ingång Query

Ingången definierar Query som en sträng. Query är värdet efter frågetecknet och används vanligtvis vid GET-förfrågningar.

http://server/uri?query

Uppbyggnaden av ett Query ser ut så här:

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

För att värdena ska kunna överföras korrekt är det rekommenderat att koda de enskilda värdena med funktionsblocket URL_ENCODE eller QUERY_ENCODE, eftersom data möjligen kan överföras ofullständigt.

Anmärkning: Observera den maximala längden på en URL om större datamängder måste överföras. Använd i så fall POST-metoden och skicka Query som Content.

Ingång Content

Ingången Content är liknande ingången Query. Dock överförs data efter Headern och större datamängder stöds. Beroende på applikation kan typen av Content också inte ha någon Query-metod.

Anmärkning: Endast UTF-8-konforma data stöds. Vid överföring av binärdata rekommenderas det att koda dessa med funktionsblocket BASE64_ENCODE.

Ingång Timeout

Ingången definierar Timeout för förfrågan som tid i formatet T#30s i sekunder. Det rekommenderas att använda ett högt Timeout. Små värden kan leda till att förfrågningar inte utförs fullständigt. På grund av Keep-Alive-förfarandet, kan det ta en stund innan förfrågningarna bearbetas normalt igen.

Ingång DIS

Om ingången är sann, sätts värdet på utgången Request till NULL.

Ingång SET

Om ingången är sann, tvingar den fram genereringen av utgången Request. Denna ingång har prioritet över ingången DIS.

Utgång Request

Utgången returnerar en sträng i JSON-format. Om den har inaktiverats, returneras värdet NULL. Den används vanligtvis direkt med utgångsvariabeln för gränssnittet.

Utgång Length

Utgången returnerar längden på ingången Content i bytes.

Utgång ID

Returnerar ID:n för den senast skapade förfrågan. Denna är användbar för att verifiera svaret med funktionsblocket HTTP_RESPONSE.