Configurar a pesquisa do Dataverse em portais

Observação

• Desde outubro de 2022, os portais do Power Apps passaram a ser Power Pages.
• Este tópico se aplica a recursos herdados. Para obter as informações mais recentes, acesse a documentação do Microsoft Power Pages.

Visão geral

A pesquisa do Dataverse fornece resultados de pesquisa rápidos e abrangentes, classificados por relevância em portais. A pesquisa do Dataverse é o mesmo serviço de pesquisa usado em aplicativos baseados em modelos e outros serviços do Microsoft Power Platform criados no Microsoft Dataverse. Para ativar a pesquisa do Dataverse, adicione a configuração do site Search/EnableDataverseSearch e defina-a como verdadeiro. Se esta configuração estiver definida como falso ou não existir, a pesquisa Lucene.NET será ativada.

Este passo a passo explica como habilitar a pesquisa para a tabela Produtos da Ordem no banco de dados de exemplo Northwind Traders, disponível no Dataverse. Para obter mais informações sobre bancos de dados de exemplo, acesse Instalar o banco de dados e os aplicativos Northwind Traders.

Você pode seguir o passo a passo com uma tabela de sua escolha, substituindo nwind_products pelo nome lógico da sua tabela.

Etapa 1: habilitar a pesquisa do Dataverse

1. No centro de administração do Power Platform, selecione um ambiente.

2. Selecione Configurações > Produto > Recursos.

3. Em Pesquisa, defina a pesquisa do Dataverse como Ativada.

4. Selecione Salvar.

   

Etapa 2: adicionar ou atualizar configurações do site de pesquisa

1. Entre no Power Apps.

2. Verifique se você está no ambiente apropriado no qual seu portal existe.

3. No painel esquerdo, selecione Aplicativos e localize o aplicativo baseado em modelo Gerenciamento do Portal.

   

4. Selecione Gerenciamento do Portal e depois Configurações do Site no painel esquerdo.

5. Crie ou atualize a configuração do site Search/EnableDataverseSearch e defina o valor como verdadeiro.

6. Crie ou atualize a configuração de site Search/EnableAdditionalEntities e defina o valor como verdadeiro.

7. Crie ou atualize a configuração do site pesquisa/filtros e adicione o valor Produtos:nwind_produtos.

Etapa 3: criar ou verificar a exibição Pesquisa no Portal

Observação

Para as etapas a seguir, a solução Northwind Traders precisa estar instalada. Se você quiser usar outra tabela, use a solução apropriada ou use a Solução padrão.

1. Acesse Power Apps e selecione Soluções no painel esquerdo.

2. Selecione Northwind Traders.

   

3. Procure a tabela Produto da Ordem.

   

4. Selecione a tabela Produto da Ordem e, depois, Exibições.

   

5. Verifique se aparece Pesquisa no Portal na lista de exibições.

   

   Se a exibição Pesquisa do Portal ainda não existir, faça o seguinte:

   1. Selecione Adicionar exibição

      

   2. Digite o nome como Pesquisa de Portal e, em seguida, selecione Criar.

      

6. Certifique-se de que a exibição inclua as colunas apropriadas que você deseja usar para pesquisa. Inclua colunas adicionais, se necessário.

   

7. Se você editou a exibição, certifique-se de selecionar Salvar e, depois, Publicar antes de continuar.

   

Etapa 3: criar permissões de tabela

1. Entre no Power Apps.

2. No painel esquerdo, selecione Aplicativos e depois Gerenciamento do Portal.

3. No painel esquerdo, selecione Permissões da Tabela.

4. Selecione Nova.

   

5. Insira o nome como Ler tudo Northwind Products e, depois, selecione o Tipo de Acesso e o privilégio Leitura apropriados.

   Neste exemplo, o tipo de acesso Global é fornecido para a tabela nwind_products.

   

   Observação

   O tipo de acesso Global fornecerá acesso a todos os registros da tabela nwind_products para contatos relacionados da função Web associada (a função Web Usuários Autenticados será aplicada a todos os usuários do portal conectados). Considere os requisitos de segurança de dados e escolha outros tipos de acesso para restringir o acesso a dados. Consulte Configurar a segurança usando permissões de tabela para obter mais detalhes.

