Compartir vía

Intercambio de mensajes EDIFACT mediante flujos de trabajo en Azure Logic Apps

  • Artículo

Para enviar y recibir mensajes EDIFACT en los flujos de trabajo que crea mediante Azure Logic Apps, use el conector EDIFACT que ofrece operaciones que admiten y administran comunicaciones EDIFACT.

En esta guía se muestra cómo agregar la codificación EDIFACT y las acciones de descodificación a un flujo de trabajo de aplicación lógica existente. Cuando no hay ningún desencadenador EDIFACT disponible, puede iniciar el flujo de trabajo. Los ejemplos de esta guía usan el Desencadenador de solicitud.

Referencia técnica del conector

El conector EDIFACT tiene diferentes versiones, en función del tipo de aplicación lógica y del entorno de host.

Aplicación lógica Entorno Versión del conector
Consumo Azure Logic Apps multiinquilino Conector administrado EDIFACT (Clase estándar). El conector EDIFACT solo proporciona acciones, pero puede usar cualquier desencadenador que funcione para su escenario. Para más información, consulte la siguiente documentación:

- Referencia del conector administrado EDIFACT
- Límites de los mensajes EDIFACT
Estándar Azure Logic Apps de inquilino único y App Service Environment v3 (solo planes de Windows) Conector integrado EDIFACT (versión preliminar) y conector administrado EDIFACT. La versión integrada difiere de las siguientes maneras:

- La versión integrada solo proporciona acciones, pero puede usar cualquier desencadenador que funcione para su escenario.

- La versión integrada puede acceder directamente a las redes virtuales de Azure. No necesita una puerta de enlace de datos local.

Para más información, consulte la siguiente documentación:

- Referencia del conector administrado EDIFACT
- Operaciones del conector integrado EDIFACT
- Límites de los mensajes EDIFACT

Operaciones integradas EDIFACT (solo flujos de trabajo estándar: versión preliminar)

La versión preliminar del conector integrado EDIFACT tiene las siguientes acciones, que son similares a las acciones de su conector administrado EDIFACT homólogo, excepto donde se indica en Limitaciones y problemas conocidos.

Limitaciones y problemas conocidos

  • Versión preliminar del conector integrado EDIFACT

    • Esta funcionalidad está en versión preliminar y está sujeta a las Condiciones de uso complementarias para las versiones preliminares de Microsoft Azure.

    • Actualmente, las acciones de este conector admiten cargas de hasta 100 MB como mínimo.

    • La versión preliminar de la acción Descodificar EDIFACT actualmente no incluye las siguientes funcionalidades:

      • Compruebe si hay números de control de intercambio, grupo y conjunto de transacciones duplicados, si están configurados.

      • Conserve todo el intercambio.

      Por lo demás, la versión preliminar de las acciones del conector integradas Codificación EDIFACT y Descodificación EDIFACT tienen funcionalidades similares a las de sus acciones de conector administrado EDIFACT homólogas.

    • Actualmente, las acciones de este conector no admiten intercambios con varias transacciones o mensajes por lotes.

    • Actualmente, las acciones de este conector no emiten seguimiento específico de EDI.

