Composants requis pour les documents envoyés sur JMS

Pour que Business Integration Connect communique avec InterChange Server à l'aide du protocole de transfert JMS, ces deux composants doivent être configurés de sorte qu'ils puissent fonctionner sur JMS. Le Tableau 70 donne un récapitulatif des étapes de configuration à suivre.

Tableau 70. Configuration de Business Integration Connect et InterChange Server pour un fonctionnement sur protocole de transfert JMS
Composant Version Pour plus d'informations
WebSphere Business Integration Connect 4.2.2

Configuration de documents sortants sur le protocole de transfert JMS

Configuration de documents entrants sur le protocole de transfert JMS

WebSphere InterChange Server 4.1.1, 4.2.0, 4.2.1, 4.2.2 Création d'artifices ICS pour JMS

De plus, pour envoyer ou recevoir un document entre Business Integration Connect et InterChange Server à l'aide du protocole de transfert JMS, vous devez également utiliser les composants compatibles avec ICS répertoriés dans le Tableau 71..

Tableau 71. Composants requis pour transférer des documents depuis et vers InterChange Server via JMS
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 Business Integration Connect communiquent par le biais des files d'attente JMS.

  1. Assurez-vous que vous utilisez l'Adaptateur pour JMS version 2.3.1 (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.
  2. L'Adaptateur pour JMS prend en charge uniquement les messages texte JMS. Si vous envisagez d'utiliser des messages JMS Byte, utilisez l'Adaptateur pour JMS version 2.5.0.

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 expliquent comment les composants dans le Tableau 71 interagissent pour envoyer et recevoir des documents entre Business Integration Connect et InterChange Server sur le protocole JMS.

Envoi de documents sur JMS

Pour qu'Business Integration Connect 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 Business Integration Connect a placé dans la file d'attente JMS. L'Adaptateur transfert alors le message à InterChange Server. La Figure 20 illustre comment Business Integration Connect envoie des documents à InterChange Server sur le protocole JMS.

Figure 20. Flux de messages entre Business Integration Connect et une collaboration via JMS


Les étapes suivantes expliquent comment Business Integration Connect participe à la notification d'événements en envoyant un document à une collaboration dans InterChange Server sur le protocole de transfert JMS :

  1. Business Integration Connect transmet un message à la file d'attente en sortie JMS.

    Si le type de regroupement du document était l'intégration dorsale, Business Integration Connect 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.

    Remarque :
    Dans Business Integration Connect, vous devez configurer une passerelle qui identifie la file d'attente JMS vers laquelle Business Integration Connect envoie le message et dans laquelle l'Adaptateur pour JMS effectue des interrogations. Pour plus d'informations, voir Configuration de documents sortants sur le protocole de transfert JMS.
  2. Lorsque l'Adaptateur pour JMS repère un message dans l'une de ses files d'attente d'entrée, il récupère ce message.

    La file d'entrée JMS que Business Integration Connect 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.

  3. L'Adaptateur pour JMS déplace le message vers sa file d'attente des messages en cours.
  4. L'Adaptateur pour JMS extrait le corps du message JMS et appelle le gestionnaire de données avec le corps du message. Ce gestionnaire de données convertit le corps du message JMS en objet métier.
    Remarque :
    Si vos messages contiennent des pièces jointes, vous pouvez installer le gestionnaire de données en pièce jointe puis configurer l'Adaptateur pour JMS pour qu'il l'appelle afin de convertir le corps du message JMS en objet métier. Pour plus d'informations, voir Gestion des documents contenant des pièces jointes.

    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.

  5. Le gestionnaire de données renvoie l'objet métier à l'Adaptateur pour JMS.
    Remarque :
    Si le gestionnaire de données en pièce jointe a été utilisé, cet objet métier contient les données utiles ainsi que les pièces jointes.
  6. Si l'Adaptateur pour JMS récupère un métaobjet enfant dynamique (spécifié à l'aide de l'attribut cw_mo_conn contenu dans les informations spécifiques à l'application au niveau de l'objet métier), l'adaptateur remplit les en-têtes JMS définis par l'utilisateur qui sont présents dans l'objet métier avec les en-têtes présents dans le message JMS.
  7. L'Adaptateur pour JMS transmet l'objet métier à InterChange Server en même temps que l'inscription.

Réception de documents sur JMS

Pour qu'Business Integration Connect 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 envoyé par InterChange Server dans une file d'attente JMS destinée à Business Integration Connect. La Figure 21 illustre comment Business Integration Connect reçoit des documents depuis InterChange Server sur le protocole JMS.

Figure 21. Flux de messages à partir d'une collaboration vers Business Integration Connect via le protocole JMS


Les étapes suivantes décrivent comment Business Integration Connect participe au traitement des requêtes en recevant un document depuis une collaboration dans InterChange Server via le protocole de transfert JMS :

  1. La collaboration dans InterChange Server appelle l'Adaptateur pour JMS, en lui envoyant l'objet métier de requête.

    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 Business Integration Connect.

  2. L'Adaptateur pour JMS utilise un gestionnaire de données pour convertir l'objet métier que la collaboration a envoyé dans un message JMS.

    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.

    Remarque :
    Si vos documents contiennent des pièces jointes, installez le gestionnaire de données en pièce jointe, puis configurer l'Adaptateur pour JMS en vue de convertir l'objet métier de requête en document contenant des pièces jointes. Pour plus d'informations, voir Gestion des documents contenant des pièces jointes.
  3. Le gestionnaire de données convertit l'objet métier en chaîne et la renvoie à l'Adaptateur pour JMS.
  4. L'Adaptateur pour JMS détermine, à partir de l'objet métier de requête, le nom du métaobjet dynamique des propriétés personnalisées JMS.

    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.

  5. L'Adapter pour JMS recherche le métaobjet dynamique correspondant à l'attribut JMSProperties.

    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.

  6. L'Adaptateur pour JMS crée un message JMS à l'aide de la chaîne renvoyée par le gestionnaire de données. Il définit également les propriétés personnalisées, telles qu'elles sont définies dans le métaobjet dynamique.
    Remarque :
    Les versions de l'Adaptateur pour JMS antérieures à 2.4.1 peuvent uniquement écrire des messages texte JMS.
  7. L'adaptateur pour JMS envoie le message de requête résultant à une file d'attente de sortie.

    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. Business Integration Connect écoute sur cette file d'attente JMS configurée comme une file d'attente d'entrée dans sa définition de cible. Pour plus d'informations, voir Configuration de documents entrants sur le protocole de transfert JMS.

  8. Business Integration Connect reçoit le message à partir de sa file d'attente d'entrée JMS, configurée dans sa cible.

Remarque :
Business Integration Connect prend uniquement en charge l'interaction asynchrone avec InterChange Server sur JMS. Par conséquent, il se peut que vous ne souhaitiez pas attendre la réponse. La réponse du participant de communauté ou de Business Integration Connect peut arriver sur une autre file d'attente. Vous pouvez configurer l'Adaptateur pour JMS pour interroger cette file d'attente. La réponse qui parvient sur la file d'attente peut être transmise à InterChange Server dans le cadre du processus de distribution des événements.

Copyright IBM Corp. 1997, 2004