Blok funkce HTTP_REQUEST

Blok funkce HTTP_REQUEST vytváří RAW dotaz pro rozhraní HTTP.

Důležité: Proměnná, která má být odeslána přes rozhraní HTTP, musí mít datový typ RAW.

URI se definuje jako proměnná na pravé straně pod komunikací. Pokud začíná lomítkem /, první lomítko / je odstraněno. Chcete-li požádat o nejnižší adresář, můžete definovat pouze proměnnou /.

Některé webové servery vyžadují záhlaví User-Agent. V opačném případě se stránka nenahrá. To není chyba Antcas Control, ale ochranný mechanismus požadovaného webového prohlížeče. Použijte vstup Header s obsahem:

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

Vstup Method

Vstup definuje metodu přenosu jako řetězec znaků. Může to být například "GET", "POST", "PUT" atd. Pokud není definována žádná metoda, je zvolena GET jako výchozí hodnota.

Vstup Type

Vstup definuje záhlaví Content-Type jako řetězec znaků. Pokud není vstup definován, nebude tento záznam přidán do záhlaví.

Vstup Header

Definuje další záhlaví jako řetězec znaků. Více záhlaví je odděleno novým řádkem. Záhlaví Content-Length se automaticky definuje a záhlaví Content-Type se definuje hodnotou na vstupu Type.

Vstup Query

Vstup definuje dotaz jako řetězec znaků. Dotaz je hodnota za otazníkem a obvykle se používá při GET požadavcích.

http://server/uri?query

Stavba dotazu vypadá takto:

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

Aby mohly být hodnoty správně přenášeny, je doporučeno jednotlivé hodnoty zakódovat pomocí bloku funkce URL_ENCODE nebo QUERY_ENCODE, protože data mohou být možná neúplně přenesena.

Poznámka: Zvažte maximální délku URL, pokud je třeba přenášet větší množství dat. V případě potřeby použijte metodu POST a odešlete dotaz jako Content.

Vstup Content

Vstup Content je podobný vstupu Query. Data jsou však přenesena po záhlaví a podporuje se větší množství dat. V závislosti na aplikaci může typ Content nemít metodu Query.

Poznámka: Podporovány jsou pouze data v souladu s UTF-8. Při přenosu binárních dat je doporučeno je zakódovat pomocí bloku funkce BASE64_ENCODE.

Vstup Timeout

Vstup definuje timeout požadavku jako čas v formátu T#30s v sekundách. Doporučuje se použít vysoký timeout. Malé hodnoty mohou vést k tomu, že požadavky nebudou úplně provedeny. Díky proceduře Keep-Alive může trvat nějakou dobu, než budou požadavky zpracovávány normálně.

Vstup DIS

Pokud je vstup pravdivý, hodnota na výstupu Request bude rovna NULL.

Vstup SET

Pokud je vstup pravdivý, tento vstup nutí generovat výstup Request. Tento vstup má přednost před vstupem DIS.

Výstup Request

Výstup vrací řetězec znaků ve formátu JSON. Pokud byl deaktivován, vrátí se hodnota NULL. Obvykle je přímo spojen s výstupní proměnnou rozhraní.

Výstup Length

Výstup vrací délku vstupu Content v bytech.

Výstup ID

Vrací ID poslední vytvořené dotazy. Je to užitečné pro ověření odpovědi s blokem funkce HTTP_RESPONSE.