Ejemplo de XML a EDI

En este apartado se proporciona un ejemplo del gestor de comunidad enviando un documento XML al concentrador, donde se transforma en una transacción EDI, se ensobra dentro de un intercambio EDI y se envía a un participante.

En este ejemplo, se da por supuesto que el especialista en correlaciones de Data Interchange Services ha creado una correlación de transformación que toma un documento XML y lo transforma en una transacción EDI 850 estándar (definida con el diccionario MX12V3R1) que procesará el participante. En este ejemplo, la correlación de denomina S_DT_XML_TO_EDI.eif.

El especialista en correlaciones de Data Interchange Services puede exportar la correlación de transformación directamente a la base de datos de WebSphere Partner Gateway. Si lo desea, el especialista en correlaciones de Data Interchange Services puede enviarle el archivo, en cuyo caso debe emplear el programa de utilidad bcgDISImport para importarlo en WebSphere Partner Gateway. En este apéndice se da por supuesto el segundo caso.

Importación de la correlación de transformación

En este apartado se describen los pasos para importar una correlación de transformación que tomará la entrada XML y la transformará en una transacción EDI. En el proceso de importar la correlación de transformación, también se importa la definición de documento asociada a la correlación.

Para poder importar la correlación de transformación, el especialista de correlaciones de Data Interchange Services debe enviársela. En este grupo de pasos se da por supuesto que el archivo, S_DT_XML_TO_EDI.eif, está en el sistema.

  1. Abra una ventana de mandatos.
  2. Entre el siguiente mandato o script:

Verificación de correlación de transformación y definiciones de flujo de documentos

Para verificar las correlaciones de transformación y las definiciones de documentos que se han importado están disponibles en la consola de comunidad, realice estos pasos:

  1. Pulse Administrador de concentrador > Configuración de concentrador > Correlaciones> Correlaciones de transformación.

    Aparece la correlación S_DT_XML_TO_EDI.

  2. Pulse el icono Ver detalles situado junto a la correlación.

    Verá las definiciones de flujo de documentos a las que está asociada esta correlación:

    Tabla 29. Definiciones de flujo de documentos asociada a la correlación
    Origen Destino
    Paquete: Ninguno
    Protocolo: FVT-XML-TEST (ALL)
    Flujo de documentos: ICGCPO (ALL)
    Paquete: N/D
    Protocolo: MX12V3R1 (ALL)
    Flujo de documentos: 850 (ALL)

La correlación S_DT_XML_TO_EDI se ha definido para tomar un documento XML y lo transforma en una transacción EDI.

Configuración del destino

En este apartado se creará un destino de directorio del sistema de archivos para el concentrador:

  1. Pulse Administrador de concentrador > Configuración de concentrador > Destinos y pulse Crear destino.
  2. En Nombre de destino, escriba: XMLFileTarget
  3. En la lista Transporte, seleccione Directorio de archivos.
  4. En Vía de acceso raíz de documentos, escriba: /Data/Manager/xmltarget
  5. En la lista Puntos de configuración, seleccione Preproceso.
  6. Seleccione com.ibm.bcg.edi.receiver.preprocesshandler.XMLSplitterHandler en la Lista disponible y pulse Añadir para moverlo a la Lista configurada.
  7. Pulse Guardar.

El gestor de comunidad envía el documento XML a este destino.

Creación de interacciones

Cree dos interacciones, una para la transformación de XML a EDI y uno para el sobre EDI.

Cree una interacción que tenga un origen que represente el documento XML y un destino que representa la transacción 850 transformada.

  1. Pulse Administración de concentrador > Configuración de concentrador > Definición de flujo de documentos.
  2. Pulse Gestionar interacciones y, a continuación, Crear interacción.
  3. Expanda Paquete: Ninguno y Protocolo: FVT-XML-TEST y seleccione Flujo de documentos: ICGCPO.
  4. Expanda Paquete: N/D y Protocolo: MX12V3R1 y seleccione Flujo de documentos: 850.
  5. En la lista Correlación de transformación, seleccione S_DT_XML_TO_EDI.
  6. En la lista Acción, seleccione Conversión de XML y Validación de EDI.
  7. Pulse Guardar.

