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
- 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.
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:
- 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
Business Integration Connect.
- Lorsque vous créez vos alias de file d'attente JMS, vous pouvez les
nommer de manière à indiquer la direction du flux entre Business Integration
Connect et InterChange Server. Par exemple, lors de la création des
files d'attente indiquées dans la colonne Nom de file d'attente
d'origine du Tableau 73, vous pouvez renommer ces files d'attente pour
qu'elles indiquent la directionnalité d'InterChange Server, comme
dans la colonne Nom de file d'attente directionnelle du Tableau 73.
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
|
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 :
- 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 21), d'où il peut être récupéré par Business Integration
Connect.
- Pour
la notification d'événements, il interroge une file d'attente JMS
afin de récupérer les messages JMS à partir de Business Integration
Connect. 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 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 :
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
:
- 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.
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.
