La transformation Erreur représente l'élément Erreur dans le service Web WSDL. La transformation Erreur génère une erreur définie par l'utilisateur dans l'opération de service Web.
La transformation Erreur représente l'une des erreurs définies par l'utilisateur suivantes :
Erreur prédéfinie
Une erreur prédéfinie a lieu lorsque la transformation Erreur représente l'élément de défaillance dans le service Web WSDL. Dans une erreur prédéfinie, la transformation Erreur crée un message d'erreur à partir des données relationnelles dans le mappage d'opération du service Web.
Erreur générique
Une erreur générique se produit lorsque la transformation Erreur ne représente pas d'élément de défaillance défini dans le service Web WSDL pour une opération de service Web. La transformation Erreur pour une erreur générique renvoie un message d'erreur générique lorsqu'une erreur se produit dans une transformation. Vous pouvez créer et configurer une transformation Erreur pour une erreur générique dans l'outil Developer.
Un mappage d'opération peut contenir plusieurs transformations Erreur. Vous pouvez ajouter plusieurs instances de la même transformation Erreur dans un mappage pour générer le même message dans différentes parties du mappage.
Vous pouvez ajouter des transformations Erreur au mappage ou les retirer sans modifier la signature de l'opération. Si vous savez qu’une erreur ne peut jamais se produire lorsque le mappage est exécuté, vous pouvez retirer la transformation Erreur du mappage. Vous devez connectez une transformation Erreur à une transformation en amont ou le mappage n'est pas valide.
Lorsque vous créez une erreur dans une opération qui a une liaison SOAP 1.1, l'assistant crée les éléments faultcode, faultstring et faultactor. Lorsque vous créez une erreur dans une opération qui a une liaison SOAP 1.2, l'assistant crée les éléments code, reason, node et role. Lorsque vous ajoutez des éléments à l'erreur, l'assistant ajoute les éléments pour le groupe de détail dans l'erreur. Utilisez l'onglet
Ports
de la transformation Erreur pour afficher la hiérarchie de l'erreur d'opération, ajouter les ports d'entrée de la transformation et mapper les ports d'entrée à l'erreur d'opération. La hiérarchie de l'erreur d'opération définit la hiérarchie du message de la réponse SOAP pour les messages d'erreur qui résultent d'une erreur définie par l'utilisateur.
Vous pouvez mapper des données XML à partir d'une chaîne ou un port d'entrée à la réponse SOAP entière. Lorsque vous mappez des données XML à la réponse SOAP entière, vous ne pouvez pas mapper les ports aux nœuds dans l'erreur d'opération.