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:
| 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 |
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:
Tal como se ha descrito en el apartado Objeto de negocio del documento, debe crear un atributo para cada elemento de información de carga que necesite transferir.
Si desea obtener más información sobre estos pasos, consulte el apartado 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.
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:
Cada uno de estos pasos se describe en los apartados siguientes.
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:
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.
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.
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 |
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
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:
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.
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:
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).
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