Composants requis pour les documents envoyés sur JMS

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.

Tableau 51. Configuration de WebSphere Partner Gateway et InterChange Server pour un fonctionnement via le protocole de transfert JMS
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.

Tableau 52. 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 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.

Envoi de documents via le transfert 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.

Figure 22. Flux de messages entre WebSphere Partner Gateway et une collaboration via JMS
Cette figure montre comment un document est envoyé à WebSphere Partner Gateway, comment WebSphere Partner Gateway envoie le message JMS à la file d'attente d'entrée d'Adapter for JMS, comment Adapter for JMS appelle le gestionnaire de données utiles et envoie l'objet métier résultant à une collaboration.

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 :

  1. WebSphere Partner Gateway place un message dans sa file d'attente de sortie 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.

    Remarque : Dans WebSphere Partner Gateway, vous devez configurer une passerelle qui identifie la file d'attente JMS à laquelle WebSphere Partner Gateway envoie le message et dans laquelle l'Adaptateur pour JMS effectue des interrogations.
  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'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.

  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 via le transfert JMS

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.

Figure 23. Flux de messages entre une collaboration et WebSphere Partner Gateway via JMS
Cette figure montre comment un objet métier est envoyé depuis unecollaboration à Adapter for JMS, comment Adapter for JMS appelle le gestionnaire de données utiles et envoie le messageJMS résultant à une file d'attente de sortie, depuis laquelleWebSphere Partner Gateway l'extrait.

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 :

  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 WebSphere Partner Gateway.

  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.
  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. 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.

  8. WebSphere Partner Gateway reçoit le message à partir de sa file d'attente d'entrée JMS, telle qu'elle est configurée dans sa cible.

Remarque : WebSphere Partner Gateway prend uniquement en charge les interactions asynchrones avec InterChange Server via le transfert 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 WebSphere Partner Gateway 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. 2003, 2005