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 Business Integration
Connect et WebSphere InterChange Server via le protocole de transfert
HTTP.
Remarques:
- Pour échanger des documents SOAP entre WebSphere Business Integration
Connect et une version de WebSphere InterChange Server antérieure à la version
4.2.2 via le protocole de transfert HTTP, voir Utilisation du protocole de transfert HTTP avec une version antérieure à ICS 4.2.2.
- Pour échanger des documents SOAP entre WebSphere Business Integration
Connect et WebSphere InterChange Server version 4.2.2 via le
protocole de transfert HTTP, voir Utilisation du protocole de transfert HTTP avec ICS version 4.2.2.
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 l'administrateur, 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 des services Web).
Pour envoyer un document SOAP depuis Business Integration Connect vers
InterChange Server via le protocole HTTP, vous devez utiliser les composants
contenus dans le Tableau 69. Tous ces composants sont fournis par Business
Integration Connect.
Tableau 69. 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.1.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.
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 Business
Integration Connect, et non au point d'extrémité réel.
- Business Integration Connect 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 à Business Integration Connect. 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é.
- Business Integration Connect achemine la réponse vers le service
Web.
Le document WSDL public fourni par Business Integration Connect 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 Business Integration Connect
que le fournisseur de ce service Web est le participant ayant l'ID métier
123456789 :
http://WBIChost/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 Business Integration Connect.
- Business Integration Connect 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, Business
Integration Connect 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 SOAP ou d'échec à la
collaboration.