Requisitos previos

  • Una cuenta y una suscripción de Azure. Si aún no tiene suscripción, regístrese para obtener una cuenta de Azure gratuita.

  • Un recurso de cuenta de integración, donde se definen y almacenan artefactos, como socios comerciales, contratos, certificados, entre otros, para su uso en los flujos de trabajo de integración empresarial y B2B. Este recurso tiene que satisfacer los siguientes requisitos:

    • Tanto la cuenta de integración como el recurso de aplicación lógica deben existir en la misma suscripción y región de Azure.

    • Define al menos dos asociados comerciales que participen en la operación EDIFACT utilizada en el flujo de trabajo. Las definiciones de ambos asociados deben usar el mismo calificador de identidad empresarial, que es ZZZ - Mutually Defined en este escenario.

    • Define un contrato EDIFACT entre los asociados comerciales que participan en el flujo de trabajo. En cada contrato hacen falta un asociado anfitrión y un asociado invitado. El contenido de los mensajes entre usted y el otro asociado debe coincidir con el tipo de contrato. Para obtener información sobre la configuración del contrato que se va a usar al recibir y enviar mensajes, consulte configuraciones de mensaje EDIFACT.

      Importante

      El conector EDIFACT solo admite caracteres UTF-8. Si la salida contiene caracteres inesperados, compruebe que los mensajes EDIFACT utilizan el juego de caracteres UTF-8.

  • En función de si está trabajando en un flujo de trabajo de aplicación lógica de consumo o en uno estándar, es posible que el recurso de la aplicación lógica necesite un vínculo a la cuenta de integración:

    Flujo de trabajo de la aplicación lógica ¿Se necesita un vínculo?
    Consumo Se requiere conexión y vínculo a la cuenta de integración. Puede crear la conexión al agregar la operación EDIFACT al flujo de trabajo.
    Estándar Se necesita la conexión a la cuenta de integración, pero no se necesita ningún vínculo. Puede crear la conexión al agregar la operación EDIFACT al flujo de trabajo.

  • El recurso de aplicación lógica y el flujo de trabajo en los que quiere usar las operaciones EDIFACT.

    Para más información, consulte la siguiente documentación:

Codificación de mensajes EDIFACT

La acción del conector administrado EDIFACT denominada acción Codificar a mensaje EDIFACT y la acción del conector incorporado EDIFACT denominada Codificar EDIFACT realizan las siguientes tareas, excepto cuando se indica en Limitaciones y problemas conocidos:

  • Permite resolver el contrato haciendo coincidir el calificador y el identificador del remitente con el calificador y el identificador del receptor del receptor.

  • Permite serializar el intercambio electrónico de datos (EDI), que convierte los mensajes codificados en XML en conjuntos de transacciones EDI del intercambio.

  • Permite aplicar segmentos de encabezado y final del conjunto de transacciones.

  • Permite generar un número de control de intercambio, un número de control de grupo y un número de control del conjunto de transacciones para cada intercambio de salida.

  • Permite reemplazar los separadores en los datos de carga útil.

  • Permite validar las propiedades EDI y específicas del asociado, como el esquema para los elementos de datos del conjunto de transacciones frente al esquema del mensaje, los elementos de datos del conjunto de transacciones y la validación extendida en los elementos de datos del conjunto de transacciones.

  • Permite generar un documento XML para cada conjunto de transacciones.

  • Permite solicitar una confirmación técnica, una funcional o ambas, si esta opción está configurada.

    • Como confirmación técnica, el mensaje CONTRL indica la recepción de un intercambio.

    • Como confirmación funcional, el mensaje CONTRL indica la aceptación o el rechazo del intercambio, el grupo o el mensaje recibido, y se incluye una lista de errores o una funcionalidad no admitida.

  1. En Azure Portal, abra el recurso de la aplicación lógica y el flujo de trabajo en el diseñador.

  2. En el diseñador, siga estos pasos generales para agregar la acción EDIFACT denominada Codificar en mensaje EDIFACT por nombre del contrato al flujo de trabajo.

    Nota:

    Si quiere usar la acción Codificar en mensaje EDIFACT por identidades en su lugar, más adelante tendrá que proporcionar valores diferentes, como el identificador de remitente y el identificador de receptor especificados por el contrato EDIFACT. También debe especificar el mensaje XML para codificar, que puede ser la salida del desencadenador o una acción anterior.

  3. Proporcione la información de conexión siguiente para la cuenta de integración:

    Propiedad Obligatorio Descripción
    Nombre de la conexión Sí Un nombre para la conexión
    cuenta de integración Sí En la lista de cuentas de integración disponibles, seleccione la cuenta que desea usar.

    Por ejemplo:

    Recorte de pantalla que muestra Azure Portal, flujo de trabajo de consumo y cuadro de conexión para la acción denominada Codificar a mensaje EDIFACT por nombre de contrato.

  4. Seleccione Crear cuando haya terminado.

  5. En la acción EDIFACT, proporcione los siguientes valores de propiedad:

    Propiedad Obligatorio Descripción
    Nombre del contrato EDIFACT Sí Contrato EDIFACT que se usará.
    Mensaje XML que se va a codificar Sí Identificador empresarial del remitente del mensaje según lo especificado por su contrato EDIFACT.
    Otros parámetros No Esta operación incluye los siguientes parámetros:

    - Separador de elementos de datos
    - Indicador de versión
    - Separador de componentes
    - Separador de repeticiones
    - Terminador de segmentos
    - Sufijo de terminador de segmento
    - Indicador decimal

    Para obtener más información, consulte Configuración de mensajes EDIFACT.

    Por ejemplo, la carga útil del mensaje XML que se va a codificar puede ser el contenido del cuerpo de la solicitud:

    Recorte de pantalla que muestra el flujo de trabajo de consumo, acción denominada Codificar a mensaje EDIFACT por nombre de contrato y propiedades de codificación de mensajes.

  6. Guarde el flujo de trabajo.

