Documentos RosettaNet

En este apartado se proporciona una visión general de los documentos de RosettaNet y muestra cómo configurar definiciones de flujo de documentos e interacciones para dichos documentos.

Visión general

RosettaNet es una organización que facilita estándares abiertos para dar soporte al intercambio de mensajes profesionales entre socios comerciales. Para obtener más información sobre RosettaNet, consulte http://www.rosettanet.org. Los estándares incluyen las especificaciones RosettaNet Implementation Framework (RNIF) y Partner Interface Process (PIP). RNIF define el modo en que los socios comerciales intercambian mensajes facilitando una infraestructura de paquetes de mensajes, protocolos de transferencia y seguridad. De momento, se han publicado dos versiones: la 1.1 y la 2.0. Un PIP define un proceso empresarial público y los formatos de mensaje basados en XML que dan soporte al proceso.

WebSphere Partner Gateway da soporte a la mensajería de RosettaNet utilizando RNIF 1.1 y 2.0. Cuando el concentrador recibe un mensaje de PIP, valida y transforma el mensaje para enviarlo al sistema intermediario apropiado. WebSphere Partner Gateway proporciona un protocolo para empaquetar el mensaje transformado en un mensaje RosettaNet Service Content (RNSC) que pueda manejar el sistema intermediario. Consulte la publicación Enterprise Integration Guide para obtener información sobre el empaquetado utilizado en estos mensajes para facilitar información de direccionamiento.

El concentrador también puede recibir mensajes RNSC de sistemas de fondo, crear el mensaje PIP apropiado y enviar el mensaje al socio comercial (un participante). El usuario deberá facilitar las definiciones de flujo de documentos para la versión de RNIF y los PIP que desee utilizar.

Además de facilitar la posibilidad de direccionamiento para mensajes RosettaNet, WebSphere Partner Gateway mantiene un estado para cada mensaje que maneja. Ello le permite reenviar cualquier mensaje que falle hasta que el número de intentos alcance un umbral específico. El mecanismo de notificación de sucesos alerta a los sistemas de fondo cuando no puede enviarse un mensaje PIP. Además, el concentrador puede generar automáticamente PIP 0A1 para enviar a los participantes apropiados cuando reciba determinados mensajes de notificación de sucesos de sistemas de fondo. Consulte la publicación Enterprise Integration Guide para obtener más información sobre la notificación de sucesos.

Paquetes de flujo de documentos RNIF y PIP

Para dar soporte a la mensajería de RosettaNet, WebSphere Partner Gateway proporciona dos conjuntos de archivos comprimidos denominados paquetes. Los paquetes RNIF constan de definiciones de flujo de documentos necesarias para dar soporte al protocolo RNIF. Estos paquetes se encuentran en el directorio B2BIntegrate.

Para RNIF V1.1, los paquetes son:

Para RNIF V02.00, los paquetes son:

El primer paquete de cada pareja proporciona las definiciones de flujo de documentos necesarias para dar soporte a las comunicaciones RosettaNet con los participantes y el segundo paquete proporciona las definiciones de flujo de documentos necesarias para dar soporte a las comunicaciones RosettaNet con sistemas de fondo.

El segundo juego de paquetes consiste en paquetes de flujo de documentos PIP. Cada paquete de flujo de documentos PIP tiene un directorio Packages que contiene un archivo XML y un directorio GuidelineMaps con archivos XSD. El archivo XML especifica las definiciones de flujo de documentos que definen el modo en que WebSphere Partner Gateway maneja el PIP y define los mensajes y señales que se intercambian. Los archivos XSD especifican el formato de los mensajes PIP y definen valores aceptables para elementos XML en los mensajes. Los archivos comprimidos para PIP 0A1 también tienen un archivo XML que el concentrador utiliza como plantilla para crear documentos 0A1.

Los PIP para los que WebSphere Partner Gateway proporciona paquetes de flujo de documentos PIP son:

Para cada PIP, existen cuatro paquetes de flujo de documentos PIP:

Cada paquete de flujo de documentos PIP sigue un convenio de denominación específico que puede utilizar para identificar si el paquete es para los mensajes entre WebSphere Partner Gateway y los participantes o entre WebSphere Partner Gateway y los sistemas de programa de fondo. El convenio de denominación también identifica la versión de RNIF, PIP y la versión PIP que soporta el paquete. Para los paquetes de flujo de documentos PIP que se utilizan para la mensajería entre WebSphere Partner Gateway y participantes, el formato es:

BCG_Package_RNIF<versión_RNIF>_<PIP><versión_PIP>.zip

Para los paquetes de flujo de documentos PIP que se utilizan para la mensajería entre WebSphere Partner Gateway y sistemas de fondo, el formato es:

