Conectar-se ao Microsoft Dataverse a partir de fluxos de trabalho nos Aplicativos lógicos do Azure

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

Para automatizar tarefas que funcionam com seu banco de dados do Microsoft Dataverse, você pode usar o conector do Microsoft Dataverse com fluxos de trabalho nos Aplicativos Lógicos do Azure.

Por exemplo, você pode criar fluxos de trabalho que criam linhas, atualizam linhas e executam outras operações. Você também pode obter informações do banco de dados do Dataverse e disponibilizar a saída para outras ações a serem usadas em seus fluxos de trabalho. Por exemplo, quando uma linha é adicionada, atualizada ou excluída no banco de dados do Dataverse, você pode enviar um email usando o conector do Outlook do Office 365.

O conector do Dataverse era conhecido anteriormente como o conector do Common Data Service 2.0 e originalmente conhecido como conector do Dynamics 365. Você pode usar o conector do Dataverse para acessar o Microsoft Dataverse para Microsoft Dynamics 365 Sales, o Serviço de Cliente do Microsoft Dynamics 365, o Serviço de Campo do Microsoft Dynamics 365, o Microsoft Dynamics 365 Customer Insights – Journeys e a Automação do Serviço de Projeto do Microsoft Dynamics 365.

Este artigo mostra como adicionar um gatilho ou ação do Dataverse ao fluxo de trabalho e como funcionam as opções de parâmetro.

Referência de conector

Para obter informações técnicas com base na descrição do Swagger do conector, como operações, limites e outros detalhes, confira a página de referência do conector gerenciado.

Pré-requisitos

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

• Um ambiente e um banco de dados do Dataverse Data Service, que é onde sua organização armazena, gerencia e compartilha dados de negócios em um banco de dados do Dataverse. Para obter mais informações, consulte os seguintes recursos:

  • Saiba mais: Criar e gerenciar ambientes do Dataverse

  • Power Platform - Visão geral dos ambientes

• Conhecimento básico sobre Aplicativos lógicos do Azure, além do recurso e fluxo de trabalho do aplicativo lógico de Consumo ou Standard de onde você quer acessar seu banco de dados do Dataverse. Para usar um gatilho do Dataverse, você precisa de um fluxo de trabalho em branco. Para usar uma ação do Dataverse, você precisa de um fluxo de trabalho que comece com qualquer gatilho apropriado para seu cenário.

  Para obter mais informações, consulte os seguintes recursos:

  • Criar um exemplo de fluxo de trabalho de aplicativo lógico de consumo

  • Criar um exemplo de fluxo de trabalho do aplicativo lógico Standard

Adicionar um gatilho do Dataverse

Com base em se você possui um fluxo de trabalho de aplicativo lógico de Consumo ou Standard, siga as etapas correspondentes:

Adicionar uma ação do Dataverse

Com base em se você possui um fluxo de trabalho de aplicativo lógico de Consumo ou Standard, siga as etapas correspondentes:

Testar seu fluxo de trabalho

Para executar o fluxo de trabalho, siga estas etapas:

1. Na barra de ferramentas do designer, selecione Executar>Executar.

2. Reproduza as condições que o gatilho exige para que o fluxo de trabalho seja executado.

Retornar linhas com base em um filtro

Para ações que retornam linhas, como a ação Listar linhas , você pode usar uma consulta ODATA que retorna linhas com base no filtro especificado. Por exemplo, você pode configurar a ação para retornar apenas linhas para contas ativas.

1. No designer, na ação, abra a lista de parâmetros Avançados e selecione o parâmetro Filtrar linhas .

   

2. No parâmetro Filtrar linhas que agora aparece na ação, insira uma expressão de consulta ODATA, por exemplo:

   statuscode eq 1

   

Para saber mais, confira a seguinte documentação:

• Listar linhas
• $filter opções de consulta do sistema

Retornar linhas com base em uma ordem de classificação

Para ações que retornam linhas, como a ação Listar linhas , você pode usar uma consulta ODATA que retorna linhas em uma sequência específica, que varia de acordo com as linhas retornadas pela ação. Por exemplo, você pode configurar a ação para retornar linhas organizadas pelo nome da conta.

1. No designer, na ação, abra a lista de parâmetros Avançados e selecione o parâmetro Classificar por .

   

2. No parâmetro Classificar por que agora aparece na ação, insira o nome da coluna a ser usado para classificação, por exemplo, nome:

   

Para saber mais, confira a seguinte documentação:

• Listar linhas
• $orderby opções de consulta do sistema

Tipos de dados de campo

Em um gatilho ou ação, o tipo de dados de um valor de campo deve corresponder ao tipo de dados necessário do campo. Esse requisito se aplica se você insere manualmente o valor ou seleciona o valor na lista de conteúdo dinâmico.

