Utilización del protocolo de transporte HTTP con ICS anterior a 4.2.2

WebSphere Business Integration Connect puede enviar y recibir documentos con una versión anterior a 4.2.2 de WebSphere InterChange Server (ICS) mediante el protocolo de transporte HTTP.

Notas:

  1. Para enviar y recibir documentos entre WebSphere Business Integration Connect e InterChange Server Versión 4.2.2 mediante el protocolo de transporte HTTP, consulte el apartado Utilización del protocolo de transporte HTTP con ICS v4.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 una versión anterior a 4.2.2 de InterChange Server y los componentes compatibles con ICS correspondientes para utilizarlos con Business Integration Connect mediante HTTP:

Envío de documentos a ICS anterior a 4.2.2 mediante HTTP

En este apartado se incluye la siguiente información sobre cómo enviar documentos de Business Integration Connect a ICS anterior a 4.2.2 mediante el protocolo de transporte HTTP:

El documento que Business Integration Connect envía a InterChange Server inicia la notificación de eventos dentro de InterChange Server.

Componentes necesarios para el envío

Business Integration Connect puede enviar documentos a las siguientes versiones anteriores a 4.2.2 de InterChange Server mediante el protocolo de transporte HTTP:

Para que Business Integration Connect pueda enviar un documento a ICS anterior a 4.2.2 utilizando el protocolo de transporte HTTP, es necesario que estos dos componentes estén configurados. En la Tabla 45 se resumen estos pasos de configuración.

Tabla 45. 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.1.1, 4.2.0, 4.2.1 Creación de artefactos de ICS anterior a 4.2.2 para HTTP

Asimismo, para enviar un documento a ICS mediante el transporte HTTP, utilice los componentes compatibles con ICS que se enumeran en la Tabla 46. La mayoría de estos componentes se proporcionan como parte del release de Business Integration Connect.

Tabla 46. Componentes necesarios para enviar documentos a ICS anterior a 4.2.2 mediante HTTP
Componente Descripción Notas y restricciones
Servlet de WebSphere Business Integration Connect (Servlet de Connect)

Este servlet es un cliente de acceso de WebSphere InterChange Server. Un cliente de acceso es un proceso que es externo a InterChange Server (ICS) y que puede solicitar la ejecución de una colaboración dentro de ICS.

El servlet se puede utilizar con las versiones anteriores a 4.2.2 de WebSphere InterChange Server.

Nota:
El servlet no se puede utilizar con la versión 4.2.2 WebSphere InterChange Server.
Manejador de datos de envoltura

El servlet de Connect llama a este manejador de datos para convertir el mensaje HTTP en el objeto de negocio de datos correspondiente. Invoca el manejador de datos adecuado para el mensaje. Por ejemplo, si la carga tiene formato XML, el manejador de datos de envoltura se puede configurar para llamar al manejador de datos de XML.

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

Nota:
Todos los componentes de la Tabla 46 se incluyen en el soporte de instalación de Business Integration Connect. Si desea obtener más información sobre la ubicación de estos componentes, consulte el apartado Despliegue del servlet de Connect.

En la Figura 9 se proporciona una visión general de cómo envía Business Integration Connect documentos a ICS anterior a 4.2.2 mediante el protocolo de transporte HTTP.

Nota:
El manejador de datos de envoltura, el manejador de datos de accesorios y el manejador de datos de carga se ejecutan todos en InterChange Server.

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


Como se muestra en la Figura 9, el servlet de WebSphere Business Integration Connect es el componente compatible con ICS con el que interactúa directamente Business Integration Connect. Este servlet de Connect es un cliente de acceso, que es un proceso externo a InterChange Server que puede solicitar la ejecución de una colaboración de ICS. El cliente de acceso emite llamadas desde una interfaz de programas de aplicación (API) denominada Server Access Interface para interactuar con ICS. WebSphere InterChange Server Access, que es el componente dentro de ICS que maneja las interacciones con los clientes de acceso, recibe e interpreta estas llamadas. Server Access Interface invoca las colaboraciones de forma sincrónica.

Notas:

  1. Aunque algunas interacciones entre Business Integration Connect y los sistemas de programa de fondo son asíncronas, Server Access invoca la colaboración de forma sincrónica y espera hasta que haya terminado la ejecución de la colaboración.

  2. Si desea obtener información más detallada sobre los clientes de acceso y Server Access, consulte Access Development Guide en el conjunto de la documentación de WebSphere InterChange Server.

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 ICS mediante el protocolo de transporte HTTP:

  1. Business Integration Connect invoca el servlet de WebSphere Business Integration Connect para enviar el documento a InterChange Server.

    Business Integration Connect envía el documento al URL especificado como pasarela de destino.

    Nota:
    El servlet de Connect se puede utilizar para invocar varias colaboraciones.
  2. El servlet de Connect crea una serie Java a partir del mensaje de petición HTTP que envía Business Integration Connect.

    El mensaje de petición HTTP contiene dos partes:

  3. El servlet de Connect consulta el archivo de propiedades del servlet para determinar las colaboraciones que debe invocar, junto con el tipo MIME y el verbo que se debe utilizar.

    Cada URL se corresponde con una colaboración que se va a invocar. (Consulte el apartado Configuración del servlet de Connect para obtener más información).

  4. El servlet de Connect envía la serie Java, junto con la información del archivo de propiedades del servlet, a WebSphere InterChange Server Access utilizando llamadas en Server Access Interface.

    Como el servlet de Connect sólo puede enviar un documento a InterChange Server (no puede recibir un documento), sólo puede participar en la notificación de eventos con InterChange Server.

    Nota:
    Para dar soporte al proceso de peticiones con InterChange Server, Business Integration Connect debe interactuar con WebSphere Business Integration Adapter para XML. Si desea obtener más información, consulte el apartado Recepción de documentos de ICS anterior a 4.2.2 mediante HTTP.
  5. WebSphere InterChange Server Access, dentro de InterChange Server, recibe la serie Java e invoca el manejador de datos de envoltura.

    El trabajo del manejador de datos de envoltura es convertir la serie Java en la estructura del objeto de negocio correspondiente. InterChange Server espera objetos de negocio como entrada.

  6. El manejador de datos de envoltura realiza el paso siguiente para convertir la serie Java en la estructura del objeto de negocio correspondiente:
    1. Extrae las cabeceras y la carga de la serie Java.
      Nota:
      Si el documento que ha enviado Business Integration Connect incluye accesorios, el manejador de datos de envoltura se puede configurar para llamar al manejador de datos de accesorios. Las acciones del manejador de datos de accesorios se describen en el apartado Manejo de documentos con accesorios.
    2. Comprueba el tipo MIME de la carga y llama al manejador de datos que se ha configurado para ese tipo MIME para convertir la carga en un objeto de negocio de carga.
    3. Crea el objeto de negocio de propiedades HTTP y el objeto de negocio dinámico.

      Establece las cabeceras HTTP en el objeto de negocio de propiedades HTTP, que es hijo del metaobjeto dinámico de este objeto de negocio de carga.

    4. Crea el objeto de negocio de nivel superior y establece el objeto de negocio de eventos como su objeto de negocio de petición.

      El manejador de datos de envoltura espera que el objeto de negocio de carga tenga una estructura jerárquica. Si desea obtener más información sobre la estructura de este objeto de negocio de carga, consulte el apartado Creación de definiciones de objetos de negocio para enviar documentos.

    5. Devuelve el objeto de negocio de nivel superior al Server Access dentro de InterChange Server.
  7. Server Access invoca la colaboración, pasándole el objeto de negocio de nivel superior.

    Asegúrese de que el puerto de colaboración del objeto de colaboración que va a invocar esté configurado como puerto externo. Consulte la documentación de WebSphere InterChange Server para obtener más información sobre cómo configurar los puertos.

  8. La colaboración se ejecuta y devuelve el objeto de negocio de nivel superior al manejador de datos de envoltura.

    Que se rellene el objeto de negocio de respuesta (dentro del objeto de negocio de nivel superior) dependerá del tipo de interacción entre InterChange Server y Business Integration Connect, según se especifica a continuación:

    Si desea obtener más información, consulte el apartado Objeto de negocio de respuesta.

  9. Si la interacción es satisfactoria, el servlet de Connect devuelve una confirmación de recibo HTTP 200 OK a Business Integration Connect.

