Aller au contenu principal
Version: Next

SOAP SEND FAULT

SOAP SEND FAULT ( typeErreur ; description )

ParamètreTypeDescription
typeErreurEntier long🡒1 = Erreur Client, 2 = Erreur Serveur
descriptionChaîne🡒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) :

ConstanteTypeValeur
SOAP client faultEntier long1
SOAP server faultEntier long2

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")

Voir aussi

SOAP DECLARATION
SOAP Get info