Cette section explique comment configurer les composants pour échanger des documents entre WebSphere Business Integration Connect et WebSphere Business Integration Message Broker via le protocole de transfert JMS. Elle contient les informations suivantes qui expliquent comment envoyer et recevoir des documents :
L'échange de document entre Business Integration Connect et la version 5.0 de Message Broker à l'aide du protocole de transfert JMS nécessite WebSphere MQ comme fournisseur JMS. Les sections qui suivent expliquent comment Business Integration Connect, Message Broker et WebSphere MQ collaborent pour échanger des documents via le protocole de transfert HTTP.
Pour que Business Integration Connect envoie un document à Message Broker par le biais du protocole JMS, vous devez utiliser les files d'attente JMS. Business Integration Connect envoie un document à sa file d'attente de sortie JMS d'où il est transféré vers la file d'attente d'entrée JMS sur laquelle Message Broker est en mode écoute. Lorsque Message Broker reçoit un document, il l'extrait de sa file d'attente d'entrée. Le flux de messages de Message Broker contient des noeuds de transfert WebSphere MQ (JMS) spéciaux qui traitent l'accès aux files d'attente JMS. La Figure 23 illustre comment Business Integration Connect envoie des documents à Message Broker sur le protocole JMS.
Les étapes suivantes expliquent comment Business Integration Connect envoie un document à un flux de messages dans Message Broker via le protocole de transfert 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.
Pour plus d'informations sur la procédure de configuration de cette file d'attente, voir Configuration de l'environnement requis pour le transfert JMS.
Une fois la logique applicative est terminée, le flux de messages envoie le document résultant à son noeud MQOutput.
Pour que Business Integration Connect reçoive un document de Message Broker via le protocole JMS, vous devez utiliser des files d'attente JMS. Message Broker envoie un document à sa file d'attente de sortie JMS d'où il est transféré vers la file d'attente d'entrée JMS sur laquelle Business Integration Connect est en mode écoute. Lorsque Business Integration Connect reçoit un document, il l'extrait de sa file d'attente d'entrée. Le flux de messages de Message Broker contient des noeuds de transfert WebSphere MQ (JMS) spéciaux qui traitent l'accès aux files d'attente JMS. La Figure 24 illustre la façon dont les documents sont envoyés de Message Broker à Business Integration Connect.
Les étapes suivantes expliquent comment Business Integration Connect reçoit un document à partir d'un flux de messages dans Message Broker via le protocole de transfert JMS :
Le flux de messages reçoit sont message entrant d'une file d'attente d'entrée JMS.
Une fois la logique applicative est terminée, le flux de messages envoie le document résultant à son noeud MQOutput.
Pour plus d'informations sur la cible, voir Configuration de documents entrants sur le protocole de transfert JMS. Pour plus d'informations sur la procédure de configuration de cette file d'attente, voir Configuration de l'environnement requis pour le transfert JMS.
L'échange de documents sur Message Broker nécessite des files d'attente JMS (éloignées et locales). Pour plus d'informations sur la manière de configurer Business Integration Connect pour être utilisé avec Message Broker sur JMS, voir Configuration de Business Integration Connect pour Message Broker. Pour utiliser le protocole JMS avec Message Broker, vous pouvez configurer le système JMS fourni par WebSphere MQ. La version 5.0 de Message Broker utilise la version 5.3 de WebSphere MQ 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.
Lors de la création de vos files d'attente JMS à utiliser entre Business Integration Connect et Message Broker, prenez en considération les points suivants :
Vous pouvez utiliser la commande suivante pour créer ce gestionnaire de files d'attente et un ensemble de files d'attente nommées :
mqsicreatebroker
Dans la mesure où Message Broker utilise un ensemble de noms de files d'attente prédéterminés, il nécessite un gestionnaire de files d'attente WebSphere MQ distinct pour chaque courtier. Message Broker peut partager cet hébergement de gestionnaire de files d'attente à l'aide de son gestionnaire de configuration et/ou du serveur de noms d'utilisateur facultatif.
Pour plus d'informations, voir WebSphere Business Integration Message Broker Installation and Configuration Guide.
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 73, vous pouvez renommer ces files d'attente pour qu'elles indiquent la directionnalité de Message Broker, comme indiqué dans la colonne Nom de file d'attente directionnelle du Tableau 89.
Tableau 89. Attribution de noms aux files d'attente JMS pour la directionnalité de Message Broker
Nom de file d'attente d'origine | Nom de file d'attente directionnelle |
---|---|
inQ | MB2WBIC |
outQ | WBIC2MB |
Pour qu'un flux de messages Message Broker traite les documents via le protocole de transfert JMS, il utilise les noeuds de transfert suivants :
L'ordre dans lequel ces noeuds de transfert sont utilisés est fonction du sens de la communication :
Tableau 90. Noeuds permettant l'envoi de documents à Message Broker via JMS
Type de noeud | Fonction | Remarques et restrictions |
---|---|---|
MQInput | Reçoit le document de Business Integration Connect | La valeur de la zone Nom de file d'attente (dans les propriétés de base) de ce noeud de transfert correspond à la file d'attente d'entrée du flux de messages. WebSphere MQ doit être configuré de sorte que cette file d'attente JMS reçoive des documents de la file d'attente de sortie de Business Integration Connect. Pour plus d'informations, voir Configuration de documents sortants sur le protocole de transfert JMS. |
Calcul | Effectue des tâches de logique applicative, telles que la suppression des informations d'en-tête | Aucun |
MQOutput | Reçoit le document du noeud de calcul et l'envoie sous forme de sortie de flux de messages | Ce noeud de transfert envoie le document résultant à une file d'attente de sortie JMS qui l'achemine vers sa prochaine destination. |
Tableau 91. Noeuds permettant la réception de documents de Message Broker
Type de noeud | Fonction | Remarques et restrictions |
---|---|---|
MQInput | Reçoit le document dans le flux de messages | Ce noeud de transfert reçoit le document entrant d'une file d'attente d'entrée JMS. |
Calcul | Effectue des tâches de logique applicative, telles que la mise à jour des informations d'en-tête | Aucun |
MQOutput | Reçoit le document du noeud de calcul et l'envoie à Business Integration Connect | La valeur de la zone Nom de file d'attente (dans les propriétés de base) de ce noeud de transfert correspond à la file d'attente de sortie du flux de messages. WebSphere MQ doit être configuré de sorte que cette file d'attente JMS envoie des documents à la file d'attente d'entrée de Business Integration Connect. Pour plus d'informations, voir Configuration de documents sortants sur le protocole de transfert HTTP. |
Pour plus de détails sur la création et la configuration des noeuds de flux de messages, consultez la documentation WebSphere Business Integration Message Broker.