Propriedade Gerenciada Não Aparece nos Resultados de Pesquisa: Causa e Solução

Ao criar uma propriedade gerenciada na pesquisa do SharePoint, se ela não aparecer nos resultados, a causa geralmente é uma incompatibilidade entre a propriedade rastreada e as configurações da propriedade gerenciada. A pesquisa do SharePoint depende de um pipeline de duas etapas: o rastreamento extrai valores brutos em propriedades rastreadas, e o esquema de pesquisa mapeia essas para propriedades gerenciadas. Se o mapeamento estiver ausente, a propriedade não será pesquisável nem exibível. Este artigo explica exatamente a falha no pipeline e fornece instruções passo a passo para corrigir o mapeamento para que sua propriedade gerenciada apareça nos resultados de pesquisa.

Por que uma Propriedade Gerenciada Não Aparece nos Resultados de Pesquisa

A pesquisa do SharePoint funciona em três estágios: rastreamento, indexação e consulta. Durante o rastreamento, o rastreador de pesquisa lê o conteúdo e armazena valores brutos em propriedades rastreadas. As propriedades rastreadas têm nomes como ows_ProjectName ou c_ProjectName. Essas propriedades rastreadas são então mapeadas para propriedades gerenciadas por meio do esquema de pesquisa. As propriedades gerenciadas são o que os usuários pesquisam e o que o web part de resultados de pesquisa exibe.

Se uma propriedade gerenciada não aparecer nos resultados de pesquisa, uma destas condições é verdadeira:

• A propriedade gerenciada não tem nenhuma propriedade rastreada mapeada para ela.
• A propriedade rastreada não contém dados porque a coluna do site ou o tipo de conteúdo não está preenchido.
• A propriedade gerenciada tem a caixa de seleção Pesquisável ou Recuperável desativada.
• Apenas um rastreamento incremental foi executado após a alteração no esquema. Um rastreamento completo é necessário.
• O esquema de pesquisa foi alterado no nível do locatário, mas o conjunto de sites usa uma configuração de pesquisa personalizada que substitui as configurações do locatário.

A causa raiz mais comum é a falta de mapeamento de propriedade rastreada. Ao criar uma propriedade gerenciada do zero, o SharePoint não atribui automaticamente uma propriedade rastreada a ela. Você deve selecionar manualmente a propriedade rastreada correta que contém os dados que deseja expor na pesquisa.

Passos para Mapear a Propriedade Rastreada e Habilitar a Propriedade Gerenciada para Pesquisa

Siga estes passos em ordem. Não pule a etapa de rastreamento completo.

1. Abra o Esquema de Pesquisa no centro de administração do SharePoint
   Vá para Centro de administração do SharePoint > Pesquisa > Esquema de Pesquisa. Esta página lista todas as propriedades gerenciadas e rastreadas do locatário. Se você estiver trabalhando em um conjunto de sites específico, use Configurações do Site > Esquema de Pesquisa.
2. Localize a propriedade gerenciada que não está aparecendo
   Na seção Propriedades Gerenciadas, digite o nome da sua propriedade na caixa de filtro. Clique no nome da propriedade para abrir sua página de configurações. Se a propriedade não existir, crie uma nova propriedade gerenciada clicando em Nova Propriedade Gerenciada.
3. Verifique o mapeamento atual da propriedade rastreada
   Role até a seção Mapeamento para propriedades rastreadas. Se a lista estiver vazia, nenhuma propriedade rastreada está mapeada. Clique em Adicionar um Mapeamento para abrir o seletor de propriedades rastreadas.
4. Selecione a propriedade rastreada correta
   No seletor de propriedades rastreadas, pesquise a propriedade rastreada que corresponde à sua coluna do site. Por exemplo, se sua coluna do site se chama ProjectName, a propriedade rastreada geralmente é ows_ProjectName ou c_ProjectName. Selecione a propriedade rastreada e clique em OK. Se você não vir a propriedade rastreada, execute um rastreamento completo primeiro (veja o passo 7) e depois retorne a este passo.
5. Ative Pesquisável e Recuperável
   Nas configurações da propriedade gerenciada, role até a caixa de seleção Pesquisável e ative-a. Ative também Recuperável se quiser que o valor da propriedade apareça nos resultados de pesquisa. Opcionalmente, ative Consultável se quiser que os usuários pesquisem especificamente por esta propriedade usando uma consulta como ProjectName:Contoso. Clique em OK ou Salvar para aplicar as alterações.