BCG_Package_RNSC<versión_integración_programas_fondo>_RNIF<versión_RNIF>_
 <PIP><versión_PIP>.zip

Por ejemplo, BCG_Package_RNIF1.1_3A4V02.02.zip se utiliza para la validación de documentos de la versión 02.02 del PIP 3A4 enviados entre los participantes y WebSphere Partner Gateway utilizando el protocolo RNIF 1.1. Para los paquetes de flujo de documentos PIP para comunicación con sistemas de fondo, el nombre del paquete también debe identificar el protocolo utilizado para enviar el contenido de RosettaNet a los sistemas de fondo. Consulte la publicación Enterprise Integration Guide para obtener información sobre el paquete utilizado para estos mensajes.

Creación de definiciones de flujo de documentos

Para la mensajería RosettaNet, WebSphere Partner Gateway requiere los paquetes RNIF para la versión de RNIF utilizada para enviar los mensajes. Para cada PIP al que WebSphere Partner Gateway da soporte, son necesarios dos paquetes de flujo de documentos de PIP para la versión de RNIF. Por ejemplo, para dar soporte a PIP 3A4 en RNIF 2.0, WebSphere Partner Gateway requiere los siguientes paquetes:

El primer paquete es compatible con la mensajería RosettaNet con participantes y el segundo paquete es compatible con la mensajería RosettaNet con sistemas de fondo. El tercer y cuarto paquetes permiten que WebSphere Partner Gateway transmita mensajes 3A4 entre participantes y sistemas de fondo mediante RNIF 2.0.

Para subir los paquetes RosettaNet:

  1. Pulse Administración de concentrador > Configuración de concentrador > Definición de flujo de documentos.
  2. Pulse Subir/descargar paquetes.
  3. Seleccione No en Paquete WSDL.
  4. Pulse Examinar y seleccione el paquete RNIF para comunicarse con los participantes.

    De manera predeterminada, los paquetes RNIF se encuentran en el directorio B2BIntegrate/Rosettanet del soporte de instalación. Por ejemplo, en el caso de que subiera el paquete de la versión 2.00 de RNIF, debería ir al directorio B2BIntegrate/Rosettanet y seleccionar: Package_RNIF_V0200.zip.

  5. Asegúrese de que Confirmar en base de datos se establece en .
  6. Pulse Subir.
  7. Pulse de nuevo Examinar y seleccione el paquete RNIF para comunicarse con las aplicaciones de programas de fondo.

    Por ejemplo, en el caso de que subiera el paquete de la versión 2.00 de RNIF, debería ir al directorio B2BIntegrate/Rosettanet y seleccionar Package_RNSC_1.0_RNIF_V02.00.zip.

  8. Pulse Subir.

    Los paquetes necesarios para comunicarse con participantes o con el sistema de programa de fondo están ahora instalados en el sistema. Si examina la página Gestionar definiciones de flujo de documentos, verá una entrada para Paquete: RNIF/Protocolo: RosettaNet, que representa el empaquetado para comunicarse con participantes y Paquete: Integración de programa de fondo/Protocolo: RNSC, que representa el empaquetado para comunicarse con las aplicaciones de programa de fondo.

  9. Para cada PIP al que se desee dar soporte, suba el paquete de flujo de documentos PIP para el PIP y para la versión RNIF a la que da soporte. Por ejemplo, para subir el 3A6 PIP Notificación de información de remesa) que se va a enviar a un participante, efectúe los siguientes pasos:
    1. Pulse Examinar y seleccione BCG_Package_RNIFV02.00_3C6V02.02 en el directorio B2BIntegrate/Rosettanet.
    2. Asegúrese de que Confirmar en base de datos se establece en .
    3. Pulse Subir.

    El 3C6V02.02 PIP ahora aparece como flujo de documentos bajo Paquete:RNIF/Protocolo:RosettaNet en la página Gestionar definiciones de flujo de documentos. También se visualiza una actividad, acción y dos señales. Se incluyen en la subida del PIP.

    Para subir el 3A6 PIP que se va a enviar a la aplicación de programa de fondo, efectúe los siguientes pasos:

    1. Pulse Examinar y seleccione BCG_Package_RNSC1.0_RNIFV02.00_3C6V02.02.zip.
    2. Asegúrese de que Confirmar en base de datos se establece en .
    3. Pulse Subir.

    El 3C6V02.02 PIP ahora aparece como flujo de documentos bajo Paquete: Integración de programas de fondo/Protocolo:RNSC en la página Gestionar definiciones de flujo de documentos.

    Si WebSphere Partner Gateway no proporciona un paquete para el PIP o la versión de PIP que se desea utilizar, puede crear su propio paquete y subirlo. Consulte el apartado Creación de paquetes de flujo de documentos PIP para obtener más información.

