Usar a pesquisa do Dataverse para recuperar linhas
Artigo
Use a ação Pesquisar linhas em fluxos para recuperar dados do Microsoft Dataverse usando palavras-chave e a pesquisa do Dataverse, que oferece resultados rápidos, inteligentes e abrangentes em tabelas no Dataverse.
Pré-requisitos
O administrador deve configurar a pesquisa do Dataverse em seu ambiente antes de usar a ação de pesquisa no Microsoft Dataverse.
Você pode adicionar a ação Pesquisar linhas para seus fluxos e fornecer uma palavra-chave em Pesquisar termo para pesquisar essa palavra-chave em todas as linhas indexadas no Dataverse.
Você pode usar o conteúdo dinâmico de uma etapa anterior no fluxo para parametrizar a caixa Termo de pesquisa. Por exemplo, você pode usar uma palavra-chave inserida em um bot do Microsoft Copilot Studio e definir as seguintes opções para iniciar uma pesquisa automatizada.
Observação
Pode levar algumas horas para que as linhas adicionadas recentemente sejam incluídas nos resultados da pesquisa.
Tipo de pesquisa
Use a opção Tipo de pesquisa para fornecer a sintaxe para a consulta de pesquisa. Use simples para indicar que deseja usar a sintaxe de consulta simples. Ou use completa se preferir usar a sintaxe de consulta Lucene. A sintaxe de consulta padrão é simples.
A sintaxe de consulta simples oferece suporte à seguinte funcionalidade:
Operador
Descrição
Operadores booleanos
Operador AND; denotado pelo operador + OR; denotado pelo operador | NOT; denotado por -
Operadores de precedência
Um termo de pesquisa "hotel+(wifi | luxury)" pesquisará resultados que contenham o termo "hotel" e "wifi" ou "luxury" (ou ambos).
Curingas
Há suporte para curingas à direita; por exemplo, "Alp*" procura por "alpino".
Correspondências exatas
Uma consulta entre aspas " ".
A sintaxe de consulta Lucene oferece suporte à seguinte funcionalidade:
Operador
Descrição
Operadores boolianos
Fornece um conjunto expandido em comparação com a sintaxe de consulta simples. Operador AND; denotado por AND, &&, + operador OR; denotado por OR, || operador NOT; denotado por NOT, !, –
Operadores de precedência
A mesma funcionalidade da sintaxe de consulta simples.
Curingas
Além de um curinga à direita, também oferece suporte a um curinga à esquerda. Curinga à direita – "alp*" Curinga à esquerda - "/.*pine/"
Pesquisa difusa
Permite consultas com erros ortográficos de até dois caracteres. "Uniersty~" retornará "University" "Blue~1" retornará "glue", "blues"
Aumento de termos
Pondera termos específicos em uma consulta de maneira diferente. "Rock^2 electronic" retornará resultados em que as correspondências a "rock" são mais importantes do que correspondências a "electronic".
Pesquisa por proximidade
Retorna resultados onde os termos estão dentro de x palavras um do outro, para resultados mais contextuais. Por exemplo, "airport hotel"~5 retorna resultados em que "airport" e "hotel" estão a cinco palavras um do outro, aumentando assim as chances de encontrar um hotel localizado próximo a um aeroporto.
Pesquisa de expressão regular (regex)
Por exemplo, /[mh]otel/ corresponde a "motel" ou "hotel".
Para usar qualquer um dos operadores de pesquisa como parte do texto de pesquisa, aplique escape ao caractere prefixando-o com uma única barra invertida (\). Os caracteres especiais com escape incluem os seguintes caracteres: + - & | ! ( ) { } [ ] ^ " ~ * ? : \ /
Search mode
Você pode especificar se algum ou todos os termos de pesquisa devem ser correspondidos para contar o documento como uma correspondência. O padrão é qualquer. Ele controla se um termo com o operador NOT é AND ou OR com outros termos na consulta (assumindo que não há operador + ou | nos outros termos).
Usando qualquer um para Modo de pesquisa aumenta a recuperação de consultas, incluindo mais resultados. Por padrão, é interpretado como "OU NÃO". Por exemplo, "wifi -luxury" corresponderá a documentos que contenham o termo "wifi" ou que não contenham o termo "luxury".
Usando todos para Modo de pesquisa aumenta a precisão das consultas, incluindo menos resultados. Por padrão, é interpretado como "E NÃO". Por exemplo, "wifi-luxury" corresponderá a documentos que contêm o termo "wifi" e não contêm o termo "luxury".
Filtro de linhas: você pode restringir sua pesquisa especificando filtros, conforme mostrado na imagem a seguir.
Filtro de tabela: você pode restringir sua pesquisa a tabelas específicas, conforme mostrado na imagem a seguir.
Ordenar por: use esta opção para classificar especificando um nome de coluna e adicionando asc ou desc como sufixo, conforme mostrado na imagem a seguir.
Usando conteúdo dinâmico e linhas do Dataverse
Você pode usar os resultados da ação diretamente pelo Conteúdo dinâmico. Aqui está o significado de cada um dos parâmetros.
Nome do parâmetro
Descrição
Corpo
O objeto que representa toda a resposta. Contém a lista de linhas, a contagem total de linhas e os resultados da faceta.
Lista de linhas
Um objeto que representa todas as linhas retornadas.
Item da lista de linhas
Uma linha individual na lista de linhas, quando usada dentro de um loop.
Pontuação de pesquisa de linha
A pontuação do Dataverse de uma linha. Essa pontuação indica o quão próximo ele correspondeu às palavras-chave e condições de pesquisa.
Destaques da pesquisa de linha
Destaca as palavras-chave específicas que correspondem às palavras-chave de pesquisa na linha.
Nome da tabela de linha
O nome da tabela para uma única linha. Esta ação agrega linhas de todas as tabelas pesquisáveis no ambiente.
ID de objeto de linha
Este é um identificador para cada linha. Use este identificador em conjunto com o nome da tabela na ação Obter linhas para ler todas as colunas em uma linha.
Código de tipo de objeto de linha
O identificador do nome da tabela para a linha.
Quando você está construindo seu fluxo, o conteúdo dinâmico pode aparecer como esta imagem:
A ação Pesquisar linhas retorna muitas outras colunas para as linhas correspondentes em um esquema de variável, dependendo da configuração de pesquisa do Dataverse.
Para usar essas colunas, analise a resposta JSON e, em seguida, use as saídas dinâmicas geradas a partir dela, conforme mostrado na imagem a seguir.