Trocar mensagens EDIFACT usando fluxos de trabalho nos Aplicativos Lógicos do Azure
Para enviar e receber mensagens EDIFACT nos fluxos de trabalho que você cria 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 deste guiará utilizam 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 fornece apenas ações, mas você pode usar qualquer gatilho que funcione para o 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 (versão prévia) 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. – 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 do conector interno EDIFACT - Limites de mensagens EDIFACT |
Operações do EDIFACT interno (somente fluxos de trabalho Standard – versão prévia)
O conector interno EDIFACT (versão prévia) tem as seguintes ações, que são semelhantes às ações do conector gerenciado EDIFACT equivalente, exceto quando citado emLimitações e problemas conhecidos.
Limitações e problemas conhecidos
Versão prévia do conector interno EDIFACT
Esse recurso está em versão prévia e está sujeito aos Termos de uso suplementares para versões prévias do Microsoft Azure.
No momento, as ações desse conector dão suporte a conteúdo de até pelo menos 100 MB.
A ação de Decodificação EDIFACT de versão prévia 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 do conector interno de Codificação EDIFACT e de decodificação EDIFACT de versão prévia têm funcionalidades semelhantes às ações do conector gerenciado EDIFACT 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:
Tanto sua conta de integração quanto o recurso do aplicativo lógico devem existir na mesma assinatura do Azure e região do Azure.
Define pelo menos dois parceiros comerciais que participam da operação EDIFACT utilizada para 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 seu 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 do contrato a serem utilizadas no recebimento e envio de mensagens, confira Configurações de mensagens 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 A conexão e o link para a conta de integração são obrigatórios. Você pode criar a conexão ao adicionar a operação EDIFACT para seu fluxo de trabalho. Standard É exigida a conexão com a conta de integração, mas não é necessário um link. Você pode criar a conexão ao adicionar a operação EDIFACT para seu 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:
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.
No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.
-
Observação
Se, em vez disso, você quiser utilizar a ação Codificar a mensagem EDIFACT por identidades, será necessário fornecer valores diferentes, como o Identificador do remetente e o Identificador do destinatário especificados pelo seu 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.
Forneça as seguintes informações de conexão para sua conta de integração:
Propriedade Obrigatório Descrição Nome da conexão Yes Um nome para a conexão Conta de integração Yes Na lista de contas de integração disponíveis, selecione a conta a ser usada. Por exemplo:
Quando terminar, selecione Criar.
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 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 liberação
- Separador de componente
- 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 da mensagem XML para decodificação pode ser a saída do conteúdo do Corpo de Texto no gatilho de Solicitação:
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
badMessagese gera os conjuntos de transações restantes emgoodMessages.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
badMessagese gera os conjuntos de transações restantes emgoodMessages.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.
No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.
No designer, siga estas etapas gerais para adicionar a ação EDIFACT chamada Decodificar a mensagem EDIFACT do seu fluxo de trabalho.
Forneça as seguintes informações de conexão para sua conta de integração:
Propriedade Obrigatório Descrição Nome da conexão Yes Um nome para a conexão Conta de integração Yes Na lista de contas de integração disponíveis, selecione a conta a ser usada. Por exemplo:
Quando terminar, selecione Criar.
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 componente
- Separador de elemento de dados
- Indicador de liberação
- Separador de repetição
- Terminador de segmento
- Sufixo do terminador de segmento
- Indicador decimal
- Conjunto de caracteres de payload
- Sufixo do terminador de segmento
- Preservar intercâmbio
- Suspender intercâmbio em caso de erro
Para obter mais informações, consulte Configurações de mensagem EDIFACT.Por exemplo, o payload da mensagem XML para decodificação pode ser a saída do conteúdo do Corpo de Texto no gatilho Solicitação:
Manipular segmentos UNH2.5 em documentos EDIFACT
Em um documento EDIFACT, o segmento UNH2.5 é utilizado 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:
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 cadaD03B_ORDERSque possua um segmento UNH2.5 diferente, você precisa implantar um esquema individual.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.
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.
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çãoschemaReferencese adicione o valor UNH2.5.
Na seção do contrato
sendAgreement, encontre a seçãoschemaReferencese adicione o valor UNH2.5.