En este apartado se describe cómo configurar los componentes para enviar y recibir documentos entre WebSphere Business Integration Connect y WebSphere Business Integration Message Broker utilizando el protocolo de transporte JMS. Se proporciona la siguiente información sobre cómo enviar y recibir documentos:
Para enviar o recibir un documento entre Business Integration Connect y Message Broker versión 5.0 utilizando el protocolo de transporte JMS, es necesario WebSphere MQ como proveedor JMS. En los siguientes apartados se describe cómo trabajan conjuntamente Business Integration Connect, Message Broker y WebSphere MQ para intercambiar documentos mediante el protocolo de transporte HTTP.
Para que Business Integration Connect pueda enviar un documento a Message Broker utilizando el protocolo de transporte JMS, se utilizan las colas JMS. Business Integration Connect envía un documento a su cola de salida JMS, donde se transfiere a la cola de entrada JMS en la que escucha Message Broker. Cuando Message Broker recibe un documento, lo recupera de su cola de entrada. El flujo de mensajes de Message Broker contiene nodos de transporte (JMS) de WebSphere MQ especiales, que manejan el acceso a las colas JMS. En la Figura 23 se proporciona una visión general de cómo envía Business Integration Connect documentos a Message Broker mediante el protocolo de transporte JMS.
En los pasos siguientes se describe cómo envía Business Integration Connect un documento a un flujo de mensajes dentro de Message Broker mediante el protocolo de transporte JMS:
Si el tipo de empaquetado del documento era Integración de programas de fondo, Business Integration Connect ha proporcionado propiedades personalizadas en este mensaje. La cabecera del mensaje JMS, JMSType, se establece con el tipo de contenido de la carga.
Si desea obtener más información sobre cómo configurar esta cola, consulte el apartado Configuración del entorno para el transporte JMS.
Cuando la lógica empresarial finaliza, el flujo de mensajes envía el documento resultante al nodo MQOutput.
Para que Business Integration Connect pueda recibir un documento de Message Broker mediante el protocolo de transporte JMS, se utilizan colas JMS. Message Broker envía un documento a su cola de salida JMS, donde se transfiere a la cola de entrada JMS en la que escucha Business Integration Connect.Cuando Business Integration Connect recibe un documento, lo recupera de su cola de entrada. El flujo de mensajes de Message Broker contiene nodos de transporte (JMS) de WebSphere MQ especiales, que manejan el acceso a las colas JMS. En la Figura 24 se proporciona una visión general de cómo se envían los documentos de Message Broker a Business Integration Connect.
En los pasos siguientes se describe cómo recibe Business Integration Connect un documento de un flujo de mensajes dentro de Message Broker mediante el protocolo de transporte JMS:
El flujo de mensajes recibe el mensaje entrante de una cola de entrada JMS.
Cuando la lógica empresarial finaliza, el flujo de mensajes envía el documento resultante al nodo MQOutput.
Si desea obtener más información sobre el destino, consulte el apartado Configuración de documentos entrantes mediante el protocolo de transporte JMS. Si desea obtener más información sobre cómo configurar esta cola, consulte el apartado Configuración del entorno para el transporte JMS.
El envío y la recepción de los documentos de Message Broker implica el uso de colas JMS (remotas y locales). Si desea obtener más información sobre cómo configurar Business Integration Connect para su uso con Message Broker mediante JMS, consulte el apartado Configuración de Business Integration Connect para Message Broker. Para utilizar el protocolo de transporte JMS con Message Broker, puede configurar el sistema JMS que proporciona WebSphere MQ. La versión 5.0 de Message Broker utiliza la versión 5.3 de WebSphere MQ como proveedor JMS. Por lo tanto, siga los pasos que se describen en el apartado Apéndice A, Configuración de un protocolo JMS con WebSphere MQ para configurar el mecanismo de protocolo de transporte JMS.
Cuando cree las colas JMS para su utilización entre Business Integration Connect e Message Broker, tenga en cuenta los siguientes puntos:
Puede utilizar el siguiente mandato para crear este gestor de colas y establecer un conjunto de colas con nombre:
mqsicreatebroker
Como Message Broker utiliza un conjunto predeterminado de nombres de cola, necesita un gestor de colas WebSphere MQ independiente por intermediario. Message Broker puede compartir este gestor de colas con el gestor de configuración, el servidor de nombre de usuario opcional, o con ambos.
Si desea obtener más información, consulte WebSphere Business Integration Message Broker Installation and Configuration Guide.
Por ejemplo, si crea las colas que se incluyen en la columna Nombre de cola original de la Tabla 73, puede cambiar el nombre de estas colas para que indiquen la direccionalidad de Message Broker, tal como se muestra en la columna Nombre de cola direccional de la Tabla 89.
Tabla 89. Nombres de las colas JMS para la direccionalidad de Message Broker
Nombre de cola original | Nombre de cola direccional |
---|---|
inQ | MB2WBIC |
outQ | WBIC2MB |
Para que un flujo de mensajes de Message Broker maneje documentos mediante el protocolo de transporte JMS, se utilizan los siguientes nodos de transporte:
El orden de uso de estos nodos de transporte depende de la dirección de la comunicación, tal como se especifica a continuación:
Tabla 90. Nodos para enviar documentos a Message Broker mediante JMS
Tipo de nodo | Objetivo | Notas y restricciones |
---|---|---|
MQInput | Recibe el documento de Business Integration Connect | El valor del campo Nombre de cola (en las propiedades básicas) de este nodo de transporte es la cola de entrada del flujo de mensajes. WebSphere MQ se debe configurar para que esta cola JMS reciba documentos de la cola de salida de Business Integration Connect. Si desea obtener más información, consulte el apartado Configuración de documentos salientes mediante el protocolo de transporte JMS. |
Compute | Realiza tareas de lógica empresarial como, por ejemplo, la eliminación de información de cabecera | Ninguna |
MQOutput | Recibe el documento del nodo Compute y lo envía como la salida del flujo de mensajes | Este nodo de transporte envía el documento resultante a una cola de salida JMS, que lo direcciona a su próximo destino. |
Tabla 91. Nodos para recibir documentos de Message Broker
Tipo de nodo | Objetivo | Notas y restricciones |
---|---|---|
MQInput | Recibe el documento en el flujo de mensajes | Este nodo de transporte recibe el documento entrante de una cola de entrada JMS. |
Compute | Realiza tareas de lógica empresarial como, por ejemplo, la actualización de la información de cabecera | Ninguna |
MQOutput | Recibe el documento del nodo Compute y lo envía a Business Integration Connect | El valor del campo Nombre de cola (en las propiedades básicas) de este nodo de transporte es la cola de salida del flujo de mensajes. WebSphere MQ se debe configurar para que esta cola JMS envíe documentos a la cola de entrada de Business Integration Connect. Si desea obtener más información, consulte el apartado Configuración de documentos salientes mediante el protocolo de transporte HTTP. |
Si desea obtener más información sobre cómo crear y configurar nodos de flujos de mensajes, consulte la documentación de WebSphere Business Integration Message Broker.
En este capítulo se describe cómo integrar WebSphere Business Integration Connect con WebSphere Data Interchange.
En este capítulo se proporciona una explicación del proceso con el que se intercambian los documentos y se describen los pasos para configurar un entorno de ejemplo para estos intercambios. El ejemplo que se utiliza en este capítulo es parecido al presentado en la guía de aprendizaje Integración de WebSphere Data Interchange V3.2 con WebSphere Business Integration Connect V4.2, que está disponible en el siguiente sitio web:
www.ibm.com/developerworks/websphere/
La guía de aprendizaje proporciona scripts adicionales (en el apartado sobre configuración de WebSphere MQ), así como correlaciones de transformaciones de ejemplo. Siguiendo la guía de aprendizaje puede configurar el entorno que se describe en este capítulo.
Se da por sentado que está familiarizado con el uso de WebSphere Data Interchange. Consulte la documentación de WebSphere Data Interchange para obtener información adicional mientras lee este capítulo.