Esta interacción representa la transformación de un documento XML en una transacción EDI y, por lo tanto, debe seleccionar una correlación de transformación.

Cree una interacción que represente el sobre EDI.

  1. Pulse Administración de concentrador > Configuración de concentrador > Definición de flujo de documentos.
  2. Pulse Gestionar interacciones y, a continuación, Crear interacción.
  3. Expanda Paquete: N/D y Protocolo: EDI-X12 y seleccione Flujo de documentos: ISA.
  4. Expanda Paquete: Ninguno y Protocolo: EDI-X12 y seleccione Flujo de documentos: ISA.
  5. En la lista Acción, seleccione Paso a través.
    Nota: en esta interacción no se produce ninguna transacción.
  6. Pulse Guardar.

Creación de participantes

Para este ejemplo, tiene dos participantes: el gestor de comunidad (gestor) y un participante (TP1).

Cree el perfil del gestor de comunidad:

  1. Pulse Administración de cuentas > Perfiles > Participante de comunidad y pulse Crear.
  2. En Nombre de inicio de sesión de empresa, escriba ComManager
  3. En Nombre de visualización de participante, escriba Gestor.
  4. En Tipo de participante, seleccione Gestor de comunidad.
  5. Pulse Nuevo para ID de empresa y escriba 000000000 como ID de formato libre.
    Nota: asegúrese de seleccionar Formato libre, no DUNS.
  6. Pulse Nuevo otra vez para ID de empresa y escribe 01-000000000 como ID de formato libre.
  7. Pulse Guardar.

Cree el segundo participante:

  1. Pulse Administración de cuentas > Perfiles > Participante de comunidad y pulse Crear.
  2. En Nombre de inicio de sesión de empresa, escriba TP1
  3. En Nombre de visualización de participante, escriba TP1
  4. En Tipo de participante, seleccione Participante.
  5. Pulse Nuevo en ID de empresa y escriba 000000001 como ID de formato libre.
    Nota: asegúrese de seleccionar Formato libre, no DUNS.
  6. Pulse Nuevo otra vez para ID de empresa y escriba 01-000000001 como ID de formato libre.
  7. Pulse Guardar.

Creación de pasarelas

Cree pasarelas de directorios de archivos para los dos participantes del ejemplo. Primero, cree una pasarela para el gestor:

  1. Pulse Administración de cuentas > Perfiles > Participante de comunidad y pulse Buscar.
  2. Pulse el icono Ver detalles situado junto al perfil del gestor.
  3. Pulse Pasarelas y luego Crear.
  4. Especifique los siguientes valores para la pasarela. Recuerde que el directorio de archivos (toda la vía de acceso) ya debe existir en el sistema de archivos.
    1. En Nombre, escriba ManagerFileGateway.
    2. En la lista Transporte, seleccione Directorio de archivos.
    3. En Dirección, escriba: file:///Data/Manager/filegateway
    4. Pulse Guardar.
  5. Pulse Lista para listar todas las pasarelas para el gestor de comunidad.
  6. Pulse Ver pasarelas predeterminadas.
  7. En la lista Producción, seleccione la pasarela que se ha creado en el paso 4.
  8. Pulse Guardar.

A continuación, cree una pasarela para el participante.

  1. Pulse Administración de cuentas > Perfiles > Participante de comunidad y pulse Buscar.
  2. Seleccione el otro participante creado para este ejemplo pulsando en el icono Ver detalles situado junto a TP1.
  3. Pulse Pasarelas y luego Crear.
  4. Especifique los siguientes valores para la pasarela. Recuerde que el directorio de archivos (toda la vía de acceso) ya debe existir.
    1. En Nombre, escriba TP1FileGateway.
    2. En la lista Transporte, seleccione Directorio de archivos.
    3. En Dirección, escriba: file:///Data/TP1/filegateway
    4. Pulse Guardar.
  5. Pulse Lista para listar todas las pasarelas para el participante.
  6. Pulse Ver pasarelas predeterminadas.
  7. En la lista Producción, seleccione la pasarela que se ha creado en el paso 4.
  8. Pulse Guardar.