Configuración de los valores de los atributos

Para definiciones de flujo de documentos PIP, la mayoría de los valores de los atributos ya están definidos y no es necesario configurarlos. Sin embargo, no es necesario definir los atributos siguientes:

Paquete RNIF (1.0)

Paquete RNIF (V02.00)

Observe que los PIP para los que WebSphere WebSphere Partner Gateway proporciona paquetes de flujo de documentos PIP no son síncronos. Por ello no es necesario cambiar los atributos Conf. sinc. necesaria y Sinc. soportada para estos PIP.

Nota: El comportamiento del atributo Conf. sinc. necesaria para los PIP de una vía y de dos vías es distinto. Para un PIP de dos vías, si Conf. sinc. necesaria se define en No, este valor prevalece sobre el valor Sí de Sin rechazo de recibo. Por ejemplo, supongamos que envía un 3A7 con los valores siguientes:

En un PIP de dos vías, recibirá un mensaje de error en el documento entrante. En un PIP de una vía, sin embargo, podrá ver el documento entrante en la consola y se devolverá un OKB 200 al participante.

Para establecer los atributos, realice los pasos siguientes:

  1. Pulse Administración de concentrador > Configuración de concentrador > Definición de flujo de documentos.
  2. Pulse los iconos Expandir para expandir individualmente un nodo al nivel apropiado de definición de flujo de documentos o seleccione Todo para expandir todos los nodos de definición de flujo de documentos visualizados.
  3. En la columna Acciones, pulse el icono Editar valores de atributo para el paquete (por ejemplo, Paquete: RNIF (1.1) o Paquete: RNIF (V02.00)) que desea editar.
  4. En el apartado Atributos de contexto de flujo de documentos, acceda a la columna Actualizar del atributo que desee establecer y seleccione o especifique el nuevo valor. Repita el mismo procedimiento para cada atributo que desee establecer.
  5. Pulse Guardar.

Nota: también puede actualizar atributos RosettaNet en el nivel de conexión pulsando Atributos para el origen o el destino y, a continuación, especificar o cambiar los valores en la columna Actualizar. Consulte el apartado Especificación o cambio de atributos.

Creación de interacciones

El siguiente proceso describe cómo crear una interacción entre un sistema de fondo y un participante. Observe que es preciso crear una interacción para cada PIP que se desea enviar y una para cada PIP que se desea recibir.

Antes de empezar, asegúrese de que se han subido las definiciones de flujo de documentos RNIF apropiadas y los paquetes para el PIP que se desea utilizar. Si desea poder generar un PIO 0A1 (Notificación de anomalía), asegúrese de haber subido dicho PIP tal como se describe en el paso 9.

