Services Web
Dans MapForce, vous pouvez insérer un appel de service Web dans un mappage comme à une fonction, y connecter les composants d'entrée et de sortie et consommer le résultat comme requis (par exemple, le prévisualiser dans la fenêtre de sortie MapForce, la passer vers un autre composant, ou l'écrire sur un fichier).
Un appel de service Web créé avec MapForce peut être exécuté par MapForce lui-même, soit sur une machine différente ou même sur une plateforme, par MapForce Server. MapForce Server peut exécuter les mappages par l’interface commande-line, durant l’appel API ou en tant que tâche FlowForce Server. Pour les détails, voir Automatisation avec MapForce Server.
MapForce vous permet également de concevoir des projets du service Web SOAP et de générer Java ou le code C# code qui implémente les services Web SOAP. Pour plus d'informations, voir Projets du service Web SOAP.
Prise en charge de services Web
MapForce prend en charge l’appel des services Web WSDL-based et REST (voir les détails ci-dessous).
•Pour les services Web basés sur WSDL, vous devez fournir un fichier WSDL du service Web. MapForce utilise le fichier WSDL pour communiquer avec le serveur Web. 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.
•Pour les services Web REST, vous devez saisir les détails de service Web (i) manuellement ou (i) automatiquement (en important un fichier WADL ou une URL). 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.
Services Web REST vs. WSDL-based
La table ci-dessous résume les détails prise en charge de services Web REST et WSDL-based dans MapForce.
Fonction | REST | basé sur WSDL |
|---|---|---|
Langage de mappage | Built-In | Built-In, C#, Java |
Automatisation avec MapForce Server | Oui | Oui, si le langage est Built-In |
Protocoles | HTTP (GET, POST, PUT, DELETE, verbes personnalisés) | •SOAP 1.1, 1.2 sur HTTP •Services Non-SOAP sur HTTP |
Requête/structures de réponse | •XML •json •Protocol Buffers •Types MIME personnalisés | Message SOAP |
Sécurité | •HTTP/HTTPS •Certificats de serveur •Certificats de client •Authentification HTTP •Authentication préemptive •Autorisation OAuth | •HTTP/HTTPS •Certificats de serveur •Certificats de client* •Authentification HTTP •Authentication préemptive* •Sécurité WS* •Autorisation OAuth*
* Pris en charge uniquement dans Built-In. |
Importer définition de service | Depuis le fichier WADL (en option) | Depuis le fichier WSDL (requis) |
Importer des paramètres depuis URL | Oui | Pas applicable |
Service Web dynamique URL | Vous pouvez fournir l'URL complète du service Web en tant que a paramètre du mappage ou le définir à l’intérieur du mappage. Vous pouvez aussi fournir des parties d'URL spécifiques en tant que paramètres du mappage alors que l'URL de base est définie dans le mappage. | Vous pouvez fournir l'URL du service Web en tant que paramètre du mappage ou vous pouvez les fixer (enregistrer avec le mappage). |
Timeout (l'intervalle après lequel l'appel s'arrêtera si le serveur web ne répond pas) | Oui | Oui |
Authentification dynamique (les détails d’authentification fournis par le mappage ou comme paramètre au mappage. Pour les détails, voir Authentification dynamique.) | Oui | Oui |
Services Web basés sur WSDL
Lorsque vous sélectionnez une services Web WSDL-based, 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.