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.

Remarque : Pour échanger des documents autres que SOAP entre WebSphere Partner Gateway et WebSphere InterChange Server via le protocole de transfert HTTP, voir Utilisation du protocole de transfert HTTP avec ICS.

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.

  1. Cet adaptateur ne peut pas être utilisé avec des documents autres que SOAP.
  2. 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é :

  1. 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.
  2. WebSphere Partner Gateway reçoit et achemine le message vers le composant Adapter for Web Services.
  3. 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.
  4. 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).
  5. 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é.
  6. 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é :

  1. 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.
  2. L'adaptateur appelle le service Web en envoyant le message SOAP à la cible externe des services Web (URL) sur WebSphere Partner Gateway.
  3. 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.
  4. Le service Web appelé reçoit le message de requête SOAP et effectue le traitement demandé.
  5. 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é.
  6. 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.

Copyright IBM Corp. 2003, 2005