Configuración del servlet de Connect

El servlet de WebSphere Business Integration Connect es un cliente de acceso, esto es, un proceso externo a InterChange Server que puede solicitar la ejecución de una colaboración dentro de InterChange Server. El cliente de acceso utiliza llamadas desde una interfaz de programas de aplicación (API) denominada Server Access Interface para interactuar con ICS. WebSphere InterChange Server Access, que es el componente de InterChange Server que maneja las interacciones con los clientes de acceso, recibe e interpreta estas llamadas.

Nota:
Si desea obtener información más detallada sobre los clientes de acceso y Server Access, consulte Access Development Guide en el conjunto de la documentación de WebSphere InterChange Server.

La configuración del servlet de Connect incluye los siguientes pasos:

Despliegue del servlet de Connect

El servlet de Connect, el manejador de datos de envoltura y el archivo de depósito del manejador de datos de envoltura están disponibles en el soporte de instalación de Business Integration Connect, en las ubicaciones que se especifican en la Tabla 47.

Tabla 47. Ubicación de los componentes del servlet de Connect
Componente Ubicación
Servlet de Connect Integration/WBI/WICS/WBICServlet/ bcgwbiservlet.war
Manejador de datos de envoltura Integration/WBI/WICS/WBICServlet/ bcgwbiwrapperdh.jar
Archivo de depósito del manejador de datos de envoltura Integration/WBI/WICS/WBICServlet MO_DataHandler_WBIWrapper.in

Nota:
Si tiene previsto enviar documentos que incluyan accesorios, también puede desplegar el manejador de datos de accesorios y su archivo de depósito asociado, tal como se describe en el apartado Despliegue del manejador de datos de accesorios.

Este servlet se puede conectar a WebSphere InterChange Server versiones 4.1.1, 4.2.0 y 4.2.1. Se puede desplegar en aquellas plataformas en las que esté soportada alguna de estas versiones de InterChange Server. Asimismo, debe asegurarse de que Server Access Interface esté soportada en la plataforma. Consulte la documentación de WebSphere InterChange Server para ver una lista de las plataformas en las que está soportada la versión de ICS que está utilizando.

Siga estos pasos para desplegar los componentes de la Tabla 47:

  1. Despliegue el servlet de Connect y los archivos asociados en el servidor web de acuerdo con la documentación del servidor web.
  2. Compruebe que los siguientes archivos estén en la CLASSPATH del servlet de Connect:

    Estos archivos se pueden encontrar en el subdirectorio lib del directorio del producto InterChange Server.

    Notas:

    1. Estos archivos deben tener la misma versión que el InterChange Server que se va a invocar.

    2. Estos archivos deben estar disponibles en el contenedor web del servlet de Connect del servidor web. Si desea obtener más información sobre cómo hacer que los archivos estén disponibles en un contenedor web, consulte la documentación del servidor web.
  3. Compruebe que los siguientes archivos estén en la CLASSPATH del servlet de Connect:

    Estos archivos se pueden encontrar en el soporte de instalación de Business Integration Connect, en el siguiente directorio:

    integration/wbi/wics/http/lib/thirdparty
     

    Nota:
    Estos archivos deben estar disponibles en el contenedor web del servlet de Connect del servidor web. Si desea obtener más información sobre cómo hacer que los archivos estén disponibles en un contenedor web, consulte la documentación del servidor web.
  4. El archivo de referencia de objeto interoperable (.ior) de InterChange Server debe estar disponible en la máquina en la que se despliegue el servlet de Connect.

    Si el servlet de Connect está en una máquina distinta de InterChange Server, puede realizar una de las acciones siguientes para que el archivo .ior esté disponible:

    Nota:
    También deberá actualizar la propiedad ICS_IORFILE en el archivo de propiedades del servlet de Connect con la ubicación de este archivo .ior. Si desea obtener más información, consulte el apartado Identificación de la instancia de InterChange Server.

Establecimiento de las propiedades del servlet de Connect

Como se ha explicado en el apartado Envío de documentos a ICS anterior a 4.2.2 mediante HTTP, el archivo de propiedades del servlet contiene información como, por ejemplo, el verbo y el nombre de puerto, que el servlet de WebSphere Business Integration Connect necesita para invocar una colaboración. Debe crear este archivo de propiedades del servlet, especificando información general sobre WebSphere InterChange Server. Posteriormente, si desea que el servlet invoque alguna colaboración, deberá proporcionar información sobre la colaboración.

En este apartado se proporciona la siguiente información sobre cómo establecer las propiedades del servlet de Connect:

Creación del archivo de propiedades del servlet

Un archivo de propiedades del servlet contiene las secciones que se enumeran en la Tabla 48.

