Monitorar e acompanhar transações B2B em fluxos de trabalho padrão para Aplicativos Lógicos do Azure (Visualização)

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

Para garantir que as operações de negócios funcionem sem problemas, manter a conformidade e solucionar problemas em cenários de integração empresarial B2B, você precisa acompanhar com precisão e confiabilidade as transações B2B que fluem através de suas soluções de integração. Se você tiver fluxos de trabalho de aplicativos lógicos padrão que funcionam com transações X12, EDIFACT ou AS2, terá acesso a recursos de rastreamento robustos que ajudam a monitorar trocas B2B de forma eficaz.

Com uma conta de integração de nível Premium, você pode configurar o acompanhamento B2B para fluxos de trabalho padrão usando o Azure Data Explorer. Esse recurso rastreia com precisão todas as transações B2B fazendo com que o Azure Data Explorer armazene todas as transações em um cluster e banco de dados, que fornecem rastreamento sem perdas, juntamente com recursos de visualização e consulta.

Por exemplo, você obtém um painel de acompanhamento para que possa monitorar, pesquisar e analisar transações B2B com eficiência. Para uma análise mais detalhada, você pode criar consultas avançadas em seu banco de dados de cluster. Com os dados de acompanhamento armazenados no Azure Data Explorer, você pode estender painéis do Microsoft Power BI ou criar painéis personalizados com seus dados.

Este guia fornece uma breve visão geral sobre como o rastreamento B2B funciona, como configurar esse recurso para seu recurso e fluxos de trabalho do aplicativo lógico padrão e como abrir o painel de rastreamento.

Limitações e problemas conhecidos

• Nesta versão prévia, o rastreamento atualmente lida apenas com transações X12 e AS2.

Como funciona o rastreamento B2B

A tabela a seguir descreve como vários componentes trabalham juntos para oferecer suporte ao rastreamento B2B:

Pré-requisitos

• Uma conta e assinatura do Azure. Se não tiver uma subscrição, inscreva-se numa conta do Azure gratuita.

• Uma conta de integração de nível Premium. Se você não tiver essa conta de integração, consulte Criar e gerenciar contas de integração para fluxos de trabalho B2B nos Aplicativos Lógicos do Azure.

• Um fluxo de trabalho padrão que usa ações integradas AS2 ou X12

  Atualmente, o rastreamento B2B suporta apenas transações processadas por essas ações.

• Um cluster e um banco de dados do Azure Data Explorer para armazenar logs de transações e dados de rastreamento.

  Se você não tiver um cluster e um banco de dados existentes, consulte Guia de início rápido: criar um cluster e um banco de dados do Azure Data Explorer e O que é o Azure Data Explorer.

Configurar o rastreamento B2B

Para essa tarefa, você precisa criar um repositório de rastreamento em sua conta de integração. Atualmente, uma conta de integração suporta apenas um repositório de rastreamento padrão.

Crie uma loja de acompanhamento para sua conta de integração

1. No portal do Azure, abra sua conta de integração de nível Premium.

2. No menu da conta de integração, em Definições, selecione Rastreamento de lojas.

3. Na barra de ferramentas, selecione Adicionar. No painel Adicionar repositório de controle , forneça as seguintes informações:

   Propriedade	Valor
   Subscrição	A assinatura do Azure para seu cluster do Azure Data Explorer.
   Azure Data Explorer	O nome do cluster no Azure Data Explorer.
   Base de dados	O nome do banco de dados do cluster.

   Por exemplo:

   

4. Quando tiver terminado, selecione OK.

Desativar ou ativar o rastreamento B2B no nível do contrato

Se tiver acordos existentes entre parceiros comerciais na sua conta de integração, pode desativar ou reativar o acompanhamento para cada contrato. Por padrão, o acompanhamento está habilitado para contratos. Atualmente, você pode desabilitar ou reativar o rastreamento de um contrato somente por meio do modo de exibição JSON.

1. No portal do Azure, abra sua conta de integração de nível Premium.