Por exemplo, suponha que você tenha uma tabela chamada Tarefas. Esta tabela tem campos que se aplicam somente a essa tabela, enquanto outras tabelas têm seus próprios campos. Para a tabela tarefas de exemplo, a tabela a seguir descreve alguns tipos de campo de exemplo e os tipos de dados que esses campos exigem para seus valores.

Para a tabela tarefas de exemplo, suponha que você use a ação Adicionar uma nova linha para criar uma nova linha associada a outras linhas de entidade, especificamente uma linha de usuário e uma linha de conta. Portanto, nesta ação, você deve especificar as IDs e os tipos de pesquisa para essas linhas de entidade usando valores que correspondam aos tipos de dados esperados para as propriedades relevantes.

• Com base na propriedade Owner , que especifica uma ID de usuário e na propriedade Owner Type , que especifica o systemusers tipo de pesquisa, a ação associa a nova linha a um usuário específico.

• Com base na propriedade Regarding , que especifica uma ID de linha e na propriedade Regarding Type , que especifica o accounts tipo de pesquisa, a ação associa a nova linha a uma conta específica.

A ação resultante se parece com o seguinte exemplo:

Solução de problemas

Chamadas de vários ambientes

O conector do Dataverse armazena informações sobre os fluxos de trabalho dos aplicativos de lógica que recebem e necessitam de notificações sobre alterações nas entidades do banco de dados usando a entidade callbackregistrations no seu banco de dados Dataverse. Se você copiar uma organização do Dataverse, todos webhooks também serão copiado. Se você copiar sua organização antes de desabilitar fluxos de trabalho mapeados para sua organização, todos webhooks copiados também apontarão para os mesmos fluxos de trabalho de aplicativos lógicos, que receberão notificações de várias organizações.

Para interromper notificações indesejadas, exclua a callbackregistrations entidade da organização que envia essas notificações seguindo estas etapas:

1. Identifique e entre na organização do Dataverse de onde você deseja remover notificações.

2. No navegador Chrome, localize o registro de retorno de chamada que você deseja excluir.

   1. Revise a lista genérica para todos os registros de retorno de chamada no seguinte URI do OData para que você possa exibir os dados dentro da entidade callbackregistrations:

      https://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations:

      Observação

      Se nenhum valor for retornado, talvez você não tenha permissões para exibir esse tipo de entidade ou talvez não tenha se conectado à organização correta.

   2. Filtre pelo nome lógico da entidade de gatilho entityname e pelo evento de notificação que corresponde ao fluxo de trabalho do aplicativo lógico (mensagem). Cada tipo de evento é mapeado para o número inteiro associado à mensagem da seguinte maneira:

      Tipo de evento	Integer da mensagem
      Create	1
      Delete	2
      Update	3
      CriarOuAtualizar	4
      CriarOuExcluir	5
      AtualizarOuDeletar	6
      CriarOuAtualizarOuExcluir	7

      Este exemplo mostra como você pode filtrar notificações Create em uma entidade chamada nov_validation usando o seguinte URI do OData para uma organização de exemplo:

      https://fabrikam-preprod.crm1.dynamics.com/api/data/v9.0/callbackregistrations?$filter=entityname eq 'nov_validation' and message eq 1

      

      Observação

      Se houver vários gatilhos para a mesma entidade ou evento, você poderá filtrar a lista usando filtros adicionais, como e createdon_owninguser_value atributos. O nome do usuário proprietário aparece em /api/data/v9.0/systemusers({id}).

   3. Depois de encontrar a ID do registro de retorno de chamada que você deseja excluir, siga estas etapas:

      1. No navegador Chrome, abra as Ferramentas de Desenvolvedor do Chrome (Teclado: F12).

      2. Na janela, na parte superior, selecione a guia Console .

      3. No prompt de linha de comando, insira este comando, que envia uma solicitação para excluir o registro de retorno de chamada especificado:

         fetch('http://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations({ID-to-delete})', { method: 'DELETE'})

         Importante

         Certifique-se de fazer a solicitação fora de uma página da Interface do Cliente Unificada (UCI), por exemplo, diretamente na página de resposta do OData ou da própria API. Caso contrário, a lógica no arquivo app.js poderá interferir nessa operação.

   4. Para confirmar que o registro de retorno de chamada não existe mais, verifique a lista de registros de retorno de chamada.

Entidade "callbackregistrations" duplicada

Em fluxos de trabalho Standard, em condições específicas, como realocação de instância ou reinicialização de aplicativo, o gatilho do Microsoft Dataverse inicia uma execução duplicada, que cria uma entidade duplicada callbackregistrations em seu banco de dados do Dataverse. Se você editar um fluxo de trabalho Standard que começa com um gatilho do Dataverse, verifique se essa callbackregistrations entidade está duplicada. Se a duplicata existir, exclua manualmente a entidade duplicada callbackregistrations .

Conteúdo relacionado

• Conectores gerenciados para Azure Logic Apps
• Conectores integrados para Azure Logic Apps
• O que são os conectores nos Aplicativos Lógicos do Azure