Configuración de posibilidades B2B

Habilite las posibilidades B2B de los dos participantes de este ejemplo. En este ejemplo, el documento XML se origina en el gestor de comunidad y se entregará al participante (TP1).

  1. Pulse Administración de cuentas > Perfiles > Participante de comunidad y pulse Buscar.
  2. Pulse el icono Ver detalles para el participante de origen de este ejemplo (ComMan).
  3. Pulse Posibilidades B2B.
  4. Habilite tres conjuntos de posibilidades para el participante de origen.
    1. Habilite la definición de flujo de documentos que representa el documento XML.
      1. Pulse el icono El rol no está activo bajo Establecer origen para Paquete: Ninguno para habilitarlo.
      2. Expanda Paquete: Ninguno.
      3. Pulse el icono El rol no está activo bajo Establecer origen para Protocolo: FVT-XML-TEST (ALL).
      4. Expanda Protocolo: FVT-XML-TEST (ALL).
      5. Pulse el icono El rol no está activo bajo Establecer origen para Flujo de documentos: ICGCPO (ALL)
    2. A continuación, habilite la definición de flujo de documentos que representa el documento transformado:
      1. Pulse el icono El rol no está activo bajo Establecer origen para Paquete: N/D para habilitarlo.
      2. Expanda Paquete: N/D.
      3. Pulse el icono El rol no está activo bajo Establecer origen para Protocolo: MX12V3R1 (ALL).
      4. Expanda Protocolo: MX12V3R1 (ALL).
      5. Pulse el icono El rol no está activo bajo Establecer origen para Flujo de documentos: 850.
    3. A continuación, habilite la definición de flujo de documentos que representa el sobre EDI:
      1. Pulse el icono El rol no está activo bajo Establecer origen para Paquete: N/D para habilitarlo.
      2. Expanda Paquete: N/D.
      3. Pulse el icono El rol no está activo bajo Establecer origen para Protocolo: EDI-X12 (ALL).
      4. Expanda Protocolo: EDI-X12 (ALL).
      5. Pulse el icono El rol no está activo bajo Establecer origen para Flujo de documentos: ISA (ALL)
  5. Pulse Administración de cuentas > Perfiles > Participante de comunidad y pulse Buscar.
  6. Pulse el icono Ver detalles para el participante de destino de este ejemplo (TPI).
  7. Pulse Posibilidades B2B.
  8. Habilite dos conjuntos de posibilidades para el participante de destino.
    1. Primero, habilite la definición de flujo de documentos que representa la transacción EDI 850.
      1. Pulse el icono El rol no está activo bajo Establecer destino para Paquete: N/D para habilitarlo.
      2. Expanda Paquete: N/D.
      3. Pulse el icono El rol no está activo bajo Establecer destino para Protocolo: MX12V3R1 (ALL).
      4. Expanda Protocolo: MX12V3R1 (ALL).
      5. Pulse el icono El rol no está activo bajo Establecer destino para Flujo de documentos: 850 (ALL).
    2. A continuación, habilite la definición de flujo de documentos:
      1. Pulse el icono El rol no está activo bajo Establecer destino para Paquete: Ninguno para habilitarlo.
      2. Expanda Paquete: Ninguno.
      3. Pulse el icono El rol no está activo bajo Establecer destino para Protocolo: EDI-X12 (ALL).
      4. Expanda Protocolo: EDI-X12 (ALL).
      5. Pulse el icono El rol no está activo bajo Establecer destino para Flujo de documentos: ISA(ALL).

Creación del perfil de sobre

