Como exibir valores de propriedades gerenciadas personalizadas em resultados de pesquisa clássicos - opção 2 no SharePoint Server
APLICA-SE A:
2013
2016
2019
Subscription Edition
SharePoint no Microsoft 365
Em How to display values from custom managed properties in search results - option 1 in SharePoint Server we showed a simple method to add a custom icon and values from two custom managed properties to your classic search results. Neste tópico, vamos ver um método um pouco mais completo para alterar a maneira como os resultados clássicos da pesquisa são exibidos, incluindo se instruções e realçamento de acerto. Neste artigo, você aprenderá:
Estratégia para matar três aves com uma única rocha - versão de resultados da pesquisa
Primeiro, vamos dizer o que queremos alcançar:
Exibe valores de duas propriedades gerenciadas personalizadas.
Aplique o realçamento de acerto às duas propriedades gerenciadas personalizadas.
Obter relevância aprimorada automaticamente para nossos resultados de pesquisa clássicos.
Antes de vermos detalhes sobre como atingir essas metas, vamos ver a estratégia que queremos seguir. Se isso ficar um pouco complexo, tente ficar travado. Esperamos que ele seja claro até o final.
Primeiro, lembre-se de como podemos pensar em realçamento de acerto:

As propriedades gerenciadas listadas na seção Propriedades realçadas por hit (JSON) da Web Part Resultados da Pesquisa e a propriedade "resumo mágico" são passadas para a propriedade HitHighlightedProperties.
Todos os valores da propriedade HitHighlightedProperties são passados para a propriedade HitHighlightedSummary.
Uma versão truncada dos valores em HitHighlightedSummary é exibida na Web Part Resultados da Pesquisa com três pontos no final.
Lembre-se também de que cada modelo de exibição de item contém uma referência ao modelo de exibição Item_CommonItem_Body e que esse modelo contém um método onlick que resultará em relevância aprimorada automaticamente com base no comportamento de clique do usuário.

Portanto, nossa estratégia é esta: criar variáveis no modelo de exibição de item que será passado e renderizado pelo modelo de Item_CommonItem_Body de exibição.
Especificamente, isso significa que temos que fazer o seguinte:
Adicione as propriedades gerenciadas personalizadas que desejamos exibir em nossos resultados de pesquisa clássicos às propriedades realçadas por hit na Web Part Resultados da Pesquisa.
Adicione as propriedades gerenciadas personalizadas a um modelo de exibição de item.
No modelo de exibição de item, crie uma variável que será usada pela propriedade HitHighlightedSummary para exibir nossas duas propriedades gerenciadas personalizadas com realçamento de acerto.
No modelo de exibição de item, deixe a referência para que Item_ComonItem_Body modelo de exibição
_#=ctx.RenderBody(ctx)=#_renderizará o resultado da pesquisa. Isso garante que a relevância seja aprimorada automaticamente.
OK, agora vamos passo a passo, com exemplos de como fizemos isso para nosso cenário do Centro de Pesquisa.
Como exibir valores de propriedades gerenciadas personalizadas com realçamento de acerto e obter relevância aprimorada automaticamente
Primeiro, você precisa encontrar os nomes de propriedades gerenciadas que correspondem às colunas de site personalizadas que você deseja usar. Vimos como fazer isso em Como exibir valores de propriedades gerenciadas personalizadas nos resultados da pesquisa - opção 1no SharePoint Server .
Em seguida, você precisa fazer alguma configuração na Web Part Resultados da Pesquisa. Estas são as etapas:
Na página Resultados da Pesquisa, selecione o menu Configurações e selecione Editar Página.
Na Web Part Resultados da Pesquisa, selecione Web Part Editar Web Part de Web > Part.
No painel de ferramentas da Web Part, selecione para expandir a seção Modelos de Exibição e selecione Usar um único modelo para exibir itens. Isso permite alterar o campo JSON (Propriedades realçadas por hit).

No campo Propriedades realçadas por hit (JSON), use o seguinte formato para adicionar as propriedades gerenciadas personalizadas às que você deseja adicionar realçamento de acerto:
"<Managed property name>"
No cenário do Centro de Pesquisa, queríamos aplicar o realçamento de acerto às propriedades gerenciadas ContentSummaryOWSMTXT e owstaxIdTechnicalSubject.