Descodificación de mensajes EDIFACT

La acción del conector administrado EDIFACT denominada acción Descodificar mensaje EDIFACT y la acción del conector incorporado EDIFACT denominada Descodificar EDIFACT realizan las siguientes tareas, excepto cuando se indica en Limitaciones y problemas conocidos:

  • Permite validar el sobre según el acuerdo entre socios comerciales.

  • Permite resolver el contrato haciendo coincidir el calificador y el identificador del remitente con el calificador y el identificador del receptor.

  • Permite dividir un intercambio en varias transacciones cuando el intercambio tiene más de una transacción que se basa en la configuración de recepción del contrato.

  • Desensamblar el intercambio.

  • Valide el intercambio electrónico de datos (EDI) y las propiedades específicas del asociado, como la estructura de sobres de intercambio, el esquema de sobres con respecto al esquema de control, el esquema de los elementos de datos del conjunto de transacciones con respecto al esquema del mensaje y la validación extendida en los elementos de datos del conjunto de transacciones.

  • Compruebe que los números de control de intercambio, grupo y conjunto de transacciones no están duplicados (solo conector administrado), si está configurado, por ejemplo:

    • Comprueba el número de control del intercambio con los intercambios recibidos anteriormente.

    • Comprueba el número de control del grupo en relación con otros números de control de grupo en el intercambio.

    • Comprueba el número de control del conjunto de transacciones con otros números de control del conjunto de transacciones de dicho grupo.

  • Divida el intercambio en conjuntos de transacciones o conserve todo el intercambio (solo conector administrado), por ejemplo:

    • Permite dividir el intercambio como conjuntos de transacciones: suspender conjuntos de transacciones en caso de error.

      La acción de descodificación divide el intercambio en conjuntos de transacciones y analiza cada uno de ellos. La acción de descodificación solo genera los conjuntos de transacciones que no superan la validación para badMessages y los resultados de las transacciones restantes se establecen en goodMessages.

    • Permite dividir el intercambio como conjuntos de transacciones: suspender intercambio en caso de error.

      La acción de descodificación divide el intercambio en conjuntos de transacciones y analiza cada uno de ellos. Si uno o varios conjuntos de transacciones del intercambio no superan la validación, la acción establece todos los conjuntos de transacciones del intercambio en badMessages.

    • Permite conservar el intercambio: suspender conjuntos de transacciones en caso de error.

      La acción de descodificación conserva el intercambio y lo procesa todo por lotes. La acción de descodificación solo genera los conjuntos de transacciones que no superan la validación para badMessages y los resultados de las transacciones restantes se establecen en goodMessages.

    • Permite conservar el intercambio: suspender intercambio en caso de error.

      La acción de descodificación conserva el intercambio y lo procesa todo por lotes. Si uno o varios conjuntos de transacciones del intercambio no superan la validación, la acción establece todos los conjuntos de transacciones del intercambio en badMessages.

  • Permite generar una confirmación técnica, una funcional o ambas, si esta opción está configurada.

    • Una confirmación técnica o CONTRL ACK informa de los resultados de una comprobación sintáctica de todo intercambio recibido.

    • Una confirmación funcional que confirma la aceptación o rechazo del intercambio o grupo recibido.

  1. En Azure Portal, abra el recurso de la aplicación lógica y el flujo de trabajo en el diseñador.

  2. En el diseñador, siga estos pasos generales para agregar la acción EDIFACT denominada Descodificar mensaje EDIFACT al flujo de trabajo.

  3. Proporcione la información de conexión siguiente para la cuenta de integración:

    Propiedad Obligatorio Descripción
    Nombre de la conexión Sí Un nombre para la conexión
    cuenta de integración Sí En la lista de cuentas de integración disponibles, seleccione la cuenta que desea usar.

    Por ejemplo:

    Recorte de pantalla que muestra el diseñador de flujo de trabajo de consumo y el panel de conexión para la acción denominada Descodificar mensaje EDIFACT.

  4. Seleccione Crear cuando haya terminado.

  5. En la acción EDIFACT, proporcione los siguientes valores de propiedad:

    Propiedad Obligatorio Descripción
    Mensaje de archivo plano EDIFACT que se va a descodificar Sí Mensaje de archivo plano XML que se va a descodificar.
    Otros parámetros No Esta operación incluye los siguientes parámetros:

    - Separador de componentes
    - Separador de elementos de datos
    - Indicador de versión
    - Separador de repeticiones
    - Terminador de segmentos
    - Sufijo de terminador de segmento
    - Indicador decimal
    - Juego de caracteres de carga útil
    - Sufijo de terminador de segmento
    - Conservar intercambio
    - Suspender intercambio en caso de error

    Para obtener más información, consulte Configuración de mensajes EDIFACT.

    Por ejemplo, la carga del mensaje XML para descodificar puede ser la salida del contenido del cuerpo del desencadenador Request:

    Recorte de pantalla que muestra el flujo de trabajo de consumo, la acción denominada Descodificar mensaje EDIFACT y las propiedades de descodificación de mensajes.