Tabla 48. Secciones del archivo de propiedades del servlet
Sección del archivo de propiedades del servlet Descripción Si desea obtener más información
Información general Propiedades para identificar la instancia de InterChange Server Identificación de la instancia de InterChange Server
Información de colaboración Propiedades para identificar cada una de las colaboraciones que se van a invocar Identificación de las colaboraciones que se van a invocar
Información de registro cronológico Propiedades para configurar el registro cronológico del servlet Especificación de la ubicación del archivo de registro del servlet

Identificación de la instancia de InterChange Server  La primera sección del archivo de propiedades del servlet de Connect contiene información general para identificar la instancia de InterChange Server con la que se comunica Business Integration Connect. Esta instancia de ICS contiene la colaboración (o las colaboraciones) que tiene que invocar Business Integration Connect. En la Tabla 49 se muestran las propiedades generales del archivo de propiedades del servlet.

Tabla 49. Propiedades generales del archivo de propiedades del servlet
Nombre de propiedad Descripción Ejemplo
ICS_SERVERNAME La máquina de sistema principal donde se ejecuta WebSphere InterChange Server. Server1
ICS_VERSION El número de versión de WebSphere InterChange Server. Los valores posibles son 4.1.1, 4.2.0 y 4.2.1. 4.2.0
ICS_IORFILE

El nombre de archivo del archivo de referencia de objeto interoperable (.ior), que se utiliza para acceder a WebSphere InterChange Server Access. En el ejemplo se muestra cómo se debe especificar la vía de acceso en un sistema Windows.

Nota:
Esta vía de acceso se debe especificar en una línea.
c:/myiorlocation/
Server1ICS.ior
ICS_USERNAME El ID de usuario para conectarse a WebSphere InterChange Server. admin
ICS_PASSWORD La contraseña para conectarse a WebSphere InterChange Server. null
ICS_ENCRYPTED_PASSWORD Una indicación de si se ha cifrado ICS_PASSWORD. El servlet establece este campo como true si la contraseña está cifrada. false
ICS_DISABLEENCRYPTION Una indicación de si el cifrado de la contraseña está inhabilitado (true) o habilitado (false). Establezca este campo como false si desea permitir que se cifren las contraseñas. true

Nota:
Si desea ver un archivo de propiedades del servlet de ejemplo que define los valores de la columna Ejemplo de Tabla 49, consulte la Archivo de propiedades del servlet de ejemplo.

Identificación de las colaboraciones que se van a invocar 

La segunda sección del archivo de propiedades del servlet de Connect contiene información de colaboración, que asocia el URL de colaboración con las propiedades de colaboración asociadas. Esta sección identifica los URL de colaboración en dos partes, según se especifica a continuación:


Tabla 50. Propiedades de colaboración del archivo de propiedades del servlet
Nombre de propiedad Descripción Ejemplo
WBIC_SERVLET_COUNT

El número de URL configurados en este archivo:

  • Si se establece como 1, el servlet procesará el URL y las propiedades de WBIC_URL_1.
  • Si se establece como 2, el servlet procesará el URL y las propiedades de WBIC_URL_1 y WBIC_URL_2.

1
WBIC_URL_1 El nombre del URL relativo PurchaseOrder
WBIC_URL_1_COLLAB El nombre de la colaboración PurchaseOrderCollab
WBIC_URL_1_PORT El nombre de puerto de la colaboración From
WBIC_URL_1_VERB El verbo al que se suscribe la colaboración Create
WBIC_URL_1_WRAPPER_MIME El tipo MIME que soporta el manejador de datos de envoltura. Tenga en cuenta que el ejemplo está en minúsculas. wbic/wrapper
WBIC_URL_1_CHARENCODE La codificación de caracteres que se utilizará en las peticiones HTTP. Especifique una codificación de caracteres Java válida. UTF-8

Nota:
Si desea ver un archivo de propiedades del servlet de ejemplo que define los valores de la columna Ejemplo de Tabla 50, consulte la Archivo de propiedades del servlet de ejemplo.

La sección de colaboración del archivo de propiedades del servlet proporciona un URL relativo para identificar la colaboración que se debe ejecutar. Para buscar la colaboración durante la ejecución, el servlet de Connect combina la siguiente información:

Por ejemplo, si ha utilizado los valores de ejemplo que se muestran en la Tabla 50, el servlet de Connect deberá obtener el URL de la colaboración PurchaseOrderCollab. Para buscar este URL, el servlet sigue estos pasos:

  1. Obtenga el URL del servlet, que identifica la ubicación del servlet de Connect.

    El servlet obtiene el URL del servlet del servidor web. Por ejemplo, supongamos que ha desplegado el servlet de Connect en la siguiente ubicación:

    http://www.yourcompany.com/tasks
     
  2. Adjunte al URL del servlet la vía de acceso de la propiedad WBIC_URL_count.

    En la Tabla 50, la propiedad WBIC_URL_1 contiene el valor "PurchaseOrder". Por lo tanto, el servlet de Connect adjuntará esta serie al URL del servlet para obtener el siguiente URL para la colaboración:

    http://www.yourcompany.com/tasks/PurchaseOrder
     

En las propiedades de la colaboración, la propiedad WBIC_URL_1_WRAPPER_MIME especifica el tipo MIME del manejador de datos de envoltura. Si especifica más de un tipo MIME, necesitará varios metaobjetos. Consulte el apartado Creación del metaobjeto hijo de envoltura para obtener más información.

Especificación de la ubicación del archivo de registro del servlet  Las propiedades de registro cronológico se especifican en la tercera sección del archivo de propiedades del servlet de Connect. La ubicación del archivo de registro del servlet se especifica en el archivo de propiedades añadiendo la siguiente sentencia:

log4jappender.RollingFile.File=logFileLocation
 

Como se muestra en la Figura 10, la propiedad log4jappender.RollingFile.File está en la sección del archivo de propiedades del servlet que configura Log4J. Para configurar el servlet de Connect, sólo es necesario especificar la ubicación del archivo de registro, estableciendo la propiedad log4jappender.RollingFile.File. Si está familiarizado con Log4J, puede establecer también algunas otras de sus propiedades.

Archivo de propiedades del servlet de ejemplo  En la Figura 10 se muestra un ejemplo del archivo de propiedades del servlet, que configura los valores de las columnas Ejemplo de la Tabla 49 y la Tabla 50.

Figura 10. Archivo de propiedades del servlet de ejemplo

