Mensagens X12 do Exchange usando fluxos de trabalho nos Aplicativos Lógicos do Azure

  • Artigo

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

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

Este guia de instruções mostra como adicionar as ações de codificação e decodificação X12 a um fluxo de trabalho de aplicativo lógico existente. O conector X12 não inclui nenhum gatilho, portanto, você pode usar qualquer gatilho para iniciar seu fluxo de trabalho. Os exemplos neste guia usam o gatilho Request.

Referência técnica do conector

O conector X12 tem uma versão entre fluxos de trabalho em Aplicativos Lógicos do Azure multilocatário, Aplicativos Lógicos do Azure de locatário único e ISE (ambiente de serviço de integração). Para obter informações técnicas sobre o conector X12 , consulte a seguinte documentação:

Pré-requisitos

Codificar mensagens X12

A operação de mensagem Codificar para X12 executa as seguintes tarefas:

  • Resolve o contrato combinando as propriedades de contexto do remetente e do destinatário.
  • Serializa o intercâmbio EDI e converte mensagens codificadas em XML em conjuntos de transações EDI no intercâmbio.
  • Aplica segmentos de cabeçalho e reboque do conjunto de transações.
  • Gera 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.
  • Substitui os separadores nos dados de carga útil.
  • Valida EDI e propriedades específicas do parceiro.
    • Validação de esquema de elementos de dados do conjunto de transações em relação ao esquema de mensagem.
    • Validação EDI em elementos de dados do conjunto de transações.
    • Validação estendida em elementos de dados de conjunto de transações.
  • Solicita um Reconhecimento Técnico e Funcional, se configurado.
    • Gera um Reconhecimento Técnico como resultado da validação do cabeçalho. O reconhecimento técnico informa o status do processamento de um cabeçalho de intercâmbio e reboque pelo recetor de endereço.
    • Gera um Reconhecimento Funcional como resultado da validação corporal. O reconhecimento funcional relata cada erro encontrado durante o processamento do documento 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 X12 chamada Codificar para mensagem X12 por nome de contrato ao seu fluxo de trabalho.

    Nota

    Se você quiser usar a ação Codificar para mensagem X12 por identidades, mais tarde terá que fornecer valores diferentes, como o identificador de remetente e identificador de destinatário especificado pelo seu contrato X12. 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. Quando solicitado, forneça as seguintes informações de conexão para sua conta de integração:

    Propriedade 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:

    Screenshot showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. Quando tiver terminado, selecione Criar.

  5. Na caixa Informações da ação X12, forneça os seguintes valores de propriedade:

    Propriedade Obrigatório Description
    Nome do contrato X12 Sim O contrato X12 a utilizar.
    Mensagem XML para codificar Sim A mensagem XML a codificar
    Outros parâmetros Não Esta operação inclui os seguintes outros parâmetros:

    - Separador de elementos de dados
    - Separador de componentes
    - Caráter de substituição
    - Terminador de segmento
    - Sufixo terminador de segmento
    - Número da versão de controle
    - Identificador do remetente do aplicativo/código GS02
    - Identificador/Código GS03 do Recetor de Aplicação

    Para obter mais informações, consulte as configurações de mensagem X12.

    Por exemplo, você pode usar a saída de conteúdo Body do gatilho Request como a carga útil da mensagem XML:

    Screenshot showing Consumption workflow, action named Encode to X12 message by agreement name, and action properties.

Descodificar mensagens X12

A operação de mensagem Decode X12 executa as seguintes tarefas:

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

  • Valida EDI e propriedades específicas do parceiro.

    • Validação estrutural EDI e validação estendida de esquema
    • Validação estrutural do envelope de intercâmbio
    • Validação de esquema do envelope em relação ao esquema de controle
    • Validação de esquema dos elementos de dados do conjunto de transações em relação ao esquema de mensagem
    • Validação EDI em elementos de dados do conjunto de transações

  • Verifica se os números de controle do conjunto de intercâmbio, grupo e transação não são duplicados.

    • Verifica o número de controle de intercâmbio em relação a intercâmbios recebidos anteriormente.
    • Verifica o número de controle de grupo em relação a outros números de controle de grupo no intercâmbio.
    • Verifica 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.

  • Divide um intercâmbio em conjuntos de transações ou preserva todo o intercâmbio:

    • Divida o intercâmbio em conjuntos de transações ou suspenda conjuntos de transações em caso de erro: analise cada conjunto de transações. A ação de decodificação X12 produz apenas os conjuntos de transações que falham na validação para , e produz os conjuntos de transações restantes para badMessagesgoodMessages.

    • Divida o intercâmbio em conjuntos de transações ou suspenda o intercâmbio em caso de erro: analise cada conjunto de transações. Se um ou mais conjuntos de transações no intercâmbio falharem na validação, a ação de decodificação X12 produzirá todos os conjuntos de transações nesse intercâmbio para badMessages.

    • Preservar o intercâmbio ou suspender conjuntos de transações em caso de erro: Preserve o intercâmbio e processe todo o intercâmbio em lote. A ação de decodificação X12 produz apenas os conjuntos de transações que falham na validação para , e produz os conjuntos de transações restantes para badMessagesgoodMessages.

    • Preservar o intercâmbio ou suspender o intercâmbio em caso de erro: Preserve o intercâmbio e processe todo o intercâmbio em lote. Se um ou mais conjuntos de transações no intercâmbio falharem na validação, a ação de decodificação X12 produzirá todos os conjuntos de transações nesse intercâmbio para badMessages.

  • Gera um Reconhecimento Técnico e Funcional, se configurado.

    • Gera um Reconhecimento Técnico como resultado da validação do cabeçalho. O reconhecimento técnico informa o status do processamento de um cabeçalho de intercâmbio e reboque pelo recetor de endereço.
    • Gera um Reconhecimento Funcional como resultado da validação corporal. O reconhecimento funcional relata cada erro encontrado durante o processamento do documento 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 X12 chamada Decodificar mensagem X12 ao seu fluxo de trabalho.

  3. Quando solicitado, forneça as seguintes informações de conexão para sua conta de integração:

    Propriedade 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:

    Screenshot showing Consumption workflow and connection information for action named Decode X12 message.

  4. Quando tiver terminado, selecione Criar.

  5. Na caixa Informações da ação X12, forneça os seguintes valores de propriedade:

    Propriedade Obrigatório Description
    Mensagem de ficheiro simples X12 para descodificar Sim A mensagem X12 em formato de arquivo simples para decodificar

    Nota: A carga ou o conteúdo da mensagem XML para a matriz de mensagens, bom ou ruim, é codificado em base64. Então, você deve usar uma expressão que processe esse conteúdo. Por exemplo, a expressão a seguir processa o conteúdo da mensagem como XML:

    xml(base64ToBinary(item()?['Body']))
    Outros parâmetros Não Esta operação inclui os seguintes outros parâmetros:

    - Preservar o intercâmbio
    - Suspender intercâmbio em caso de erro

    Para obter mais informações, consulte as configurações de mensagem X12.

    Por exemplo, você pode usar a saída de conteúdo Corpo do gatilho Request como a carga útil da mensagem XML, mas primeiro deve pré-processar esse conteúdo usando uma expressão:

    Screenshot showing Consumption workflow, action named Decode X12 message, and action properties.

Próximos passos