Componentes necesarios para los documentos mediante el transporte JMS

Para que Business Integration Connect se comunique con InterChange Server mediante el protocolo de transporte JMS, es necesario que estos dos componentes estén configurados para trabajar con JMS. En la Tabla 70 se resumen estos pasos de configuración.

Tabla 70. Configuración de Business Integration Connect e InterChange Server para el protocolo de transporte JMS
Componente Versión Si desea obtener más información
WebSphere Business Integration Connect 4.2.2

Configuración de documentos salientes mediante el protocolo de transporte JMS

Configuración de documentos entrantes mediante el protocolo de transporte JMS

WebSphere InterChange Server 4.1.1, 4.2.0, 4.2.1, 4.2.2 Creación de artefactos de ICS para JMS

Asimismo, para enviar o recibir un documento entre Business Integration Connect e InterChange Server mediante un protocolo de transporte JMS, también se utilizan los componentes compatibles con ICS que se enumeran en la Tabla 71.

Tabla 71. Componentes necesarios para transferir documentos a y desde InterChange Server mediante JMS
Componente Descripción Notas y restricciones

WebSphere Business Integration Adapter para JMS

(Adaptador de JMS)

Este adaptador permite a InterChange Server intercambiar objetos de negocio con aplicaciones que envíen o reciban datos en forma de mensajes JMS. El adaptador de JMS y Business Integration Connect se comunican mediante colas JMS.

  1. Asegúrese de que está utilizando el adaptador de JMS versión 2.3.1 (o posterior), que da soporte a las propiedades de cabecera personalizada. Consulte la documentación del adaptador para asegurarse de que la versión del adaptador es compatible con la versión de InterChange Server que está utilizando.
  2. El adaptador de JMS sólo da soporte a mensajes de texto JMS. Si tiene previsto utilizar mensajes de bytes JMS, utilice el adaptador de JMS versión 2.5.0.

Un manejador de datos de carga Este manejador de datos convierte la carga entre el formato del documento y la representación de objeto de negocio. Si desea obtener más información, consulte el apartado Especificación del manejador de datos de carga.
Manejador de datos de accesorios

Este manejador de datos convierte los documentos con accesorios en objetos de negocio.

Este manejador de datos sólo es necesario si los documentos incluyen accesorios. Si desea obtener más información, consulte el apartado Manejo de documentos con accesorios.

En los siguientes apartados se describe cómo trabajan conjuntamente los componentes de la Tabla 71 para enviar y recibir documentos entre Business Integration Connect e InterChange Server mediante el protocolo de transporte JMS.

Envío de documentos mediante el transporte JMS

Para que Business Integration Connect pueda enviar un documento a InterChange Server utilizando el protocolo de transporte JMS, se utiliza el adaptador de JMS para recuperar el mensaje que Business Integration Connect ha puesto en una cola JMS. A continuación, el adaptador direcciona el mensaje a InterChange Server. En la Figura 20 se proporciona una visión general de cómo envía Business Integration Connect documentos a InterChange Server mediante el protocolo de transporte JMS.

Figura 20. Flujo de mensajes de Business Integration Connect a una colaboración mediante el protocolo de transporte JMS


En los pasos siguientes se describe cómo participa Business Integration Connect en la notificación de eventos enviando un documento a una colaboración dentro de InterChange Server mediante el protocolo de transporte JMS:

  1. Business Integration Connect envía un mensaje a su cola de salida 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.

    Nota:
    Dentro de Business Integration Connect, debe configurar una pasarela que identifique la cola JMS a la que Business Integration Connect envía el mensaje y en la que el adaptador de JMS realiza el sondeo. Si desea obtener más información, consulte el apartado Configuración de documentos salientes mediante el protocolo de transporte JMS.
  2. Cuando el adaptador de JMS ve un mensaje en una de sus colas de entrada, lo recupera.

    La cola JMS que utiliza Business Integration Connect como cola de salida es la misma cola que el adaptador de JMS utiliza como cola de entrada. Si desea obtener más información sobre cómo configurar esta cola, consulte el apartado Configuración de las colas JMS. Si desea obtener más información sobre el proceso del adaptador de JMS, consulte Adapter for JMS User Guide.

  3. El adaptador de JMS traslada el mensaje a su cola en progreso.
  4. El adaptador de JMS extrae el cuerpo del mensaje JMS e invoca un manejador de datos con el cuerpo del mensaje. Este manejador de datos convierte el cuerpo del mensaje JMS en un objeto de negocio.
    Nota:
    Si los mensajes tienen accesorios, puede instalar el manejador de datos de accesorios y, a continuación, configurar el adaptador de JMS para que lo llame para convertir el cuerpo del mensaje JMS en un objeto de negocio. Si desea obtener más información, consulte el apartado Manejo de documentos con accesorios.

    Cuando el tipo de empaquetado es de integración de programas de fondo y el documento contiene accesorios, el manejador de datos configurado es el responsable de manejar la carga y los accesorios.

  5. El manejador de datos devuelve el objeto de negocio al adaptador de JMS.
    Nota:
    Si se ha utilizado el manejador de datos de accesorios, este objeto de negocio contiene la carga y los accesorios.
  6. Si el adaptador de JMS encuentra un metaobjeto dinámico hijo (especificado utilizando cw_mo_conn en la información específica de la aplicación de nivel de objeto de negocio), el adaptador rellena las cabeceras JMS definidas por el usuario que hay en el objeto de negocio con las cabeceras que hay en el mensaje JMS.
  7. El adaptador de JMS entrega el objeto de negocio a InterChange Server como parte de una entrega de suscripción.