# Example properties file for WebSphere Business Integration
 # Connect
  ICS_SERVERNAME=Server1
  ICS_VERSION=4.2
  ICS_IORFILE=C:/myiorlocation/Server1InterChangeServer.ior
  ICS_USERNAME=admin
  ICS_PASSWORD=null
  ICS_ENCRYPTED_PASSWORD=false
  ICS_DISABLEENCRYPTION=true
 
# Collaboration properties for single collaboration
  WBIC_SERVLET_COUNT=1
 
 WBIC_URL_1=PurchaseOrder
  WBIC_URL_1_COLLAB=PurchaseOrderCollab
  WBIC_URL_1_CHARENCODE=UTF-8
  WBIC_URL_1_PORT=From
  WBIC_URL_1_VERB=Create
  WBIC_URL_1_WRAPPER_MIME=wbic/wrapper
 
#Log4J Debug Properties
 #Possible Categories - debug/info/warn/error/fatal
 #Default Category "error". Output to: stdout and RollingFile
 log4j.rootCategory=debug,RollingFile
 log4j.appender.RollingFile=org.apache.log4j.RollingFileAppender
 
#Log File Name
 log4j.appender.RollingFile.File=D:\\_DEV\\servlet.log
 log4j.appender.RollingFile.MaxFileSize=1000KB
 
#Number of backup files to keep
 log4j.appender.RollingFile.MaxBackupIndex=10
 log4j.appender.RollingFile.layout=org.apache.log4j.PatternLayout
 log4j.appender.RollingFile.layout.ConversionPattern=
    %d{yyyy-MM-ddHH:mm:SS} %-5p [%c{1}] - %m%n
 

También puede encontrar un archivo de propiedades del servlet de ejemplo en el directorio SAMPLES en el soporte de instalación de Business Integration Connect.

Identificación de la ubicación del archivo de propiedades del servlet

El descriptor de despliegue del servlet de Connect, web.xml, proporciona parámetros de inicialización del servlet. Para identificar la ubicación del archivo de propiedades del servlet, se establece el parámetro WBIC_FILENAME en este descriptor de despliegue. Este parámetro especifica el nombre completo de la vía de acceso del archivo de propiedades del servlet de Connect.

Por ejemplo, si el archivo de propiedades del servlet de ejemplo que se muestra en la Figura 10 se denominaba connectServlet.cfg y se encontraba en el directorio de despliegue del servlet de Connect (por ejemplo, C:\WBIC\integration ), deberá establecer el parámetro WBIC_FILENAME como sigue:

C:\WBIC\integration\connectServlet.cfg
 

Configuración del manejador de datos de envoltura

El manejador de datos de envoltura convierte un documento de un formato serializado (que el servlet de Connect ha creado a partir del mensaje HTTP) en su objeto de negocio correspondiente. Cuando el servlet de Connect invoca una colaboración, envía a InterChange Server el formato serializado del documento que le ha enviado Business Integration Connect. Esta solicitud de colaboración la recibe WebSphere Server Access, que reside en InterChange Server. Como se muestra en la Figura 9, Server Access llama al manejador de datos de envoltura y le pasa el documento de Business Integration Connect. El manejador de datos devuelve el objeto de negocio de carga correspondiente.

Para configurar el manejador de datos de envoltura, siga estos pasos:

Los pasos para configurar el manejador de datos de envoltura se resumen en las siguientes secciones. Si desea obtener información general sobre los manejadores de datos, consulte Data Handler Guide en el conjunto de la documentación de WebSphere InterChange Server.

Especificación de la ubicación del manejador de datos de envoltura

InterChange Server necesita saber la ubicación del manejador de datos de envoltura para cargarlo durante la ejecución. Siga estos pasos para especificar la ubicación:

  1. Edite el script de arranque de ICS, start_server.bat, que se encuentra en el subdirectorio bin del directorio del producto InterChange Server (en la máquina donde reside InterChange Server).
  2. En este archivo, añada el archivo jar del manejador de datos de envoltura, bcgwbiwrapperdh.jar, a la lista de archivos jar incluida en el arranque de ICS. Normalmente, los archivos jar de manejador de datos se añaden a la variable DATAHANDLER en el script de arranque de ICS.
    Nota:
    Si ha instalado el manejador de datos de accesorios opcional, también debe añadir su archivo jar al script de arranque de ICS. Si desea obtener más información, consulte el apartado Especificación de la ubicación del manejador de datos de accesorios.

Creación de los objetos de negocio de configuración del manejador de datos de envoltura

Para identificar el manejador de datos que se debe invocar, Server Access (dentro de InterChange Server) comprueba el metaobjeto de manejador de datos de nivel superior, MO_Server_DataHandler. Este archivo se encuentra en el siguiente subdirectorio del directorio del producto InterChange Server:

repository\edk
 

Este metaobjeto de nivel superior asocia un tipo MIME con un metaobjeto hijo, que contiene la información de configuración del manejador de datos. Por lo tanto, la creación de objetos de negocio de configuración implica los siguientes pasos:

  1. Creación del metaobjeto hijo de envoltura

    Debe inicializar un metaobjeto hijo con la información de configuración del manejador de datos de envoltura.

  2. Edición del metaobjeto MO_Server_DataHandler

    Debe crear una entrada en este metaobjeto que asocie un tipo MIME con el nombre del metaobjeto hijo del manejador de datos de envoltura.

Creación del metaobjeto hijo de envoltura

Para configurar el manejador de datos de envoltura, debe crear un metaobjeto hijo e inicializarlo con información de configuración. El manejador de datos utiliza los atributos de este metaobjeto para obtener la información de configuración, incluido el nombre de la clase de manejador de datos para la que se debe crear una instancia. Para crear este metaobjeto, se crea una definición de objeto de negocio que contiene los atributos incluidos en la Tabla 51.

Nota:
Utilice Business Object Designer para crear esta definición de objeto de negocio.

Tabla 51. Propiedades de configuración en el metaobjeto hijo de envoltura
Atributo Descripción
ClassName

Nombre de clase (necesario), que apunta a la siguiente clase de manejador de datos:

com.ibm.bcg.integration.wbi.datahandlers.
 WBICWrapperDataHandler
 
TopBOPrefix Prefijo que se utiliza para determinar el nombre del objeto de negocio de nivel superior. Si el objeto de negocio de petición devuelto por el manejador de datos configurado para la petición no tiene el distintivo wbic_mainboname en la información específica de la aplicación de nivel de objeto de negocio, el nombre del objeto de nivel superior se obtiene añadiendo TopBOPrefix al nombre del objeto de negocio de petición.
wbic_request_mime

