Configuration de l'environnement requis pour le transfert JMS

Dans la mesure où l'envoi et la réception de documents vers et depuis InterChange Server nécessitent l'utilisation de composants compatibles avec ICS, vous devez effectuer les tâches d'installation et de configuration décrites dans le Tableau 72. Pour plus d'informations sur la manière de configurer Business Integration Connect pour être utilisé avec InterChange Server sur JMS, voir Configuration de Business Integration Connect pour InterChange Server.

Tableau 72. Configuration de l'environnement requis pour l'utilisation du protocole JMS
Etape de configuration Pour plus d'informations
1. Configurez vos files d'attente JMS. Configuration des files d'attente JMS

2. Configurez WebSphere Business Integration Adapter for JMS.

Configuration de l'Adaptateur pour JMS

Remarque :
Si vos documents contiennent des pièces jointes, vous devez également installer et configurer le composant Attachment Data Handler. Pour plus d'informations, voir Gestion des documents contenant des pièces jointes.

Configuration des files d'attente JMS

Pour utiliser le protocole JMS avec InterChange Server, vous devez configurer le système JMS fourni par WebSphere MQ. Les versions prises en charge d'InterChange Server utilisent WebSphere MQ version 5.3 comme fournisseur JMS. Par conséquent, vous pouvez suivre les étapes décrites dans Annexe A, Configuration d'un protocole JMS avec WebSphere MQ pour configurer le mécanisme de protocole JMS.

Important:
Les opérations décrites dans Annexe A, Configuration d'un protocole JMS avec WebSphere MQ doivent être effectuées sur la machine où WebSphere Business Integration Connect réside. Ce document présume que le mécanisme de transfert JMS requis par l'Adaptateur pour JMS et InterChange Server a déjà été configuré pendant l'installation d'InterChange Server.

Lors de la création de files d'attentes JMS en vue d'être utilisée entre Business Integration Connect et InterChange Server, prêter une attention particulière aux points suivants:


Tableau 73. Attribution de noms aux files d'attente JMS pour la directionnalité d'InterChange Server
Nom de file d'attente d'origine Nom de file d'attente directionnelle
inQ ICS2WBIC
outQ WBIC2ICS

Configuration de l'Adaptateur pour JMS

L'Adaptateur pour JMS est un composant compatible avec ICS qui permet à Business Integration Connect d'échanger des documents avec InterChange Server sous la forme de messages JMS. Il prend en charge les interactions suivantes avec InterChange Server :

Important:
WebSphere Business Integration Connect n'intègre pas WebSphere Business Integration Adaptateur pour JMS. Vous devez vous procurer ce produit séparément et l'installer conformément aux instructions figurant dans le document Guide de l'Adaptateur pour JMS. Il est important de lire attentivement les opérations décrites dans ce document afin d'installer et de configurer correctement l'Adaptateur pour JMS.

Lorsque vous avez configuré l'Adaptateur pour JMS pour communiquer avec InterChange Server, suivez les étapes de cette section afin de configurer cet adaptateur pour qu'il accepte les messages JMS envoyés par Business Integration Connect :

Spécification du gestionnaire de données utiles

Comme l'illustre la Figure 21, l'Adaptateur pour JMS utilise un gestionnaire de données pour convertir les objets métier reçus depuis InterChange Server en un message JMS.

Remarque :
Le gestionnaire de données que l'Adaptateur pour JMS appelle convertit les données utiles du document. Si votre document est inclus dans une enveloppe XML (car il comprend des pièces jointes ou l'indicateur d'enveloppe est sur Oui), configurer le gestionnaire de données en pièce jointe de sorte qu'il fonctionne comme un gestionnaire de données utiles. Pour plus d'informations, voir Gestion des documents contenant des pièces jointes.

Pour indiquer quel gestionnaire de données utiliser pour convertir les données utiles, vous devez suivre les étapes spécifiées dans la section Conversion d'objet métier. De plus, vous devez configurer l'Adaptateur pour JMS pour qu'il utilise ce gestionnaire de données utiles. Dans le panneau de configuration du connecteur, suivre les étapes suivantes :

Vous pouvez également indiquer quel gestionnaire de données utiliser dans le métaobjet dynamique ou statique. Les mêmes propriétés (DataHandlerMimeType , DataHandlerConfigMO et DataHandlerClassName) sont disponibles en tant qu'attributs dans ces métaobjets. Pour plus d'informations, voir le document Guide utilisateur de l'Adaptateur pour JMS.

Identification des files d'attente JMS

Lorsque l'Adaptateur pour JMS reçoit un document d'InterChange Server, il le place dans sa file d'attente de sortie, qui est ensuite interrogée par le réceptionnaire de Business Integration Connect. De même, lorsque Business Integration Connect envoie un document à InterChange Server, il place le document dans sa file d'attente de sortie, qui est interrogée par l'Adaptateur pour JMS.

Le Tableau 74 résume comment configurer les files d'attente que l'Adaptateur pour JMS utilise pour recevoir et envoyer des documents.

Remarque :
Pour plus d'informations sur la configuration des files d'attente JMS, voir le document Guide utilisateur de l'Adaptateur pour JMS.

Tableau 74. Files d'attente JMS
File d'attente JMS Jeu de configuration
File d'attente d'entrée

Affectez à la propriété de configuration du connecteur InputDestination le nom de la file d'attente JMS que l'Adaptateur pour JMS interrogera pour obtenir les messages entrants.

Vérifiez que le nom de cette file d'attente est identique à celui que Business Integration Connect utilise pour sa file d'attente JMS de sortie. Si cette file d'attente n'est pas spécifiée dans la propriété InputDestination, l'Adaptateur pour JMS n'interrogera pas la file d'attente.

Remarque :
La propriété InputDestination contient une liste de files d'attente d'entrée séparée par des virgules. Si l'Adaptateur pour JMS interroge plusieurs files d'attente, assurez-vous que cette liste contient le nom de la file d'attente JMS qu'utilise Business Integration Connect comme file d'attente JMS de sortie.
File d'attente de sortie Pendant l'exécution, la collaboration peut affecter de manière dynamique à l'attribut OutputQueue dans le métaobjet dynamique le nom de la file d'attente JMS à laquelle l'Adaptateur pour JMS envoie son message.

Vous devez vous assurer que les métaobjets statiques ou dynamiques sont configurés pour pouvoir écrire sur la file d'attente sur laquelle la cible de Business Integration Connect écoute.

Copyright IBM Corp. 1997, 2004