Funksjonsblokk HTTP_REQUEST

Funksjonsblokken HTTP_REQUEST oppretter en RAW-henvendelse for HTTP-grensesnittet.

Viktig: Den variable som skal sendes fra grensesnittet HTTP må ha datatypen RAW.

URI defineres som en variabel på høyre side under kommunikasjon. Hvis denne starter med et /, blir det første / fjernet. For å gjøre en henvendelse til det nederste katalogen, kan bare variabelen / defineres.

Noen webservere krever User-Agent-Header. Ellers lastes ikke siden. Dette er ikke en feil i Antcas Control, men en beskyttelsesmekanisme for den henvendte nettleseren. Bruk inngangen Header med følgende innhold:

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

Inngang Method

Inngangen definerer metoden for overføringen som en streng. Denne kan for eksempel være "GET", "POST", "PUT" eller lignende. Hvis ingen metode er definert, blir GET valgt som standard.

Inngang Type

Inngangen definerer Header Content-Type som en streng. Hvis inngangen ikke er definert, legges ikke posten til i headeren.

Inngang Header

Definerer tilleggsheaderposter som en streng. Flere headerposter skilles med et linjeskift. Header Content-Length defineres automatisk og Header Content-Type defineres med verdien på inngangen Type.

Inngang Query

Inngangen definerer Query som en streng. Query er verdien etter spørsmålstegnet og brukes vanligvis ved GET-henvendelser.

http://server/uri?query

Oppbyggingen av et query ser slik ut:

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

For at verdiene skal kunne overføres korrekt, er det lurt å kode de enkelte verdiene med funksjonsblokken URL_ENCODE eller QUERY_ENCODE, da dataene kanskje ikke blir fullstendig overført.

Merk: Ta hensyn til den maksimale lengden på en URL hvis større datamengder må overføres. Bruk om nødvendig POST-metoden og send Query som Content.

Inngang Content

Inngangen Content er lik inngangen Query. Imidlertid blir dataene overført etter headeren, og større datamengder støttes. Avhengig av applikasjonen kan typen Content også ikke ha en Query-metode.

Merk: Bare UTF-8-samtlige data støttes. Ved overføring av binære data anbefales det å kode disse med funksjonsblokken BASE64_ENCODE.

Inngang Timeout

Inngangen definerer timeout for henvendelsen som tid i formatet T#30s i sekunder. Det anbefales å bruke et høyt timeout. Små verdier kan føre til at henvendelser ikke blir fullstendig utført. På grunn av Keep-Alive-prosedyrer, kan det ta en stund før henvendelsene blir behandlet normalt igjen.

Inngang DIS

Hvis inngangen er sann, blir verdien på utgangen Request lik NULL.

Inngang SET

Hvis inngangen er sann, tvinger denne genereringen av utgangen Request. Denne inngangen har prioritet over inngangen DIS.

Utgang Request

Utgangen returnerer en streng i JSON-format. Hvis den er deaktivert, returneres verdien NULL. Den brukes vanligvis direkte med utgangsvariabelen til grensesnittet.

Utgang Length

Utgangen returnerer lengden på inngangen Content i bytes.

Utgang ID

Returnerer ID-en for den siste genererte henvendelsen. Denne er nyttig for å verifisere svaret med funksjonsblokken HTTP_RESPONSE.