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

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 las acciones de codificación y descodificación EDIFACT a un flujo de trabajo de aplicación lógica existente. Cuando no haya 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 versiones diferentes, basadas en el tipo de aplicación lógica y el 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 obtener más información, consulte la siguiente documentación: - Referencia del conector administrado EDIFACT - Límites de mensajes EDIFACT
Consumo	Entorno del servicio de integración (ISE)	Conector administrado EDIFACT (clase estándar) y versión DE ISE EDIFACT , que tiene límites de mensajes diferentes a la clase Standard. El conector EDIFACT solo proporciona acciones, pero puede usar cualquier desencadenador que funcione para su escenario. Para obtener más información, consulte la siguiente documentación: - Referencia del conector administrado EDIFACT - Límites de 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 maneras siguientes: - 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 obtener más información, consulte la siguiente documentación: - Referencia del conector administrado EDIFACT - Operaciones del conector integrado EDIFACT - Límites de mensajes EDIFACT

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

El conector integrado EDIFACT en versión preliminar tiene las siguientes acciones, que son similares a las acciones del conector administrado EDIFACT equivalente, excepto cuando se indiquen en Limitaciones y problemas conocidos.

• Acción Codificar EDIFACT
• Acción Descodificación EDIFACT

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 acción de descodificación EDIFACT en versión preliminar no incluye actualmente las siguientes funcionalidades:

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

    • Conserve todo el intercambio.

    De lo contrario, las acciones del conector integrado de codificación EDIFACT y descodificación EDIFACT en versión preliminar tienen funcionalidades similares a las acciones del conector administrado EDIFACT equivalente.

  • 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 requieren Conectar ion 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:

  • Creación de un flujo de trabajo de aplicación lógica de consumo de ejemplo en Azure Logic Apps multiinquilino

  • Creación de un ejemplo de flujo de trabajo de aplicación lógica del plan Estándar en Azure Logic Apps de un solo inquilino

Codificación de mensajes EDIFACT

La acción del conector administrado EDIFACT denominada Codificar en mensaje EDIFACT y la acción del conector integrado EDIFACT denominada Codificación EDIFACT realiza las siguientes tareas, excepto donde 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.

Consumo

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 siguiente información de conexión 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:

   

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 del mensaje XML para codificar puede ser la salida de contenido cuerpo del desencadenador Solicitud:

   

6. Guarde el flujo de trabajo.

Estándar

Conector integrado EDIFACT (versión preliminar)

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 Codificación EDIFACT al flujo de trabajo.

3. En el panel de acciones EDIFACT, proporcione los valores de propiedad necesarios:

   Propiedad	Obligatorio	Descripción
   Mensaje para codificar	Sí	El contenido del mensaje XML que desea codificar. En concreto, el identificador de negocio para el remitente del mensaje tal y como especifica el contrato EDIFACT.
   Parámetros avanzados	No	En la lista, agregue cualquier otra propiedad que quiera usar. Esta operación incluye los siguientes parámetros: - Calificador del receptor de identidad del remitente - Identificador del receptor de identidad del remitente - Calificador de receptor de identidad de receptor - Identificador de receptor de identidad del receptor - Nombre del contrato EDIFACT

   Por ejemplo, la carga del mensaje XML para codificar puede ser la salida de contenido cuerpo del desencadenador Solicitud:

   

4. Guarde el flujo de trabajo.

Conector administrado ediFACT

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 siguiente información de conexión para la cuenta de integración:

   Propiedad	Obligatorio	Descripción
   Nombre de la conexión	Sí	Un nombre para la conexión
   Id. de cuenta de integración	Sí	El identificador de recurso de la cuenta de integración, que tiene el formato siguiente: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Por ejemplo: /subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Para encontrar este identificador de recurso, siga estos pasos: 1. En el Azure Portal, abra la cuenta de integración. 2. En el menú de la cuenta de integración, seleccione Información general. 3. En la página Información general, seleccione el Vista JSON. 4. Desde la propiedad Identificador de recurso, copie el valor.
   Dirección URL de SAS de la cuenta de integración	Sí	La dirección URL del punto de conexión de solicitud que usa la autenticación de firma de acceso compartido (SAS) para proporcionar acceso a la cuenta de integración. Esta dirección URL de devolución de llamada tiene el formato siguiente: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Por ejemplo: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=ZZZZZZZZZZZZZZZZZZZZZZZZZZZ Para encontrar esta dirección URL, siga estos pasos: 1. En el Azure Portal, abra la cuenta de integración. 2. En el menú de la cuenta de integración, en Configuración, seleccione Dirección URL de devolución de llamada. 3. Desde la propiedad Dirección URL de devolución de llamada generada, copie el valor.
   Tamaño del bloque de números de control	No	Tamaño de bloque de números de control que se van a reservar de un contrato para escenarios de alto rendimiento

   Por ejemplo:

   

4. Seleccione Crear cuando haya terminado.

5. En el panel de acciones 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 del mensaje XML para codificar puede ser la salida de contenido cuerpo del desencadenador Solicitud:

   

6. Guarde el flujo de trabajo.

Descodificación de mensajes EDIFACT

La acción del conector administrado EDIFACT denominada Descodificar mensaje EDIFACT y la acción del conector integrado EDIFACT denominada Descodificación EDIFACT realiza las siguientes tareas, excepto donde 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.

Consumo

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 siguiente información de conexión 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:

   

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:

   

Estándar

Conector integrado EDIFACT (versión preliminar)

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 Descodificación EDIFACT al flujo de trabajo.

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

   Propiedad	Obligatorio	Descripción
   Mensaje para 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 repetición - Terminador de segmento - Sufijo de terminador de segmento - Indicador decimal - Juego de caracteres de carga - 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:

   

4. Guarde el flujo de trabajo.

Conector administrado ediFACT

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 siguiente información de conexión 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:

   

4. Seleccione Crear cuando haya terminado.

5. En el panel de acciones 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 del mensaje XML para descodificar puede ser la salida del contenido del cuerpo del desencadenador Request:

   

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 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 estándar o consumo, 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.

     

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

     

Pasos siguientes

• Configuración de mensajes EDIFACT