Partilhar via

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ários e Aplicativos Lógicos do Azure de locatário único. Para obter informações técnicas sobre o conector X12 , consulte a seguinte documentação:

Pré-requisitos

  • Uma conta e subscrição do Azure. Se ainda não tiver uma subscrição do Azure, 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 X12 usada em seu fluxo de trabalho. As definições para ambos os parceiros devem usar o mesmo qualificador de identidade comercial X12.

    • Define um contrato X12 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 X12.

      Importante

      Se estiver a trabalhar com esquemas HIPAA (Health Insurance Portability and Accountability Act), tem de adicionar uma schemaReferences secção ao seu contrato. Para obter mais informações, consulte Esquemas e tipos de mensagem HIPAA.

    • Define os esquemas a serem usados para validação XML.

      Importante

      Se você estiver trabalhando com esquemas HIPAA (Health Insurance Portability and Accountability Act), certifique-se de revisar os esquemas e os tipos de mensagem da HIPAA.

  • 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 X12 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 X12 ao seu fluxo de trabalho.

  • O recurso do aplicativo lógico e o fluxo de trabalho onde você deseja usar as operações X12.

    Para obter mais informações, veja a seguinte documentação:

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:

    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:

    Captura de tela mostrando o fluxo de trabalho de consumo e as informações de conexão para a ação chamada Codificar para mensagem X12 pelo nome do contrato.

  4. Quando tiver terminado, selecione Criar.

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

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

    Captura de tela mostrando o fluxo de trabalho de consumo, a ação chamada Codificar para mensagem X12 pelo nome do contrato e as propriedades da ação.

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

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

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

    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:

    Captura de tela mostrando o fluxo de trabalho de consumo e informações de conexão para a ação chamada Decodificar mensagem X12.

  4. Quando tiver terminado, selecione Criar.

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

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

    Captura de tela mostrando o fluxo de trabalho de consumo, a ação chamada Decodificar mensagem X12 e as propriedades da ação.

Próximos passos