WSDL et services SOAP en logigramme

Ce qu’est un fichier WSDL

WSDL (Web Services Description Language) est un format XML qui décrit des services web, le plus souvent des services SOAP. WSDL 1.1, la version la plus répandue dans les systèmes existants, organise la description en :

• types : les structures de données, en général en XML Schema,
• messages : les données échangées,
• portType : l’ensemble des opérations proposées par le service,
• binding : la façon dont les opérations sont transportées (par exemple SOAP sur HTTP),
• service : l’adresse réseau du point d’accès.

WSDL 2.0 renomme certains de ces concepts (interface au lieu de portType, endpoint au lieu de port) mais garde le même principe.

Trouver les opérations

Les opérations sont la partie utile pour un logigramme : des noms comme CreerContrat, ObtenirDevis ou AnnulerCommande. En WSDL 1.1, cherchez les éléments operation à l’intérieur de portType. Leur nom décrit en général une action métier, ce qui en fait de bons libellés pour des étapes automatiques.

Des opérations au processus

Les opérations forment un catalogue, pas une séquence. L’ordre (« obtenir un devis, puis créer le contrat si le client accepte ») vient du processus métier. Comme pour les fichiers OpenAPI, le meilleur résultat vient de la combinaison :

1. d’une courte description du processus, qui nomme le responsable de chaque étape,
2. du WSDL, pour que les étapes automatiques portent le nom exact de l’opération.

Importer un WSDL dans Flowchartio

Enregistrez le WSDL avec l’extension .xml (l’import accepte .json, .yaml, .yml et .xml, jusqu’à 5 Mo). Flowchartio lit les opérations et les utilise comme endpoints pendant la génération : une étape comme « Créer le contrat » peut ainsi porter CreerContrat.

Ce qu’il faut documenter pour une intégration SOAP

• Les fautes SOAP renvoyées par chaque opération et la réaction de votre système.
• Les délais et les relances, avec leurs limites, comme pour tout workflow d’intégration d’API.
• Les étapes de sécurité, comme la signature ou les en-têtes d’authentification, quand elles influencent le flux.
• Les relais vers des personnes, par exemple une revue manuelle quand le service rejette une demande.

Logigramme ou BPMN ?

Les organisations qui utilisent des services SOAP disposent souvent aussi de modèles BPMN. Si l’objectif est d’expliquer l’intégration à des personnes, un logigramme suffit ; s’il doit être exécuté par un moteur de processus, voir logigramme ou BPMN.

Importez votre WSDL et générez le logigramme.