Control de segmentos UNH2.5 en documentos EDIFACT

En un documento EDIFACT, el segmento UNH2.5 se usa para la búsqueda de esquemas. Por ejemplo, en este mensaje EDIFACT de ejemplo, el campo UNH es EAN008:

UNH+SSDD1+ORDERS:D:03B:UN:EAN008

Para controlar un documento EDIFACT o procesar un mensaje EDIFACT que tiene un segmento UN2.5, siga estos pasos:

  1. Actualice o implemente un esquema que tenga el nombre de nodo raíz UNH2.5.

    Por ejemplo, supongamos que el nombre de la raíz del esquema para el campo UNH del ejemplo es EFACT_D03B_ORDERS_EAN008. Para cada D03B_ORDERS con un segmento UNH2.5 diferente, tiene que implementar un esquema distinto.

  2. En el Azure Portal, agregue el esquema al recurso de la cuenta de integración o al recurso de aplicación lógica, en función de si tiene un flujo de trabajo de aplicación lógica de consumo o estándar, respectivamente.

  3. Tanto si está usando la acción de descodificación o codificación EDIFACT, cargue el esquema y realice configuración del esquema en las secciones Configuración de recepción o Configuración de envío del contrato EDIFACT, respectivamente.

  4. Para editar el contrato EDIFACT, en el panel Contratos, seleccione el contrato pertinente. En la barra de herramientas del panel Contratos, seleccione Editar como JSON.

    • En la sección receiveAgreement del contrato, busque la sección schemaReferences y agregue el valor UNH2.5.

      Captura de pantalla que muestra Azure Portal con la sección

    • En la sección sendAgreement del contrato, busque la sección schemaReferences y agregue el valor UNH2.5.

      Captura de pantalla que muestra Azure Portal con la sección

Pasos siguientes