Partilhar via

Trocar mensagens EDIFACT usando fluxos de trabalho nos Aplicativos Lógicos do Azure

Para enviar e receber mensagens EDIFACT em fluxos de trabalho que criar usando os Aplicativos Lógicos do Azure, use o conector EDIFACT, que fornece operações que suportam e gerem a comunicação EDIFACT.

Este guia mostra como adicionar as ações de codificação e decodificação EDIFACT a um fluxo de trabalho de aplicativo lógico existente. Quando nenhum gatilho EDIFACT está disponível, pode usar qualquer gatilho para iniciar o seu fluxo de trabalho. Os exemplos neste guia usam o gatilho de pedido Request trigger.

Referência técnica do conector

O conector EDIFACT tem diferentes versões, com base no tipo de aplicativo lógico e no ambiente de host.

Aplicação de Lógica Ambiente Versão do conector
Consumo Aplicativos Lógicos Multilocatário do Azure Conector gerenciado EDIFACT (classe padrão). O conector EDIFACT tem apenas um gatilho, mas você pode usar qualquer gatilho que funcione para o seu cenário. Para obter mais informações, consulte a seguinte documentação:

- Referência do conector gerenciado EDIFACT
- Limites de mensagens EDIFACT
Standard Aplicações Lógicas do Azure e Ambiente de Serviço de Aplicações v3 para um único cliente (apenas para planos Windows) EDIFACT conector integrado e EDIFACT conector gerido. A versão integrada difere das seguintes maneiras:

- A versão integrada fornece apenas ações, mas você pode usar qualquer gatilho que funcione para o seu cenário.

- Aceita um arquivo simples como entrada versus XML para a versão gerenciada.

- A versão interna pode acessar diretamente as redes virtuais do Azure. Você não precisa de um gateway de dados local.

Para obter mais informações, consulte a seguinte documentação:

- Referência do conector gerenciado EDIFACT
- operações de conector incorporadas do EDIFACT
- Limites de mensagens EDIFACT

Operações integradas EDIFACT (somente fluxos de trabalho padrão)

O conector integrado EDIFACT tem as seguintes ações, que são semelhantes às ações do conector gerido EDIFACT correspondente, exceto conforme observado em Limitações e problemas conhecidos.

Limitações e problemas conhecidos

  • EDIFACT conector embutido

    • Atualmente, as ações deste conector suportam cargas úteis de até 100 MB.

    • A ação EDIFACT Decode atualmente não inclui os seguintes recursos:

      • Verifique se há números de controle duplicados de intercâmbio, grupo e conjunto de transações, caso esteja configurado.

      • Preservar todo o intercâmbio.

      Caso contrário, as ações do conector incorporado EDIFACT Encode e EDIFACT Decode têm recursos semelhantes às ações do conector gerido EDIFACT correspondentes.

    • Atualmente, as ações deste conector não suportam intercâmbios com múltiplas transações ou mensagens agrupadas.

    • Atualmente, as ações desse conector não emitem rastreamento específico de EDI.

