Configuration de l'environnement requis pour le transfert JMS
Etant donné que l'échange de documents sur InterChange
Server nécessite l'utilisation de l'Adaptateur pour JMS et de files
d'attente JMS, vous devez effectuer les tâches d'installation et de
configuration décrites dans le
tableau 53. Pour plus d'informations
sur la manière de configurer WebSphere Partner Gateway pour une
utilisation avec InterChange Server via JMS, voir
Configuration de WebSphere Partner Gateway pour InterChange Server.
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 la version
5.3 de WebSphere MQ comme fournisseur JMS. Vous pouvez utiliser les étapes duGuide de configuration du concentrateur pour
configurer le mécanisme de protocole JMS.
Important : Les opérations décrites dans le Guide de configuration du concentrateur doivent être effectuées sur l'ordinateur où WebSphere Partner Gateway 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 vos files d'attente JMS à utiliser entre
WebSphere Partner Gateway et InterChange Server, prenez en
considération les points suivants :
- Une partie du processus d'installation d'InterChange Server
implique la création d'un gestionnaire de files d'attente WebSphere
MQ. Vous pouvez utiliser ce gestionnaire de files d'attente avec
WebSphere Partner Gateway.
- Lorsque vous créez vos alias de file d'attente JMS, vous pouvez
les nommer de manière à indiquer la direction du flux entre WebSphere
Partner Gateway et InterChange Server. Par exemple, si vous créez les
files d'attente répertoriées dans la colonne Nom de file
d'attente d'origine du
tableau 54, vous pouvez renommer ces
files d'attente pour qu'elles indiquent le flux directionnel
d'InterChange Server, comme indiqué dans la colonne Nom de file
d'attente directionnelle du
tableau 54.
Tableau 54. 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 |
ICS2HUB |
outQ |
HUB2ICS |
Configuration de l'Adaptateur pour JMS
Adapter for JMS permet à WebSphere Partner Gateway d'échanger des documents avec InterChange Server sous la forme de messages JMS.
Il prend en charge les interactions suivantes avec InterChange Server :
- Pour le traitement des requêtes, il reçoit l'objet métier de requête depuis InterChange Server, le convertit en message JMS (à l'aide
d'un gestionnaire de données), puis le place dans une file d'attente
JMS (voir la figure 23), d'où il
peut être récupéré par WebSphere Partner Gateway.
- Pour la notification d'événements, il interroge une
file d'attente JMS afin de récupérer les messages JMS à partir de
WebSphere Partner Gateway. Lorsqu'il reçoit un message JMS, il le convertit
en objet métier d'événement (à l'aide d'un gestionnaire de
données) et l'envoie à InterChange Server.
Important : WebSphere Partner Gateway 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 WebSphere Partner Gateway :
Spécification du gestionnaire de données utiles
Comme l'illustre la figure 23,
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 :
- Définissez les propriétés de configuration du connecteur afin d'identifier le gestionnaire de données utiles à utiliser :
- Attribuez aux propriétés DataHandlerConfigMO et
DataHandlerMimeType, respectivement, le nom du métaobjet
du gestionnaire de données de niveau supérieur et le type MIME pris
en charge.
- Affectez à la propriété DataHandlerClassName le nom de
la classe du gestionnaire de données à instancier.
Remarque : Vous définissez soit les
propriétés DataHandlerConfigMO et
DataHandlerMimeType soit la
propriété DataHandlerClassName.
- Ajoutez le métaobjet du gestionnaire
de données de niveau supérieur dans la liste des objets métier
pris en charge.
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 WebSphere Partner
Gateway. De même, lorsque WebSphere Partner Gateway 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 55 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 55. 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 WebSphere Partner Gateway utilise comme 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 WebSphere Partner Gateway 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 que
l'Adaptateur pour JMS utilise pour envoyer 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 WebSphere Partner Gateway est en mode écoute.