Selecione Aplicar para salvar as alterações. Thehe Display Templates section closes.
Para reabrir a seção, selecione Exibir Modelos e selecione Usar tipos de resultados para exibir itens.

Selecione OK e salve a página.
Em seguida, você precisa adicionar as propriedades gerenciadas personalizadas a um modelo de exibição de item. Veja o que você deve fazer:
Abra o modelo de exibição de item que pertence ao tipo de resultado para o qual você deseja personalizar os resultados da pesquisa.
No nosso cenário do Centro de Pesquisa, esse era o conteúdo do TechNet.
No modelo de exibição de item, na marca ManagedPropertyMapping, use a sintaxe a seguir para adicionar as propriedades gerenciadas personalizadas que você deseja exibir:
'<Current item property name>':<Managed property name>'
No nosso cenário do Centro de Pesquisa, queríamos que os valores das propriedades gerenciadas ContentSummaryOWSMTXT e owstaxIdTechnicalSubject apareçam no resultado da pesquisa. Para facilitar a manutenção do arquivo, nomeimos as propriedades do item atual da mesma forma que as propriedades gerenciadas.

Em seguida, você precisa criar variáveis no modelo de exibição de item que será usado e renderizado pelo Item_Common_Item_Body de exibição. Veja o que você deve fazer:
Como você não tem nenhuma garantia de que os valores de suas propriedades personalizadas conterão qualquer uma das palavras de consulta inseridas, ou seja, o realçamento de acerto não será usado, você precisa criar variáveis que garantam que o valor de suas propriedades personalizadas será exibido independentemente do realçamento de acerto.
As capturas de tela a seguir mostram como criamos duas variáveis para nossas propriedades personalizadas ContentSummaryOWSMTXT e owstaxIdTechnicalSubject.

Além disso, adicionamos uma variável semelhante para a propriedade Title. Se você não adicionar isso, os resultados da pesquisa não serão renderizados.

A última etapa que você precisa fazer no modelo de exibição de item é criar uma variável que substituirá a propriedade HitHighlightedSummary usada para exibir os valores.

Salve o modelo de exibição do item.
Observação
Você não precisa fazer essa etapa se estiver usando SharePoint no Microsoft 365. Vá para Configurações do site > Tipos de resultados de pesquisa. Um alerta de Sincronização de Propriedades é exibido.

Esse alerta aparece porque adicionamos propriedades gerenciadas a um modelo de exibição de item (o que fizemos na Etapa 9). Para atualizar os tipos de resultados com as propriedades gerenciadas recém-adicionadas, escolha Atualizar.

Importante
Se você não fizer essa atualização, as propriedades gerenciadas recém-adicionadas não serão exibidas nos resultados da pesquisa.
Depois que fizemos essas alterações, quando os usuários entraram em uma consulta no Centro de Pesquisa, o resultado da pesquisa incluiu:

Um ícone personalizado
O valor de Título com realçamento de acerto
O valor de ContentSummaryOWSMTXT com realçamento de acerto
O valor de owstaxIdTechnicalSubject (As palavras de consulta não corresponderam ao valor da propriedade, mas devido à variável que criamos na etapa 10, o valor aparece.)
Um link para o item na lista
Queríamos fazer uma pequena alteração em como o valor de owstaxIdTechnicalSubject aparece. Queríamos dar aos usuários um pouco mais de contexto sobre o que esse valor representa. Portanto, decidimos adicionar o texto "Assunto Técnico:" antes do valor. Além disso, como esse valor nem sempre está presente para todos os itens de lista, decidimos que ele só deve ser exibido quando um valor estava presente.
Para fazer isso, fizemos uma alteração na variável que substitui a propriedade HitHighlightedSummary:

Observe que adicionamos uma cor ligeiramente diferente ao texto "Assunto Técnico:". Com essa adição, o resultado final da pesquisa é exibido da seguinte forma:

Em Como criar um novo tipo de resultado no SharePoint Server, decidimos que queríamos 6 tipos de resultados diferentes. Depois de criar o tipo de resultado de conteúdo do TechNet e o modelo de exibição, foi muito fácil copiar esse trabalho para os outros 5 tipos de resultados.
E aqui está o resultado:

Portanto, agora que alteramos a maneira como os resultados clássicos da pesquisa são exibidos, a próxima etapa é alterar os valores exibidos no painel de foco.