Aller au contenu principal

Appel SOAP

Configuration actuelle de la tâche Appel SOAP dans le concepteur de flux de travail
  • Type de tâche: soap-call

Description​

La tâche "Appel SOAP" permet de lancer une requête à un service web basé sur le protocole SOAP. La tâche gère automatiquement la construction de l'enveloppe XML (Envelope) et le parsing des messages d'erreur (Fault) retournés par le serveur.

Paramètres de Configuration​

  • Connexion SSL: Spécifie si l'appel doit utiliser le protocole SSL (oui / non).
  • Proxy: Configuration pour le routage de l'appel :
  • Paramètre Système: Utilise les paramètres proxy par défaut du système.
  • Pas de Proxy: Aucun proxy n'est utilisé.
  • Proxy Personnalisé: Permet d'insérer une adresse spécifique dans le champ dédié.
  • Endpoint: L'URL complète du service web SOAP à interroger. (ex. https://www.dataaccess.com/webservicesserver/NumberConversion.wso).
  • Namespace: L'URI de l'espace de noms XML à associer au préfixe ns à l'intérieur du corps de la requête. Insérer la déclaration complète, y compris xmlns:ns= et l'espace de noms entre guillemets. (ex. xmlns:ns="http://www.dataaccess.com/webservicesserver/").
  • Header: Insérer la balise <soap:Header> dans le message SOAP. Si aucun données ne doivent être incluses, utiliser <soap:Header/>. Si le service requiert des informations (ex. jeton d'autorisation), les insérer à l'intérieur de la balise :
<soap:Header>
 <auth:Token>ABC123XYZ</auth:Token>
</soap:Header>```
  • Body: Insérer la balise <soap:Body> contenant les données de l'appel (ex. <soap:Body>...<ns:Metodo></ns:Metodo></soap:Body>).

Notes Techniques Importantes​

  • Envelope: Ne pas insérer la balise </soap:Envelope>. La tâche génère automatiquement l'en-tête XML et l'ouverture/fermeture de l'Envelope.
  • Content-Type: La tâche utilise exclusivement text/xml; charset=utf-8 comme Content-Type par défaut et n'est pas modifiable.

Output Parameters​

La tâche expose les paramètres suivants une fois la réponse du serveur reçue :

  • result: Retourne un message textuel décrivant le résultat de l'opération.
  • response: Contient l'intégralité de l'XML de réponse envoyé par le serveur en cas de succès.
  • faultCode: Retourne le code d'erreur SOAP (ex. soap:Server ou soap:Client) si l'appel échoue.
  • faultString: Retourne la description textuelle de l'erreur fournie par le service web.
  • exitStatus: Code d'état de l'opération (0 indique succès).
  • resultJson: Représentation complète de l'exécution de la tâche au format JSON.

Example resultJson​

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Error Handling​

En cas d'erreur SOAP (présence d'un nœud <soap:Fault>), la tâche est marquée comme Failed. Les détails de l'erreur seront mappés dans les paramètres faultCode et faultString, facilitant le débogage ou la gestion de branches conditionnelles dans le workflow.