Tipo MIME soportado por el manejador de datos que invoca el manejador de datos de envoltura para procesar la carga del mensaje de petición. Asegúrese de que este manejador de datos se ha configurado para que WebSphere InterChange Server Access pueda invocarlo. Si desea obtener más información, consulte el apartado Edición del metaobjeto MO_Server_DataHandler.

Nota:
Si los documentos contienen accesorios, el tipo MIME de esta propiedad de configuración debe ser el tipo MIME que invoca el manejador de datos de accesorios. Si desea obtener más información, consulte el apartado Manejo de documentos con accesorios.
wbic_response_mime

Tipo MIME del manejador de datos que invocará el manejador de datos de envoltura para procesar la carga del mensaje de respuesta.

Nota:
No es necesario establecer wbic_response_mime si Business Integration Connect no espera una respuesta.

Importante:
Para asignar un valor a los atributos de la Tabla 51, establezca el valor por omisión del atributo. Por ejemplo, si el manejador de datos de envoltura va a utilizar el manejador de datos delimitado para el mensaje de solicitud, establezca el valor por omisión del atributo wbic_request_mime como text/delimited .

Puede definir un metaobjeto hijo para cada instancia del manejador de datos de envoltura que necesite utilizar. Por ejemplo, si necesita dar soporte sólo a un tipo MIME de petición o a una combinación de tipos MIME de petición y respuesta, puede crear un único metaobjeto hijo y establecer los valores por omisión de los atributos wbic_request_mime y wbic_response_mime según corresponda. No obstante, si necesita dar soporte a combinaciones diferentes de tipos MIME de petición y respuesta, puede crear un metaobjeto hijo para cada una de las combinaciones soportadas.

Business Integration Connect proporciona el siguiente archivo de depósito de InterChange Server, que contiene un metaobjeto hijo de ejemplo para el manejador de datos de envoltura:

DirProducto/Integration/WBI/WICS/WBICServlet/MO_DataHandler_WBICWrapper.in
 

donde DirProducto es el directorio del producto Business Integration Connect instalado. Este archivo de depósito define una única instancia del manejador de datos de envoltura, que se configura para llamar al manejador de datos delimitado para los objetos de negocio de petición y respuesta. En la Figura 11 se muestra el metaobjeto hijo de ejemplo denominado MO_DataHandler_WBICWrapper.

Figura 11. Metaobjeto hijo de ejemplo de un manejador de datos de envoltura


Si también tiene que dar soporte a un documento cuyo mensaje de petición estaba en XML, deberá crear un segundo metaobjeto hijo para representar una segunda instancia del manejador de datos de envoltura. En este metaobjeto hijo, el valor por omisión del atributo wbic_request_mime tendrá el tipo MIME de text/xml.

Edición del metaobjeto MO_Server_DataHandler

WebSphere InterChange Server Access utiliza un metaobjeto de nivel superior denominado MO_Server_DataHandler para asociar tipos MIME que los clientes de acceso pueden manejar con los manejadores de datos que proporcionan soporte a estos tipos MIME. En concreto, este metaobjeto de nivel superior asocia tipos MIME con metaobjetos hijo de manejador de datos.

El metaobjeto MO_Server_DataHandler es una definición de objeto de negocio. Por lo tanto, para editar este metaobjeto, active MO_Server_DataHandler en Business Object Designer y añádale un nuevo atributo por cada instancia soportada del manejador de datos de envoltura. Cada instancia de este manejador de datos es una combinación exclusiva de tipos MIME de petición y respuesta.

Realice las siguientes modificaciones en el metaobjeto MO_Server_DataHandler:

Por ejemplo, supongamos que tiene el manejador de datos de envoltura tal como está configurado en la Figura 11. La Figura 12 muestra el metaobjeto MO_Server_DataHandler con un atributo que asocia el tipo MIME wbic_wrapper con la instancia del manejador de datos de envoltura configurada por el metaobjeto hijo MO_DataHandler_WBICWrapper. Este metaobjeto MO_Server_DataHandler también asocia los tipos MIME de petición y respuesta (text/delimited) con el metaobjeto hijo del manejador de datos delimitado.

Figura 12. Asociación del tipo MIME wbic_wrapper con el manejador de datos de envoltura


Repita este proceso para cada combinación exclusiva de tipo MIME de petición y respuesta a la que deba dar soporte, añadiendo un atributo en el metaobjeto de nivel superior MO_Server_DataHandler cuyo nombre de atributo sea el tipo MIME asociado con la instancia del manejador de datos de envoltura y cuyo tipo sea el nombre del metaobjeto hijo asociado. Compruebe también que existan en MO_Server_DataHandler los tipos MIME de petición y respuesta configurados (y sus metaobjetos hijo).

Nota:
Si utiliza el manejador de datos de accesorios para procesar accesorios en los documentos de Business Integration Connect, debe modificar también MO_Server_DataHandler para dar soporte al manejador de datos de accesorios, tal como se describe en el apartado Configuración del manejador de datos de accesorios.

Creación de definiciones de objetos de negocio para enviar documentos

El servlet de WebSphere Business Integration Connect envía el documento a InterChange Server en forma de un objeto de negocio de carga. Para el servlet de Connect, el objeto de negocio de carga se representa como una jerarquía de objetos de empresa. El manejador de datos de envoltura crea esta jerarquía de objetos de negocio cuando recibe un documento de Business Integration Connect. Por lo tanto, debe crear definiciones de objetos de negocio para representar esta jerarquía.

Como el servlet de Connect sólo participa en la notificación de eventos con InterChange Server, los atributos de petición y respuesta del objeto de negocio de nivel superior se interpretan tal como se muestra en la Tabla 52.

Tabla 52. Objetos de negocio de petición y respuesta en la notificación de eventos
Atributo Uso
Objeto de negocio de petición Contiene el mensaje de petición del Business Integration Connect; este mensaje es el evento que desencadena la colaboración.
Objeto de negocio de respuesta Contiene el mensaje de respuesta, si la interacción es sincrónica.

Si desea obtener más información sobre cómo crear esta estructura del objeto de negocio, consulte el apartado Creación de definiciones de objetos de negocio para ICS anterior a 4.2.2 mediante HTTP.

Recepción de documentos de ICS anterior a 4.2.2 mediante HTTP

En este apartado se incluye la siguiente información sobre cómo recibir documentos de Business Integration Connect de InterChange Server anterior a 4.2.2 mediante el protocolo de transporte HTTP:

