Quando você pesquisa no SharePoint, os resultados dependem de como o conteúdo é indexado e mapeado. Por padrão, o SharePoint usa propriedades rastreadas que podem não corresponder aos seus termos de negócio. As propriedades gerenciadas permitem controlar quais campos aparecem nos resultados da pesquisa e como os usuários os filtram. Este artigo explica o que são propriedades gerenciadas, por que elas melhoram a precisão da pesquisa e como criá-las e configurá-las passo a passo.
Principais conclusões: Configuração de propriedades gerenciadas na pesquisa do SharePoint
- Central de administração do SharePoint > Pesquisa > Gerenciar esquema de pesquisa: Local central para criar e editar propriedades gerenciadas.
- Mapear uma propriedade rastreada para uma propriedade gerenciada: Conecte campos de metadados existentes para que se tornem pesquisáveis e refináveis.
- Habilitar refinadores e classificação: Torne as propriedades gerenciadas utilizáveis nos resultados da pesquisa para filtragem e ordenação.
O que são propriedades gerenciadas e por que usá-las
A pesquisa do SharePoint cria automaticamente propriedades rastreadas a partir de colunas de site, metadados de documentos e propriedades de arquivo. As propriedades rastreadas têm nomes como ows_MyColumn e não são amigáveis. Além disso, elas não podem aparecer nos resultados da pesquisa como refinadores ou opções de classificação por padrão.
Uma propriedade gerenciada é um campo do índice de pesquisa que você define. Você mapeia uma ou mais propriedades rastreadas para ela. Uma vez mapeada, a propriedade gerenciada pode ser usada em consultas de pesquisa, refinadores, classificação e modelos de exibição. Por exemplo, você pode criar uma propriedade gerenciada chamada ProjectName e mapeá-la para a propriedade rastreada de uma coluna de site chamada Project Name. Os usuários podem então filtrar os resultados da pesquisa por nome do projeto.
Antes de começar, confirme que você tem permissões de administrador do SharePoint Online ou, pelo menos, direitos de administrador do Aplicativo de Serviço de Pesquisa. Você também precisa de um conjunto de sites com conteúdo que tenha os metadados que deseja expor. Este guia usa a central de administração do SharePoint no Microsoft 365.
Etapas para criar e configurar propriedades gerenciadas
- Abrir a página de esquema de pesquisa
Vá para a central de administração do SharePoint. Na navegação à esquerda, selecione Pesquisa. Em seguida, escolha Gerenciar esquema de pesquisa. Esta página lista todas as propriedades gerenciadas existentes. - Criar uma nova propriedade gerenciada
Clique em Nova propriedade gerenciada. No campo Nome da propriedade, insira um nome sem espaços. Use PascalCase ou sublinhados para legibilidade, por exemplo ProjectName. O nome da propriedade é o identificador interno usado nas consultas. - Definir o tipo de propriedade
Selecione o Tipo que corresponde aos seus dados: Texto, Inteiro, Decimal, Data e Hora, Sim/Não ou Pessoa ou Grupo. Para texto curto como um nome de projeto, escolha Texto. Para um valor numérico de orçamento, escolha Decimal. - Configurar as configurações de pesquisa
Marque as caixas para como a propriedade deve se comportar na pesquisa:
– Pesquisável: Permite que o conteúdo da propriedade corresponda aos termos da consulta.
– Consultável: Permite que os usuários usem o nome da propriedade em consultas, como ProjectName:Alpha.
– Recuperável: Faz com que o valor da propriedade apareça nos resultados da pesquisa.
– Refinável: Habilita a propriedade como um refinador nos resultados da pesquisa.
– Classificável: Permite que os resultados sejam classificados por esta propriedade.
– Seguro para anônimos: Use apenas se a propriedade não contiver dados confidenciais. - Mapear propriedades rastreadas
Na seção Mapeamentos para propriedades rastreadas, clique em Adicionar um mapeamento. Na caixa de diálogo, digite parte do nome da propriedade rastreada ou navegue pela lista. Selecione a propriedade rastreada que corresponde à sua coluna de site. Por exemplo, se você tiver uma coluna de site chamada ProjectName, procure por ows_ProjectName. Clique em OK. Você pode mapear várias propriedades rastreadas para uma propriedade gerenciada se elas contiverem o mesmo tipo de dados. - Salvar a propriedade gerenciada
Clique em OK na parte inferior do formulário. A propriedade aparece na lista. Um rastreamento completo da fonte de conteúdo é acionado automaticamente. Aguarde a conclusão do rastreamento antes de testar. - Testar a propriedade gerenciada na pesquisa
Vá para um site do SharePoint que contenha documentos com os metadados mapeados. Execute uma consulta de pesquisa. Se você habilitou refinável, verifique o painel de refinadores à esquerda. A propriedade gerenciada deve aparecer como uma opção de filtro. Se você habilitou classificável, pode classificar os resultados por essa propriedade na web part de resultados da pesquisa.
Problemas comuns após configurar propriedades gerenciadas
A propriedade gerenciada não aparece nos resultados da pesquisa
A causa mais comum é que o mapeamento da propriedade rastreada está incorreto ou o conteúdo não foi reindexado. Verifique o mapeamento editando a propriedade gerenciada e conferindo a lista Mapeamentos para propriedades rastreadas. Confirme também que a propriedade rastreada realmente contém dados. Você pode verificar isso visualizando as propriedades do documento no site. Se a coluna do site estiver vazia, nenhum valor será indexado.
Para forçar a reindexação, vá para as configurações do conjunto de sites. Em Pesquisa e disponibilidade offline, escolha Reindexar site. Isso aciona um rastreamento completo. Aguarde de 15 a 30 minutos e teste novamente.
O refinador não mostra valores mesmo com dados existentes
Isso acontece quando a propriedade gerenciada não está marcada como Refinável. Edite a propriedade e habilite a caixa de seleção Refinável. Após salvar, a propriedade precisa de um rastreamento completo para atualizar o índice de pesquisa. Certifique-se também de que o tipo da propriedade corresponde aos dados. Por exemplo, uma propriedade de texto não pode ser usada como refinador numérico.
Consulta de pesquisa com propriedade gerenciada não retorna resultados
Se você usar uma consulta como ProjectName:Alpha e obtiver zero resultados, a propriedade pode não estar marcada como Consultável. Edite a propriedade e habilite Consultável. Verifique também se o valor que você está pesquisando corresponde exatamente ao valor indexado. As propriedades gerenciadas diferenciam maiúsculas de minúsculas por padrão. Use letras minúsculas em sua consulta para garantir.
Comparação das configurações de propriedades gerenciadas
| Configuração | Finalidade | Necessário para refinadores |
|---|---|---|
| Pesquisável | Permite que o conteúdo da propriedade corresponda às consultas do usuário | Não |
| Consultável | Permite que os usuários usem o nome da propriedade em consultas avançadas | Não |
| Recuperável | Torna o valor da propriedade visível nos itens de resultado da pesquisa | Não |
| Refinável | Habilita a propriedade como um filtro no painel de refinadores da pesquisa | Sim |
| Classificável | Permite classificar os resultados da pesquisa por esta propriedade | Não |
Após criar propriedades gerenciadas, você pode usá-las em web parts de resultados de pesquisa, modelos de exibição personalizados e consultas à API REST. O segredo é mapear a propriedade rastreada correta e habilitar apenas as configurações necessárias. Muitas propriedades refináveis podem deixar a página de resultados da pesquisa mais lenta.
Agora você pode criar propriedades gerenciadas que correspondem aos seus metadados de negócio. Comece identificando as três principais colunas que seus usuários mais pesquisam. Mapeie-as como propriedades gerenciadas e habilite refinável para aquelas que precisam de filtragem. Para cenários de pesquisa avançados, combine várias propriedades gerenciadas em uma web part de resultados de pesquisa usando a configuração JSON de Refinement.