WEB SERVICE GET RESULT
WEB SERVICE GET RESULT ( valeurRetour {; nomRetour {; *}} )
| Paramètre | Type | Description | |
|---|---|---|---|
| valeurRetour | Variable | ← | Valeur retournée par le Web Service |
| nomRetour | Text | → | Nom du paramètre à récupérer |
| * | Operator | → | Libérer la mémoire |
Description
La commande WEB SERVICE GET RESULT permet de récupérer une valeur renvoyée par le Web Service à l’issue du traitement effectué.
Note : Cette commande doit être utilisée uniquement après la commande WEB SERVICE CALL.
Le paramètre valeurRetour reçoit la valeur renvoyée par le Web Service. Passez dans ce paramètre une variable 4D. Cette variable est généralement $0, correspondant à la valeur retournée par la méthode proxy. Il est toutefois possible d’utiliser des variables intermédiaires (vous devez utiliser des variables process uniquement).
Note : Chaque variable ou tableau 4D utilisé(e) doit être préalablement déclaré(e) à l’aide des commandes des thèmes “Compilateur” et “Tableaux”.
Le paramètre optionnel nomRetour permet de spécifier le nom du paramètre à récupérer. Toutefois, comme la plupart des Web Services retournent une seule valeur, ce paramètre n’est généralement pas nécessaire.
Le paramètre *, optionnel, indique au programme de libérer la mémoire consacrée au traitement de la requête. Vous devez passer ce paramètre après la récupération de la dernière valeur renvoyée par le Web Service.
Exemple
Imaginons un Web Service retournant l’heure courante dans n’importe quelle ville du monde. Les paramètres reçus par le Web Service sont le nom de la ville et le code du pays. Le Web Service retourne alors l’heure correspondante. La méthode proxy d’appel pourrait être de la forme suivante :
var $1 : Text
var $2 : Text
var $0 : Time
WEB SERVICE SET PARAMETER("ville";$1)
WEB SERVICE SET PARAMETER("code_pays";$2)
WEB SERVICE CALL("http://www.villesdumonde.com/WS";"WSHeures#Heure_ville";"Heure_ville";
"http://www.villesdumonde.com/namespace/default")
If(OK=1)
WEB SERVICE GET RESULT($0;"retour";*)
End if