Documentos cXML

Este apartado contiene un resumen de soporte cXML e información para la creación de definiciones de flujo de documentos para intercambios cXML.

Visión general

El Gestor de documentos de WebSphere Partner Gateway identifica 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 gestor de documentos se encarga de la validación DTD en los documentos cXML; sin embargo, WebSphere Partner Gateway no proporciona DTD cXML. Puede descargarlos de www.cxml.org y seguidamente subirlos a WebSphere Partner Gateway 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 el apartado Asociación de correlaciones de definiciones de flujo de documentos para obtener más información sobre la asociación del DTD con el flujo de documentos cXML.

El gestor 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 de procedencia y destino (From y To) de la cabecera cXML contienen el elemento de credencial (Credential) que se utiliza para el direccionamiento y autenticación del documento. El ejemplo siguiente muestra los elementos de procedencia y destino (From y To) del documento cXML.

Nota: aquí y en toda esta publicación, los números DUNS sólo se proporcionan como ejemplos.
<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 gestor de documentos utiliza el número DUNS como el identificador de empresa para direccionamiento y autenticación. Si no se indica ningún número DUNS, se utiliza la primera credencial.

WebSphere Partner Gateway 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: Request, Response o Message.

Request

Existen muchos tipos de peticiones cXML. El elemento Request dentro del documento cXML corresponde al flujo de documentos de WebSphere Partner Gateway. 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 documentos en WebSphere Partner Gateway:

Elemento cXML
Definición de flujo de documentos
cXML DOCTYPE
Protocolo
Versión DTD
Versión de protocolo
Request (tipo)
Por ejemplo, OrderRequest
Flujo de documentos
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 el resultado de algunas peticiones podrían no tener ningún dato, el elemento Response opcionalmente puede contener sólo un elemento Status. Un elemento Response también puede contener cualquier dato de nivel de aplicación. Durante PunchOut, por ejemplo, los datos de nivel de aplicación se incluyen en un elemento PunchOutSetupResponse. Estos son algunos elementos Response típicos:

La tabla siguiente muestra la relación entre los elementos de un documento de respuesta cXML y las definiciones de flujo de documentos en WebSphere Partner Gateway:

Elemento cXML
Definición de flujo de documentos
cXML DOCTYPE
Protocolo
Versión DTD
Versión de protocolo
Response (tipo)
Por ejemplo, ProfileResponse
Flujo de documentos
Mensaje

Un mensaje cXML contiene la información del flujo de documentos WebSphere Partner Gateway en el elemento Mensaje de cXML. Puede contener un elemento 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 <Message> corresponde al flujo de documentos creado en WebSphere Partner Gateway. En el ejemplo siguiente, 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 documentos en WebSphere Partner Gateway:

Elemento cXML
Definición de flujo de documentos
cXML DOCTYPE
Protocolo
Versión DTD
Versión de protocolo
Mensaje
Flujo de documentos

La forma más sencilla de diferenciar un mensaje unidireccional de un documento de petición y respuesta es la presencia de un elemento Message en lugar de un elemento Request-Response.

Un mensaje puede tener los atributos siguientes:

Cabeceras Content-type y documentos adjuntos

Todos los documentos cXML deben incluir una cabecera Content-type. Para los documentos cXML sin datos adjuntos, se utilizan las siguientes cabeceras Content-type:

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 Content-type que aparecen en la siguiente lista:

El elemento boundary es cualquier 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

WebSphere Partner Gateway soporta las siguientes interacciones de definición de flujo de documentos cXML:

Creación de definiciones de flujo de documentos

Utilice el proceso siguiente para crear una nueva definición de flujo de documentos para un documento cXML.

Nota: Debe asegurarse de que se haya definido la versión correcta de cXML antes de crear una definición de flujo de documentos cXML. La versión predeterminada es 1.2.009.

  1. Pulse Administración de concentrador > Configuración de concentrador > Definición de flujo de documentos.
  2. Pulse Crear definición de flujo de documentos. Aparece la página Crear definiciones de flujo de documentos.
  3. Seleccione Flujo de documentos para el tipo de flujo de documentos.
  4. Realice una de las siguientes tareas, en función del tipo de documento:
  5. Especifique 1.0 en Versión.

    El número de versión es sólo de referencia. La versión de protocolo real se obtiene a partir de la versión de DTD en el documento cXML.

  6. Especifique una Descripción opcional.
  7. Seleccione en Nivel de documento.
  8. Seleccione Habilitado para Estado.
  9. Seleccione para todos los atributos de Visibilidad.
  10. Pulse la carpeta Paquete: Ninguno para desglosar las opciones de selección de paquete.
  11. Seleccione Protocolo: cXML (1.2.009): cXML.
  12. Pulse Guardar.

Creación de interacciones

Después de crear la definición de flujo de documentos, configure una interacción para el documento cXML.

Para crear interacciones, siga este procedimiento.

  1. Pulse Administración de concentrador > Configuración de concentrador > Definición de flujo de documentos.
  2. Pulse Gestionar interacciones.
  3. Pulse Crear interacción.
  4. Si el documento cXML es el origen, en Origen, expanda Paquete: Ninguno y Protocolo: cXML y seleccione Flujo de documentos: <flujo_documentos>. Si el documento cXML es el destino, expanda Paquete: Ninguno y Protocolo: cXML y seleccione Flujo de documentos: <flujo_documentos> en la columna Destino.
  5. Expanda la columna de origen o destino para la otra mitad de la interacción (el documento que se convertirá en cXML o el documento que se va a transformar desde cXML) y expanda este paquete y protocolo y seleccione su flujo de documentos.
  6. Seleccione Paso a través en la lista Acción al final de la página. (Paso a través es la única opción válida soportada para documentos cXML).

Copyright IBM Corp. 2003, 2005