Creación de definiciones de objetos de negocio para JMS

El adaptador de JMS envía y recibe el documento en InterChange Server en forma de un objeto de negocio de carga. El adaptador de JMS invoca el manejador de datos de carga para manejar este objeto de negocio cuando recibe o envía un documento de Business Integration Connect, tal como se especifica a continuación:

Por lo tanto, debe crear las definiciones de objetos de negocio que se muestran en la Tabla 75 para representar la estructura del objeto de negocio de carga que espera el adaptador de JMS.

Tabla 75. Definiciones de objetos de negocio para el adaptador de JMS
Condición Definición de objeto de negocio Si desea obtener más información
Si utiliza el Ninguno o empaquetado de integración de programas de fondo para el mensaje y los documentos no tienen accesorios

Objeto de negocio de carga

Creación de la estructura del objeto de negocio de carga para JMS.
Si utiliza el empaquetado de integración de programas de fondo para el documento

Objetos de negocio que deben mantener la información de cabecera del mensaje:

  • Metaobjeto dinámico
  • Objeto de negocio de propiedades JMS

Creación de la información de cabecera JMS.
Si el documento incluye accesorios También debe crear objetos de negocio adicionales para representar los accesorios. Creación de definiciones de objetos de negocio relacionadas con los accesorios

Creación de la estructura del objeto de negocio de carga para JMS

La estructura del objeto de negocio de carga del protocolo de transporte JMS depende del tipo de empaquetado, tal como se especifica a continuación:

Nota:
Para el proceso de peticiones, el protocolo de transporte JMS sólo puede dar soporte a interacciones asíncronas. Puede enviar un objeto de negocio de petición, pero no puede obtener una respuesta. Por lo tanto, deberá crear una definición de objeto de negocio de petición, pero no una definición de objeto de negocio para una respuesta.

Creación de la información de cabecera JMS

Si envía o recibe documentos que utilizan el empaquetado de integración de programas de fondo mediante el protocolo de transporte JMS, el objeto de negocio de petición debe contener información de cabecera de nivel de transporte personalizada. El adaptador de JMS espera que esta información de cabecera personalizada esté en su metaobjeto dinámico.

En la Figura 22 se muestra la estructura del objeto de negocio que utiliza el adaptador de JMS para un objeto de negocio de petición que representa un documento de Business Integration Connect que utiliza el empaquetado de integración de programas de fondo.

Nota:
En Adapter for JMS User Guide puede encontrar información sobre esta estructura de objeto de negocio necesaria. Consulte esta guía cuando defina las definiciones de objetos de negocio.

Figura 22. Relación del objeto de negocio de petición con el metaobjeto dinámico JMS


Siga estos pasos para asegurarse de que la estructura del objeto de negocio incluye un metaobjeto hijo dinámico:

  1. Cree una definición de objeto de negocio que mantenga las propiedades JMS que necesita el empaquetado de integración de programas de fondo.
  2. Cree una definición de objeto de negocio para el metaobjeto dinámico.
  3. Modifique la definición de objeto de negocio del objeto de negocio de petición para que incluya un atributo para el metaobjeto dinámico.

Cada uno de estos pasos se describe en los apartados siguientes.

Creación del objeto de negocio de propiedades JMS

Un objeto de negocio de propiedades JMS contiene las propiedades JMS necesarias para las cabeceras de nivel de transporte que necesita el empaquetado de integración de programas de fondo. También puede contener el atributo de tipo de contenido, que especifica la cabecera de tipo de contenido que se establece en el mensaje de petición, y el atributo content-length, que especifica la longitud del mensaje, en bytes. En la Tabla 4 se describen cada uno de los campos de cabecera de transporte válidos.

Para crear una definición de objeto de negocio de propiedades JMS, siga estos pasos:

  1. Cree un atributo dentro de la definición de objeto de negocio para cada uno de los campos de cabecera de nivel de transporte.

    Todos los atributos deben tener un tipo de atributo String. Para los mensajes JMS, los nombres de los campos de cabecera de transporte utilizan subrayados en lugar de guiones, tal como se muestra en la Tabla 76.

  2. Para cada uno de los atributos de la definición de objeto de negocio de propiedades JMS, añada información específica de la aplicación que identifique el objetivo del atributo asociado.

    Esta información específica de la aplicación de nivel de atributo debe tener el siguiente formato:

    name=JMSproperty;type=string
     

    donde JMSproperty es uno de los valores de la columna Nombre de propiedad JMS de la Tabla 76.

  3. Para los atributos de la definición de objeto de negocio de propiedades JMS, puede añadir un valor por omisión que indique el valor común (o sólo válido) para ese campo de nivel de transporte.

