Compartilhar via

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

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

Este guia mostra como adicionar as ações de codificação e decodificação EDIFACT a um fluxo de trabalho do aplicativo lógico existente. Quando nenhum gatilho EDIFACT estiver disponível, você poderá usar qualquer gatilho para iniciar o fluxo de trabalho. Os exemplos neste guia usam o Gatilho de solicitação.

Referência técnica do conector

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

Aplicativo lógico Ambiente Versão do conector
Consumo Aplicativos Lógicos Multilocatários do Azure Conector gerenciado EDIFACT (classe Standard). O conector EDIFACT tem apenas um gatilho, mas você pode usar qualquer gatilho que funcione para seu cenário. Para saber mais, confira a seguinte documentação:

- Referência do conector gerenciado EDIFACT
- Limites de mensagens EDIFACT
Standard Aplicativos Lógicos do Azure de locatário único e Ambiente do Serviço de Aplicativo v3 (somente planos Windows) Conector interno EDIFACT e conector gerenciado EDIFACT. A versão interna é diferente das seguintes maneiras:

– A versão interna fornece apenas ações, mas você pode usar qualquer gatilho que funcione para 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 saber mais, confira a seguinte documentação:

- Referência do conector gerenciado EDIFACT
- Operações internas de conector EDIFACT
- Limites de mensagens EDIFACT

Operações internas EDIFACT (somente fluxos de trabalho Padrão)

O conector interno EDIFACT tem as seguintes ações, que são semelhantes às ações do conector gerenciado EDIFACT de seu equivalente, exceto quando observado em Limitações e problemas conhecidos.

Limitações e problemas conhecidos

  • Conector interno EDIFACT

    • No momento, as ações desse conector dão suporte a cargas de até 100 MB.

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

      • Verificar se há números de controle duplicados de intercâmbio, grupo e conjunto de transações, se configurados.

      • Preservar todo o intercâmbio.

      Caso contrário, as ações de conector interno de codificação EDIFACT e decodificação EDIFACT têm funcionalidades semelhantes às ações do conector gerenciado EDIFACT de seu equivalente.

    • No momento, as ações desse conector não dão suporte a intercâmbios com várias transações ou mensagens em lote.

    • No momento, as ações desse conector não emitem controle específico de EDI.

Pré-requisitos

  • Uma conta e uma assinatura do Azure. Caso ainda não tenha uma assinatura, inscreva-se em uma conta gratuita do Azure.

  • Um recurso de conta de integração no qual você define e armazena artefatos, como parceiros comerciais, contratos, certificados e assim por diante, para usar em seus fluxos de trabalho de integração empresarial e B2B. O recurso precisa atender aos seguintes requisitos:

    • Sua conta de integração e o recurso de aplicativo lógico devem existir na mesma assinatura do Azure e na 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 os dois parceiros devem usar o mesmo qualificador de identidade de negócios, que é Mutuamente Definido em ZZZ para esse cenário.

    • Define um contrato EDIFACT entre os parceiros comerciais que participam do fluxo de trabalho. Cada contrato requer um parceiro de host 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 dá suporte apenas a caracteres UTF-8. Se a saída contiver caracteres inesperados, verifique se suas mensagens EDIFACT usam o conjunto de caracteres UTF-8.

  • Dependendo de se você está trabalhando em um fluxo de trabalho de aplicativo lógico de Consumo ou Standard, seu recurso de aplicativo lógico poderá exigir um link para sua conta de integração:

    Fluxo de trabalho do Aplicativo Lógico Link necessário?
    Consumo Conexão e link para conta de integração são necessários. Você pode criar a conexão ao adicionar a operação EDIFACT ao fluxo de trabalho.
    Standard A 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 fluxo de trabalho.

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

    Para saber mais, confira a seguinte documentação:

  • O conteúdo a ser codificado ou decodificado. Nos fluxos de trabalho de Consumo, as ações do conector gerenciado EDIFACT aceitam uma mensagem XML como entrada. Em fluxos de trabalho Standard, as ações do conector interno EDIFACT aceitam um arquivo simples, enquanto o conector gerenciado EDIFACT aceita uma mensagem XML.

Codificar mensagens EDIFACT