6. Selecione Salvar e Fechar.

7. Selecione e abra Ler tudo Northwind Products.

8. Role para baixo até a seção Funções da Web e selecione Adicionar Função da Web Existente.

   

9. Procure Usuários Autenticados e selecione Adicionar:

   

Etapa 4: adicionar uma página da Web de detalhes do registro

1. Acesse Power Apps e selecione Aplicativos no painel esquerdo.

2. Selecione Mais Comandos (…) para o portal e, depois, selecione Editar para abrir o portal nos portais do Power Apps Studio.

3. No menu, no canto superior esquerdo, selecione Nova Página e depois selecione o layout Em Branco para a página.

   

4. Digite o nome da página da Web como Produtos da Ordem.

5. No painel esquerdo, selecione Componentes e depois Formulário.

   

6. No lado direito de seu espaço de trabalho, selecione Usar existente ou Criar Novo, escolha o formulário Exibir Produtos da tabela nwind_products e depois defina Modo como ReadOnly.

Etapa 5: adicionar um marcador de site para a página da Web de detalhes do registro

1. Entre no Power Apps.

2. No painel esquerdo, selecione Aplicativos e depois Gerenciamento do Portal.

3. No painel de navegação esquerdo, selecione Marcador de Site.

4. Selecione Novo e crie um novo marcador de site fazendo o seguinte:

   1. Para Nome, digite nwind_products_SearchResultPage.

   2. Para Página, selecione Produtos da Ordem.

   

Etapa 6: verificar funcionalidade de pesquisa do Dataverse

1. Navegue até o portal com uma conta de usuário que tem a função da Web Autenticada atribuída.

2. Vá para a barra de ferramentas ou a página de pesquisa, e pesquise um registro conhecido.

   Por exemplo, use o termo de pesquisa Northwind Clam Chowder para obter os resultados associados à tabela nwind_products.

   

Limitações

• Não é possível aumentar a relevância, pesquisar ou filtrar resultados por um nome de coluna do Dataverse que foi configurado na configuração do site Consulta/Pesquisa.

• O parâmetro filter no objeto Liquid searchindex não filtrará resultados da pesquisa.

  Por exemplo: {% searchindex query: 'support', filter: ' +statecode:0'%} não filtrará resultados de pesquisa correspondentes que não tenham statecode:0.

• Embora a exibição Pesquisa no Portal possa ter qualquer operador em um filtro, apenas a seguinte lista de operadores é aplicada para consultar os resultados da pesquisa:

  • Igual a
  • Diferente de
  • É maior que
  • É maior ou igual a
  • É menor que
  • É menor que ou igual a

• Campos relacionados definidos na exibição Pesquisa no Portal como uma coluna de filtro ou uma coluna de exibição não têm suporte da pesquisa do Dataverse e serão ignorados.

• O conteúdo de anexos e objetos especificados em uma coluna de tipo de arquivo não é pesquisado.

Problemas conhecidos

• Se você mudar a configuração do site Search/EnableDataverseSearch de verdadeiro para falso para desabilitar a pesquisa do Dataverse e reativar a pesquisa Lucene.NET, será necessário ir até o centro de administração dos portais do Power Apps e escolher Ações > Reiniciar para reiniciar o portal. Se você perder esta etapa, verá uma página de erro ao tentar recriar o índice de pesquisa e os usuários não verão os resultados da pesquisa.

• Ao pesquisar uma palavra-chave, você pode encontrar continuamente a mensagem "Ocorreu um problema ao realizar a pesquisa. Tente novamente." Para corrigir isso, reinicie o portal abrindo o centro de administração dos portais do Power Apps e escolhendo Ações > Reiniciar.

Confira também

Usar pesquisa por facetas
Pesquisa de anexos de arquivo

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).