CX_HTTP_REQUEST::SetQueryParameter

CX_HTTP_REQUEST::SetQueryParameter

184206

Beschreibung:

Diese Methode setzt die Query-Parameter für den aktuellen Request. Query-Parameter werden unabhängig von der HTTP-Method und dem Content-Type immer in der Query (also in der URL) übertragen. Die Query-Parameter lassen sich auch über SetURL setzen, indem man eine URL mit Query-String angibt. Dabei sollte lediglich beachtet werden, dass SetURL alle vorher gesetzten Query-Parameter löscht.
Beispiel: /api?session=1234&username=cx&action=reload. 

Wenn der Body nicht leer ist oder der Content-Type nicht passt, dann werden die regulären Parmeter (siehe SetParameter) ebenfalls als Query-Parameter übertragen. Die Query-Parameter, die über SetQueryParameter gesetzt wurden haben bei gleichnamigen Parametern vorrang.

Hinweis: Bei SendRequest werden die Query-Parameter aus technischen Gründen in alphabetischer Reihenfolge gesendet.

Durch Setzten eines leeren Strings wird ein ein Parameter wieder gelöscht.

Code-Beispiel:

Var(req)
CreateTransObject(CX_HTTP_REQUEST) -> req
"http://apihost.com/create/person?name=john&id=3" req Call(SetURL)

//Set query parameters to transmit
"name" "jimmy" req Call(SetQueryParameter)
"age" "12" req Call(SetQueryParameter)

req GetManager(WEB_SERVICE) Call(SendRequest) //Sends /create/person?age=12&id=3&name=jimmy

Funktionsaufruf: Call(SetQueryParameter)