6. Verifique o mapeamento na propriedade rastreada
   Mude para a guia Propriedades Rastreadas na página Esquema de Pesquisa. Encontre a propriedade rastreada que você mapeou. Clique nela e verifique se sua propriedade gerenciada aparece na seção Mapeada para Propriedades Gerenciadas. Se não aparecer, o mapeamento não foi salvo. Repita os passos 3 a 5.
7. Solicite um rastreamento completo
   Vá para Centro de administração do SharePoint > Pesquisa > 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 de minutos a horas, dependendo do tamanho do seu conteúdo. Aguarde até que o status do rastreamento mostre Ocioso antes de testar.
8. Teste a propriedade gerenciada nos resultados de pesquisa
   Realize uma pesquisa no site que contém o conteúdo com a propriedade. Se você ativou Consultável, pode pesquisar usando a sintaxe NomeDaPropriedadeGerenciada:valor. Por exemplo, ProjectName:Contoso. Se você ativou apenas Recuperável, pesquise um termo que exista no conteúdo e verifique as propriedades de exibição do resultado.

Se a Propriedade Gerenciada Ainda Não Aparecer Após a Correção Principal

O web part de resultados de pesquisa não exibe o valor da propriedade

Mesmo que a propriedade gerenciada seja Recuperável, o web part de resultados de pesquisa padrão pode não exibi-la. Você deve configurar o modelo de exibição ou o web part de resultados de pesquisa moderno para mostrar a propriedade. No SharePoint moderno, edite o web part de resultados de pesquisa, vá para Propriedades > Propriedades de resultados de pesquisa e adicione o nome da propriedade gerenciada à lista de propriedades exibidas. Na pesquisa clássica, modifique o XSLT no modelo de exibição.

A coluna do site existe, mas a propriedade rastreada está ausente

Se você adicionou uma coluna do site após o último rastreamento completo, a propriedade rastreada pode ainda não existir. Execute um rastreamento completo primeiro e depois verifique novamente a lista de propriedades rastreadas. Se a propriedade rastreada ainda não aparecer, verifique se a coluna do site tem dados em pelo menos um item. Uma coluna vazia não gera uma propriedade rastreada.

Esquema de pesquisa do locatário vs esquema de pesquisa do conjunto de sites

O SharePoint permite que administradores de conjunto de sites criem um esquema de pesquisa personalizado que substitui o esquema de nível de locatário. Se a propriedade gerenciada estiver definida no nível do locatário, mas o conjunto de sites tiver um esquema personalizado, a propriedade não aparecerá. Vá para a página Esquema de Pesquisa do conjunto de sites e verifique se um esquema personalizado está ativo. Se estiver, exclua o esquema personalizado ou recrie a propriedade gerenciada no nível do conjunto de sites.

A propriedade gerenciada é substituída por uma fonte de resultados

As fontes de resultados podem limitar quais propriedades gerenciadas são retornadas nos resultados de pesquisa. Se você tiver uma fonte de resultados personalizada que restrinja propriedades, a propriedade gerenciada não aparecerá. Verifique a transformação de consulta da fonte de resultados em Administração da Pesquisa > Fontes de Resultados. Remova quaisquer restrições de propriedade na transformação de consulta.

Configurações da Propriedade Gerenciada: Pesquisável vs Recuperável vs Consultável

Configuração	Efeito nos Resultados de Pesquisa	Quando Ativar
Pesquisável	O conteúdo da propriedade é indexado e corresponde a consultas de pesquisa	Sempre ative se quiser que os usuários encontrem conteúdo pesquisando esta propriedade
Recuperável	O valor da propriedade pode ser exibido em web parts de resultados de pesquisa	Ative se quiser mostrar o valor da propriedade na lista de resultados
Consultável	Os usuários podem consultar a propriedade diretamente usando a sintaxe NomeDaPropriedade:valor	Ative apenas se precisar de consultas precisas baseadas em propriedades

Uma propriedade gerenciada deve ter Pesquisável ativado para aparecer nos resultados. Recuperável controla apenas a exibição. Consultável é opcional e geralmente não é necessário para pesquisas simples por palavras-chave.

Conclusão

Uma propriedade gerenciada que não aparece nos resultados de pesquisa geralmente é corrigida mapeando-a para a propriedade rastreada correta e executando um rastreamento completo. Verifique se a propriedade rastreada existe e contém dados. Ative as caixas de seleção Pesquisável e Recuperável nas configurações da propriedade gerenciada. Após o rastreamento completo, teste a propriedade com uma consulta de pesquisa. Se a propriedade ainda não aparecer, verifique se há um esquema personalizado do conjunto de sites ou uma fonte de resultados que substitua as configurações do locatário. Use a configuração do web part de resultados de pesquisa para exibir o valor da propriedade nos resultados de pesquisa.