Tabla 76. Atributos de la definición de objeto de negocio de propiedades JMS
Campo de cabecera de transporte Nombre de propiedad JMS
x-aux-sender-id x_aux_sender_id
x-aux-receiver-id x_aux_receiver_id
x-aux-protocol x_aux_protocol
x-aux-protocol-version x_aux_protocol_version
x-aux-process-type x_aux_process_type
x-aux-process-version x_aux_process_version
x-aux-create-datetime x_aux_create_datetime
x-aux-msg-id x_aux_msg_id
x-aux-production x_aux_production
x-aux-system-msg-id x_aux_system_msg_id
x-aux-payload-root-tag x_aux_payload_root_tag
x-aux-process-instance-id x_aux_process_instance_id
x-aux-event-status-code x_aux_event_status_code
x-aux-third-party-bus-id x_aux_third_party_bus_id
x-aux-transport-retry-count x_aux_transport_retry_count
content-type content_type
content-length content_length

Nota:
En la Tabla 76 no se incluye una lista exhaustiva de las cabeceras necesarias para la integración de programas de fondo. Si desea ver una lista completa y una descripción de las cabeceras, consulte el apartado Contenido de la cabecera de nivel de transporte. Asegúrese de sustituir los caracteres de subrayado por guiones en los nombres de campo de cabecera de transporte.

En la Figura 22, la definición de objeto de negocio JMSProps_BusObj contiene atributos para los distintos campos de cabecera de transporte. Estos atributos contienen todos información específica de la aplicación de nivel de atributo donde se especifica el nombre de la cabecera de protocolo relacionada. Por ejemplo, el atributo x_aux_sender_id contiene información específica de la aplicación establecida de la siguiente manera:

name=x_aux_sender_id;type=string
 

Creación del metaobjeto dinámico JMS

Este metaobjeto dinámico contiene un objeto de negocio hijo con información de configuración para el adaptador de JMS. Para crear una definición de objeto de negocio para un metaobjeto dinámico, siga estos pasos:

  1. Cree un atributo denominado JMSProperties, cuyo tipo de atributo sea la definición de objeto de negocio del objeto de negocio de propiedades JMS (consulte el apartado Creación del objeto de negocio de propiedades JMS).
  2. Añada otras propiedades de configuración según sea necesario. Si desea ver una lista de los atributos válidos del metaobjeto dinámico, consulte Adapter for JMS User Guide. Consulte esta guía para obtener información sobre cómo crear atributos para configurar el metaobjeto dinámico.

Para que el adaptador de JMS pueda funcionar con Business Integration Connect, la definición de objeto de negocio del metaobjeto dinámico debe incluir el atributo denominado JMSProperties, cuyo tipo de atributo sea la definición de objeto de negocio del objeto de negocio de propiedades JMS (consulte el apartado Creación del objeto de negocio de propiedades JMS). Por ejemplo, en la Figura 22, la definición de objeto de negocio JMSDynMO_BusObj contiene atributos para varias propiedades de configuración (que no se muestran) e incluye el atributo JMSProperties.

Modificación de la definición de objeto de negocio de petición

Para incorporar la estructura del objeto de negocio en el objeto de negocio de petición, debe realizar las siguientes modificaciones en la definición de objeto de negocio de petición:

  1. Añada un atributo a la definición de objeto de negocio de petición que mantenga el metaobjeto hijo dinámico.

    El tipo de atributo de este atributo es la definición de objeto de negocio del metaobjeto dinámico (consulte el apartado Creación del metaobjeto dinámico JMS).

  2. Añada el distintivo cw_mo_conn a la información específica de la aplicación de nivel de objeto de negocio de la definición de objeto de negocio de petición para identificar el atributo que contiene el metaobjeto dinámico.

    El distintivo cw_mo_conn tiene el siguiente formato:

    cw_mo_conn=dynamicMetaObjAttr
     

    donde dynamicMetaObjAttr es el nombre del atributo en el objeto de negocio de petición que mantiene el metaobjeto dinámico.

Por ejemplo, en la Figura 22, se ha añadido un atributo denominado JMSDynMO a la definición de objeto de negocio de petición, WBIC_JMSRequest_BusObj . Este atributo contiene el metaobjeto dinámico, que es un objeto de negocio hijo del tipo JMSDynMO_BusObj. Asimismo, la información específica de la aplicación del objeto de negocio de petición se ha modificado para incluir el siguiente distintivo cw_mo_conn que identifica este metaobjeto dinámico:

cw_mo_conn=JMSDynMO
 

Copyright IBM Corp. 1997, 2004