Scénario utilisateur
Un scénario courant est le flux d'une requête à partir d'une mappe, via des adaptateurs SOAP et HTTP vers le service Web, et le flux de la réponse vers la mappe à partir du service Web.
L'adaptateur est conçu pour être appelé dans un appel de fonction de mappe GET. Le troisième paramètre de GET est le message de requête. Par exemple :
Response = GET("SOAP", "-HDR -TRANSPORT 'HTTP(-URL http://
www.stuff.com -T)'", PACKAGE(Request))
Séquence d'actions de l'adaptateur
Les éléments suivants décrivent la séquence d'actions qui se produisent dans le scénario utilisateur.
- Le message de requête est d'abord transmis à Adaptateur SOAP.
- Il se peut que le message de requête possède ou non une enveloppe SOAP. Si l'enveloppe n'est pas fournie, l'adaptateur l'ajoute.
- Il se peut que le message de requête possède ou non un en-tête d'enveloppe SOAP. L'adaptateur ne fait rien avec l'en-tête. S'il n'est pas fourni dans la requête, aucun en-tête n'est envoyé.
- L'adaptateur spécifié dans la commande -TRANSPORT est appelé pour émettre la requête et recevoir une réponse. En général, il s'agit de l'adaptateur HTTP qui enverra ensuite une requête HTTP et renverra la réponse HTTP.
- Adaptateur SOAP est appelé une seconde fois pour traiter la réponse.
- L'adaptateur consulte le corps pour voir s'il existe une balise Fault. Si c'est le cas, Adaptateur SOAP renvoie un message d'erreur composé de faultstring et faultcode.
- L'enveloppe SOAP est supprimée, sauf si la commande -RAW est spécifiée.
- Si l'adaptateur est appelé à l'aide de la commande -HDR et qu'il existe un en-tête d'enveloppe SOAP, les données d'en-tête sont renvoyées.
- Si l'adaptateur est appelé à l'aide de la commande -RETURN, toutes les balises XML sont supprimées et seule la donnée spécifiée du message de réponse est renvoyée. Si le message de réponse renvoie plusieurs données, le message de réponse XML entier est renvoyé avec un code d'avertissement. Cette commande est mutuellement exclusive avec la commande -HDR.