Recepción de documentos mediante el transporte JMS

Para que Business Integration Connect pueda recibir un documento de InterChange Server utilizando el protocolo de transporte JMS, se utiliza el adaptador de JMS, que coloca el mensaje que recibe de InterChange Server en una cola JMS para que Business Integration Connect pueda recuperarlo. En la Figura 21 se proporciona una visión general de cómo recibe Business Integration Connect documentos de InterChange Server mediante el protocolo de transporte JMS.

Figura 21. Flujo de mensajes de una colaboración a Business Integration Connect mediante el protocolo de transporte JMS


En los pasos siguientes se describe cómo participa Business Integration Connect en el proceso de peticiones recibiendo un documento de una colaboración dentro de InterChange Server mediante el protocolo de transporte JMS:

  1. La colaboración dentro de InterChange Server realiza una llamada de servicio al adaptador de JMS y le envía el objeto de negocio de petición.

    El objeto de negocio de petición contiene información específica de la aplicación que apunta a un metaobjeto dinámico que contiene la información de cabecera de nivel de transporte JMS que espera Business Integration Connect.

  2. El adaptador de JMS utiliza un manejador de datos para convertir el objeto de negocio que ha enviado la colaboración en un mensaje JMS.

    El adaptador lee las propiedades DataHandlerMimeType y DataHandlerConfigMO para determinar el manejador de datos que debe utilizar. Si desea obtener más información, consulte el apartado Especificación del manejador de datos de carga.

    Nota:
    Si los documentos tienen accesorios, instale el manejador de datos de accesorios y, a continuación, configure el adaptador de JMS para que lo llame para convertir el objeto de negocio de petición en un documento con accesorios. Si desea obtener más información, consulte el apartado Manejo de documentos con accesorios.
  3. El manejador de datos convierte el objeto de negocio en una serie y lo devuelve al adaptador de JMS.
  4. El adaptador de JMS determina, a partir del objeto de negocio de petición, el nombre del metaobjeto dinámico para las propiedades JMS personalizadas.

    El adaptador busca en la información específica de la aplicación del objeto de negocio de petición el distintivo cw_mo_conn, que identifica el atributo que contiene al metaobjeto dinámico. Si utiliza el empaquetado de integración de programas de fondo para el documento, puede especificar la información de cabecera de nivel de transporte en este metaobjeto dinámico.

  5. El adaptador de JMS busca el atributo JMSProperties en el metaobjeto dinámico.

    Si este atributo está completo, el adaptador establece los campos de cabecera de nivel de transporte en el documento de petición. Dentro del atributo JMSProperties, también puede especificar la cabecera JMS estándar de tipo de contenido. Si desea obtener más información, consulte el apartado Creación de la información de cabecera JMS.

  6. El adaptador de JMS crea un mensaje JMS utilizando la serie devuelta por el manejador de datos. También establece las propiedades personalizadas, tal como se ha definido en el metaobjeto dinámico.
    Nota:
    Las versiones del adaptador de JMS anteriores a la 2.4.1 sólo pueden escribir mensajes de texto JMS.
  7. El adaptador de JMS envía el mensaje de petición resultante a una cola de salida.

    La cola se puede especificar en el metaobjeto estático o en el metaobjeto dinámico. Si desea obtener más información sobre la especificación de colas, consulte el apartado Identificación de las colas JMS. Business Integration Connect escucha en esta cola JMS, que está configurada como cola de entrada en la definición de destino. Si desea obtener más información, consulte el apartado Configuración de documentos entrantes mediante el protocolo de transporte JMS.

  8. Business Integration Connect recibe el mensaje de la cola de entrada JMS, tal como está configurado en el destino.

Nota:
Business Integration Connect da soporte sólo a la interacción asíncrona con InterChange Server mediante JMS. Por lo tanto, puede que no desee esperar la respuesta. La respuesta del participante de comunidad o de Business Integration Connect puede venir en otra cola. Puede configurar el adaptador de JMS para que sondee esa cola. La respuesta que se incluye en la cola se puede entregar a InterChange Server como parte de la entrega del evento.

Copyright IBM Corp. 1997, 2004