Compartilhar via


Passo a passo: configurar tabelas adicionais para pesquisa global  

Observação

Desde o dia 12 de outubro de 2022, os portais do Power Apps passaram a ser Power Pages. Mais Informações: O Microsoft Power Pages já está disponível para todos (blog)
Em breve, migraremos e mesclaremos a documentação dos portais do Power Apps com a documentação do Power Pages.

Visão Geral

Você pode habilitar tabelas adicionais para a funcionalidade de pesquisa. Configurar a pesquisa para tabelas adicionais requer ações adicionais, que são descritas neste artigo. Essas etapas de configuração explícitas garantem que nenhum registro seja acidentalmente disponibilizado usando a pesquisa global.

Etapas para configurar pesquisa para tabelas adicionais

Para configurar pesquisa para tabelas adicionais:

  1. Habilitar pesquisa de tabelas adicionais pela primeira vez, adicionando uma nova configuração Search/EnableAdditionalEntities e definindo-o como verdadeiro. Esta é uma etapa única que permite a pesquisa de todas as tabelas adicionais padrão e personalizadas.

  2. Crie uma exibição de Pesquisa no Portal para cada tabela adicional com os filtros e colunas necessários que precisam ser pesquisáveis.

  3. Configure permissões de tabela para que cada tabela adicional com uma função da Web tenha pelo menos privilégio de leitura. Pule esta etapa se você já tiver as permissões de leitura configuradas para cada tabela.

  4. Crie uma página de detalhes do registro para cada tabela para mostrar os detalhes do registro selecionado na página de resultados da pesquisa. Pule esta etapa se você já tiver criado uma página de detalhes no registro de resultados separada para cada tabela.

  5. Crie um marcador de site nomeado <entitylogicalname>_SearchResultPage para cada tabela com a página de detalhes no registro associada.

  6. Recrie o índice de pesquisa.

  7. Verifique os resultados da pesquisa.

Aviso

Se você não criar uma página de detalhes no registro ou se não vincular a página de detalhes no registro ao marcador do site para pesquisa, não será possível selecionar os registros adicionais da tabela na página de resultados da pesquisa para visualizar os detalhes no registro.

Configuração do site para tabelas adicionais

A configuração do site Search/EnableAdditionalEntities é necessária para configurar tabelas adicionais para pesquisa.

Importante

Search/EnableAdditionalEntities serve explicitamente para permitir a pesquisa de tabelas adicionais. A principal configuração do site de pesquisa Pesquisa/Habilitada deve estar definida como verdadeira para usar a funcionalidade de pesquisa.

Você também pode definir outras configurações de site relacionadas semelhantes à configuração de pesquisa para tabelas padrão. Por exemplo, você pode usar a configuração Search/Filters para configurar tabelas adicionais e adicionar uma opção de filtro suspenso à pesquisa global. Mais informações: Configurações do site.

Marcador de site para página de detalhes do registro

A página de detalhes do registro é configurada usando um Marcador de Site nomeado <entitylogicalname>_SearchResultPage.

Por exemplo, se o nome lógico de sua tabela for nwind_products, o marcador do site será nwind_products_SearchResultPage. O valor do marcador de site é a página de detalhes do registro que você deseja abrir quando aquele resultado da pesquisa é selecionado. Por padrão, uma ID do registro é passada no parâmetro de cadeia de consulta id para a página de detalhes do registro. Para obter mais informações sobre como adicionar formulários em uma página, acesse Compor uma página.

Importante

Certifique-se de que a página de detalhes do registro tenha um formulário básico ou uma lógica escrita para mostrar os detalhes do resultado da pesquisa. Por exemplo, Etapa 4 – adicionar página de detalhes do registro no passo a passo a seguir.

A explicação passo a passo a seguir explica cada etapa em detalhes com um banco de dados de exemplo e solução para configurar a pesquisa de tabelas adicionais.

