Quando uma propriedade gerenciada na Pesquisa do SharePoint não retorna resultados, os usuários veem páginas de pesquisa vazias para conteúdo que sabem que existe. Esse problema geralmente ocorre porque a propriedade gerenciada não está mapeada para uma propriedade rastreada, a propriedade não é pesquisável ou o índice de pesquisa não foi atualizado após uma alteração no esquema. Este artigo explica por que as propriedades gerenciadas falham ao aparecer nos resultados da pesquisa e fornece instruções passo a passo para verificar mapeamentos, atualizar configurações e reindexar o conteúdo.
Principais Conclusões: Corrigindo Resultados de Pesquisa de Propriedade Gerenciada
- Central de administração do SharePoint > Pesquisa > Propriedades Gerenciadas: Verifique se a propriedade gerenciada possui uma propriedade rastreada mapeada e se a opção Pesquisável está ativada.
- Central de administração do SharePoint > Pesquisa > Propriedades Rastreadas: Confirme se existe uma propriedade rastreada para o seu tipo de conteúdo e se ela mapeia para a propriedade gerenciada correta.
- Configurações do Site > Pesquisa e Disponibilidade Offline > Reindexar: Force um rastreamento completo após alterações no esquema para que o índice reflita os novos mapeamentos.
Por que as Propriedades Gerenciadas Falham ao Aparecer nos Resultados da Pesquisa
A Pesquisa do SharePoint usa um sistema de propriedades de duas camadas. As propriedades rastreadas armazenam dados brutos extraídos de documentos e itens de lista durante um rastreamento. As propriedades gerenciadas são os campos voltados para o usuário que as consultas de pesquisa segmentam. Uma propriedade gerenciada não pode retornar resultados a menos que esteja conectada a pelo menos uma propriedade rastreada que contenha dados.
As causas mais comuns para uma propriedade gerenciada não aparecer nos resultados da pesquisa são:
- A propriedade gerenciada não possui mapeamento de propriedade rastreada.
- A propriedade rastreada mapeada não contém dados para os itens que você está pesquisando.
- A propriedade gerenciada não está configurada como Pesquisável ou Consultável no esquema.
- O índice de pesquisa não foi atualizado após alterações no esquema.
- A propriedade rastreada está excluída do índice devido a uma regra de análise ou inclusão.
Como Funciona o Mapeamento de Propriedade Rastreada para Gerenciada
Quando o SharePoint rastreia um site, ele cria propriedades rastreadas com base em colunas do site, metadados de documentos e conteúdo de arquivos. Essas propriedades rastreadas têm nomes como ows_MyColumn ou MyColumn. Uma propriedade gerenciada como MyColumn deve incluir um mapeamento para a propriedade rastreada. Sem esse mapeamento, a propriedade gerenciada não tem dados para retornar.
Você pode mapear várias propriedades rastreadas para uma única propriedade gerenciada. A propriedade gerenciada pode ser configurada para incluir conteúdo de todas as propriedades rastreadas mapeadas ou apenas de uma específica. Se o mapeamento estiver ausente, a propriedade gerenciada existe no esquema, mas não contém valores indexados.
Etapas para Verificar e Corrigir Mapeamentos de Propriedades Gerenciadas
- Abra a central de administração do SharePoint
Faça login no Microsoft 365 com uma conta de administrador do SharePoint. Na central de administração, selecione Centros de administração e depois SharePoint. - Navegue até Administração da Pesquisa
Na navegação à esquerda, expanda Pesquisa e depois selecione Gerenciar Esquema de Pesquisa. - Localize a propriedade gerenciada
Na página Propriedades Gerenciadas, digite o nome da propriedade no campo de filtro e pressione Enter. Selecione o nome da propriedade para abrir suas configurações. - Verifique o mapeamento da propriedade rastreada
No editor de propriedades, role até a seção Mapeamentos para propriedades rastreadas. Se nenhuma propriedade rastreada estiver listada, clique em Adicionar um Mapeamento. Pesquise a propriedade rastreada que corresponde à sua coluna de site ou metadados de documento. Selecione a propriedade rastreada correta e clique em OK. - Ative Pesquisável e Consultável
No mesmo editor de propriedades, certifique-se de que Pesquisável esteja definido como Sim e Consultável como Sim. Essas configurações permitem que a propriedade retorne resultados em consultas de pesquisa. Clique em OK para salvar as alterações. - Verifique se a propriedade rastreada existe
Vá para a guia Propriedades Rastreadas no Esquema de Pesquisa. Filtre pelo seu tipo de conteúdo ou nome de coluna. Se a propriedade rastreada não existir, o conteúdo ainda não foi rastreado ou a coluna do site foi adicionada após o último rastreamento. Execute um rastreamento completo para criar a propriedade rastreada. - Reindexe o site ou a lista
Vá para o site onde o conteúdo reside. Navegue até Configurações do Site > Pesquisa e Disponibilidade Offline. Em Indexação de Conteúdo do Site, clique em Reindexar Site. Para uma lista específica, abra as configurações da lista, selecione Configurações Avançadas e depois clique em Reindexar Lista. Essa ação força um rastreamento completo desse conteúdo. - Execute um rastreamento completo a partir da Administração da Pesquisa
Na central de administração do SharePoint, vá para Pesquisa > Gerenciar Esquema de Pesquisa. À esquerda, selecione Administração da Pesquisa. Em Agenda de Rastreamento, clique em Iniciar rastreamento completo para a fonte de conteúdo que contém seu site. Um rastreamento completo pode levar horas dependendo da quantidade de conteúdo. - Teste a consulta
Após a conclusão do rastreamento, vá para a central de pesquisa ou caixa de pesquisa do site. Digite uma consulta que use a propriedade gerenciada, por exemploMyColumn:"valor". Se a propriedade ainda não retornar resultados, repita as etapas de verificação de mapeamento.
Se a Propriedade Gerenciada Ainda Tiver Problemas Após a Correção Principal
Propriedade gerenciada mostra zero resultados para conteúdo conhecido
A propriedade gerenciada pode estar mapeada para uma propriedade rastreada que não contém os dados esperados. Verifique a propriedade rastreada usando a opção Testar Propriedade Rastreada no Esquema de Pesquisa. Se a propriedade rastreada não tiver valores, o conteúdo não foi rastreado ou a coluna do site não está mapeada para uma propriedade rastreada. Adicione a coluna do site a um item de lista, salve-o e reindexe a lista.
A pesquisa retorna resultados apenas para alguns itens
Isso acontece quando a propriedade gerenciada está mapeada para várias propriedades rastreadas, mas apenas alguns itens preenchem essas propriedades. Verifique se todos os tipos de conteúdo relevantes escrevem na mesma propriedade rastreada. Se você usar propriedades rastreadas separadas para diferentes tipos de conteúdo, mapeie cada uma para a mesma propriedade gerenciada. Defina a opção Incluir conteúdo de todas as propriedades rastreadas mapeadas nas configurações da propriedade gerenciada.
Colunas de site personalizadas não aparecem nas propriedades rastreadas
O SharePoint não cria propriedades rastreadas para colunas de site até que a coluna seja adicionada a uma lista e a lista seja rastreada. Crie uma lista de teste que inclua a coluna personalizada, adicione alguns itens com dados nessa coluna e reindexe a lista. Após o próximo rastreamento, a propriedade rastreada deve aparecer no Esquema de Pesquisa.
Propriedade é pesquisável, mas não consultável no código
Se você estiver usando a API REST de Pesquisa do SharePoint ou CSOM, a propriedade gerenciada deve estar marcada como Consultável no esquema. Verifique também se a propriedade está incluída na fonte de resultados da pesquisa. Na central de administração do SharePoint, vá para Pesquisa > Fontes de Resultados e verifique se a transformação de consulta inclui a propriedade gerenciada.
Configurações de Propriedade Gerenciada: Pesquisável vs Consultável vs Recuperável
| Configuração | Finalidade | Necessário para Resultados |
|---|---|---|
| Pesquisável | Permite que a propriedade seja correspondida em consultas de texto completo | Sim |
| Consultável | Permite que a propriedade seja usada em consultas de restrição de propriedade como NomePropriedade:valor |
Sim |
| Recuperável | Permite que o valor da propriedade seja retornado na exibição dos resultados da pesquisa | Não (mas necessário para exibição) |
| Permitir vários valores | Permite que a propriedade armazene vários valores de propriedades rastreadas | Depende dos dados |
Uma propriedade gerenciada deve ter tanto Pesquisável quanto Consultável ativados para aparecer nos resultados da pesquisa. Recuperável controla se o valor aparece no snippet do resultado da pesquisa ou em modelos de exibição personalizados. Se apenas Recuperável estiver ativado, a propriedade existe no índice, mas não pode ser usada em consultas de pesquisa.
Conclusão
Agora você pode verificar se uma propriedade gerenciada tem o mapeamento correto de propriedade rastreada e se Pesquisável e Consultável estão ativados. Após fazer alterações no esquema, sempre reindexe o site ou lista afetados e execute um rastreamento completo para atualizar o índice de pesquisa. Como prática recomendada, teste a propriedade com uma consulta simples como NomePropriedade:valor imediatamente após a conclusão do rastreamento. Para cenários complexos, use as ferramentas de teste do Esquema de Pesquisa na central de administração do SharePoint para confirmar se as propriedades rastreadas contêm os dados esperados.