SOAP SEND FAULT
SOAP SEND FAULT ( typeErreur ; description )
| Paramètre | Type | Description | |
|---|---|---|---|
| typeErreur | Integer | → | 1 = Erreur Client, 2 = Erreur Serveur |
| description | Text | → | Description de l’erreur à envoyer au client SOAP |
Description
La commande SOAP SEND FAULT 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 client fault | Entier long | 1 |
| SOAP server fault | 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 :
SOAP SEND FAULT(SOAP client fault;"Valeurs positives requises")