Ao clicar em uma vertical de pesquisa no SharePoint, como Pessoas, Conversas ou Vídeos, você pode ver uma página em branco ou uma mensagem informando que nenhum resultado foi encontrado. Esse problema ocorre quando a vertical de pesquisa está mal configurada, a fonte de resultado está ausente ou o esquema de pesquisa não mapeia as propriedades gerenciadas esperadas. Este artigo explica as causas técnicas de verticais de pesquisa vazias e fornece aos proprietários de sites um processo passo a passo para diagnosticar e corrigir cada camada do pipeline de pesquisa.
Principais Conclusões: Diagnosticando Verticais de Pesquisa Vazias no SharePoint
- Verticais de pesquisa no centro de administração do SharePoint > Pesquisa > Vertical: Controla quais fontes de resultado e regras de consulta se aplicam a cada vertical.
- Definição da fonte de resultado na Administração de Pesquisa: Determina se a vertical usa o índice local do SharePoint, um índice remoto ou um conector híbrido.
- Mapeamento de propriedades gerenciadas no Esquema de Pesquisa: Garante que as propriedades rastreadas usadas pela vertical existam e estejam definidas como Pesquisável.
Por que as Verticais de Pesquisa do SharePoint Mostram Resultados Vazios
Uma vertical de pesquisa é uma visualização pré-filtrada do índice de pesquisa. Ao clicar em Pessoas, o SharePoint adiciona uma regra de consulta que restringe os resultados a conteúdos onde a propriedade ContentClass é igual a “Person”. Se essa propriedade estiver ausente no índice, a vertical retorna zero itens. A causa raiz é quase sempre uma de três coisas: a fonte de resultado não está captando o conteúdo correto, a regra de consulta está filtrando por uma propriedade que não existe ou o rastreamento ainda não indexou o conteúdo.
O SharePoint Online usa um índice de pesquisa unificado que atende a todas as verticais. O esquema de pesquisa define quais propriedades rastreadas se tornam propriedades gerenciadas. Se uma propriedade não estiver definida como Pesquisável, a vertical de pesquisa não pode filtrar por ela. Proprietários de sites frequentemente presumem que, como o conteúdo existe no site, ele aparecerá na vertical de pesquisa. Essa suposição está errada. A vertical deve ser explicitamente configurada para consultar uma propriedade gerenciada que seja Pesquisável e Consultável.
O Papel das Fontes de Resultado
Cada vertical de pesquisa está vinculada a uma fonte de resultado. A fonte de resultado informa ao SharePoint onde procurar os resultados. As fontes de resultado padrão são Resultados Locais do SharePoint, Resultados de Pessoas e Resultados de Vídeo. Se uma vertical apontar para uma fonte de resultado personalizada que tenha uma conexão quebrada ou uma URL inválida, a vertical retorna resultados vazios. Os proprietários de sites devem verificar se a fonte de resultado está ativa e se seu protocolo corresponde ao ambiente.
O Papel das Regras de Consulta
As regras de consulta aplicam filtros adicionais à consulta de pesquisa. Uma regra de consulta pode adicionar uma condição que exige que uma propriedade gerenciada específica contenha um valor. Se a propriedade gerenciada não estiver populada, a regra remove todos os resultados. Os proprietários de sites devem verificar se uma regra de consulta está bloqueando a vertical revisando as condições e ações da regra.
Passos para Verificar e Corrigir Verticais de Pesquisa Vazias
- Abra as páginas de administração de pesquisa
Vá para o centro de administração do SharePoint. Em Pesquisa, selecione Administração de Pesquisa. Esta página lista todas as fontes de resultado, regras de consulta e esquemas de pesquisa do locatário. Você precisa ser administrador do SharePoint ou administrador de conjunto de sites para ver essas configurações. - Selecione a vertical que mostra resultados vazios
Na página Administração de Pesquisa, clique em Verticais. Encontre a vertical que está com problema. Clique no nome da vertical para abrir suas propriedades. Anote os nomes da fonte de resultado e da regra de consulta associados a esta vertical. - Teste a fonte de resultado manualmente
Vá para Fontes de Resultado na navegação à esquerda. Encontre a fonte de resultado que você anotou. Clique na fonte de resultado e depois em Testar. Na caixa de texto da consulta, insira uma palavra-chave simples que exista em seu site. Se o teste não retornar resultados, a fonte de resultado está mal configurada. Verifique a URL de conexão, o protocolo e o método de autenticação. Para uma fonte de resultado personalizada, certifique-se de que a URL aponte para um endpoint de pesquisa válido. - Verifique as condições da regra de consulta
Vá para Regras de Consulta na navegação à esquerda. Encontre a regra associada à vertical. Clique no nome da regra. Observe a seção Condições. Se a regra exigir um valor de propriedade gerenciada, verifique se a propriedade existe no esquema de pesquisa e se está populada no índice. Se a condição não puder ser satisfeita, a regra suprimirá todos os resultados. Remova ou desabilite a condição se ela for desnecessária. - Verifique o mapeamento da propriedade gerenciada
Vá para Esquema de Pesquisa. Pesquise pela propriedade gerenciada que a vertical usa. Por exemplo, a vertical Pessoas usa ContentClass. Clique na propriedade. Confirme se a propriedade está definida como Pesquisável e Consultável. Se não estiver, altere a configuração e clique em OK. Um rastreamento completo será acionado automaticamente. - Force um reindexação do site
No conjunto de sites, vá para Configurações do Site > Pesquisa e Disponibilidade Offline. Clique em Reindexar site. Esta ação solicita um rastreamento completo do conteúdo do site. Aguarde a conclusão do rastreamento, que pode levar várias horas dependendo do volume de conteúdo. - Limpe o cache do navegador e teste novamente
Após a conclusão do rastreamento, pressione Ctrl+F5 para forçar um recarregamento completo da página. Navegue até a vertical de pesquisa e insira uma consulta. Se os resultados aparecerem, a correção está concluída.
Se as Verticais de Pesquisa do SharePoint Ainda Mostrarem Resultados Vazios
Vertical de Pesquisa Retorna Resultados Vazios Apenas para um Usuário
Quando um único usuário vê resultados vazios, mas outros usuários veem conteúdo, a causa provável é um problema de corte de segurança. O usuário não tem permissão de leitura nos itens que deveriam aparecer. Verifique as permissões do usuário no site ou biblioteca que contém o conteúdo. Se o usuário não tiver acesso, conceda o nível de permissão apropriado.
Vertical de Pesquisa Retorna Resultados Vazios Após uma Migração de Site
Após uma migração de site, o índice de pesquisa pode não refletir o novo local. A fonte de resultado pode ainda apontar para a URL do site antigo. Vá para Fontes de Resultado e atualize a URL de conexão para o novo site. Em seguida, acione um rastreamento completo a partir da página Administração de Pesquisa.
Vertical de Pesquisa Retorna Resultados Vazios para Tipos de Conteúdo Personalizados
Se a vertical usar uma propriedade gerenciada derivada de um tipo de conteúdo personalizado, a propriedade deve ser mapeada para uma propriedade rastreada. No Esquema de Pesquisa, clique na propriedade gerenciada. Em Mapeamentos, adicione um mapeamento para a propriedade rastreada que corresponde à coluna personalizada. Defina a propriedade como Pesquisável e Consultável, depois reindexe o site.
| Item | Resultados Locais do SharePoint | Resultados de Pessoas |
|---|---|---|
| Tipo de fonte de resultado | Serviço de pesquisa do SharePoint | Serviço de pesquisa do SharePoint |
| Transformação de consulta | Nenhuma | ContentClass=Person |
| Propriedade gerenciada usada | Title, Content | ContentClass |
| Falha comum | URL da fonte de resultado está errada | ContentClass não está como Pesquisável |
Após revisar a fonte de resultado, a regra de consulta e o esquema de pesquisa, você pode identificar o ponto exato de falha. Comece com o teste da fonte de resultado, pois ele isola o problema de conexão. Em seguida, verifique a regra de consulta para ver se uma condição está filtrando todos os itens. Por fim, verifique o mapeamento da propriedade gerenciada para garantir que a propriedade esteja disponível para filtragem. A maioria das verticais vazias é corrigida tornando uma única propriedade Pesquisável ou removendo uma condição quebrada de uma regra de consulta.