Utilización del protocolo de transporte HTTP con ICS v4.2.2

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:

  1. Para enviar y recibir documentos entre WebSphere Business Integration Connect y WebSphere InterChange Server anterior a 4.2.2 mediante el protocolo de transporte HTTP, consulte el apartado Utilización del protocolo de transporte HTTP con ICS anterior a 4.2.2.

  2. Si intercambia documentos SOAP mediante el protocolo de transporte HTTP, consulte el apartado Envío de documentos SOAP mediante HTTP/S.

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:

Componentes necesarios para los documentos en ICS v4.2.2 mediante el transporte 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.

Tabla 61. Componentes necesarios para transferir documentos con InterChange Server v4.2.2 mediante HTTP
Componente Descripción Notas y restricciones

WebSphere Business Integration Adapter para HTTP

(Adaptador de HTTP)

Este adaptador permite a InterChange Server intercambiar objetos de negocio con aplicaciones que envíen o reciban datos en forma de corrientes de datos HTTP.

Este adaptador no se puede utilizar con WebSphere InterChange Server anterior a v4.2.2.

Un manejador de datos de carga Este manejador de datos convierte la carga del documento entre el formato del documento (normalmente XML) y la representación de objeto de negocio. Este manejador de datos es necesario y debe dar soporte al tipo MIME del documento de carga.
Manejador de datos de accesorios

Este manejador de datos maneja los documentos accesorios del mensaje del documento.

Este manejador de datos sólo es necesario si los documentos incluyen accesorios.

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.

Envío de documentos a ICS v4.2.2 mediante 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.

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


Recepción de documentos de ICS v4.2.2 mediante 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.

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


Configuración del entorno para el transporte HTTP con ICS v4.2.2

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:

Importante:
WebSphere Business Integration Connect no incluye WebSphere Business Integration Adaptador de HTTP. Este producto se debe obtener por separado y se instala de acuerdo con las instrucciones que se describen en Adapter for HTTP User Guide. 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.

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:

Especificación del manejador de datos de carga

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.

Nota:
El manejador de datos al que llama el adaptador de HTTP convierte al carga del documento. Si el documento se envuelve en un sobre de transporte XML (contiene accesorios, o el distintivo de sobre es Sí), configure el manejador de datos de accesorios como el manejador de datos de carga. Si desea obtener más información, consulte el apartado Manejo de documentos con accesorios.

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:

Configuración del nombre de paquete del manejador de protocolo

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
 

Configuración del receptor de protocolo HTTP

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:

  1. Configure un receptor de protocolo con subpropiedades debajo de la siguiente propiedad de configuración:
    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
    • HTTPS

    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

  2. Configure las configuraciones de URL que soporta el receptor de protocolo con subpropiedades debajo de la siguiente propiedad de configuración:
    ProtocolListenerFramework
        ProtocolListeners
           HttpListener1
              URLsConfiguration
                 URL1
     

    Establezca la propiedad ContextPath en el URI de las peticiones HTTP que recibe el receptor de protocolo.

    Nota:
    Este directorio debe ser el mismo que especifica la pasarela de Business Integration Connect como su URI de destino. Si desea obtener más información, consulte el apartado Configuración de documentos salientes mediante el protocolo de transporte HTTP.
  3. Si el documento contiene accesorios, debe configurar una transformación para el receptor de protocolo estableciendo las subpropiedades de la siguiente propiedad de configuración:
    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.

Creación de definiciones de objetos de negocio para ICS v4.2.2 mediante HTTP

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:

  • Objeto de negocio de nivel superior
  • Objeto de negocio de petición
  • Objeto de negocio de respuesta (opcional)
  • Objeto de negocio de error (opcional)

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:

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

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

Creación de la estructura del objeto de negocio de carga para ICS v4.2.2 mediante HTTP

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.

Nota:
Si desea ver una descripción detallada de esta estructura del objeto de negocio, consulte Adapter for HTTP User Guide.

Figura 18. Estructura del objeto de negocio del objeto de negocio de carga HTTP para ICS v4.2.2


Objeto de negocio de nivel superior

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.

Nota:
Cuando se utiliza el adaptador de HTTP con Business Integration Connect, no es necesario incluir objetos de negocio de error en el objeto de negocio de nivel superior.

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.

Tabla 66. Información específica de la aplicación de 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.

Objeto de negocio de petición

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:

Nota:
El objeto de negocio de nivel superior identifica los objetos de negocio hijo como los objetos de negocio de petición y respuesta. No obstante, esta estructura se utiliza tanto en el proceso de peticiones como en la notificación de eventos.

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:


Tabla 67. Distintivos en la información específica de la aplicación del objeto de negocio de petición
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

Nota:
Si utiliza el manejador de datos de accesorios para procesar documentos envueltos en un sobre de transporte XML, debe modificar el objeto de negocio de petición para que mantenga los accesorios, tal como se describe en el apartado Creación de definiciones de objetos de negocio relacionadas con los accesorios.

Objeto de negocio de respuesta

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:

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.

Creación de información de cabecera de nivel de transporte HTTP para ICS v4.2.2

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.

Figura 19. Relación del objeto de negocio de petición con el metaobjeto de configuración de protocolo HTTP


Siga estos pasos para asegurarse de que la estructura del objeto de negocio incluye un metaobjeto de configuración de protocolo HTTP:

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

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

Creación del objeto de negocio de propiedades definidas por el usuario

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:

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

    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).

  2. Para cada uno de los atributos del objeto de negocio de propiedades HTTP, 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 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
 

Creación del metaobjeto de configuración de protocolo HTTP

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:

  1. Cree un atributo dentro de la definición de objeto de negocio para cada uno de los campos que necesite.

    Todos los atributos deben tener un tipo de atributo String.

    Nota:
    Si desea ver una lista completa de los atributos del metaobjeto de configuración de protocolo HTTP, consulte Adapter for HTTP User Guide.
  2. Añada el atributo UserDefinedProperties a esta definición de objeto de negocio.

    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.

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

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:

  1. Añada un atributo a la definición de objeto de negocio de petición que mantenga el metaobjeto de configuración de protocolo HTTP.

    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).

  2. Añada el distintivo cw_mo_http 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 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
 

Creación de artefactos de ICS v4.2.2 para HTTP

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

Creación del objeto de conector HTTP

Para obtener una instancia del adaptador de HTTP durante la ejecución, siga estos pasos en el gestor de sistemas:

  1. Cree los objetos de conector:
  2. Configure los objetos de conector.

    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.

Enlace de colaboraciones para comunicarse con el adaptador de HTTP

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:

Copyright IBM Corp. 1997, 2004