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 de aplicativo lógico existente. Quando nenhum gatilho EDIFACT está disponível, você pode qualquer gatilho para iniciar seu 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 de aplicativo lógico e no ambiente do host.
| Aplicativo lógico | Ambiente | Versão do conector |
|---|---|---|
| Consumo | Aplicativos Lógicos do Azure multilocatários | Conector gerenciado EDIFACT (classe Standard). O conector EDIFACT fornece apenas ações, mas você pode usar qualquer gatilho que funcione para seu cenário. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado EDIFACT - Limites de mensagens EDIFACT |
| Consumo | Ambiente do serviço de integração (ISE) | Conector gerenciado EDIFACT (classe Standard) e versão EDIFACT ISE, que tem limites de mensagem diferentes da classe Standard. O conector EDIFACT fornece apenas ações, mas você pode usar qualquer gatilho que funcione para 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 de locatário único e Ambiente do Serviço de Aplicativo v3 (somente planos Windows) | Conector integrado EDIFACT (visualização) e conector gerenciado EDIFACT. A versão interna difere 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 obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado EDIFACT - Operações de conector integradas EDIFACT - Limites de mensagens EDIFACT |
Operações internas do EDIFACT (somente fluxos de trabalho padrão - Visualização)
O conector interno EDIFACT de visualização tem as seguintes ações, que são semelhantes às ações do conector gerenciado EDIFACT equivalente, exceto onde observado em Limitações e problemas conhecidos.
Limitações e problemas conhecidos
Visualizar conector integrado 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.
Atualmente, as ações desse conector oferecem suporte a cargas úteis de até pelo menos 100 MB.
A ação de visualização de Decodificação EDIFACT atualmente não inclui os seguintes recursos:
Verifique se há números de controle de intercâmbio, grupo e conjunto de transações duplicados, se configurados.
Preserve todo o intercâmbio.
Caso contrário, as ações de conector interno de codificação EDIFACT de visualização e decodificação EDIFACT têm recursos semelhantes às ações de conector gerenciado EDIFACT de sua contraparte.
Atualmente, as ações desse conector não oferecem suporte a intercâmbios com várias transações ou mensagens em lote.
No momento, as ações desse conector não emitem rastreamento 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 necessá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 a ação de mensagem EDIFACT e a ação interna do conector EDIFACT denominada EDIFACT Encode executa as seguintes tarefas, exceto onde observado 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 Esta 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, a carga da mensagem XML a ser codificada pode ser a saída de conteúdo do corpo do gatilho de solicitação:
Salve seu fluxo de trabalho.
Decodificar 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 DECODIFICAR EDIFACT executa as seguintes tarefas, exceto onde observado 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.
Verifique se os números de controle de intercâmbio, grupo e conjunto de transações não são duplicados (somente 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.
Divida o intercâmbio em conjuntos de transações ou preserve todo o intercâmbio (somente 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 Esta 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 seu recurso de conta de integração ou recurso de aplicativo lógico, com base em se você tem um fluxo de trabalho de aplicativo lógico Consumo ou Padrão, 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.