version 2003
LIRE RESULTAT WEB SERVICE (valeurRetour{; nomRetour{; *}})
Paramètre | Type | Description | |
valeurRetour | Variable | Valeur retournée par le Web Service | |
nomRetour | Chaîne | Nom du paramètre à récupérer | |
* | Libérer la mémoire |
Description
La commande LIRE RESULTAT WEB SERVICE 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 APPELER WEB SERVICE.
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 :
C_TEXTE($1) C_TEXTE($2) C_HEURE($0) FIXER PARAMETRE WEB SERVICE("ville";$1) FIXER PARAMETRE WEB SERVICE("code_pays";$2) APPELER WEB SERVICE("http://www.villesdumonde.com/WS";"WSHeures#Heure_ville";"Heure_ville"; "http://www.villesdumonde.com/namespace/default") Si (OK=1) LIRE RESULTAT WEB SERVICE($0;"retour";*) Fin de si
Référence
APPELER WEB SERVICE, FIXER PARAMETRE WEB SERVICE.