Functieblok HTTP_REQUEST
De functieblok HTTP_REQUEST maakt een RAW-query voor de HTTP-schnittstelle.
Belangrijk: De te verzenden variabele van de HTTP-schnittstelle moet het datatype RAW hebben.
De URI wordt als variabele aan de rechterkant onder Communicatie gedefinieerd. Als deze begint met een /, wordt het eerste / verwijderd. Moet er een verzoek naar de laagste map worden gestuurd, kan alleen de variabele / worden gedefinieerd.
Sommige webservers vereisen de User-Agent-header. Anders wordt de pagina niet geladen. Dit is geen fout van Antcas Control, maar een beveiligingsmechanisme van de aangevraagde webbrowser. Gebruik de ingang Header met de inhoud:
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
Ingang Method
De ingang definieert de methode van de overbrenging als tekenreeks. Deze kan bijvoorbeeld "GET", "POST", "PUT" enzovoort zijn. Wordt er geen methode gedefinieerd, dan wordt GET als standaard gekozen.
Ingang Type
De ingang definieert de header Content-Type als tekenreeks. Is de ingang niet gedefinieerd, dan wordt de inzending niet aan de header toegevoegd.
Ingang Header
Definieert aanvullende headerinzendingen als tekenreeks. Meerdere headers worden gescheiden door een regelafbreking. De header Content-Length wordt automatisch gedefinieerd en de header Content-Type wordt gedefinieerd met de waarde aan de ingang Type.
Ingang Query
De ingang definieert het query als tekenreeks. Het query is de waarde na het vraagteken en wordt meestal gebruikt bij GET-verzoeken.
http://server/uri?query
De opbouw van een query ziet er dan zo uit:
var1=wert1&var2=wert2&va...
Opdat de waarden correct kunnen worden overgedragen, is het raadzaam om de afzonderlijke waarden met de functieblok URL_ENCODE of QUERY_ENCODE te coderen, omdat de gegevens mogelijk onvolledig worden overgedragen.
Opmerking: Let op de maximale lengte van een URL als grotere hoeveelheden gegevens moeten worden overgedragen. Gebruik indien nodig de POST-methode en verzend het query als Content.
Ingang Content
De ingang Content is vergelijkbaar met die van de ingang Query. Echter, worden de gegevens na de header overgedragen en worden grotere hoeveelheden gegevens ondersteund. Afhankelijk van het gebruik kan het type Content ook geen query-methode hebben.
Opmerking: Er worden alleen UTF-8-conforme gegevens ondersteund. Bij het overbrengen van binaire gegevens wordt aanbevolen om deze te coderen met de functieblok BASE64_ENCODE.
Ingang Timeout
De ingang definieert het timeout van het verzoek als tijd in het formaat T#30s in seconden. Het wordt aanbevolen om een hoog timeout te gebruiken. Kleine waarden kunnen ertoe leiden dat verzoeken niet volledig worden uitgevoerd. Door het Keep-Alive-proces kan het enige tijd duren voordat de verzoeken weer normaal worden verwerkt.
Ingang DIS
Als de ingang waar is, wordt de waarde aan de uitgang Request gelijk aan NULL.
Ingang SET
Als de ingang waar is, dwingt deze het genereren van de uitgang Request. Deze ingang heeft voorrang boven de ingang DIS.
Uitgang Request
De uitgang geeft een tekenreeks in JSON-formaat terug. Als hij is gedeactiveerd, wordt de waarde NULL teruggegeven. Hij wordt meestal rechtstreeks verbonden met de uitgangsvariabele van de schakeling.
Uitgang Length
De uitgang geeft de lengte van de ingang Content in bytes terug.
Uitgang ID
Geeft de ID van het laatst gegenereerde verzoek terug. Dit is handig om het antwoord te verifiëren met de functieblok HTTP_RESPONSE.