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:
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:
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.
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
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.
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:
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:
Business Integration Connect envía el documento al URL especificado como pasarela de destino.
El mensaje de petición HTTP contiene dos partes:
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).
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.
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.
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.
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.
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.
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.
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.
La configuración del servlet de Connect incluye los siguientes pasos:
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
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:
Estos archivos se pueden encontrar en el subdirectorio lib del directorio del producto InterChange Server.
Notas:
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
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:
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:
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.
| 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 |
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:
Especifica un número entero de URL configurados en este archivo:
Las propiedades de colaboración asociadas tienen nombres de propiedad del tipo WBIC_URL_count_propertyName. En la Tabla 50 se define un ejemplo de estas propiedades WBIC_URL_count_propertyName. En la columna Ejemplo, esta tabla incluye valores de ejemplo de las propiedades WBIC_URL_count_propertyName para el primer URL de colaboración (count es 1 ).
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:
| 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 |
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:
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
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.
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
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.
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:
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:
Debe inicializar un metaobjeto hijo con la información de configuración del manejador de datos de envoltura.
Debe crear una entrada en este metaobjeto que asocie un tipo MIME con el nombre del metaobjeto hijo del manejador de datos 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.
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.
|
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.
|
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.
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:
El tipo de atributo de este atributo es la definición de objeto de negocio del metaobjeto hijo del manejador de datos de envoltura (consulte el apartado Creación del metaobjeto hijo de envoltura).
El tipo de atributo de estos atributos será el metaobjeto hijo del manejador de datos asociado.
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).
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
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.
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.
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.
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.
|
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.
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:
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.
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.
El manejador de protocolo HTTP llama al manejador de datos para convertir el objeto de negocio en una corriente de datos HTTP.
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.
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.
Business Integration Connect escucha en este URL, que está configurado como su destino.
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.
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 |
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:
connectors/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:
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.
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.
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.
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
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.
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.
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
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.
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:
| 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:
| 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 |
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.
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.
|
MimeType | Serie |
Define el tipo de contenido y el formato de los datos que se pasan al URL.
|
BOPrefix | Serie |
Se utiliza para determinar a qué manejador de datos se debe llamar.
|
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. |
Si desea ver una descripción completa de la estructura del objeto de negocio de nivel superior, consulte Adapter for XML User Guide.
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:
Si desea obtener más información, consulte el apartado Creación de definiciones de objetos de negocio para enviar documentos.
Si desea obtener más información, consulte el apartado Creación de definiciones de objetos de negocio para recibir documentos.
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:
Este atributo proporciona información de configuración para las cabeceras del mensaje. Si desea obtener más información, consulte el apartado Creación de información de cabecera de nivel de transporte HTTP para InterChange Server anterior a 4.2.2.
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 | Sí |
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) |
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:
Este distintivo tiene la siguiente sintaxis:
wbic_type=reply
Si no se especifica este distintivo, el manejador de datos de envoltura utiliza el metaobjeto hijo indicado por el atributo wbic_response_mime (en el objeto de negocio de nivel superior) para determinar el manejador de datos que se debe utilizar en la respuesta.
Si el intercambio entre Business Integration Connect e InterChange Server es asincrónico, Business Integration Connect no espera una respuesta, por lo que no es necesario crear un objeto de negocio de respuesta.
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.
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:
Cada uno de estos pasos se describe en los apartados siguientes.
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:
Todos los atributos deben tener un tipo de atributo String. Puede denominar al atributo con el nombre exacto de la propiedad HTTP (tal como se especifica en la columna Campo de cabecera de la Tabla 4).
Esta información específica de la aplicación de nivel de atributo tiene el siguiente formato:
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
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.
La definición de objeto de negocio de petición representa la información que se solicita a Business Integration Connect. Si desea obtener información sobre cómo crear el objeto de negocio de petición, consulte el apartado Objeto de negocio de petición. Para incorporar el metaobjeto dinámico a la estructura de objeto de negocio de carga, debe realizar las siguientes modificaciones en la definición de objeto de negocio de petición:
El tipo de atributo de este atributo es la definición de objeto de negocio del metaobjeto dinámico (consulte el apartado Creación del metaobjeto dinámico HTTP).
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
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.
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 |
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:
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.
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.