Envoi de documents SOAP sur HTTP/S
Les documents SOAP diffèrent des autres types de documents
échangés sur HTTP/S. Ils utilisent le composant standard Adapter for
Web Services, qui appelle le gestionnaire de données SOAP dans le but
de convertir les messages SOAP en objets métier, et inversement.
Cette section explique comment échanger des documents SOAP entre
WebSphere Partner Gateway et WebSphere InterChange Server via le protocole de transfert
HTTP.
Pour plus d'informations sur la structure de l'objet métier et
sur WSDL Object Discovery Agent (ODA), un outil de conception qui
permet de créer des objets métier SOAP contenant des informations
sur les services Web cibles, voir la documentation du composant
Adapter for Web Services.
Comme l'explique le Guide de configuration du concentrateur, vous devez
configurer une cible pour recevoir les appels du service Web à partir
d'un système dorsal (la cible des services Web), ainsi qu'une
cible pour recevoir les appels du service Web depuis un participant
de communauté (cible externe des services Web).
Composants requis pour l'envoi et la réception de documents
Pour envoyer un document SOAP depuis WebSphere Partner
Gateway vers InterChange Server via le protocole HTTP, vous devez utiliser le
composant contenu dans le
tableau 50.
Tableau 50. Composants requis pour envoyer des documents SOAP à InterChange Server via HTTP
Composant |
Description |
Remarques et limitations |
WebSphere Business Integration Adapter
for Web Services |
Cet adaptateur permet à InterChange Server d'échanger des objets métier avec des applications qui envoient ou reçoivent des données sous la forme de messages HTTP. |
- Cet adaptateur ne peut pas être utilisé
avec des documents autres que SOAP.
- Assurez-vous que vous utilisez le composant Adapter for Web
Services version 3.4.0 (ou supérieure). Voir le document
Adapter for Web Services User Guide pour vous assurer que le niveau de l'adaptateur est
compatible avec la version de WebSphere InterChange Server que vous
utilisez.
|
Remarque : Si un document SOAP contient des pièces jointes, vous n'avez pas besoin d'utiliser le composant Attachment Data Handler pour les traiter.
Comment les participants de communauté
appellent les services Web
Les opérations suivantes ont lieu lorsqu'un participant de
communauté envoie une requête de collaboration qui est affichée en
tant que service Web fourni par le Gestionnaire de communauté :
- Le participant de communauté envoie un message de requête SOAP à la destination indiquée dans le document WSDL généré pour la collaboration.
Notez que le point d'extrémité spécifié dans le document WSDL
correspond à la cible des services Web (URL) de WebSphere Partner
Gateway, et non au point d'extrémité réel.
- WebSphere Partner Gateway reçoit et achemine le message vers le
composant Adapter for Web Services.
- Le composant Adapter for Web Services envoie le message SOAP au
gestionnaire de données SOAP dans le but de convertir le message SOAP
en objet métier. L'adaptateur appelle la collaboration affichée
en tant que service Web.
- S'il s'agit d'une opération de requête/réponse, la collaboration
renvoie un objet métier de réponse SOAP (ou d'échec).
- Si la collaboration renvoie un objet métier de réponse SOAP
(ou d'échec), le composant Adapter for Web Services appelle le
gestionnaire de données SOAP pour qu'il convertisse l'objet métier de réponse SOAP (ou d'échec) en message de réponse SOAP. L'adaptateur renvoie la réponse à WebSphere Partner Gateway. Si la
collaboration n'a pas renvoyé d'objet métier de réponse SOAP (ou
d'échec), le composant Adapter for Web Services renvoie le code
d'état de réponse HTTP approprié.
- WebSphere Partner Gateway achemine la réponse vers le service Web.
Comment le Gestionnaire de communauté
appelle les services Web
Le document WSDL public fourni par WebSphere Partner
Gateway peut être utilisé pour créer des objets métier à l'aide de
l'agent ODA WSDL. Il est important de remarquer que lorsque le service Web est fourni
par un participant de communauté utilisé par le Gestionnaire de
communauté, l'URL public utilisé par ce dernier pour appeler le
service Web doit contenir la chaîne de requête suivante :
?to=<Community participant Web Service Provider's business ID>
Par exemple, l'adresse suivante informe WebSphere Partner Gateway
que le fournisseur de ce service Web est le participant ayant l'ID
métier 123456789 :
http://<Hub_IP_address>/bcgreceiver/Receiver?to=123456789
Le composant WSDL ODA n'ajoutera pas la chaîne de requête à la
valeur par défaut de l'attribut de l'URL de l'objet métier de
niveau supérieur du service Web.
Voici ce qui se produit lorsqu'une collaboration envoie une
requête (au composant Adapter for Web Services) pour appeler le
service Web d'un participant de communauté :
- La collaboration envoie une requête d'appel à l'adaptateur, qui
appelle le gestionnaire de données SOAP pour qu'il convertisse
l'objet métier en message de requête SOAP.
- L'adaptateur appelle le service Web en envoyant le message SOAP à
la cible externe des services Web (URL) sur WebSphere Partner
Gateway.
- WebSphere Partner Gateway agit en tant que proxy en envoyant le
message SOAP vers le point d'extrémité correspondant au service Web
(participant de communauté) cible. Cette opération appelle le service Web.
- Le service Web appelé reçoit le message de requête SOAP et
effectue le traitement demandé.
- Le service Web appelé envoie un message de réponse SOAP (ou d'échec).
Dans le cas d'une opération à sens unique, un code d'état HTTP est renvoyé.
- S'il s'agit d'un service Web de requête/réponse, WebSphere
Partner Gateway achemine le message de réponse (ou d'échec) SOAP vers
l'adaptateur, qui à son tour appelle le gestionnaire de données pour
convertir ce message en objet métier de réponse ou d'échec. Le connecteur
renvoie l'objet métier de réponse ou d'échec SOAP à la collaboration.
