Partilhar via

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

  • Artigo

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 de aplicativo lógico existente. Quando nenhum gatilho EDIFACT está disponível, você pode qualquer gatilho para iniciar seu fluxo de trabalho. Os exemplos neste guia usam o gatilho Request.

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 lógica Environment Versão do conector
Consumo Aplicativos Lógicos do Azure Multilocatários Conector gerenciado EDIFACT (classe padrão). O conector EDIFACT fornece apenas ações, 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 Aplicativos Lógicos do Azure e Ambiente do Serviço de Aplicativo v3 de locatário único (somente planos do Windows) Conector integrado EDIFACT (visualização) e conector gerenciado EDIFACT . 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.

- 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
- EDIFACT built-in operações de conector
- Limites de mensagens EDIFACT

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

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

Problemas conhecidos e de limitações

  • Visualizar conector integrado EDIFACT

    • Esta funcionalidade está em pré-visualização e está sujeita aos Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure.

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

    • A ação de visualizaçã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, se configurado.

      • Preservar todo o intercâmbio.

      Caso contrário, as ações de visualização EDIFACT Encode e EDIFACT decodificam o conector interno têm recursos semelhantes às ações do conector gerenciado EDIFACT correspondentes.

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

    • 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 no fato de você estar trabalhando em um fluxo de trabalho de aplicativo lógico de consumo ou padrão, seu recurso de aplicativo lógico pode 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 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:

Codificar mensagens EDIFACT

A ação do conector gerenciado EDIFACT chamada Codificar para a ação de mensagem EDIFACT e a ação do conector interno EDIFACT chamada EDIFACT Encode executa as seguintes tarefas, exceto onde observado em Limitações e problemas conhecidos:

  • Resolva o contrato fazendo a correspondência entre o qualificador do remetente e o identificador e o qualificador e identificador do destinatário.

  • Serialize o Electronic Data Interchange (EDI), que converte mensagens codificadas em XML em conjuntos de transações EDI no intercâmbio.

  • Aplique segmentos de cabeçalho e reboque do 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 EDI e propriedades específicas do parceiro, como o esquema para elementos de dados de conjunto de transações em relação ao esquema de mensagem, elementos de dados de conjunto de transações e validação estendida em elementos de dados de conjunto de transações.

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

  • Solicite um reconhecimento técnico, um reconhecimento funcional ou ambos, se 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 do aplicativo lógico no designer.

  2. No designer, siga estas etapas gerais para adicionar a ação EDIFACT chamada Codificar para EDIFACT mensagem por nome de contrato 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:

    Property Necessário Description
    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:

    Property Necessário Description
    Nome do acordo EDIFACT Sim A utilização do acordo EDIFACT.
    Mensagem XML para codificar Sim 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 da mensagem XML a ser codificada pode ser a saída de conteúdo do corpo 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 gerenciado EDIFACT chamada Decodificar ação de mensagem EDIFACT e a ação de conector interno EDIFACT chamada EDIFACT Decodificar executam as seguintes tarefas, exceto onde observado em Limitações e problemas conhecidos:

  • Valide o envelope em relação ao contrato de parceiro comercial.

  • Resolva o contrato fazendo a correspondência entre o qualificador e o identificador do remetente juntamente com o qualificador e o identificador do destinatário.

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

  • Desmonte o 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 do conjunto de intercâmbio, grupo e transação não são duplicados (somente conector gerenciado), 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:

    • Split Interchange como 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.

    • Split Interchange como 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 sobre o intercâmbio recebido completo.

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

  1. No portal do Azure, abra o recurso e o fluxo de trabalho do aplicativo lógico 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:

    Property Necessário Description
    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:

    Property Necessário Description
    Mensagem de arquivo simples EDIFACT para decodificar Sim A mensagem de arquivo simples XML para decodificar.
    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 de carga útil
    - 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 útil da mensagem XML a ser decodificada pode ser a saída de conteúdo do corpo 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 um que tem um segmento UNH2.5 diferente, você precisa implantar um esquema individual.

  2. No portal do Azure, adicione o esquema ao recurso da 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 Padrão, respectivamente.

  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 do receiveAgreement contrato, localize a schemaReferences seção 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