Para crear una interacción para un PIP concreto, realice los siguientes pasos:

  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. Expanda el árbol Origen hasta el nivel de Acción y expanda el árbol Destino hasta el nivel de Acción.
  5. En los árboles, seleccione las definiciones de flujo de documentos que se utilizarán para el contexto fuente y el contexto de destino. Por ejemplo, si el participante es el iniciador de un PIP 3C6 (un PIP de una acción), seleccione las siguientes definiciones de flujo de documentos:
    Tabla 5. PIP 3C6 iniciado por un participante
    Origen Destino
    Paquete: RNIF (V02.00) Paquete: Integración de programas de fondo (1.0)
    Protocolo: RosettaNet (V02.00) Protocolo: RNSC (1.0)
    Flujo de documentos: 3C6 (V01.00) Flujo de documentos: 3C6 (V01.00)
    Actividad: Notificación de información de remesa Actividad: Notificación de información de remesa
    Acción: Acción de notificación de información de remesa Acción: Acción de notificación de información de remesa

    Si el sistema de fondo es el iniciador de PIP 3C6, seleccione las siguientes definiciones de flujo de documentos:

    Tabla 6. PIP 3C6 iniciado por un sistema de fondo
    Origen Destino
    Paquete: Integración de programas de fondo (1.0) Paquete: RNIF (V02.00)
    Protocolo: RNSC (1.0) Protocolo: RosettaNet (V02.00)
    Flujo de documentos: 3C6 (V01.00) Flujo de documentos: 3C6 (V01.00)
    Actividad: Notificación de información de remesa Actividad: Notificación de información de remesa
    Acción: Acción de notificación de información de remesa Acción: Acción de notificación de información de remesa

    Para un PIP de dos acciones como 3A4 iniciado por un participante, seleccione las siguientes definiciones de flujo de documentos para la primera acción:

    Tabla 7. PIP 3A4 iniciado por un participante
    Origen Destino
    Paquete: RNIF (V02.00) Paquete: Integración de programas de fondo (1.0)
    Protocolo: RosettaNet (V02.00) Protocolo: RNSC (1.0)
    Flujo de documentos: 3A4 (V02.02) Flujo de documentos: 3A4 (V02.02)
    Actividad: Petición de pedido de compra Actividad: Petición de pedido de compra
    Acción: Acción de petición de pedido de compra Acción: Acción de petición de pedido de compra

    Si un sistema de fondo inicia el PIP 3A4 de dos acciones, seleccione las siguientes definiciones de flujo de documentos para la primera acción.

    Tabla 8. PIP 3A4 iniciado por un sistema de fondo
    Origen Destino
    Paquete: Integración de programas de fondo (1.0) Paquete: RNIF (V02.00)
    Protocolo: RNSC (1.0) Protocolo: RosettaNet (V02.00)
    Flujo de documentos: 3A4 (V02.02) Flujo de documentos: 3A4 (V02.02)
    Actividad: Petición de pedido de compra Actividad: Petición de pedido de compra
    Acción: Acción de petición de pedido de compra Acción: Acción de petición de pedido de compra
  6. En el campo Acción, seleccione Traducción bidireccional de RosettaNet y Contenido de servicio de RosettaNet con validación.
  7. Pulse Guardar.
  8. Si está configurando un PIP de dos acciones, repita los pasos necesarios para crear la interacción para la segunda acción. Por ejemplo, seleccione las siguientes definiciones de flujo de documentos para la segunda acción para un PIP 3A4 iniciado por un participante. Ésta es la acción en la que el sistema de fondo envía la respuesta.
    Tabla 9. PIP 3A4 iniciado por un participante (segunda acción)
    Origen Destino
    Paquete: Integración de programas de fondo (1.0) Paquete: RNIF (V02.00)
    Protocolo: RNSC (1.0) Protocolo: RosettaNet (V02.00)
    Flujo de documentos: 3A4 (V02.02) Flujo de documentos: 3A4 (V02.02)
    Actividad: Petición de pedido de compra Actividad: Petición de pedido de compra
    Acción: Acción de confirmación de pedido de compra Acción: Acción de confirmación de pedido de compra

    Para la segunda acción para un PIP 3A4 iniciado por un sistema de fondo, seleccione las siguientes definiciones de flujo de documentos:

    Tabla 10. PIP 3A4 iniciado por un sistema de fondo (segunda acción)
    Origen Destino
    Paquete: RNIF (V02.00) Paquete: Integración de programas de fondo (1.0)
    Protocolo: RosettaNet (V02.00) Protocolo: RNSC (1.0)
    Flujo de documentos: 3A4 (V02.02) Flujo de documentos: 3A4 (V02.02)
    Actividad: Petición de pedido de compra Actividad: Petición de pedido de compra
    Acción: Acción de confirmación de pedido de compra Acción: Acción de confirmación de pedido de compra
  9. Si desea generar la 0A1 Notificación de anomalía, cree una interacción para XMLEvent.
    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. Expanda el árbol Origen hasta el nivel de Flujo de documentos y expanda el árbol Destino hasta el nivel de Flujo de documentos.
    5. Seleccione las siguientes definiciones de flujo de documentos:
      Tabla 11. Definición de flujo de documentos de suceso XML
      Origen Destino
      Paquete: Integración de programas de fondo (1.0) Paquete: Integración de programas de fondo (1.0)
      Protocolo: XMLEvent (1.0) Protocolo: XMLEvent (1.0)
      Flujo de documentos: XMLEvent (1.0) Flujo de documentos: XMLEvent (1.0)
    6. En el campo Acción, seleccione Paso a través.
    7. Pulse Guardar.
  10. Cree una interacción para XMLEvent con 0A1 RNSC.
    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. Expanda el árbol Origen hasta el nivel de Flujo de documentos y expanda el árbol Destino hasta el nivel de Actividad.
    5. Seleccione las siguientes definiciones de flujo de documentos:
      Tabla 12. Definición de flujo de documentos de suceso XML a 0A1
      Origen Destino
      Paquete: Integración de programas de fondo (1.0) Paquete: Integración de programas de fondo (1.0)
      Protocolo: XMLEvent (1.0) Protocolo: RNSC (1.0)
      Flujo de documentos: XMLEvent (1.0) Flujo de documentos: 0A1 (V02.00)
      Actividad: Distribución de notificación de anomalía.
    6. En el campo Acción, seleccione Traducción bidireccional de RosettaNet y XML con validación.
    7. Pulse Guardar.

Copyright IBM Corp. 2003, 2005