Services web SOAP
Avec MapForce Enterprise Edition, vous pouvez générer du code Java ou C# permettant de mettre en œuvre des services web SOAP, à partir de fichiers WSDL (Web Services Description Language) existants. MapForce prend en charge WSDL 1.1 et WSDL 2.0 (pour plus d'informations concernant la prise en charge et les restrictions, voir Notes de prise en charge SOAP/WSDL et Spécifications Services Web SOAP Java ).
MapForce vous permet d'appeler votre service web SOAP et d'exporter les données de réponse vers n'importe quel format pris en charge par MapForce. Si le fichier WDSL met en place plusieurs services, points terminaux et opérations vous pouvez les sélectionner ou les mettre à jour directement dans MapForce.
Autre solution pour créer des services web SOAP
Au lieu de développer des services web SOAP à partir de fichiers WSDL existants, vous pouvez également déployer des mappages MapForce sur MapForce Server, où vous pourrez les exécuter via une API ou un appel en ligne de commande. De plus, avec FlowForce Server, vous pouvez aussi exposer le mappage en tant que service web générique (pas SOAP) sur l'appareil sur lequel FlowForce Server est exécuté. Tout mappage conçu pour le langage de transformation Built-In se qualifie pour un déploiement vers MapForce Server ou FlowForce Server. FlowForce Server est une solution serveur dédiée capable non seulement de convertir les mappages MapForce en services web génériques, mais aussi de les exécuter sous forme de tâches planifiées ou à la demande. Pour plus d'informations, voir Déployer des mappages vers FlowForce Server.
Prérequis
Pour créer un service web avec MapForce, vous aurez besoin d’un fichier WSDL qui définit la structure du service web. Vous pouvez concevoir des fichiers WSDL et tester des requêtes SOAP avec Altova XMLSpy, par exemple. De plus, vous devez disposer d’un logiciel spécifique à la plateforme, requis pour créer, déployer, et exécuter un service web SOAP (voir ci-dessous).
Pour Java, les technologies suivantes sont suivies :
•Java SE JDK 8, 11, 17, 21, 25 (y compris OpenJDK)
•Apache Tomcat (serveur web qui hébergera le service)
•Apache Axis2 (framework de services web qui facilite la création, le déploiement et l'utilisation des services web ; intégré à Tomcat)
•Apache Ant (outil command-line qui sera utilisé pour créer le code)
Pour C#), les technologies suivantes sont suivies :
•Microsoft Visual Studio 2013, 2015, 2017, 2019, 2022, 2026
•Microsoft Internet Information Services (IIS) version 5.0 ou plus.
configuration de service web SOAP
Le diagramme ci-dessous illustre l’ensemble du processus de configuration du service web SOAP. Veuillez noter que seules les deux premières étapes se produisent dans MapForce. Les étapes 3 à 5 dépendent des particularités des outils tiers et des environnements utilisés par votre organisation.
Les étapes de configuration du service web SOAP sont décrites ci-dessous.
Étape 1 : Concevoir un service web depuis un fichier WSDL
Une fois que vous disposez du fichier WSDL, vous pouvez créer un nouveau projet de service web MapForce. Un projet de service web MapForce présente une structure prédéfinie qui vous permet d’accéder rapidement à une opération WSDL ou à un service web particulier qu’il contient. Lorsque vous démarrez un projet de service web MapForce, vous pouvez, si vous le souhaitez, demander à MapForce de générer automatiquement des fichiers de mappage pour toutes les opérations WSDL présentes dans le fichier WSDL. Vous pouvez également sélectionner individuellement les services WSDL et les points de terminaison WSDL à inclure dans le projet de service web MapForce. Dans l'interface utilisateur graphique de MapForce, les opérations WSDL correspondent aux mappages et les paramètres d'entrée et de sortie de l'opération apparaissent en tant que composants dans le mappage.
Tout en travaillant avec des mappages qui comprennent l'entrée ou la sortie des opérations WSDL, vous pouvez prévisualiser les résultats d'exécution comme vous le feriez pour tout autre mappage. Pour ce faire, il vous faut un fichier de requête SOAP d'échantillon (format XML) qui est conforme à la grammaire WSDL du service web (ce type de fichiers d'instance peut être généré avec XMLSpy).
Étape 2 : Générer code Java ou C#
La prochaine étape est de générer le code C# ou Java pour des mappages individuels (à des fins de test) ou pour le projet entier.
Étape 3 : Créer code
Dans cette étape, vous construisez le code C# ou Java généré (en dehors de MapForce).
Étape 4 : Déployez le service web sur un serveur
Une fois le code généré, vous devrez déployer le service sur votre serveur web personnalisé. Le service web compilé peut être hébergé par le serveur de votre choix, par exemple :
•Apache Tomcat
•Internet Information Services (IIS)
Étape 5 : Appeler le service web
La dernière étape est d’appeler le service web, qui implique d’envoyer une requête au serveur web qui traite la requête, réalise l’action correspondante, et envoie une réponse au client. Le client du service web peut être toute application qui peut générer les appels SOAP et traiter les réponses (par ex., XMLSpy et MapForce).
Pour plus d’information sur la création du service web SOAP, qui couvre l’Étape 1 décrite ci-dessus, voir Créer un Projet de service Web SOAP. Pour voir comment sont implémentées les Étapes 2 à 5, voir Générer le service Web SOAP (Java).