El documento que recibe Business Integration Connect de InterChange Server ha sido iniciado por el proceso de peticiones dentro de InterChange Server.

Componentes necesarios para la recepción

Business Integration Connect puede recibir documentos de las siguientes versiones anteriores a 4.2.2 de InterChange Server mediante el protocolo de transporte HTTP:

Para que Business Integration Connect pueda recibir un documento de InterChange Server anterior a 4.2.2 utilizando el protocolo de transporte HTTP, es necesario que estos dos componentes estén configurados. En la Tabla 45 se resumen estos pasos de configuración. Asimismo, para recibir un documento de InterChange Server mediante el protocolo HTTP, utilice los componentes compatibles con ICS que se enumeran en la Tabla 53.

Tabla 53. Componentes necesarios para recibir documentos de InterChange Server anterior a 4.2.2 mediante HTTP
Componente Descripción Notas y restricciones

WebSphere Business Integration Adapter para XML

(Adaptador de XML)

Este adaptador permite a InterChange Server intercambiar objetos de negocio con aplicaciones que reciban datos en forma de mensajes HTTP. El adaptador de XML y Business Integration Connect se comunican a través de una dirección URL.

El adaptador de XML no se suministra con Business Integration Connect. Debe utilizar la versión 3.1.x o posterior de este adaptador.

Nota:
El adaptador sólo se puede utilizar con WebSphere InterChange Server versión 4.2.2.
El manejador de protocolos HTTP o HTTPS

Este manejador de protocolos trabaja con el adaptador de XML para enviar la corriente de datos y recibirla del URL.

Este manejador de protocolos se proporciona con Business Integration Connect. Si desea obtener más información, consulte el apartado Despliegue del manejador de protocolo HTTP.
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 convierte los documentos que contienen accesorios entre el formato del documento y la representación de objeto 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 la Figura 13 se proporciona una visión general de cómo recibe Business Integration Connect documentos de InterChange Server anterior a 4.2.2 mediante el protocolo de transporte HTTP.

Nota:
Todas las referencias al manejador de protocolo HTTP se aplican también al manejador de protocolo HTTPS.

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


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

  1. La colaboración dentro de InterChange Server realiza una llamada de servicio al adaptador de XML y le envía un objeto de negocio de nivel superior que incluye objetos hijo de petición y respuesta.

    El objeto hijo de petición contiene información específica de la aplicación que apunta a un metaobjeto dinámico que contiene las cabeceras HTTP personalizadas que espera Business Integration Connect.

  2. El adaptador de XML invoca el manejador de protocolo HTTP.
  3. El manejador de protocolo HTTP utiliza un manejador de datos para convertir el objeto de negocio que ha enviado la colaboración en una corriente de datos HTTP.

    El manejador de protocolo lee el tipo MIME y el URL del objeto de negocio de nivel superior para determinar el manejador de datos que debe utilizar y la dirección del receptor.

  4. A partir del objeto de negocio de nivel superior, el manejador de protocolo HTTP obtiene el primer objeto de negocio completo. Éste es el objeto de negocio de petición.

    El manejador de protocolo HTTP llama al manejador de datos para convertir el objeto de negocio en una corriente de datos HTTP.

    Nota:
    Si los documentos tienen accesorios, instale el manejador de datos de accesorios y, a continuación, configure el adaptador de XML 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.
  5. El manejador de protocolo HTTP determina, a partir del objeto de negocio de petición, el nombre del metaobjeto dinámico.

    El manejador de protocolo HTTP 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 correspondiente al metaobjeto dinámico. Si utiliza el empaquetado de integración de programas de fondo para los documentos, puede especificar la información de cabecera HTTP personalizada en este metaobjeto dinámico.

  6. El manejador de protocolo HTTP busca el atributo HTTPProperties en el metaobjeto dinámico.

    Si este atributo está completo, el manejador de protocolo establece las cabeceras de nivel de transporte en el mensaje de petición. Dentro del atributo HTTPProperties, también puede especificar la cabecera HTTP estándar de tipo de contenido. 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.

  7. El manejador de protocolo HTTP crea una corriente de datos HTTP utilizando la serie devuelta por el manejador de datos. También establece la información de cabecera personalizada, tal como se ha definido en el metaobjeto dinámico.
  8. El manejador de protocolo HTTP envía el mensaje de petición resultante en forma de corriente de datos al URL especificado.

    Business Integration Connect escucha en este URL, que está configurado como su destino.

  9. Business Integration Connect responde con HTTP 200 OK.

    Si la propiedad de conector ReturnBusObjResponse (del adaptador de XML) es true, la invocación es sincrónica. El manejador de protocolo convierte el mensaje de respuesta en un objeto de negocio de respuesta y lo devuelve al adaptador de XML. El adaptador establece el objeto de negocio en el objeto de negocio de nivel superior. A continuación, el objeto de negocio de nivel superior se devuelve a la colaboración de InterChange Server.

Configuración del entorno para HTTP con ICS anterior a 4.2.2

Como la recepción de los documentos de InterChange Server implica el uso de componentes compatibles con ICS, debe realizar las tareas de configuración que se describen en la Tabla 54. Si desea obtener más información sobre cómo configurar Business Integration Connect para comunicarse con InterChange Server anterior a 4.2.2 mediante HTTP, consulte el apartado Cómo proporcionar soporte a los documentos salientes.

Tabla 54. Configuración del entorno para enviar documentos
Paso Si desea obtener más información

1. Desplegar el manejador de protocolo HTTP.

Despliegue del manejador de protocolo HTTP

2. Configurar WebSphere Business Integration Adapter para XML.

Configuración del adaptador de XML

Nota:
Si los documentos contienen accesorios, también debe instalar y configurar el manejador de datos de accesorios, tal como se describe en el apartado Manejo de documentos con accesorios.

Despliegue del manejador de protocolo HTTP

Business Integration Connect proporciona un manejador de protocolo HTTP personalizado para enviar y recibir mensajes en Business Integration Connect. Este manejador de protocolo HTTP está disponible en el soporte de instalación de Business Integration Connect, en el siguiente archivo:

Integration/WBI/WICS/WBICServlet/bcgwbiprotocol.jar
 

Este manejador de protocolo personalizado se puede conectar al adaptador de XML versión 3.1.x o posterior. Si desea ver una lista de las versiones y plataformas soportadas de InterChange Server, consulte Adapter for XML User Guide para la versión del adaptador que esté utilizando.