2. No menu da conta de integração, em Configurações, selecione Contratos. Selecione um contrato.

3. Na barra de ferramentas da página Contratos, selecione Editar como JSON.

4. No acordo, encontre os objetos sendAgreement e receiveAgreement.

5. Para desativar o rastreamento, altere trackingState para Disabled. Para reativar o rastreamento, altere trackingState para ou Enabled.

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

• Adicionar contratos entre parceiros em contas de integração
• Adicionar parceiros comerciais a contas de integração

Solucionar problemas de configuração de rastreamento

Para que o rastreamento funcione corretamente, verifique se todas as seguintes condições são atendidas:

• Existe uma loja de rastreamento na sua conta de integração.
• Em um contrato, o trackingState atributo é definido como Enabled.

Abrir o painel de acompanhamento

1. Antes de usar o painel de controle, verifique se o fluxo de trabalho executa algumas ações internas X12, EDIFACT ou AS2 para que o repositório de rastreamento contenha dados.

2. No menu da sua conta de integração, em Monitoramento, selecione Rastreamento B2B, que abre o painel.

   Por padrão, a guia Visão geral é selecionada e mostra um resumo de alto nível com gráficos para todos os tipos de mensagens suportados, status de mensagens, parceiros com mais erros e um resumo de mensagens para cada parceiro.

   Tab	Descrição
   Descrição geral	Veja um resumo de alto nível para todos os tipos de mensagens suportados.
   AS2	Veja os detalhes de todas as transações AS2 coletadas.
   X12	Veja os detalhes de todas as transações X12 coletadas.

   Por exemplo:

   

3. Para alterar o intervalo de tempo do painel a partir do valor padrão, na lista TimeRange , selecione o intervalo desejado.

4. Para visualizar os detalhes das mensagens coletadas, selecione a guia AS2 ou X12 .

   A guia selecionada mostra as mensagens coletadas juntamente com suas propriedades e valores.

   O exemplo a seguir mostra os detalhes disponíveis para mensagens X12 coletadas:

   

Tabelas de banco de dados

No cluster do Azure Data Explorer, o banco de dados armazena dados de transação em um formato estruturado em tabela. Essa estrutura de tabela fornece a capacidade de consultar e recuperar dados de rastreamento B2B de forma eficiente, fornecer informações estruturadas sobre o fluxo de mensagens, o status de processamento e solucionar problemas.

• A tabela chamada AS2TrackRecords armazena transações AS2.
• A tabela chamada EdiTrackRecords armazena transações X12 e EDIFACT.

Gerencie lojas de rastreamento com a API REST

Você pode usar a API REST dos Aplicativos Lógicos do Azure para criar, atualizar, excluir e recuperar programaticamente seu repositório de rastreamento.

Criar ou atualizar um repositório de rastreamento

Crie um repositório de rastreamento ou atualize um existente.

PUT https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Corpo da solicitação

{ 
  "properties": {
    "adxClusterUri": "https://{cluster-name}.kusto.windows.net",
    "databaseName": "{database-name}"
  }
}

Resposta

Retorne os detalhes do repositório de rastreamento criado ou atualizado.

Obtenha uma loja de rastreamento específica

Obtenha os detalhes sobre uma loja de rastreamento específica.

GET https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Parâmetros:

Resposta

Forneça os detalhes sobre a loja de rastreamento especificada.

Obter todas as lojas de rastreamento

Obtenha todas as lojas de rastreamento em sua conta de integração.

GET https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores?api-version=2016-06-01

Resposta

Retorne uma lista de lojas de rastreamento associadas à sua conta de integração.

Excluir um repositório de rastreamento

Exclua um repositório de rastreamento existente da sua conta de integração.

DELETE https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Resposta

Retorne uma confirmação de sucesso para uma base de dados de rastreamento eliminada com êxito.

Conteúdo relacionado

• Esquemas para rastrear transações B2B - Fluxos de trabalho padrão