Observação

  • Este passo a passo explica como habilitar a pesquisa para a tabela Produtos da Ordem no banco de dados de exemplo Northwind, disponível com Microsoft Dataverse. Para obter mais informações sobre bancos de dados de exemplo, consulte Instalar o banco de dados e os aplicativos Northwind Traders.
  • Você pode seguir o passo a passo com uma tabela de sua escolha, substituindo o nome de tabela nwind_products com o nome lógico da sua tabela.

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

  1. Entre no Power Apps.

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

  3. Selecione Aplicativos no painel de navegação à esquerda e localize o aplicativo baseado em modelo Gerenciamento de portal .  

    Gerenciamento do Portal.

    Observação

    O aplicativo Gerenciamento de portal pode ter o nome Portais do Dynamics 365, caso esteja em um ambiente em que aplicativos do Dynamics 365 estejam instalados.

  4. Selecione para abrir o aplicativo Gerenciamento de portal e vá para Configurações do site no painel de navegação à esquerda.

  5. Crie uma nova configuração, Search/EnableAdditionalEntities e defina o valor como verdadeiro.

    Configuração do site para EnableAdditionalEntities.

  6. Crie ou atualize a configuração pesquisa/filtros e adicione o valor Products:nwind_products.

    Configuração do site Pesquisa/filtros.

Etapa 2: 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 de navegação à esquerda.

  2. Selecione Northwind Traders.

    Selecionar solução.

  3. Procure pela tabela Produtos na Ordem.

    Tabela Produto do Pedido.

  4. Selecione a tabela Produto da Ordem e, em seguida, selecione Exibições.

    Produto do Pedido – Exibições.

  5. Verifique se você vê Pesquisa no Portal na lista de exibições.

    Exibição Pesquisa no Portal.

    Se a exibição Pesquisa no Portal ainda não existir, selecione Adicionar exibição, digite o nome como Pesquisa no Portal e selecione Criar.

    Adicionar uma exibição.

    Adicionar a exibição Pesquisa no Portal.

  6. Verifique se as colunas apropriadas foram adicionadas à exibição para pesquisa.

    Adicione colunas.

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

    Salvar e publicar.

Etapa 3: criar permissões de tabela

  1. Entre no Power Apps.

  2. Selecione Aplicativos no painel de navegação à esquerda e selecione a opção para abrir o aplicativo baseado em modelo Gerenciamento de portal .  

  3. Selecione Permissões de Tabela no painel de navegação esquerdo.

  4. Selecione Novo.

    Novo registro de Permissão de Tabela.

  5. Insira o nome como Produtos da Northwind Ler Todos e, em seguida, selecione o Tipo de acesso e privilégio Leitura apropriados.

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

    Tipo de Acesso e Permissões de leitura.

  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.

    Adicionar uma função Web existente.

  9. Procure Usuários autenticados e selecione Adicionar:

    Adicionar usuários autenticados.

Etapa 4: página da Web Adicionar detalhes do registro

  1. Acesse Power Apps e selecione Aplicativos no painel de navegação à esquerda.

  2. Selecione Mais comandos (…) para o portal e, em seguida, Editar para abrir o portal em Power Apps Studio.

  3. Selecione Nova página no menu no canto superior esquerdo e layout Em branco para a página.

    Nova página.

  4. Digite o nome da página como Produtos do pedido.

    Observação

    Esta página será exibida quando os usuários selecionarem um registro da página de resultados da pesquisa para exibir os detalhes do registro selecionado.

  5. Selecione Componentes no painel de navegação à esquerda e adicione um componente Formato à página da web.

    Adicionar um componente do formulário.

  6. Selecione a opção Usar existente ao lado direito do seu espaço de trabalho, selecione o formulário Ver produtos para a tabela nwind_products e, em seguida, defina Modo como Somente leitura.

    Definir o modo.

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

  1. Entre no Power Apps.

  2. Selecione Aplicativos no painel de navegação à esquerda e selecione a opção para abrir o aplicativo baseado em modelo Gerenciamento de portal .  

  3. Selecione Marcador de site no painel de navegação à esquerda.

  4. Selecione Novo e crie um novo marcador de site usando os seguintes detalhes:

    • Nome: nwind_products_SearchResultPage
    • Página: Produtos do pedido

    Novo marcador de site.

Etapa 6: recriar o índice de pesquisa

  1. Navegue no portal usando uma conta de usuário que tenha atribuída a função de Web Administrador.

  2. Acrescente a URL na barra de endereço com /_services/about e selecione Enter.

    Página _services_about.

  3. Selecione Limpar cache.

  4. Após limpar o cache, selecione Recriar índice de pesquisa.

Etapa 7: verifique se a pesquisa global funciona com a tabela personalizada

  1. Navegue até o portal com um usuário que tenha a Função da Web  Autenticado atribuída.

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

    Por exemplo, use a palavra-chave de pesquisa Northwind Clam Chowder para obter os resultados associados à tabela nwind_products.

    Resultados da pesquisa.

Próximas etapas

Remover uma tabela da pesquisa global

Consulte também

Pesquisar configurações de site relacionadas
Pesquisa progressiva

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).