Services Web
MapForce prend en charge des services Web basés sur WSDL et non WSDL. Les services Web Non-WSDL incluent une large catégorie de HTTP API génériques qui sont souvent référrés comme REST ou RESTful API. MapForce prend également en charge l'API Shopify et les API GraphQL génériques.
Services web basés sur WSDL
Un service web basé sur WSDL utilise un fichier WSDL (Web Services Description Language) pour décrire les opérations du service, les messages d’entrée et de sortie, et les détails de réseau. Les fichiers WSDL sont basés sur XML et utilisent généralement le protocole SOAP qui définissent comment les messages sont échangés entre un client et un service.
MapForce vous permet également de concevoir un projet de service web SOAP et de générer du code Java ou C# qui implémente le service web SOAP. De plus, vous pouvez appeler le service web SOAP et 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.
Protocoles des services basés sur WSDL
Pour les services web basés sur WSDL, vous pouvez utiliser les protocoles suivants :
•SOAP 1.1, 1.2 sur HTTP : Les styles RPC/Encoded et Document/Literal sont pris en charge. Si le serveur web retourne une erreur WSDL, l'exécution de mappage cesse. Pour ces cas particuliers, vous pouvez insérer en option un composant d’exception dans la zone de mappage pour gérer l'erreur. Si le serveur web retourne une erreur non-WSDL, l'exécution de mappage cesse et un message d'erreur est retourné (ou affiché sur l'écran si vous prévisualisez le mappage dans MapForce).
•Non-SOAP sur HTTP : Cela fait référence aux services un peu moins connus HTTP non-SOAP. avec HTTP GET, le style url-encoded est pris en charge. avec HTTP POST, les styles url-encoded et text/xml sont pris en charge.
HTTP API
Les HTTP API ont généralement des structures de requête ou de réponse dans la partie du corps message. MapForce prend en charge les types suivants de corps de requête et de réponse : JSON, XML, les Protocol Buffers et corps non structurés avec les types MIME personnalisés.
Pour les API HTTP, vous pouvez saisir les détails de service web manuellement ou automatiquement. Les détails de service web incluent une URL, une méthode de requête (par ex., GET, POST, PUT), des structures de requête ou de réponse (par ex., XML, JSON, types MIME personnalisés), et des paramètres.
XML et JSON
Vous pouvez utiliser les schémas JSON, XML ou DTD pour vos structures de requête/réponse. MapForce peut aussi accepter un fichier XML avec une référence de schéma valide. De plus, vous pouvez aussi importer la définition de service web depuis un fichier WADL et faire des ajustements nécessaires manuellement. Veuillez noter, néanmoins que WADL ne fournit aucune méthode standard pour définir des structures JSON, il ne fournit que des structures XML.
Si vous disposez d’un échantillon de fichier d’instance XML ou JSON sans fichier de schéma, vous pouvez créer le schéma à l’aide de XMLSpy (https://www.altova.com/fr/xmlspy.html). Le cas échéant, XMLSpy peut convertir votre fichier d'instance de XML à JSON, ou vice-versa.
Protocol Buffers
Si vous souhaitez travailler avec les requêtes et réponses Protocol Buffers, il vous faut un fichier .proto qui décrit le fichier binaire Protocol Buffers. Dans ce scénario, le corps du service web peut être mappé de ou vers un composant Protocol Buffers. Pour plus d'informations, voir Exemple : Lire des données depuis Protocol Buffers et Exemple : Écrire les données dans les Protocol Buffers.
Les corps non structurés avec des types MIME personnalisés
Vous pouvez aussi appeler des services web si la structure de requête ou de réponse est flexible et n'est pas liée à un schéma particulier. Dans de tels cas, vous pouvez utiliser les fonctions mime intégrées à MapForce pour créer un corps de message brut envoyé à un service web (l'entité MIME) ou pour traiter l'entité MIME renvoyée par le service web.
API Shopify et API GraphQL génériques
MapForce vous permet d'appeler l'API Shopify ou une API GraphQL générique.
GraphQL est un langage de requête pour les API. Shopify est une plateforme de commerce électronique qui permet aux entreprises de créer et de gérer des boutiques en ligne, de vendre des produits, de gérer les commandes, les clients, les paiements et les expéditions. Les développeurs peuvent accéder aux données de la boutique et les manipuler de manière programmée via l'API Shopify, et automatiser divers processus. L'API Shopify prend en charge GraphQL pour interagir avec les données de la boutique.
Pour plus d'informations, veuillez consulter la rubrique API Shopify et API GraphQL. Pour en savoir plus sur la création de requêtes et de mutations GraphQL, veuillez consulter la section Exemples.
Exemples
Pour les exemples de mappages avec les appels de service web, voir les chapitres suivants :
•Exemple : Appeler un HTTP API
•Exemple : Mapper des données depuis un RSS Feed
•Exemple : Appeler un service Web SOAP
•Exemple : Autorisation OAuth 2.0