4D Doc Center : WEB SERVICE LIRE RESULTAT

4D v14.3

WEB SERVICE LIRE RESULTAT


WEB SERVICE LIRE RESULTAT ( valeurRetour {; nomRetour {; *}} )

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 WEB SERVICE LIRE RESULTAT 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 APPELER.

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)

 

 WEB SERVICE FIXER PARAMETRE("ville";$1)

 WEB SERVICE FIXER PARAMETRE("code_pays";$2)

 

 WEB SERVICE APPELER("http://www.villesdumonde.com/WS";"WSHeures#Heure_ville";"Heure_ville"; 

                   "http://www.villesdumonde.com/namespace/default")

 

 Si(OK=1)

    WEB SERVICE LIRE RESULTAT($0;"retour";*) 

 Fin de si