A continuación, cree el perfil para el sobre que contendrá la transacción 850 transformada.

  1. Pulse Administrador de concentrador > Configuración de concentrador > EDI > Perfil de sobre.
  2. Pulse Crear.
  3. Escriba el nombre del perfil: EnvProf1.
  4. En la lista Estándar EDI, seleccione X12.
  5. El botón General está seleccionado de manera predeterminada. Escriba los siguientes valores para los atributos generales del sobre:
  6. Pulse el botón Intercambio y escriba los siguientes valores para los atributos de intercambio:
  7. Pulse Guardar.

Creación del formato XML

En este apartado se creará el formato XML personalizado.

  1. Pulse Administración de concentrador > Configuración de concentrador > Formatos XML.
  2. Pulse Crear formato XML.
  3. En Formato de direccionamiento, seleccione FVT-XML-TEST ALL.
  4. En Tipo de archivo, seleccione XML.
  5. En Tipo de identificador, seleccione Distintivo de directorio raíz y escriba MMDoc.
  6. En ID de empresa de origen, seleccione Constante y escriba 000000000.
  7. En ID de origen de destino, seleccione Constante y escriba 000000001.
  8. En Flujo de documentos de origen, seleccione Constante y escriba ICGCPO.
  9. En Versión de flujo de documentos de origen, seleccione Constante y escriba ALL.
  10. Pulse Guardar.

Activación de las conexiones

Active las conexiones de participante:

  1. Pulse Administración de cuentas > Conexiones de participante.
  2. Seleccione Gestor en la lista Origen.
  3. Seleccione TP1 en la lista Destino.
  4. Pulse Buscar.
  5. Pulse Activar para la siguiente conexión:
    Tabla 30. Conexión de documento XML con transacción EDI
    Origen Destino
    Paquete: Ninguno (N/D)
    Protocolo: FVT-XML-TEST (ALL)
    Flujo de documentos: ICGCPO (ALL)
    Paquete: N/D (N/D)
    Protocolo: MX12V3R1 (ALL)
    Flujo de documentos: 850 (ALL)
  6. Pulse Activar para la conexión que representa el sobre EDI:
    Tabla 31. Conexión del sobre EDI
    Origen Destino
    Paquete: N/D (N/D)
    Protocolo: EDI-X12 (ALL)
    Flujo de documentos: ISA (ALL)
    Paquete: Ninguno (N/D)
    Protocolo: EDI-X12 (ALL)
    Flujo de documentos: ISA (ALL)

Configuración de atributos

Configure los atributos Posibilidades B2B del participante de destino (TP1) y el participante de origen (gestor):

  1. Pulse Administración de cuentas > Perfiles > Participante de comunidad y pulse Buscar.
  2. Pulse el icono Ver detalles situado junto a TPI para seleccionarlo.
  3. Pulse Posibilidades B2B.
  4. Pulse el icono Expandir situado junto a Paquete: N/D.
  5. Pulse el icono Editar situado junto a Protocolo: MX12V3R1.
  6. Especifique los siguientes atributos:
    1. En la fila Perfil de sobre, seleccione EnvProf1 en la lista.
    2. En la fila Calificador de intercambio, escriba 01.
    3. En la fila Identificador de intercambio, escriba 000000001.
    4. En el Indicador de uso del intercambio, escriba T.
  7. Pulse Guardar.
  8. Pulse Administración de cuentas > Perfiles > Participante de comunidad y pulse Buscar.
  9. Pulse Ver detalles junto a Gestor para seleccionarlo.
  10. Pulse Posibilidades B2B.
  11. Pulse el icono Expandir situado junto a Paquete: N/D.
  12. Pulse el icono Editar situado junto a Protocolo: MX12V3R1 (ALL).
  13. Especifique los siguientes atributos:
    1. En la fila Calificador de intercambio, escriba 01.
    2. En la fila Identificador de intercambio, escriba 000000000.
    3. En el Indicador de uso del intercambio, escriba T.
  14. Pulse Guardar.

En este punto, si el participante de origen (el gestor de comunidad) envía un documento XML al participante, dicho documento se convertirá (en el concentrador) en una transacción EDI ensobrada y luego se enviará a la pasarela del participante.

Copyright IBM Corp. 2003, 2005