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 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
Consumo	Ambiente de serviço de integração (ISE)	Conector gerenciado EDIFACT (classe Standard) e versão ISE EDIFACT, 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 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.

• Ação de codificação EDIFACT
• EDIFACT Ação de descodificação

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:

  • Criar um exemplo de fluxo de trabalho do aplicativo lógico de consumo em aplicativos lógicos do Azure multilocatários

  • Criar um exemplo de fluxo de trabalho de aplicativo lógico padrão em Aplicativos Lógicos do Azure de locatário único

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.

Consumo

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	Obrigató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:

   

4. Quando tiver terminado, selecione Criar.

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

   Property	Obrigató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:

   

6. Salve seu fluxo de trabalho.

Standard

EDIFACT built-in conector (visualização)

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 EDIFACT Encode ao seu fluxo de trabalho.

3. No painel de ações EDIFACT, forneça os valores de propriedade necessários:

   Property	Obrigatório	Description
   Mensagem para codificar	Sim	O conteúdo da mensagem XML que você deseja codificar. Especificamente, o identificador comercial do remetente da mensagem, conforme especificado pelo seu contrato EDIFACT.
   Parâmetros avançados	Não	Na lista, adicione quaisquer outras propriedades que você deseja usar. Esta operação inclui os seguintes outros parâmetros: - Qualificador do Destinatário da Identidade do Remetente - Identificador do destinatário da identidade do remetente - Qualificador do Recetor de Identidade do Recetor - Identificador do recetor de identidade do recetor - Nome do acordo 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:

   

4. Salve seu fluxo de trabalho.

Conector gerenciado EDIFACT

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	Obrigatório	Description
   Nome da ligação	Sim	Um nome para a conexão
   ID da conta de integração	Sim	O ID do recurso para sua conta de integração, que tem o seguinte formato: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Por exemplo: /subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Para localizar este ID de recurso, siga estes passos: 1. No portal do Azure, abra sua conta de integração. 2. No menu da conta de integração, selecione Visão geral. 3. Na página Visão geral , selecione Visualização JSON. 4. A partir da propriedade Resource ID, copie o valor.
   URL SAS da Conta de Integração	Sim	A URL do ponto de extremidade de solicitação que usa a autenticação de assinatura de acesso compartilhado (SAS) para fornecer acesso à sua conta de integração. Este URL de retorno de chamada tem o seguinte formato: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Por exemplo: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=ZZZZZZZZZZZZZZZZZZZZZZZZZZZ Para localizar este URL, siga estes passos: 1. No portal do Azure, abra sua conta de integração. 2. No menu da conta de integração, em Configurações, selecione URL de retorno de chamada. 3. A partir da propriedade URL de retorno de chamada gerado, copie o valor.
   Tamanho do bloco de número de controle	Não	O tamanho do bloco de números de controle a serem reservados de um contrato para cenários de alta taxa de transferência

   Por exemplo:

   

4. Quando tiver terminado, selecione Criar.

5. No painel de ações EDIFACT, forneça os seguintes valores de propriedade:

   Property	Obrigató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:

   

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 , e produz os conjuntos de transações restantes para badMessagesgoodMessages.

  • 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 , e produz os conjuntos de transações restantes para badMessagesgoodMessages.

  • 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.

Consumo

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	Obrigató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:

   

4. Quando tiver terminado, selecione Criar.

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

   Property	Obrigató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:

   

Standard

EDIFACT built-in conector (visualização)

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 EDIFACT Decode ao seu fluxo de trabalho.

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

   Property	Obrigatório	Description
   Mensagem 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 liberação - Separador de repetição - Terminador de segmento - Sufixo do terminador de segmento - Indicador decimal - Conjunto de caracteres de carga útil - Sufixo do 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:

   

4. Salve seu fluxo de trabalho.

Conector gerenciado EDIFACT

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	Obrigató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:

   

4. Quando tiver terminado, selecione Criar.

5. No painel de ações EDIFACT, forneça os seguintes valores de propriedade:

   Property	Obrigató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 decodificada pode ser a saída de conteúdo do corpo do gatilho Request:

   

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.

     

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

     

Próximos passos

• Configurações de mensagem EDIFACT