Pour que WebSphere Partner Gateway communique avec InterChange Server à l'aide du protocole de transfert JMS, ces composants doivent être configurés de sorte qu'ils puissent fonctionner sur JMS. Le tableau 51 donne un récapitulatif des étapes de configuration à suivre.
Composant | Version | Pour plus d'informations |
---|---|---|
WebSphere Partner Gateway | 6.0 |
Configuration pour l'envoi de documents à ICS via le protocole de transfert JMS Configuration pour la réception de documents depuis ICS via le protocole de transfert JMS |
WebSphere InterChange Server | 4.2.2, 4.3 | Création d'artifices ICS pour JMS |
Pour échanger un document entre WebSphere Partner Gateway et InterChange Server via le protocole JMS, vous devez également utiliser les composants répertoriés dans le tableau 52.
Composant | Description | Remarques et limitations |
---|---|---|
WebSphere Business Integration Adapter for JMS (Adaptateur pour JMS) |
Ce composant 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 JMS. L'Adaptateur pour JMS et WebSphere Partner Gateway communiquent par le biais des files d'attente JMS. |
Assurez-vous que vous utilisez l'Adaptateur pour JMS version 2.7.0 (ou supérieure), qui assure la prise en charge des propriétés d'en-tête personnalisé. Voir la documentation relative à l'adaptateur pour vérifier que sa version est compatible avec la version d'InterChange Server que vous utilisez. |
Un gestionnaire de données utiles | Ce gestionnaire de données convertit les données utiles à partir du format du document en représentation d'objet métier. | Pour plus d'informations, voir Spécification du gestionnaire de données utiles. |
Gestionnaire de données en pièce jointe |
Ce gestionnaire de données convertit les documents contenant des pièces jointes en objets métier. |
Ce gestionnaire de données est nécessaire uniquement si votre document contient des pièces jointes. Pour plus d'informations, voir Gestion des documents contenant des pièces jointes. |
Les sections suivantes décrivent la façon dont les composants répertoriés dans le tableau 52 fonctionnent conjointement pour permettre l'échange de documents entre WebSphere Partner Gateway et InterChange Server via le protocole JMS.
Pour que WebSphere Partner Gateway envoie un document à InterChange Server par le biais du protocole JMS, vous devez utiliser l'Adaptateur pour JMS afin de récupérer le message que WebSphere Partner Gateway a placé dans la file d'attente JMS. L'adaptateur achemine alors le message vers InterChange Server. La figure 22 illustre comment WebSphere Partner Gateway envoie des documents à InterChange Server via le protocole JMS.
Les étapes suivantes expliquent comment WebSphere Partner Gateway participe à la notification d'événements en envoyant un document à une collaboration dans InterChange Server sur le protocole de transfert JMS :
Si le type de regroupement du document est l'intégration dorsale, WebSphere Partner Gateway a intégré des propriétés personnalisées dans ce message. L'en-tête de message JMS, JMSType, est défini avec le type de contenu des données utiles.
La file d'attente JMS que WebSphere Partner Gateway utilise comme file d'attente de sortie est identique à celle utilisée par l'Adaptateur pour JMS comme file d'attente d'entrée. Pour plus d'informations sur la manière de configurer cette file d'attente, voir Configuration des files d'attente JMS. Pour plus d'informations sur le traitement de l'Adaptateur pour JMS, voir le document Guide utilisateur de l'Adaptateur pour JMS.
Lorsque le type de regroupement est l'intégration dorsale et que le document contient des pièces jointes, le gestionnaire de données configuré est responsable de la gestion des données utiles et des pièces jointes.
Pour que WebSphere Partner Gateway puisse recevoir un document issu d'InterChange Server par le biais du protocole JMS, vous devez utiliser l'Adaptateur pour JMS qui place le message reçu d'InterChange Server dans une file d'attente JMS destinée à WebSphere Partner Gateway. La figure 23 illustre comment WebSphere Partner Gateway reçoit des documents d'InterChange Server via le protocole JMS.
Les étapes suivantes expliquent comment WebSphere Partner Gateway participe au traitement des requêtes en recevant un document depuis une collaboration dans InterChange Server via le protocole de transfert JMS :
L'objet métier de requête contient des informations spécifiques à l'application qui désignent un métaobjet dynamique comprenant des informations d'en-tête de transfert JMS attendues par WebSphere Partner Gateway.
L'adaptateur lit les propriétés DataHandlerMimeType et DataHandlerConfigMO afin de déterminer quel gestionnaire de données utiliser. Pour plus d'informations, voir Spécification du gestionnaire de données utiles.
L'adaptateur recherche les informations spécifiques à l'application relatives à l'objet métier de requête correspondant au code cw_mo_conn, qui identifient l'attribut contenant le métaobjet dynamique. Si vous utilisez le regroupement d'intégration dorsale pour votre document, vous pouvez indiquer les informations d'en-tête de transfert dans ce métaobjet dynamique.
Si cet attribut a une valeur, l'adaptateur définit les zones d'en-tête de transfert dans le document de requête. Dans l'attribut JMSProperties, vous pouvez également indiquer l'en-tête JMS standard du type de contenu. Pour plus d'informations, voir Création des informations d'en-tête JMS.
La file d'attente peut être indiquée dans le métaobjet statique ou le métaobjet dynamique. Pour plus d'informations sur la spécification des files d'attente, voir Identification des files d'attente JMS. WebSphere Partner Gateway écoute sur cette file d'attente JMS configurée comme une file d'attente d'entrée dans sa définition de cible.