Lade...
 

CX_HTTP_REQUEST::SetHeader

CX_HTTP_REQUEST::SetHeader

184205

Beschreibung:

Diese Methode setzt einen HTTP-Header für eine HTTP-Anfrage. Die Methode ist dafür gedacht, eine Anfrage für SendRequest vorzubereiten und entsprechende Header zu setzen. Vorhandene Header können durch setzen des Wertes "" oder NULL gelöscht werden. Eine besondere Bedeutung hat der Content-Type Header. Dieser beeinflusst, ob die mit SetParameter gesetzten Parameter im Body, oder in der URL übertragen werden. Ist der Content-Type weder leer, noch application/x-www-form-urlencoded, noch multipart/form-data, dann werden alle Parameter über die URL übermittelt.

Mehrfache Werte für einen Header, wie bei Set-Cookie üblich, werden nicht unterstützt. Ein erneutes SetHeader überschreibt den vorherigen Wert. SetHeader arbeitet beim Überschreiben case-insensitiv.

 

Code-Beispiel:

Var(req)
//Create Request and set API-url
CreateTransObject(CX_HTTP_REQUEST) -> req
"http://apihost.com/create/person" req Call(SetURL)

//Create person via POST-method
"POST" req Call(SetMethod)

//Set correct content-type
"Content-Type" "application/json" req Call(SetHeader)

//Set the request body
"{\"name\":\"jimmy\", \"age\":13}" req Call(SetBody)

//Send request
req GetManager(WEB_SERVICE) Call(SendRequest)

 

Stack
Stack Position Objekttyp Kurzbeschreibung
Stack(In) Top STRING Headerwert
  Top-1 STRING Headername
Stack(Out) Top TYP  
Funktionsaufruf: Call(SetHeader)