Notes de prise en charge SOAP/WSDL
Le tableau suivant résume les détails de la prise en charge WSDL dans MapForce.
Prise en charge WSDL | Version 1.1, note W3C disponible à l'adresse http://www.w3.org/TR/wsdl Version 2.0, recommandation du W3C disponible à l'adresse http://www.w3.org/TR/wsdl20/ |
Système de types WSDL | Schéma XML 2001 |
Prise en charge SOAP | Version 1.1 : http://www.w3.org/TR/2000/NOTE-SOAP-20000508/ Version 1.2 : http://www.w3.org/TR/soap12-part0/ |
Protocoles | SOAP sur HTTP (les protocoles HTTP POST et HTTP GET ne sont pas pris en charge). |
C# | La SOAPAction doit être différente pour chaque opération dans C#. |
Liaisons | Les opérations multiples portant le même nom ne sont actuellement pas prises en charge (section 2.5 de la spécification WSDL 1.1). |
Style/utilisation | •Document/littéral : pris en charge. •RPC/littéral : pris en charge dans C# •RPC/encodé : prise en charge limitée •Un style/une utilisation par service web (Java) ou par opération (C#) est actuellement pris en charge. |
En-têtes SOAP | Dépend de la plate-forme sous-jacente. |
SOAP encodingStyle | Si use="encoded", le style d'encodage "http://schemas.xmlsoap.org/soap/encoding/" est utilisé pour l'ensemble du soap:Body. Les autres styles d'encodage ne sont pas pris en charge.
L'attribut encodingStyle est ignoré dans les messages (section 4.1.1 de la spécification SOAP 1.1). |
Références | •Les références à des ressources externes ne sont actuellement pas prises en charge (section 5.4.1 de la spécification SOAP 1.1). •Les références à des éléments indépendants sont prises en charge. |
SOAP-ENC:Array | L'accès linéaire est pris en charge. Les arrays partiels et les arrays creux ne sont actuellement pas pris en charge. |
SOAP personnalisé Améliorations | Non pris en charge. |
Par défaut ou fixe valeurs dans les schémas | Non pris en charge. |
Validation des messages non SOAP | Non validé ; transmis au cadre sous-jacent. |
Espaces de noms | Les entrées sans espace de noms sont des WSDL non valides et ne sont donc pas prises en charge (WSDL et XML 1.0). |
WSDL 1,1
portType
Un élément <portType> définit une interface de service web, à savoir :
•les opérations pouvant être effectuées.
•les messages impliqués dans chaque opération en tant qu'entrées et sorties.
types
L'élément <types> définit les types de données utilisés par le service web. MapForce prend en charge les schémas XML dans les fichiers WSDL, car il s'agit du système de types le plus courant pour les fichiers WSDL. MapForce affiche ces éléments (types de données) sous forme d'éléments dans un composant (message), ce qui vous permet de les mapper directement à d'autres éléments/constructions.
message
L'élément <message> définit les parties de chaque message et les éléments de données des paramètres d'entrée et de sortie d'une opération. Il s'agit des messages échangés par le client et le serveur. Il existe trois types de messages : Entrée, Sortie et Erreur. Dans MapForce, chaque message est un composant à partir duquel ou vers lequel vous pouvez mapper d'autres éléments. Les messages peuvent être constitués d'une ou de plusieurs parties de message.
Lorsque vous utilisez la combinaison document/littéral dans MapForce, il est nécessaire que l'élément message/part fasse référence à un élément global plutôt qu'à un type. Par exemple, dans le code suivant, l'attribut element fait référence à un élément global défini dans un schéma (ns2:Vendor) :
<message name="processRequest"> |
Alors que le code suivant fait référence à un type dans le schéma :
<message name="processRequest"> |
opération
Les opérations utilisent des messages comme paramètres d'entrée et de sortie. Une opération peut avoir :
•un message d'entrée
•zéro ou plusieurs messages de sortie
•zéro ou plusieurs messages d'erreur
Les messages d'entrée ne peuvent être utilisés que comme composants source. Les messages de sortie et d'erreur ne peuvent être utilisés que comme composants cibles.
WSDL 2.0
WSDL 2.0 est très différent de WSDL 1.1, les principales différences étant les suivantes :
•Les types de port ont été renommés « interfaces ».
•Les messages et les parties sont désormais définis à l'aide du système de types XML Schema dans l'élément types.
•Les ports ont été renommés « points de terminaison ».
•Les entrées et sorties des opérations WSDL 2.0 sont définies par le schéma XML.
Dans MapForce, la boîte de dialogue Paramètres du composant d'un composant WSDL affiche « Point de terminaison » pour les ports WSDL 1.1 et les points de terminaison WSDL 2.0. |