Este apartado contiene un resumen de soporte cXML e información para la creación de definiciones de flujo de documentos para intercambios cXML.
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.
<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.
Existen tres tipos de documento cXML: Request, Response o Message.
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:
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:
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:
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:
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.
WebSphere Partner Gateway soporta las siguientes interacciones de definición de flujo de documentos cXML:
Utilice el proceso siguiente para crear una nueva definición de flujo de documentos para un documento cXML.
<cXML> <Response> <Status code="200" text="OK"/> </Response> </cXML> <cXML> <Response> <Status code="200" text="OK"/> <ProfileResponse> </Response> </cXML>
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.
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.