Para desplegar el manejador de protocolo HTTP en el adaptador de XML, debe notificar al adaptador de XML la ubicación del manejador de protocolo HTTP, para que pueda cargarlo durante la ejecución. Siga estos pasos para especificar la ubicación del manejador de protocolo HTTP:

  1. Edite el script de arranque del adaptador de XML, start_xml.bat, que se encuentra en el siguiente subdirectorio del directorio del producto en el que se instalan los adaptadores de WebSphere Business Integration:
    connectors/xml
     
  2. En este script de arranque, añada el archivo jar del manejador de protocolo HTTP, bcgwbiprotocol.jar, a la lista de archivos jar de la CLASSPATH del adaptador de XML.

Configuración del adaptador de XML

El adaptador de XML es el componente compatible con ICS que permite a Business Integration Connect intercambiar documentos con InterChange Server en forma de mensajes HTTP. Da soporte a la interacción de procesos de peticiones con InterChange Server, como se especifica a continuación:

Nota:
La característica de notificación de eventos de este adaptador no se utiliza. Para enviar mensajes HTTP de Business Integration Connect a InterChange Server, utilice el servlet de WebSphere Business Integration Connect, tal como se describe en el apartado Envío de documentos a ICS anterior a 4.2.2 mediante HTTP.
Importante:
WebSphere Business Integration Connect no incluye WebSphere Business Integration Adapter para XML. Este producto se debe obtener por separado y se instala de acuerdo con las instrucciones que se describen en Adapter for XML 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 XML para comunicarse con InterChange Server, siga los pasos de estos apartados para configurar este adaptador para que acepte mensajes HTTP de Business Integration Connect.

Especificación del manejador de datos de carga

Como se muestra en la Figura 13, el manejador de protocolo del adaptador de XML 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 XML para que utilice este manejador de datos de carga. En Connector Configurator, establezca la propiedad de configuración del conector DataHandlerConfigMO para que especifique el metaobjeto de manejador de datos de nivel superior que utiliza el adaptador de XML en la identificación de manejadores de datos. Asegúrese de incluir el nombre del metaobjeto de manejador de datos de nivel superior en la lista de objetos de negocio soportados del adaptador.

Configuración del nombre de paquete del manejador de protocolo

El adaptador de XML utiliza la propiedad de configuración del conector JavaProtocolHandlerPkgs para identificar el nombre de los paquetes de manejador de protocolo Java. Para la integración con Business Integration Connect, compruebe que la propiedad JavaProtocolHandlerPkgs esté establecida en el nombre de paquete del manejador de protocolo HTTP proporcionado por Business Integration Connect :

com.ibm.bcg.integration.wbi.utils.protocolhandlers
 

Especificación del soporte de un objeto de negocio de respuesta

El adaptador de XML utiliza la propiedad de configuración del conector ReturnBusObjResponse para indicar si debe devolver un objeto de negocio de respuesta. Sólo se devuelve un objeto de negocio de respuesta si la interacción es sincrónica. Por omisión, la propiedad de configuración del conector ReturnBusObjResponse está establecida como false. Para configurar el adaptador de XML para que devuelva un objeto de negocio de respuesta, establezca la propiedad de configuración del conector ReturnBusObjResponse como true.

Nota:
Si Business Integration Connect da soporte a interacciones sincrónicas para el protocolo de empresa y empaquetado que utiliza el gestor de comunidad, establezca la propiedad de configuración del conector ReturnBusObjResponse como true y proporcione el objeto de negocio de respuesta del objeto de negocio de nivel superior.

Para establecer las propiedades de configuración del conector, utilice la herramienta Connector Configurator, que se incluye como parte del release de WebSphere Business Integration Adapter para XML. En Connector Configurator, la propiedad ReturnBusObjResponse debe aparecer en la pestaña específica de Connector de las propiedades del conector.

Creación de definiciones de objetos de negocio para recibir documentos

WebSphere Business Integration Adapter para XML recibe información de InterChange Server en forma de un objeto de negocio de carga. Para el adaptador de XML, el objeto de negocio de carga se representa como una jerarquía de objetos de empresa. El adaptador de XML crea esta jerarquía de objetos de negocio cuando recibe un documento de Business Integration Connect. Por lo tanto, debe crear definiciones de objetos de negocio para representar esta jerarquía.

Como el adaptador de XML sólo participa en el proceso de peticiones con InterChange Server, los atributos de petición y respuesta del objeto de negocio de nivel superior se interpretan tal como se muestra en la Tabla 55.

Tabla 55. Objetos de negocio de petición y respuesta en el proceso de peticiones
Atributo Uso
Objeto de negocio de petición Contiene la información de peticiones de InterChange Server; el manejador de protocolo y el manejador de datos convierten y envían esta información al URL en el que escucha Business Integration Connect.
Objeto de negocio de respuesta Contiene la información de respuesta de Business Integration Connect, si la interacción es sincrónica.

Si desea obtener más información sobre cómo crear esta estructura del objeto de negocio, consulte el apartado Creación de definiciones de objetos de negocio para ICS anterior a 4.2.2 mediante HTTP.

Creación de definiciones de objetos de negocio para ICS anterior a 4.2.2 mediante HTTP

El servlet de Connect envía el documento a InterChange Server en forma de un objeto de negocio de carga. El adaptador de XML recibe el mensaje de InterChange Server en este mismo formato. Ambos componentes invocan 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 56 para representar la estructura del objeto de negocio de carga que esperan el adaptador de XML y el servlet de Connect.

Tabla 56. Definiciones de objetos de negocio para el protocolo de transporte HTTP
Condición Definición de objeto de negocio Si desea obtener más información
Si está utilizando el empaquetado de integración de programas de fondo Ninguno o para el documento y los documentos no tienen accesorios

Jerarquía de objetos de negocio para el objeto de negocio de carga:

  • Objeto de negocio de nivel superior
  • Objeto de negocio de petición
  • Objeto de negocio de respuesta (sólo si se espera una respuesta)

Creación de la estructura del objeto de negocio de carga para ICS anterior a 4.2.2 mediante HTTP
Si utiliza el empaquetado de integración de programas de fondo para el documento

Añada al objeto de negocio de carga los objetos de negocio que deben mantener la información de cabecera de nivel de transporte:

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

Creación de información de cabecera de nivel de transporte HTTP para InterChange Server anterior a 4.2.2
Si el documento incluye accesorios (es necesario el empaquetado de integración de programas de fondo) También debe crear objetos de negocio adicionales para representar los accesorios. Creación de definiciones de objetos de negocio relacionadas con los accesorios

