Resumen de soporte cXML

El administrador de documentos de WebSphere Business Integration Connect identifica a un documento cXML por el nombre del elemento raíz del documento XML (es decir "cXML") y la versión indicada por cXML DOCTYPE (DTD). Por ejemplo, el siguiente DOCTYPE es el de la versión cXML 1.2.009:

<!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.009/cXML.dtd">

El administrador de documentos se encarga de la validación DTD en los documentos cXML; sin embargo, Business Integration Connect no proporciona DTD cXML. Puede descargarlos de www.cxml.org y seguidamente subirlos a Business Integration Connect a través del módulo del mapa de validación en la consola de comunidad. Tras subir el DTD, asócielo con el flujo de documentos cXML. Consulte Configuración del concentrador para obtener más información sobre la asociación del DTD con el flujo de documentos cXML.

El administrador de documentos utiliza dos atributos del elemento raíz cXML para la gestión de documentos: ID de la carga e indicación de la hora. El ID de la carga cXML y la indicación de la hora se utilizan como número de identificación del documento e indicación de la hora del documento. Ambos aparecen en la consola de comunidad para la gestión de documentos.

Los elementos procedencia y destino de la cabecera cXML contienen el elemento de credenciales que se utiliza para el direccionamiento y autenticación del documento. El ejemplo inferior muestra los elementos de procedencia y destino del documento cXML.

<Header>
 <From>
  
             <Credential domain="AcmeUserId">
                 <Identity>admin@acme.com</Identity>
             </Credential>
             <Credential domain="DUNS">
                 <Identity>130313038</Identity>
             </Credential>
 </From
 <To>
             <Credential domain="DUNS">
                 <Identity>987654321</Identity>
             </Credential>
             <Credential domain="IBMUserId">
                 <Identity>test@ibm.com</Identity>
             </Credential>
 </To>
 

Si se utiliza más de un elemento de credencial, el administrador de documentos utiliza el número DUNS como el identificador empresarial para direccionamiento y autenticación. Si no se indica ningún número DUNS, se utiliza la primera credencial.

Business Integration Connect no utiliza la información del elemento remitente.

Si la transacción es síncrona, la cabecera de procedencia y destino no se utiliza en un documento de respuesta cXML. El documento de respuesta se envía a través de la misma conexión que se establece mediante el documento de la petición.

Tipos de documento cXML

Existen tres tipos de documento cXML: petición, respuesta o mensaje.

Petición

Existen muchos tipos de peticiones cXML. El elemento petición del documento cXML corresponde a la definición de flujo de documento en Business Integration Connect. Estos son algunos elementos de petición típicos:

La tabla siguiente muestra la relación entre los elementos de un documento de petición cXML y las definiciones de flujo de documento en Business Integration Connect:

elemento cXML
Definición de flujo de documento

cXML DOCTYPE
Protocolo

Versión DTD
Versión de protocolo

Petición (tipo)
Por ejemplo, PeticiónPedido (OrderRequest)
Flujo de documento

Respuesta

El participante de destino envía una respuesta cXML para informar al participante de origen acerca de los resultados de la petición cXML. Puesto que los resultados de algunas peticiones podrían no tener ningún dato, opcionalmente el elemento Respuesta puede contener sólo un elemento Estado. Un elemento Respuesta también puede contener cualquier dato de nivel de aplicación. Durante FicharSalida (PunchOut), por ejemplo, los datos de nivel de aplicación se incluyen en un elemento RespuestaConfigFicharSalida (PunchOutSetupResponse). Estos son algunos elementos de respuesta típicos:

La tabla siguiente muestra la relación entre los elementos de un documento de petición cXML y las definiciones de flujo de documento en Business Integration Connect:

Elemento cXML
Definición de flujo de documento

cXML DOCTYPE
Protocolo

Versión DTD
Versión de protocolo

Respuesta (tipo)
Por ejemplo, RespuestaPerfil (ProfileResponse)
Flujo de documento

Mensaje

Un mensaje cXML contiene la información del flujo de documento Business Integration Connect en el elemento Mensaje de cXML. Puede contener un elemento de estado opcional idéntico al que se encuentra en un elemento Respuesta. Se utilizaría en mensajes de respuesta a mensajes de petición.

El contenido del mensaje se define según las necesidades profesionales del usuario. El elemento directamente debajo del elemento <Mensaje> corresponde al flujo de documentos creado en Business Integration Connect. En el ejemplo siguiente, MensajeCambioSuscripción (SubscriptionChangeMessage) sería el flujo del documento:

<Message>
 <SubscriptionChangeMessage type="new">
            <Subscription>
                 <InternalID>1234</InternalID>
                 <Name xml:lang="en-US">Q2 Prices</Name>
                 <Changetime>1999-03-12T18:39:09-08:00</Changetime>
                 <SupplierID domain="DUNS">942888711</SupplierID>
                 <Format version="2.1">CIF</Format>
             </Subscription>
 </SubscriptionChangeMessage>
 </Message>
 

La tabla siguiente muestra la relación entre los elementos de un mensaje cXML y las definiciones de flujo de documento en Business Integration Connect:

Elemento cXML
Definición de flujo de documento

cXML DOCTYPE
Protocolo

Versión DTD
Versión de protocolo

Mensaje
Flujo de documento

La forma más sencilla de diferenciar un mensaje unidireccional de un documento de petición y respuesta es la presencia de un elemento Mensaje en lugar de un elemento Petición o Respuesta.

Un mensaje puede tener los atributos siguientes:

Cabeceras de tipo contenido y documentos adjuntos

Todos los documentos cXML deben incluir una cabecera de tipo contenido. Para los documentos cXML sin datos adjuntos, se utilizan las siguientes cabeceras de tipo contenido:

El protocolo cXML permite adjuntar archivos externos a través de MIME. Por ejemplo, los compradores con frecuencia necesitan clarificar los pedidos de compra con informes, dibujos o faxes adjuntos. Para los documentos cXML que contienen datos adjuntos debe utilizarse una de las cabeceras de tipo contenido que se mencionan a continuación:

El elemento límite es un texto único que se utiliza para separar la parte del cuerpo de la parte de carga del mensaje MIME. Consulte la Guía del usuario cXML en www.cxml.org para obtener más información.

Interacciones cXML válidas

Business Integration Connect soporta las siguientes interacciones de definición de flujo de documento cXML:
Origen Destino Paquete de origen Paquete de destino Protocolo de origen Protocolo de destino Paso a través Validación Traducción

Participante

Administrador

Ninguno

Ninguno

cXML

cXML

x

x


Administrador

Participante

Ninguno

Ninguno

cXML

cXML

x

x


Administrador

Participante


Ninguno

XML

cXML

x

x

x

Copyright IBM Corp. 1997, 2004