WEB SERVICE GET RESULT
WEB SERVICE GET RESULT ( returnValue {; returnName {; *}} )
| Parameter | Type | Description | |
|---|---|---|---|
| returnValue | Variable | ← | Value returned by the Web Service |
| returnName | Text | → | Name of the parameter to be retrieved |
| * | Operator | → | Free up memory |
Description
The WEB SERVICE GET RESULT command retrieves a value sent back by the Web Service as a result of the processing performed.
Note: This command must be used only after the WEB SERVICE CALL command.
The returnValue parameter receives the value sent back by the Web Service. Pass a 4D variable in this parameter. This variable is generally $0, corresponding to the value returned by the proxy method. It is, however, possible to use intermediary variables (you must use process variables only).
Note: Each 4D variable or array used must be previously declared using the commands of the “Compiler and Arrays” themes.
The optional returnName parameter specifies the name of the parameter to be retrieved. However, since most Web Services only return a single value, this parameter is generally not necessary.
The optional * parameter signals the program to free up the memory devoted to the processing of the request. You must pass this parameter after retrieving the last value sent by the Web Service.
Example
Imagine that a Web Service returns the current time in any city in the world. The parameters received by the Web Service are the name of the city and the country code. In return, the Web Service sends the corresponding time. The proxy calling method could be in the following form:
var $1 : Text
var $2 : Text
var $0 : Time
WEB SERVICE SET PARAMETER("city";$1)
WEB SERVICE SET PARAMETER("country_code";$2)
WEB SERVICE CALL("http://www.citiesoftheworld.com/WS";"WSTime#City_time";"City_time";\
"http://www.citiesoftheworld.com/namespace/default")
If(OK=1)
WEB SERVICE GET RESULT($0;"return";*)
End if