Pré-requisitos

  • Uma conta e subscrição do Azure. Se ainda não tiver uma subscrição, inscreva-se numa conta gratuita do Azure.

  • Um recurso de conta de integração onde você define e armazena artefatos, como parceiros comerciais, contratos, certificados e assim por diante, para uso em sua integração empresarial e fluxos de trabalho B2B. Este recurso tem de cumprir os seguintes requisitos:

    • Sua conta de integração e o recurso do aplicativo lógico devem existir na mesma assinatura do Azure e na mesma região do Azure.

    • Define pelo menos dois parceiros comerciais que participam da operação EDIFACT usada em seu fluxo de trabalho. As definições para ambos os parceiros devem usar o mesmo qualificador de identidade comercial, que é ZZZ - Mutuamente Definido para este cenário.

    • Define um acordo EDIFACT entre os parceiros comerciais que participam do seu fluxo de trabalho. Cada acordo requer um parceiro anfitrião e um parceiro convidado. O conteúdo das mensagens entre você e o outro parceiro deve corresponder ao tipo de contrato. Para obter informações sobre as configurações de contrato a serem usadas ao receber e enviar mensagens, consulte Configurações de mensagem EDIFACT.

      Importante

      O conector EDIFACT suporta apenas caracteres UTF-8. Se a saída contiver caracteres inesperados, verifique se as mensagens EDIFACT usam o conjunto de caracteres UTF-8.

  • Com base em se estás a trabalhar num fluxo de trabalho de aplicação lógica de consumo ou padrão, o teu recurso de aplicação lógica poderá necessitar de um link para a tua conta de integração.

    Fluxo de trabalho da aplicação lógica Link necessário?
    Consumo Conexão e link para a conta de integração são necessários. Você pode criar a conexão ao adicionar a operação EDIFACT ao seu fluxo de trabalho.
    Standard Conexão com a conta de integração necessária, mas nenhum link necessário. Você pode criar a conexão ao adicionar a operação EDIFACT ao seu fluxo de trabalho.

  • O recurso do aplicativo lógico e o fluxo de trabalho onde você deseja usar as operações EDIFACT.

    Para obter mais informações, veja a seguinte documentação:

  • O conteúdo a codificar ou descodificar. Em fluxos de trabalho de consumo, as ações do conector gerenciado EDIFACT aceitam uma mensagem XML como entrada. Em fluxos de trabalho padrão, as ações de conector interno EDIFACT aceitam um arquivo simples, enquanto o conector gerenciado EDIFACT aceita uma mensagem XML.

Codificar mensagens EDIFACT

A ação do conector gerido EDIFACT chamada Codificar para mensagem EDIFACT e a ação do conector incorporado EDIFACT chamada EDIFACT Encode executam as seguintes tarefas, exceto conforme observado em Limitações e problemas conhecidos.

  • Resolvam o acordo ao corresponder o qualificador e identificador do remetente com o qualificador e identificador do destinatário.

  • Serializar o Intercâmbio Eletrônico de Dados (EDI), que converte mensagens codificadas em XML em conjuntos de transações EDI na troca.

  • Aplique segmentos de cabeçalho e trailer ao conjunto de transações.

  • Gere um número de controle de intercâmbio, um número de controle de grupo e um número de controle de conjunto de transações para cada intercâmbio de saída.

  • Substitua os separadores nos dados de carga útil.

  • Valide o EDI e as propriedades específicas do parceiro, como o esquema de elementos de dados do conjunto de transações em comparação com o esquema da mensagem, e aplique validação estendida nesses elementos de dados.

  • Gere um documento XML para cada conjunto de transações.

  • Solicite um reconhecimento técnico, um reconhecimento funcional ou ambos, se estiver configurado.

    • Como reconhecimento técnico, a mensagem CONTRL indica o recibo de um intercâmbio.

    • Como reconhecimento funcional, a mensagem CONTRL indica a aceitação ou rejeição do intercâmbio, grupo ou mensagem recebidos, incluindo uma lista de erros ou funcionalidades não suportadas.

  1. No portal do Azure, abra o recurso e o fluxo de trabalho da aplicação lógica no Designer.

  2. No designer, siga estas etapas gerais para adicionar a ação EDIFACT chamada Codificar mensagem para EDIFACT por nome do acordo ao seu fluxo de trabalho.

    Nota

    Se você quiser usar a ação Codificar para mensagem EDIFACT por identidades, mais tarde terá que fornecer valores diferentes, como o identificador de remetente e identificador de recetor especificado pelo seu contrato EDIFACT. Você também precisa especificar a mensagem XML a ser codificada, que pode ser a saída do gatilho ou uma ação anterior.

  3. Forneça as seguintes informações de conexão para sua conta de integração:

    Propriedade Necessário Descrição
    Nome da ligação Sim Um nome para a conexão
    Conta de integração Sim Na lista de contas de integração disponíveis, selecione a conta a ser usada.

    Por exemplo:

    A captura de tela mostra o portal do Azure, o fluxo de trabalho de Consumo e a caixa de conexão para a ação chamada Codificar para mensagem EDIFACT pelo nome do contrato.

  4. Quando tiver terminado, selecione Criar.

  5. Na ação EDIFACT , forneça os seguintes valores de propriedade:

    Propriedade Necessário Descrição
    Nome do acordo EDIFACT Sim O acordo EDIFACT a ser utilizado.
    Mensagem XML para codificar Sim A mensagem XML a ser codificada. Especificamente, o identificador comercial do remetente da mensagem, conforme especificado pelo seu contrato EDIFACT.
    Outros parâmetros Não Esta operação inclui os seguintes outros parâmetros:

    - Separador de elementos de dados
    - Indicador de libertação
    - Separador de componentes
    - Separador de repetição
    - Terminador de segmento
    - Sufixo terminador de segmento
    - Indicador decimal

    Para obter mais informações, consulte Configurações de mensagem EDIFACT.

    Por exemplo, a carga útil a codificar pode ser o conteúdo do Body de saída do gatilho Request:

    A captura de tela mostra o fluxo de trabalho de consumo, a ação chamada Codificar para mensagem EDIFACT pelo nome do contrato e as propriedades de codificação da mensagem.

  6. Salve seu fluxo de trabalho.

