Monitorar e acompanhar transações B2B em fluxos de trabalho Standard para Aplicativos Lógicos do Azure (versão prévia)

Aplica-se a: Aplicativos Lógicos do Azure (Standard)

Para garantir que as operações comerciais sejam executadas 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 por meio de suas soluções de integração. Se você tiver fluxos de trabalho de aplicativo lógico Standard que funcionam com transações X12, EDIFACT ou AS2, você terá acesso a recursos de acompanhamento robustos que ajudam a monitorar as trocas B2B efetivamente.

Com uma conta de integração de nível Premium, você pode configurar o acompanhamento B2B para fluxos de trabalho Standard usando o Azure Data Explorer. Essa funcionalidade controla 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 acompanhamento sem perdas, juntamente com recursos de visualização e consulta.

Por exemplo, você obtém um painel de acompanhamento para que você possa monitorar, pesquisar e analisar transações B2B com eficiência. Para uma análise mais detalhada, você pode criar consultas avançadas no banco de dados do cluster. Com o acompanhamento de dados 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 acompanhamento B2B funciona, como configurar essa funcionalidade para seu recurso de aplicativo lógico Padrão e fluxos de trabalho e como abrir o painel de acompanhamento.

Limitações e problemas conhecidos

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

Como funciona o rastreamento B2B

A tabela a seguir descreve como vários componentes funcionam juntos para dar suporte ao acompanhamento B2B:

Pré-requisitos

• Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.

• Uma conta de integração no 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 acompanhamento B2B dá suporte apenas a 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 acompanhamento.

  Se você não tiver um cluster e um banco de dados existentes, consulte 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 acompanhamento B2B

Para essa tarefa, você precisa criar um repositório de acompanhamento em sua conta de integração. Atualmente, uma conta de integração dá suporte a apenas um repositório de acompanhamento padrão.

Criar um repositório de acompanhamento para a conta de integração

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

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

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

   Propriedade	Value
   Subscription	A assinatura do Azure para o seu cluster do Azure Data Explorer.
   Azure Data Explorer	O nome do cluster no Azure Data Explorer.
   Banco de dados	O nome do banco de dados do cluster.

   Por exemplo:

   A captura de tela mostra o portal do Azure, o menu da conta de integração Premium com o item selecionado chamado Armazenamentos de Rastreamento, a barra de ferramentas com a opção selecionada para Adicionar e o painel aberto para Adicionar armazenamento de rastreamento.

4. Quando terminar, selecione OK.

Desabilitar ou habilitar o acompanhamento B2B no nível do contrato

Se você tiver contratos existentes entre parceiros comerciais em sua conta de integração, poderá desabilitar ou reabilitar o acompanhamento de cada contrato. Por padrão, o acompanhamento está habilitado para contratos. Atualmente, é possível desabilitar ou reabilitar o acompanhamento para um contrato somente por meio da exibição JSON.

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

2. No menu 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 contrato, localize os objetos sendAgreement e receiveAgreement.

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

Para saber mais, confira 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 acompanhamento funcione corretamente, verifique se todas as seguintes condições foram atendidas:

• Existe um repositório de acompanhamento em 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 acompanhamento, verifique se o fluxo de trabalho executa algumas ações internas X12, EDIFACT ou AS2 para que o repositório de acompanhamento contenha dados.

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

   Por padrão, a guia Visão Geral é selecionada e mostra um resumo de alto nível com grafos para todos os tipos de mensagens compatíveis, status de mensagem, parceiros com mais erros e um resumo de mensagens para cada parceiro.

   Guia	Description
   Visão geral	Exiba um resumo de alto nível para todos os tipos de mensagens com suporte.
   AS2	Exiba os detalhes de todas as transações AS2 coletadas.
   X12	Exiba os detalhes de todas as transações X12 coletadas.

   Por exemplo:

   

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

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

   A guia selecionada mostra as mensagens coletadas junto 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 por tabela. Essa estrutura de tabela fornece a capacidade de consultar e recuperar dados de acompanhamento B2B com eficiência, fornecer insights estruturados sobre o fluxo de mensagens, o status do processamento e a solução de problemas.

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

Gerenciar lojas de rastreamento com a API REST

Você pode usar a API REST do Azure Logic Apps para criar, atualizar, excluir e recuperar o repositório de acompanhamento programaticamente.

Criar ou atualizar um repositório de acompanhamento

Crie um repositório de acompanhamento 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

Retornar os detalhes do repositório de acompanhamento criado ou atualizado.

Obter um repositório de acompanhamento específico

Obtenha os detalhes sobre um repositório de acompanhamento específico.

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 da loja de rastreamento especificada.

Obter todos os repositórios de acompanhamento

Obtenha todos os repositórios de acompanhamento na 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 locais de rastreamento associados à sua conta de integração.

Excluir um repositório de acompanhamento

Exclua um repositório de acompanhamento existente na 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

Devolver uma resposta de êxito para um repositório de acompanhamento excluído com êxito.

Conteúdo relacionado

• Esquemas para acompanhar transações B2B – Fluxos de trabalho padrão