Cette section explique comment configurer les composants pour échanger des documents entre WebSphere Partner Gateway 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 documents entre WebSphere Partner Gateway 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 WebSphere Partner Gateway, Message Broker et WebSphere MQ collaborent pour échanger des documents via le protocole de transfert HTTP.
Pour que WebSphere Partner Gateway envoie un document à Message Broker par le biais du protocole JMS, vous devez utiliser les files d'attente JMS. WebSphere Partner Gateway 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 25 illustre comment WebSphere Partner Gateway envoie des documents à Message Broker via le protocole JMS.
Les étapes suivantes expliquent comment WebSphere Partner Gateway 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, 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.
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 WebSphere Partner Gateway reçoive un document de Message Broker par le biais du 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 WebSphere Partner Gateway est en mode écoute. Lorsque WebSphere Partner Gateway 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 26 illustre la façon dont les documents sont envoyés de Message Broker à WebSphere Partner Gateway.
Les étapes suivantes expliquent comment WebSphere Partner Gateway 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 WebSphere Partner Gateway pour une utilisation avec Message Broker via JMS, voir Configuration de WebSphere Partner Gateway 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. Vous pouvez utiliser les étapes duGuide de configuration du concentrateur pour configurer le mécanisme de protocole JMS.
Lors de la création de vos files d'attente JMS à utiliser entre WebSphere Partner Gateway 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 54, vous pouvez renommer ces files d'attente pour qu'elles indiquent la direction du flux, comme indiqué dans la colonne Nom de file d'attente directionnelle du tableau 70.
Nom de file d'attente d'origine | Nom de file d'attente directionnelle |
---|---|
inQ | MB2HUB |
outQ | HUB2MB |
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 :
Type de noeud | Fonction | Remarques et restrictions |
---|---|---|
MQInput | Reçoit le document de WebSphere Partner Gateway | 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 WebSphere Partner Gateway. Pour plus d'informations, voir Configuration pour la réception de documents via 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. |
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 à WebSphere Partner Gateway | 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 WebSphere Partner Gateway. Pour plus d'informations, voir Configuration de documents entrants sur le protocole de transfert JMS. |
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.