WebSphere Business Integration Connect puede enviar y recibir documentos con WebSphere InterChange Server (ICS) versión 4.2.2 mediante el protocolo de transporte HTTP.
Notas:
En este apartado se proporciona la siguiente información sobre cómo configurar InterChange Server v4.2.2 y los componentes compatibles con ICS correspondientes para utilizarlos con Business Integration Connect mediante HTTP:
Para que Business Integration Connect pueda comunicarse con InterChange
Server v4.2.2 utilizando el protocolo de transporte HTTP, es
necesario que estos dos componentes estén configurados. En la Tabla 60 se resumen estos pasos de configuración.
Tabla 60. Configuración de Business Integration Connect e InterChange Server
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 HTTP Configuración de documentos entrantes mediante el protocolo de transporte HTTP
|
WebSphere InterChange Server | 4.2.2 | Creación de artefactos de ICS v4.2.2 para HTTP |
Asimismo, para enviar o recibir un documento entre Business Integration
Connect e InterChange Server v4.2.2 utilizando el protocolo de
transporte HTTP, se utilizan los componentes compatibles con ICS que se
enumeran en la Tabla 61.
En los siguientes apartados se describe cómo trabajan conjuntamente los componentes de la Tabla 61 para enviar y recibir documentos entre Business Integration Connect e InterChange Server v4.2.2 mediante el protocolo de transporte HTTP.
Para que Business Integration Connect pueda enviar un documento a InterChange Server v4.2.2 utilizando el protocolo de transporte HTTP, se utiliza el adaptador de HTTP para recuperar el documento que ha enviado Business Integration Connect como una corriente de datos HTTP. A continuación, el adaptador direcciona el documento a InterChange Server. En la Figura 16 se proporciona una visión general de cómo envía Business Integration Connect documentos a InterChange Server v4.2.2 mediante el protocolo de transporte HTTP.
Para que Business Integration Connect pueda recibir un documento de InterChange Server v4.2.2 utilizando el protocolo de transporte HTTP, se utiliza el adaptador de HTTP, que envía el mensaje que recibe de InterChange Server como una corriente de datos HTTP para que Business Integration Connect pueda recuperarlo. En la Figura 17 se proporciona una visión general de cómo recibe Business Integration Connect documentos de InterChange Server v4.2.2 mediante el protocolo de transporte HTTP.
Como el envío y la recepción de los documentos de InterChange Server implica el uso de componentes compatibles con ICS, debe realizar las tareas de configuración del Adaptador de HTTP. Si desea obtener más información sobre cómo configurar Business Integration Connect para su uso con InterChange Server mediante HTTP, consulte el apartado Configuración de Business Integration Connect para InterChange Server.
El adaptador de HTTP es el componente compatible con ICS que permite a Business Integration Connect intercambiar documentos con InterChange Server v4.2.2 en forma de mensajes HTTP. Da soporte a las siguientes interacciones con InterChange Server:
Cuando haya configurado el adaptador de HTTP para comunicarse con InterChange Server, siga los pasos de estos apartados para configurar este adaptador para que escuche mensajes HTTP de Business Integration Connect:
Como se muestra en la Figura 17, el adaptador de HTTP utiliza un manejador de datos para convertir los objetos de negocio que recibe de InterChange Server en las corrientes de datos HTTP correspondientes.
Para indicar qué manejador de datos desea utilizar para convertir la carga, siga los pasos que se enumeran en el apartado Conversión de objetos de negocio. Asimismo, debe configurar el adaptador de HTTP para que utilice este manejador de datos de carga. Puede establecer el manejador de datos de carga de las formas siguientes:
El adaptador de HTTP utiliza la propiedad de configuración del conector JavaProtocolHandlerPackages para identificar el nombre de los paquetes de manejador de protocolo Java. Para la integración con Business Integration Connect, compruebe que la propiedad JavaProtocolHandlerPackage esté establecida en el valor por omisión:
com.ibm.net.ssl.internal.www.protocol
El adaptador de HTTP da soporte a propiedades de configuración jerárquicas para obtener la información que necesita para configurar los receptores de protocolo. La propiedad de configuración de nivel superior se denomina ProtocolListenerFramework. En esta propiedad de nivel superior hay varios niveles de subpropiedades. Para configurar los manejadores de protocolo para su utilización con el adaptador de HTTP, asegúrese de que las propiedades estén configuradas en la propiedad ProtocolListener, tal como se describe en los pasos siguientes:
ProtocolListenerFramework ProtocolListeners HttpListener1
Para configurar el receptor de protocolo, establezca las subpropiedades que
se enumeran en la Tabla 62.
Tabla 62. Configuración del receptor de protocolo
Propiedad | Descripción | Valor |
---|---|---|
Protocol |
Tipo de receptor de protocolo:
|
http o https
|
Host | Dirección IP en la que escucha el receptor de protocolo | Dirección IP de la máquina local en la que se ejecuta WebSphere Business Integration Connect |
Port | Puerto en el que el receptor de protocolo escucha las peticiones | 8080 |
ProtocolListenerFramework ProtocolListeners HttpListener1 URLsConfiguration URL1
Establezca la propiedad ContextPath en el URI de las peticiones HTTP que recibe el receptor de protocolo.
ProtocolListenerFramework ProtocolListeners HttpListener1 URLsConfiguration URL1 TransformationRules TransformationRule1
Para configurar la transformación de accesorios del receptor de protocolo,
establezca las subpropiedades que se enumeran en la Tabla 63. Necesita una norma de transformación para cada
instancia del manejador de datos de accesorios que esté utilizando. Si
desea obtener más información sobre el manejador de datos de accesorios,
consulte el apartado Manejo de documentos con accesorios.
Tabla 63. Configuración de la transformación de accesorios del receptor de protocolo
Propiedad | Descripción | Valor |
---|---|---|
ContentType | Tipo de contenido de los datos que se van a transformar con un manejador de datos | Tipo de contenido asociado con los datos de accesorios |
MimeType | Tipo MIME que se utiliza para identificar el manejador de datos que se debe invocar | Tipo MIME asociado con la instancia del manejador de datos de accesorios |
Charset | Juego de caracteres que se utiliza cuando se transforman los datos del tipo de contenido especificado | Juego de caracteres de los datos de accesorios |
Si desea obtener más información sobre estas propiedades, consulte Adapter for HTTP User Guide.
El adaptador de HTTP envía y recibe el documento en InterChange Server en forma de un objeto de negocio de carga. El adaptador de HTTP 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 64 para representar la estructura del objeto de negocio de
carga que espera el adaptador de HTTP.
Tabla 64. Definiciones de objetos de negocio para el adaptador de HTTP
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 ICS v4.2.2 mediante HTTP |
Si utiliza el empaquetado de integración de programas de fondo para el mensaje |
Añada al objeto de negocio de carga los objetos de negocio que deben mantener la información de cabecera del mensaje:
| Creación de información de cabecera de nivel de transporte HTTP para ICS v4.2.2. |
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 El adaptador de HTTP espera una estructura del objeto de negocio formada por los siguientes objetos de negocio:
En la Figura 18 se muestra una estructura del objeto de negocio de ejemplo para la definición de objeto de negocio de carga que se utiliza con InterChange Server v4.2.2 mediante el protocolo de transporte HTTP.
Figura 18. Estructura del objeto de negocio del objeto de negocio de carga HTTP para ICS v4.2.2
El objeto de negocio de nivel superior es una envoltura de los objetos de negocio de petición y respuesta. Debe crear una definición de objeto de negocio para este objeto de negocio. En la Tabla 57 se resumen los atributos de la definición de objeto de negocio de nivel superior.
Tabla 65. Atributos del objeto de negocio de nivel superior
Atributo | Tipo de atributo | Descripción |
---|---|---|
MimeType | Serie |
Define el tipo de contenido y el formato de los datos que se pasan al
URL.
|
Charset | Serie |
Se utiliza para determinar a qué manejador de datos se debe llamar.
|
Request | Objeto de negocio | Objeto de negocio hijo que representa el mensaje de petición. El objetivo de este objeto de negocio depende de si participa en el proceso de peticiones o en la notificación de eventos. Si desea obtener más información sobre la estructura de este objeto de negocio, consulte el apartado Objeto de negocio de petición. |
Response | Objeto de negocio | Objeto de negocio hijo que representa el mensaje de respuesta (si espera una respuesta). El objetivo de este objeto de negocio depende de si participa en el proceso de peticiones o en la notificación de eventos. Si desea obtener más información sobre la estructura de este objeto de negocio, consulte el apartado Objeto de negocio de respuesta. |
En la Tabla 66 se resume la información específica de la aplicación que
puede incluir la definición de objeto de negocio de nivel superior.
Información específica de la aplicación | Distintivo | Descripción |
---|---|---|
Nivel de objeto de negocio | ws_mode | Define si la interacción es sincrónica o asíncrona |
Nivel de atributo | ws_botype | Define qué atributo contiene el objeto de negocio de petición o respuesta |
Si desea ver una descripción completa de la estructura del objeto de negocio de nivel superior y la información específica de la aplicación, consulte Adapter for HTTP User Guide.
El objeto de negocio de petición contiene los datos que se pasan al URL. Representa el mensaje de petición HTTP. El objetivo de este objeto de negocio de petición depende de la tarea de InterChange Server en la que esté participando, según se especifica a continuación:
Si desea ver una descripción básica de la estructura del objeto de negocio de petición, consulte Adapter for HTTP User Guide. Para Business Integration Connect, existen dos personalizaciones que debe realizar en la estructura de la definición de objeto de negocio de petición:
Este atributo proporciona información de configuración para las cabeceras de nivel de transporte del mensaje. Si desea obtener más información, consulte el apartado Creación de información de cabecera de nivel de transporte HTTP para ICS v4.2.2.
Distintivo de información específica de la aplicación | Descripción | ¿Obligatorio? |
---|---|---|
ws_tloname | Proporciona el nombre del objeto de negocio de nivel superior | Sólo es necesario si la definición de objeto de negocio participa en la notificación de eventos |
cw_mo_http | Especifica el metaobjeto de configuración de protocolo HTTP, que contiene los campos de cabecera de nivel de transporte HTTP. Si desea obtener más información, consulte el apartado Creación de información de cabecera de nivel de transporte HTTP para ICS v4.2.2. | Sólo es necesario si utiliza el empaquetado de integración de programas de fondo |
El objeto de negocio de respuesta contiene los datos que se reciben del URL. Contiene atributos para cada uno de los distintivos XML del mensaje de respuesta. El objetivo de este objeto de negocio de respuesta depende de la tarea de InterChange Server en la que esté participando, según se especifica a continuación:
Independientemente de si la respuesta forma parte de la notificación de eventos o del proceso de peticiones, sólo se envía un objeto de negocio de respuesta si el intercambio entre Business Integration Connect e InterChange Server es sincrónico y se espera una respuesta de empresa como respuesta a la petición.
Si desea ver una descripción básica de la estructura del objeto de negocio de error, consulte Adapter for HTTP User Guide. Para Business Integration Connect, debe realizar algunas personalizaciones en la estructura de la definición de objeto de negocio de petición:
Este atributo proporciona información de configuración para las cabeceras de nivel de transporte del mensaje. Si desea obtener más información, consulte el apartado Creación de información de cabecera de nivel de transporte HTTP para ICS v4.2.2.
Este distintivo tiene la siguiente sintaxis:
ws_botype=response
Si no se especifica este distintivo, el manejador de datos de envoltura utiliza el metaobjeto hijo indicado por el atributo wbic_response_mime (en el objeto de negocio de nivel superior) para determinar el manejador de datos que se debe utilizar en la respuesta.
Si el intercambio entre Business Integration Connect e InterChange Server es asíncrona, Business Integration Connect no espera una respuesta, por lo que no es necesario crear un objeto de negocio de respuesta.
Si envía los documentos con el empaquetado de integración de programas de fondo mediante el protocolo de transporte HTTP, el objeto de negocio de petición debe contener información de cabecera de nivel de transporte personalizada. El adaptador de HTTP espera que esta información de cabecera personalizada esté en un metaobjeto dinámico.
En la Figura 19 se muestra la estructura del objeto de negocio de un objeto de negocio de petición que representa un documento de Business Integration Connect con empaquetado de integración de programas de fondo mediante el protocolo de transporte HTTP.
Siga estos pasos para asegurarse de que la estructura del objeto de negocio incluye un metaobjeto de configuración de protocolo HTTP:
Cada uno de estos pasos se describe en los apartados siguientes.
El adaptador de HTTP da soporte a un objeto de negocio de propiedades definidas por el usuario para mantener propiedades personalizadas en el metaobjeto de configuración de protocolo HTTP. Business Integration Connect utiliza este objeto de negocio para mantener las propiedades HTTP que necesita el empaquetado de integración de programas de fondo. También puede contener el atributo Content-Type, 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 definidas por el usuario para los campos de cabecera HTTP, siga estos pasos:
Todos los atributos deben tener un tipo de atributo String. Puede denominar al atributo con el nombre exacto de la propiedad HTTP (tal como se especifica en la columna Campo de cabecera de la Tabla 4).
Esta información específica de la aplicación de nivel de atributo tiene el siguiente formato:
ws_prop_name=HTTPproperty
donde HTTPproperty es uno de los valores de la columna Campo de cabecera de la Tabla 4.
En la Figura 19, la definición de objeto de negocio HttpProps_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:
ws_prop_name=x-aux-sender-id
Para la notificación de eventos, el objeto de negocio de petición, respuesta o error puede contener un metaobjeto dinámico denominado metaobjeto de configuración de protocolo HTTP para mantener información de configuración (por ejemplo, información de cabecera).
Si desea ver una descripción básica de la estructura del objeto de negocio de configuración de protocolo HTTP, consulte Adapter for HTTP User Guide. Para Business Integration Connect, debe realizar las siguientes personalizaciones en la estructura de la definición de objeto de negocio de configuración de protocolo HTTP:
Todos los atributos deben tener un tipo de atributo String.
El tipo de atributo de este atributo es la definición de objeto de negocio del objeto de negocio de propiedades definidas por el usuario (consulte el apartado Creación del objeto de negocio de propiedades definidas por el usuario).
Por ejemplo, en la Figura 19, la definición de objeto de negocio HttpConfigMO_BusObj contiene el atributo UserDefinedProperties, cuyo tipo de atributo es HttpProps_BusObj.
La definición de objeto de negocio de petición representa la información que se solicita a Business Integration Connect. Si desea obtener información sobre cómo crear el objeto de negocio de petición, consulte el apartado Objeto de negocio de petición.Para incorporar el metaobjeto dinámico a la estructura de objeto de negocio de carga, 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 de configuración de protocolo HTTP (consulte el apartado Creación del metaobjeto de configuración de protocolo HTTP).
El distintivo cw_mo_http tiene el siguiente formato:
cw_mo_http=HttpConfigMetaObjAttr
donde HttpConfigMetaObjAttr es el nombre del atributo en el objeto de negocio de petición que mantiene el metaobjeto de configuración de protocolo HTTP.
Por ejemplo, en la Figura 19, se ha añadido un atributo denominado HttpConfigMO a la definición de objeto de negocio de petición, WBIC_HttpRequest_BusObj . Este atributo contiene el metaobjeto dinámico, que es un objeto de negocio hijo del tipo HttpConfigMO_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_http que identifica este metaobjeto dinámico:
cw_mo_http=HttpConfigMO
Para configurar InterChange Server v4.2.2 para la
comunicación con Business Integration Connect mediante el protocolo de
transporte HTTP, debe crear los artefactos de InterChange Server que se
muestran en la Tabla 68.
Tabla 68. Artefactos para comunicarse con ICS v4.2.2 mediante el protocolo de transporte HTTP
Artefacto de ICS | Objetivo | Si desea obtener más información |
---|---|---|
Definiciones de objeto de negocio | Representa el documento | Creación de definiciones de objetos de negocio para ICS v4.2.2 mediante HTTP |
Objeto de conector | Representa el adaptador de HTTP durante la ejecución | Creación del objeto de conector HTTP |
Plantilla de colaboración y objeto de colaboración | Representa el proceso de empresa que utiliza InterChange Server para procesar el documento | Enlace de colaboraciones para comunicarse con el adaptador de HTTP |
Para obtener una instancia del adaptador de HTTP durante la ejecución, siga estos pasos en el gestor de sistemas:
Si desea obtener más información sobre cómo configurar el adaptador de HTTP para utilizarlo con Business Integration Connect, consulte el apartado Configuración del entorno para el transporte HTTP con ICS v4.2.2.
Tal como se ha descrito en el apartado Creación de las colaboraciones, debe existir un objeto de colaboración durante la ejecución de InterChange Server para saber dónde se reciben y se envían los objetos de negocio. Cuando se crea el objeto de colaboración de la colaboración que utiliza el adaptador de HTTP para enviar información y recibirla de Business Integration Connect, los puertos de colaboración se enlazan de la siguiente manera: