SOAP Web Services
L'édition MapForce Enterprise vous permet de générer un code de programme Java ou C# qui met en place des services web SOAP, depuis des fichiers Web Services Description Language (WSDL) existants. Vous pouvez mapper des données vers des opérations WSDL comme suit :
•À partir de l'entrée de l'opération WSDL vers toute source de données prise en charge par MapForce, y compris les fichiers plats, XML, XBRL, EDI, Microsoft Excel, et les bases de données.
•À partir des sources de données prises en charge par MapForce vers la sortie de l'opération WSDL.
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 ).
| Note : | à la place de développer des services Web SOAP depuis des fichiers WSDL existants, vous pouvez aussi déployer des mappages MapForce vers MapForce Server, où vous pourrez les exécuter par un API ou un appel de 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 de serveur dédiée qui est capable non seulement de convertir des mappages MapForce dans des services Web génériques, mais aussi de les exécuter en tant que des tâches programmées ou sur demande. Pour plus d'informations, voir Déployer des mappages vers FlowForce Server. |
Prérequis
Pour créer un service Web avec MapForce, le fichier WSDL du service Web est requis. Veuillez noter que vous pouvez concevoir des fichiers WSDL et tester des requêtes SOAP avec XMLSpy, par exemple. De plus, vous devrez utiliser un logiciel spécifique à la plateforme nécessaire pour créer, déployer et exécuter un service Web SOAP, par exemple :
Java
•Java SE JDK 8 ou 11 (y compris OpenJDK)
•Apache Tomcat: https://tomcat.apache.org/
•Apache Axis2: https://axis.apache.org/axis2/java/core/, un framework SOAP en exécution dans le cadre de Tomcat
•Apache Ant: https://ant.apache.org/
C#
•Microsoft Visual Studio 2013, 2015, 2017, 2019, 2022
•Microsoft Internet Information Services (IIS) version 5.0 ou plus.
Comment cela fonctionne ?
Le diagramme suivant illustre tout le processus, en commençant depuis la mise en place d'un service Web depuis un fichier WSDL existant jusqu'à l'étape permettant de l'appeler par des applications de client SOAP. Veuillez noter que seules les deux premières étapes se produisent dans MapForce. Les étapes 3 et 4 dépendent des particularités des outils tiers et des environnements utilisés par votre organisation.
Le processus illustré ci-dessus fonctionne comme suit :
Étape # | Description |
1. Concevoir le Service Web depuis un fichier WSDL existant | Une fois que vous avez le fichier WSDL, vous pouvez lancer un nouveau Projet de Service Web MapForce. Un Projet de Service Web MapForce contient une structure prédéfinie qui vous permet d'accéder rapidement à une opération WSDL particulière ou le service Web s'y trouvant. Lorsque vous lancez un projet MapForce Web Service, vous pouvez demander à MapForce de générer des fichiers de mappage automatiquement pour toutes les opérations WSDL trouvées dans le fichier WSDL. En alternative, vous pouvez sélectionner individuellement les Services WSDL et les Endpoints WSDL à inclure dans le Projet de Service Web MapForce. Dans l'interface d'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). |
2. Générer code Java ou C# | Lorsque votre Projet de Service Web est prêt dans MapForce, vous pouvez générer le code C# ou Java soit pour des mappages individuels (à des fins de test), soit pour le projet entier. Dans le deuxième cas, MapForce crée un serveur de service Web complet dans le langage de votre choix (C# ou Java). |
3. Créer et déployer le service Web vers un serveur | Dans cette étape, vous compilez le code C# ou Java généré (excepté MapForce) et vous le déployez sur votre serveur Web personnalisé. Votre serveur Web doit être en mesure d'héberger des services SOAP et de répondre aux appels client SOAP, voir la section "Exigences préalable" ci-dessus. |
4. Hébergement du service Web | Le service Web compilé peut être hébergé par le serveur de votre choix, par exemple : •Apache Tomcat •Internet Information Services (IIS) |
5. Appeler le service Web | Les clients du service Web incluent toutes les applications capables de générer des appels SOAP et de traiter la réponse, y compris XMLSpy ou MapForce lui-même. |
Pour plus d'informations concernant étape 1, voir Créer des projets de Service Web SOAP. Pour toutes les autres étapes, voir Exemple : Générer des Services Web SOAP (C#) et Exemple : Générer des Services Web SOAP (Java)