Funkcióblokk HTTP_REQUEST

A Funkcióblokk HTTP_REQUEST létrehoz egy RAW lekérdezést az HTTP interfészhez.

Fontos: Az HTTP interfészen küldendő változónak a RAW adattípusnak kell lennie.

A URI a Kommunikáció alatt definiált jobb oldali változóként van megadva. Ha ez egy / karakterrel kezdődik, akkor az első / karaktert eltávolítja. Ha a legalsó mappára kell lekérdezni, akkor csak a / változót lehet definiálni.

Néhány webfelületen szükséges a User-Agent fejléc. Ellenkező esetben az oldal nem töltődik be. Ez nem Antcas Control hibája, hanem a lekérdezett böngésző védelmi mechanizmusa. Használja az Header bemenetet a következő tartalommal:

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

Bemenet Method

A bemenet definiálja az átviteli módot szövegként. Ez például "GET", "POST", "PUT" stb. lehet. Ha nincs mód definiálva, akkor az alapértelmezett GET lesz.

Bemenet Type

A bemenet definiálja a Header Content-Type-t szövegként. Ha a bemenet nem definiált, akkor a bejegyzés nem kerül hozzáadásra a fejléchez.

Bemenet Header

Definiál további fejléceket szövegként. Több fejlécet sorvégjellel választanak el. A Header Content-Length automatikusan definiált, és a Header Content-Type az Type bemenet értékével definiálva.

Bemenet Query

A bemenet definiálja a Query-t szövegként. A Query az értékeket tartalmazza a kérdőjel után, és általában GET lekérdezésekben használatos.

http://server/uri?query

A Query szerkezete a következő:

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

Aért az értékek helyesen átvihetők legyenek, ajánlott a különbözö értékeket a URL_ENCODE vagy QUERY_ENCODE funkcióblokkokkal kódolni, mivel az adatok esetlegesen hiányosan kerülhetnek átvitelre.

Megjegyzés: Vegyék figyelembe egy URL maximális hosszát, ha nagyobb adatmennyiségeket kell átvinni. Használja lehetséges esetben a POST módot és küldje el a Query-t Contentként.

Bemenet Content

A Content bemenet hasonló a Query bemenethez. Azonban az adatok a fejléc után kerülnek átvitelre, és nagyobb adatmennyiségeket támogat. Attól függően, hogy milyen alkalmazás használja, a Content típusának nem kell Query módot tartalmaznia.

Megjegyzés: Csak UTF-8 megfelelő adatok támogatottak. Bináris adatok átvitelénél ajánlott ezeket a BASE64_ENCODE funkcióblokkal kódolni.

Bemenet Timeout

A bemenet definiálja a lekérdezés időtartamát időformátumban T#30s másodpercben. Ajánlott magas időtartamot használni. Kisebb értékek miatt lehet, hogy a lekérdezések nem teljesülnek. A Keep-Alive eljárás miatt, lehet, hogy egy ideig tart, amíg a lekérdezések újra normálisan feldolgozódnak.

Bemenet DIS

Ha a bemenet igaz, akkor a Request kimeneten az érték NULL lesz.

Bemenet SET

Ha a bemenet igaz, akkor erőteljesen generálja a Request kimenetet. Ez a bemenet prioritást kap a DIS bemenet előtt.

Kimenet Request

A kimenet visszaad egy JSON formátumú szöveget. Ha deaktiválták, akkor a NULL értéket adja vissza. Általában közvetlenül összekötik az interfész kimeneti változójával.

Kimenet Length

A kimenet visszaadja a Content bemenet hosszat bájtokban.

Kimenet ID

Visszaadja az utolsó generált lekérdezés azonosítóját. Ez hasznos, hogy ellenőrizze a válaszokat a HTTP_RESPONSE funkcióblokkal.