Nota:
Si está definiendo objetos de negocio para documentos cXML, consulte el apartado Creación de objetos de negocio para cXML.

Creación de la estructura del objeto de negocio de carga para ICS anterior a 4.2.2 mediante HTTP

El manejador de datos de envoltura (para enviar documentos) y el adaptador de XML y el manejador de protocolo HTTP (para recibir documentos) esperan la misma estructura del objeto de negocio para el objeto de negocio de carga. Esta estructura del objeto de negocio está formada por los siguientes objetos de negocio:

En la Figura 14 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 anterior a 4.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 XML User Guide.

Figura 14. Estructura del objeto de negocio del objeto de negocio de carga HTTP para InterChange Server anterior a 4.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 esta definición de objeto de negocio de nivel superior.

Tabla 57. Atributos del objeto de negocio de nivel superior
Atributo Tipo de atributo Descripción
URL Serie

Destino de los datos del objeto de negocio.

Importante:
El manejador de datos de envoltura no utiliza este atributo. No obstante, el adaptador de XML sí lo utiliza.
MimeType Serie

Define el tipo de contenido y el formato de los datos que se pasan al URL.

Importante:
El manejador de datos de envoltura no utiliza este atributo. No obstante, el adaptador de XML sí lo utiliza.
BOPrefix Serie

Se utiliza para determinar a qué manejador de datos se debe llamar.

Importante:
El manejador de datos de envoltura no utiliza este atributo.
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.
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.

Nota:
Si utiliza el manejador de datos de accesorios para procesar accesorios, 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.

Si desea ver una descripción completa de la estructura del objeto de negocio de nivel superior, consulte Adapter for XML User Guide.

Objeto de negocio de petición

El objeto de negocio de petición contiene los datos que se pasan al URL. Contiene atributos para cada uno de los distintivos XML del mensaje de petición. 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:
Esta estructura del objeto de negocio identifica sus dos 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 XML 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 58. 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?
wbic_mainboname Proporciona el nombre del objeto de negocio de nivel superior
cw_mo_conn Especifica el metaobjeto dinámico, 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 InterChange Server anterior a 4.2.2. No (sólo es necesario si utiliza el empaquetado de integración de programas de fondo)

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 éste es el caso, debe seguir los siguientes pasos adicionales:

Nota:
El objeto de negocio de respuesta no incluye un atributo para el metaobjeto dinámico.

Si el intercambio entre Business Integration Connect e InterChange Server es asincrónico, Business Integration Connect no espera una respuesta, por lo que no es necesario crear un objeto de negocio de respuesta.

Creación de objetos de negocio para cXML

Para los documentos cXML, puede utilizar XML ODA (Object Discovery Agent) para crear los objetos de negocio. XML ODA puede consumir cXML DTD. No obstante, tenga en cuenta que XML ODA no da soporte a ENTITY. Por lo tanto, antes de ejecutar cXML DTD con XML ODA, deberá eliminar ENTITY de DTD.

Cuando se generan objetos de negocio utilizando XML ODA, puede seleccionar el distintivo cXML como elemento raíz. No obstante, esto puede dar como resultado un objeto de negocio muy grande, que capture el cXML DTD completo. Si desea crear un objeto de negocio más pequeño, puede seleccionar un distintivo diferente como elemento raíz, pero deberá escribir un manejador de nombres personalizado para el manejador de datos de XML. El manejador de datos invocará este manejador de nombres para la resolución de nombres de objetos de negocio de nivel superior. Consulte la documentación del manejador de datos de XML para obtener información sobre cómo escribir manejadores de nombres personalizados.

Creación de información de cabecera de nivel de transporte HTTP para InterChange Server anterior a 4.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 manejador de datos de envoltura y el adaptador de XML esperan que esta información de cabecera personalizada esté en un metaobjeto dinámico.

En la Figura 15 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 15. Relación del objeto de negocio de petición con el metaobjeto dinámico HTTP


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

  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 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 HTTP

Un objeto de negocio de propiedades HTTP contiene 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 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).

    Nota:
    La única excepción de los nombres de propiedad HTTP es que el campo de tipo de contenido debe tener un atributo denominado Content_Type.
  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:

    name=HTTPproperty
     

    donde HTTPproperty es uno de los valores de la columna Campo de cabecera de la Tabla 4.

En la Figura 15, 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:

name=x-aux-sender-id
 

Creación del metaobjeto dinámico HTTP

El metaobjeto dinámico contiene un objeto de negocio hijo con información de configuración para la información de cabecera HTTP. Asegúrese de que la estructura del objeto de negocio incluya un metaobjeto dinámico. La definición de objeto de negocio del metaobjeto dinámico debe incluir un atributo denominado HttpProperties, cuyo tipo de atributo sea la definición de objeto de negocio del objeto de negocio de propiedades HTTP (consulte el apartado Creación del objeto de negocio de propiedades HTTP).

Por ejemplo, en la Figura 15, la definición de objeto de negocio HttpDynMO_BusObj contiene el atributo HttpProperties, 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 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 HTTP).

  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 15, se ha añadido un atributo denominado HttpDynMO 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 HttpDynMO_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=HttpDynMO
 

Creación de artefactos de ICS anterior a 4.2.2 para HTTP

Para configurar InterChange Server anterior a 4.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 59.

Tabla 59. Artefactos para comunicarse con ICS anterior a 4.2.2 mediante el protocolo de transporte HTTP
Artefacto de ICS Objetivo Si desea obtener más información
Definiciones de objeto de negocio Representar el documento Creación de definiciones de objetos de negocio para ICS anterior a 4.2.2 mediante HTTP
Objeto de conector (necesario sólo para el proceso de peticiones) Representar el adaptador de XML durante la ejecución Creación del objeto de conector XML
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 XML

Creación del objeto de conector XML

Para dar soporte al proceso de peticiones con InterChange Server anterior a 4.2.2 mediante el protocolo de transporte HTTP, se utiliza el adaptador de XML para enviar un documento a InterChange Server. Para obtener una instancia del adaptador de XML 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 XML para utilizarlo con Business Integration Connect, consulte el apartado Configuración del adaptador de XML.

Enlace de colaboraciones para comunicarse con el adaptador de XML

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 envía información a Business Integration Connect, los puertos se enlazan. Para el proceso de peticiones, establezca el puerto de colaboración "to" que utiliza el adaptador de XML para enviar peticiones a Business Integration Connect en el objeto de conector creado para el adaptador de XMP; es decir, el adaptador de XMP es el adaptador de destino.

Copyright IBM Corp. 1997, 2004