A ação do conector gerenciado EDIFACT denominada Codificar para mensagem EDIFACT e a ação do conector interno EDIFACT chamada Codificação EDIFACT executa as seguintes tarefas, exceto quando citado em Limitações e problemas conhecidos:

  • Resolva o contrato, correspondendo o qualificador de remetente e o identificador e o qualificador do destinatário e o identificador.

  • Serialize o EDI (Intercâmbio de Dados Eletrônicos), que converte mensagens codificadas em XML em conjuntos de transações EDI no intercâmbio.

  • Aplique os segmentos de cabeçalho e rodapé do conjunto de transação.

  • 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 conteúdo.

  • Valide o EDI e as propriedades específicas do parceiro, como o esquema para elementos de dados do conjunto de transações em relação ao esquema de mensagem, elementos de dados do conjunto de transações e validação estendida em elementos de dados do conjunto de transações.

  • Gere um documento XML para cada conjunto de transação.

  • Solicite uma confirmação técnica, uma confirmação funcional ou ambas, se configuradas.

    • Como uma confirmação técnica, a mensagem CONTRL indica o recebimento de um intercâmbio.

    • Como uma confirmação funcional, a mensagem CONTRL indica a aceitação ou a rejeição do intercâmbio recebido, do grupo ou da mensagem, incluindo uma lista de erros ou funcionalidade sem suporte.

  1. No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.

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

    Observação

    Se você quiser usar a mensagem Encode to EDIFACT por ação de identidades, será necessário fornecer valores diferentes, como o identificador do Remetente e Identificador do Receptor especificados pelo contrato EDIFACT. Você também precisa especificar a mensagem XML para codificar, 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 Obrigatório Descrição
    Nome da conexã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 Consumo e a caixa de conexão para a ação denominada Codificar para mensagem EDIFACT por nome do contrato.

  4. Quando terminar, selecione Criar.

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

    Propriedade Obrigatório Descrição
    Nome do contrato do EDIFACT Sim O contrato EDIFACT a ser usado.
    Mensagem XML para codificar Sim A mensagem XML a ser codificada. O identificador comercial do remetente da mensagem conforme especificado pelo contrato EDIFACT.
    Outros parâmetros Não Essa operação inclui os seguintes outros parâmetros:

    - Separador de elemento de dados
    - Indicador de versão
    - Separador de componentes
    - Separador de repetição
    - Terminador de segmento
    - Sufixo do terminador de segmento
    - Indicador decimal

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

    Por exemplo, o conteúdo a ser codificado pode ser a saída de conteúdo do Corpo do gatilho Solicitação:

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

  6. Salve seu fluxo de trabalho.

Decodificar mensagens EDIFACT

A ação do conector gerenciado EDIFACT chamada Decodificar mensagem EDIFACT e a ação do conector interno EDIFACT chamada Decodificação EDIFACT executam as seguintes tarefas, exceto quando citado em Limitações e problemas conhecidos:

  • Valida o envelope com relação ao acordo entre parceiros comerciais.

  • Resolva o acordo combinando o qualificador e identificador do remetente com o qualificador e identificador do receptor.

  • Divida um intercâmbio em vários conjuntos de transações quando o intercâmbio tem mais de uma transação, com base nas Configurações de Recebimento do contrato.

  • Desmonte o intercâmbio.

  • Valide o EDI (Intercâmbio de Dados Eletrônicos) e as propriedades específicas do parceiro, como a estrutura de envelope de intercâmbio, o esquema de 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 em elementos de dados do conjunto de transações.

  • Verificar se os números de controle de intercâmbio, grupo e conjunto de transações não estão duplicados (apenas o conector gerenciado), se configurados, por exemplo:

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

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

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

  • Dividir o intercâmbio em conjuntos de transações ou preservar todo o intercâmbio (apenas o conector gerenciado), por exemplo:

    • Divida intercâmbio como conjuntos de transação – suspenda conjuntos de transação com erro.

      A ação de decodificação divide o intercâmbio em conjuntos de transações e avalia cada conjunto de transações. A ação gera apenas os conjuntos de transações que falharam na validação em badMessages e gera os conjuntos de transações restantes em goodMessages.

    • Divida intercâmbio como conjuntos de transação – suspenda o intercâmbio com erro.

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

    • Preserve o intercâmbio – suspenda conjuntos de transações com erro.

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

    • Preserve o intercâmbio – suspenda o intercâmbio com 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 gerará todos os conjuntos de transações no intercâmbio em badMessages.

  • Gere uma confirmação técnica, uma confirmação funcional ou ambos, se configurado.

    • Uma confirmação técnica ou o CONTRL ACK, que reporta os resultados de uma verificação sintática no intercâmbio completo recebido.

    • Uma confirmação funcional que confirma a aceitação ou a rejeição para o intercâmbio ou grupo recebido.

  1. No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.

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

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

    Propriedade Obrigatório Descrição
    Nome da conexã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 Consumo e o painel de conexão para a ação chamada Decodificar mensagem EDIFACT.

  4. Quando terminar, selecione Criar.

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

    Propriedade Obrigatório Descrição
    Mensagem de arquivo simples EDIFACT para decodificar Sim A mensagem de arquivo simples XML a ser decodificada.
    Outros parâmetros Não Essa operação inclui os seguintes outros parâmetros:

    - Separador de componentes
    - Separador de elemento de dados
    - Indicador de versão
    - Separador de repetição
    - Terminador de segmento
    - Sufixo do terminador de segmento
    - Indicador decimal
    - Conjunto de caracteres de conteúdo
    - Sufixo do terminador de segmento
    - Preservar Intercâmbio
    - Suspender intercâmbio por erro

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

    Por exemplo, o conteúdo a ser decodificado pode ser a saída de conteúdo do Corpo do gatilho Solicitação :

    A captura de tela mostra o fluxo de trabalho 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 tem 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 raiz do esquema para o campo UNH de exemplo é EFACT_D03B_ORDERS_EAN008. Para cada D03B_ORDERS que possua um segmento UNH2.5 diferente, você precisa implantar um esquema individual.

  2. No portal do Azure, adicione o esquema ao recurso da sua conta de integração ou ao recurso do aplicativo lógico, com base no fato de você ter um fluxo de trabalho do aplicativo lógico Consumo ou Standard, respectivamente.

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

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

    • Na seção do contrato receiveAgreement, encontre 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 contrato sendAgreement, encontre a seção schemaReferences e adicione o valor UNH2.5.

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

Próximas etapas

  • Last updated on