Descodificar mensagens EDIFACT

A ação do conector gerido EDIFACT denominada Decodificar mensagem EDIFACT e a ação do conector incorporado EDIFACT denominada Decodificar EDIFACT executam as seguintes tarefas, exceto conforme observado em Limitações e problemas conhecidos:

  • Valide o envelope com base no contrato do parceiro comercial.

  • Resolva o acordo ao corresponder o qualificador e o identificador do remetente com o qualificador e o identificador do destinatário.

  • Divida uma troca em vários conjuntos de transações com base nas Definições de Recebimento do contrato, quando a troca tiver mais de uma transação.

  • Desmonte a estrutura de intercâmbio.

  • Valide o EDI (Electronic Data Interchange) e propriedades específicas do parceiro, como a estrutura do envelope de intercâmbio, o esquema do envelope em relação ao esquema de controle, o esquema para os elementos de dados do conjunto de transações em relação ao esquema de mensagem e a validação estendida nos elementos de dados do conjunto de transações.

  • Verifique se os números de controle para o intercâmbio, o grupo e o conjunto de transações não são duplicados (somente o conector gerido), se configurados, por exemplo:

    • Verifique o número de controle de intercâmbio em relação a intercâmbios recebidos anteriormente.

    • Verifique o número de controle de grupo em relação a outros números de controle de grupo no intercâmbio.

    • Verifique o número de controle do conjunto de transações em relação a outros números de controle do conjunto de transações nesse grupo.

  • Divida o intercâmbio em conjuntos de transações ou preserve todo o intercâmbio (somente conector gerenciado), por exemplo:

    • Divida a Intercâmbio em conjuntos de transações - suspenda os conjuntos de transações em caso de erro.

      A ação de decodificação divide o intercâmbio em conjuntos de transações e analisa cada conjunto de transações. A ação produz apenas os conjuntos de transações que falham na validação para badMessages, e produz os conjuntos de transações restantes para goodMessages.

    • Divida o Intercâmbio em conjuntos de transações - suspenda o intercâmbio em caso de erro.

      A ação de decodificação divide o intercâmbio em conjuntos de transações e analisa cada conjunto de transações. Se um ou mais conjuntos de transações no intercâmbio falharem na validação, a ação produzirá todos os conjuntos de transações nesse intercâmbio para badMessages.

    • Preserve Interchange - suspenda conjuntos de transações em caso de erro.

      A ação de decodificação preserva o intercâmbio e processa todo o intercâmbio em lote. A ação produz apenas os conjuntos de transações que falham na validação para badMessages, e produz os conjuntos de transações restantes para goodMessages.

    • Preserve Interchange - suspenda o intercâmbio em caso de erro.

      A ação de decodificação preserva o intercâmbio e processa todo o intercâmbio em lote. Se um ou mais conjuntos de transações no intercâmbio falharem na validação, a ação produzirá todos os conjuntos de transações nesse intercâmbio para badMessages.

  • Gere um reconhecimento técnico, um reconhecimento funcional ou ambos, se configurado.

    • Um reconhecimento técnico ou o CONTRL ACK, que relata os resultados de uma verificação sintática completa sobre todo o intercâmbio recebido.

    • Um reconhecimento funcional que confirma a aceitação ou rejeição do intercâmbio ou grupo recebido.

  1. No portal do Azure, abra o recurso e o fluxo de trabalho da aplicação lógica no Designer.

  2. No designer, siga estas etapas gerais para adicionar a ação EDIFACT chamada Decodificar mensagem EDIFACT ao seu fluxo de trabalho.

  3. Forneça as seguintes informações de conexão para sua conta de integração:

    Propriedade Necessário Descrição
    Nome da ligação Sim Um nome para a conexão
    Conta de integração Sim Na lista de contas de integração disponíveis, selecione a conta a ser usada.

    Por exemplo:

    A captura de tela mostra o designer de fluxo de trabalho de consumo e o painel de conexão para a ação chamada Decodificar mensagem EDIFACT.

  4. Quando tiver terminado, selecione Criar.

  5. Na ação EDIFACT , forneça os seguintes valores de propriedade:

    Propriedade Necessário Descrição
    Mensagem de arquivo simples EDIFACT para decodificar Sim A mensagem de arquivo plano XML para descodificar.
    Outros parâmetros Não Esta operação inclui os seguintes outros parâmetros:

    - Separador de componentes
    - Separador de elementos de dados
    - Indicador de libertação
    - Separador de repetição
    - Terminador de segmento
    - Sufixo terminador de segmento
    - Indicador decimal
    - Conjunto de caracteres da carga de dados
    - Sufixo terminador de segmento
    - Preservar o intercâmbio
    - Suspender intercâmbio em caso de erro

    Para obter mais informações, consulte Configurações de mensagem EDIFACT.

    Por exemplo, a carga a ser decodificada pode ser o conteúdo do corpo de saída do gatilho Request:

    A captura de tela mostra o fluxo de trabalho de consumo, a ação chamada Decodificar mensagem EDIFACT e as propriedades de decodificação de mensagens.

