version 2003
ENVOYER ERREUR SOAP (typeErreur; description)
Paramètre | Type | Description | |
typeErreur | Entier long | 1 = Erreur Client, 2 = Erreur Serveur | |
description | Chaîne | Description de l'erreur à envoyer au client SOAP |
Description
La commande ENVOYER ERREUR SOAP permet de retourner une erreur à un client SOAP en indiquant l'origine de l'erreur : client ou serveur. Utiliser cette commande vous permet de signaler une erreur à un client sans devoir retourner de résultat.
Par exemple, une erreur côté client peut être détectée lorsque vous publiez un Web Service "Racine_carree" et qu'un client envoie une requête avec un nombre négatif ; vous pouvez utiliser cette commande afin d'indiquer au client qu'une valeur positive est requise.
Une erreur possible côté serveur peut être par exemple un manque de mémoire survenu lors de l'exécution de la méthode.
Passez dans typeErreur l'origine de l'erreur. Vous pouvez utiliser les constantes prédéfinies suivantes, placées dans le thème "Web Services (Serveur)" :
Constante | Type | Valeur |
SOAP erreur client | Entier long | 1 |
SOAP erreur serveur | Entier long | 2 |
Passez dans description un descriptif de l'erreur. Si l'implémentation du client est conforme, l'erreur pourra être traitée.
Exemple
Pour reprendre l'exemple du Web Service "Racine_carree" fourni dans la description de la commande, l'instruction suivante peut être utilisée pour traiter les requêtes sur des nombres négatifs :
ENVOYER ERREUR SOAP(SOAP erreur client;"Valeurs positives requises")
Référence
DECLARATION SOAP, Lire informations SOAP.