Pesquisar dados
No conector do Microsoft Dataverse, a ação Pesquisar linhas permite que você use o recurso de pesquisa do Dataverse em seus fluxos da nuvem do Power Automate. A pesquisa do Dataverse fornece resultados rápidos e abrangentes em várias tabelas.
Para usar a pesquisa do Dataverse em seus fluxos do Power Automate, primeiro faça o seguinte:
Habilite a pesquisa do Dataverse para seu ambiente.
Selecione tabelas pesquisáveis para pesquisa do Dataverse.
Especifique as colunas a serem pesquisadas e as colunas a serem retornadas.
Fornecemos instruções rápidas sobre como configurar seu ambiente para pesquisa do Microsoft Dataverse aqui, mas se desejar instruções passo a passo, navegue até Configurar pesquisa do Dataverse para seu ambiente.
Habilitar pesquisa do Dataverse
Para habilitar a pesquisa do Dataverse para seu ambiente, navegue até o Centro de administração do Power Platform e acesse as configurações do ambiente para o qual deseja ativar a pesquisa do Dataverse. Na página de configurações, expanda a seção Produto e selecione Recursos. Você pode habilitar ou desabilitar a pesquisa do Dataverse na seção Pesquisar, usando o botão de alternância.
Selecionar tabelas pesquisáveis
Para selecionar as tabelas para pesquisa, abra a solução em que as tabelas residem, selecione o botão de link Gerenciar índice de pesquisa localizado na guia Visão geral. Aqui, você pode selecionar as tabelas que deseja indexar para pesquisa do Dataverse.
Especificar colunas
A Exibição de Localização Rápida da tabela orienta as colunas pesquisáveis e os filtros para uma tabela habilitada para pesquisa do Dataverse. Você pode configurar as colunas para pesquisa por meio do botão Editar colunas da tabela de localização na seção Localizar por....
Também pode criar uma vista rápida concebida para pesquisa do Dataverse que tenha seu próprio filtro, classificação e colunas.
Usar a ação de linhas de pesquisa do Dataverse
Usar a ação de linhas de pesquisa do Dataverse para pesquisa básica é simples; a única entrada necessária é o termo de pesquisa; você pode usar conteúdo dinâmico de uma etapa anterior como termo de pesquisa. Neste exemplo, usamos um fluxo disparado manualmente com um parâmetro de entrada. Em seguida, selecionamos a entrada do gatilho como o termo de pesquisa para nossa ação de linhas de pesquisa do Dataverse. Estamos simplificando aqui, mas a entrada pode vir de qualquer ação anterior.
As linhas de pesquisa do Dataverse retornam todas as linhas que correspondem ao termo de pesquisa; às vezes, esse resultado pode ser de uma única tabela ou de várias tabelas. Na maioria dos casos, as colunas de resultados de múltiplas tabelas não corresponderiam e exigiriam que você configurasse os resultados retornados antes que eles chegassem ao destino final.
Neste exemplo, a ação de linhas de pesquisa do Dataverse retorna resultados das tabelas Contato, Reserva e Revisão. Sabendo que as colunas retornadas não são iguais, transformamos os dados em uma variável array com colunas comuns antes de criar uma tabela HTML.
Primeiramente, criamos uma variável de array para armazenar os resultados da pesquisa combinados. Depois disso, adicionamos uma etapa de análise JSON para interpretar os resultados recebidos da ação de linhas de pesquisa do Dataverse. A aplicação a cada ação foi então empregada para iterar cada resultado.
Introduzimos um controle switch para gerenciar adequadamente o resultado de cada item da tabela. Esta etapa foi crucial para garantir que pudéssemos usar as colunas exclusivas de cada tabela por meio do conteúdo dinâmico. Finalmente, incorporamos os resultados na variável de matriz de resultados da pesquisa.
Ao implementar essas etapas, resolvemos efetivamente o problema de colunas incompatíveis e transformamos os dados para facilitar a criação da tabela HTML.
Filtro de tabela
A ação de linhas de pesquisa do Dataverse permite selecionar quais tabelas você deseja pesquisar. Neste exemplo, nossa pesquisa do Dataverse foi configurada para pesquisar em várias tabelas, mas estamos restringindo a ação de linhas de pesquisa do Dataverse no fluxo do Power Automate para pesquisar apenas a tabela de contato.
Filtro de linhas
Você pode empregar uma expressão de filtro no estilo OData para restringir a pesquisa. Se desejar que a pesquisa retorne apenas contatos de Redmond, você deverá fornecer esta expressão como Filtro de Linha.
address1_city eq 'Redmond'
Neste exemplo, nossa pesquisa do Dataverse foi configurada para pesquisar em várias tabelas, mas estamos restringindo a ação de linhas de pesquisa do Dataverse no Power Automate para pesquisar apenas a tabela de contatos.
Classificar
Se você quiser classificar os resultados retornados por pontuação de pesquisa em ordem decrescente e depois por nome completo em ordem crescente, use essas expressões como ordens de classificação.
Classificar por item - 1: @search.score desc
Classificar por item - 2: fullname asc