Manipular segmentos UNH2.5 em documentos EDIFACT

Em um documento EDIFACT, o segmento UNH2.5 é usado para pesquisa de esquema. Por exemplo, nesta mensagem EDIFACT de exemplo, o campo UNH é EAN008:

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

Para manipular um documento EDIFACT ou processar uma mensagem EDIFACT que tenha um segmento UN2.5, siga estas etapas:

  1. Atualize ou implante um esquema que tenha o nome do nó raiz UNH2.5.

    Por exemplo, suponha que o nome da raiz do esquema para o campo UNH de exemplo seja EFACT_D03B_ORDERS_EAN008. Para cada D03B_ORDERS que tem um segmento UNH2.5 diferente, é preciso implantar um esquema individual.

  2. No portal Azure, adicione o esquema ao recurso da sua conta de integração ou ao recurso do aplicativo lógico, dependendo se tem um fluxo de trabalho de aplicativo lógico de Consumo ou Padrão, respetivamente.

  3. Se você estiver usando a ação de decodificação ou codificação EDIFACT, carregue seu esquema e configure as configurações de esquema nas seções Configurações de recebimento ou Configurações de envio do contrato EDIFACT, respectivamente.

  4. Para editar seu contrato EDIFACT, no painel Contratos , selecione seu contrato. Na barra de ferramentas do painel Contratos, selecione Editar como JSON.

    • Na seção receiveAgreement do contrato, localize a seção schemaReferences e adicione o valor UNH2.5.

      Captura de tela mostrando o portal do Azure com a seção

    • Na seção do sendAgreementcontrato, localize a schemaReferences seção e adicione o valor UNH2.5.

      Captura de tela mostrando o portal do Azure com a seção

Próximos passos

  • Last updated on