Como exibir valores de propriedades gerenciadas personalizadas no painel de foco no SharePoint Server
APLICA-SE A: 
2013 2016 2019 Subscription Edition 
SharePoint no Microsoft 365
Em Como exibir valores de propriedades gerenciadas personalizadas nos resultados da pesquisa - opção 2 no SharePoint Server, mostramos como exibir valores de propriedades gerenciadas personalizadas com realçamento de acerto e obter relevância aprimorada automaticamente com base no comportamento de clique do usuário final. Neste artigo, você aprenderá:
Como decidir qual modelo de exibição do painel de foco deve ser modificado
Como copiar um modelo de exibição de painel de foco existente
Como decidir qual modelo de exibição do painel de foco deve ser modificado
Antes de fazermos algo, vamos primeiro atualizar nossas recordações sobre como os diferentes modelos de exibição estão conectados:
Cada tipo de resultado contém uma referência a um modelo de exibição de item.
Cada modelo de exibição de item contém uma referência a um modelo de exibição do painel de foco.
Cada modelo de exibição de item contém uma referência ao modelo de exibição de item comum.
Cada modelo de exibição de painel de foco referenciado contém referências a três modelos comuns de exibição de painel de foco.
Por padrão, a renderização do painel de foco é executada pelos três modelos comuns de exibição do painel de foco. A ilustração a seguir mostra como os modelos comuns de exibição do painel de foco foram usados para renderizar o painel de foco padrão em nosso cenário do Centro de Pesquisa.
Para facilitar a vida ao adicionar propriedades personalizadas ao painel de foco, você deve deixar esses três modelos comuns de exibição do painel de foco como estão e, em vez disso, se concentrar no modelo de exibição específico do painel de foco do tipo de resultado (realçado na ilustração abaixo). Isso é o que fizemos em nosso cenário do Centro de Pesquisa e é o que demonstraremos neste artigo.
Isso pode parecer confuso agora, mas mostraremos todas as etapas necessárias nas próximas duas seções. Portanto, vamos começar!
Como copiar um modelo de exibição de painel de foco existente
Lembre-se de quando criamos o conteúdo do modelo de exibição de item personalizado TechNet , começamos copiando o modelo de exibição de item chamado Item_Default (consulte Como criar um novo tipo de resultado no SharePoint Server para obter mais informações). O Item_Default de exibição contém uma referência ao modelo de exibição Item_Default_HoverPanel painel de foco. Como copiamos o modelo Item_Default de exibição, nosso modelo de exibição de conteúdo do TechNet também contém uma referência ao Item_Default_HoverPanel .
Queríamos usar o modelo de exibição Item_Default_HoverPanel painel de foco como base quando adicionamos propriedades personalizadas ao nosso painel de foco. Portanto, em nossa unidade de rede mapeada, copiamos o modelo Item_Default_HoverPanel de exibição
e deu a ele um novo nome: TechNet_Content_HoverPanel .
Só precisamos renomear o arquivo HTML, pois o nome do arquivo JavaScript associado foi atualizado automaticamente.
No modelo de exibição de conteúdo do TechNet, mudamos a referência no var hoverUrl para que ele apontasse para o modelo de exibição recém-copiado e renomeado TechNet_Content_HoverPanel de exibição.
Como alterar um modelo de exibição do painel de foco para mostrar valores de propriedades gerenciadas personalizadas
No cenário do Centro de Pesquisa, o painel de foco padrão continha quase nenhuma informação adicional sobre o resultado da pesquisa.
Queríamos adicionar os valores das quatro colunas de site a seguir ao painel de foco:
GUID/UUID
Escritor Interno
Status
Contato de envio
A captura de tela a seguir mostra como esses valores são mantidos para um item em nossa lista interna.
Ao adicionar propriedades personalizadas a um painel de foco, precisamos adicioná-las ao modelo de exibição do item (realçada na ilustração abaixo).
Novamente, porque isso não é muito intuitivo: ao adicionar propriedades personalizadas a um painel de foco, precisamos adicioná-las ao modelo de exibição de item .
Para exibir propriedades personalizadas no painel de foco, veja o que você deve fazer:
Encontre os nomes de propriedades gerenciadas das colunas de site que você deseja usar. Como exibir valores de propriedades gerenciadas personalizadas nos resultados da pesquisa - a opção 1 no SharePoint Server mostrou como fazer isso.
Abra o modelo de exibição de item que contém a referência ao modelo de exibição do painel de foco que você deseja personalizar. 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 cenário do Centro de Pesquisa, adicionamos quatro propriedades gerenciadas ao modelo de exibição de item de conteúdo do TechNet.
-
Observação
Você não precisa fazer essa etapa se estiver usando SharePoint em 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 novas propriedades gerenciadas a um modelo de exibição de item (fizemos isso na Etapa 2). Para atualizar os tipos de resultados com as propriedades gerenciadas recém-adicionadas, escolha Atualizar.
Importante
Se você não fizer a atualização, as propriedades gerenciadas recém-adicionadas não aparecerão no painel de foco.
Abra o modelo de exibição do painel de foco que você deseja alterar e use HTML para adicionar as propriedades personalizadas que você deseja exibir.
No nosso cenário do Centro de Pesquisa, abrimos o *TechNet_Content_HoverPanel. A captura de tela a seguir mostra como adicionamos nossas quatro propriedades personalizadas.
Salve o arquivo.
Ao fazer uma nova pesquisa e passar o mouse sobre um resultado de pesquisa, vimos que as quatro propriedades personalizadas agora eram exibidas. Legal!
No entanto, ainda não estamos completamente completos. Os valores para o Contato de Envio e Escritor Interno apareciam de forma diferente. A captura de tela pode não mostrar claramente, mas esperemos que você possa ver que o valor para o Escritor Interno apareceu bem, mas o valor para o Contato de Envio foi muito longo e continha um GUID feio.
Esses dois valores vêm de uma coluna de site do tipo Pessoa ou Grupo. A diferença é que, nas configurações da coluna do site, o Internal Writer é configurado para mostrar Nome, enquanto o Contato de Envio é configurado para mostrar Nome (com presença).
Para fazer o Contato de Envio aparecer corretamente, copiamos a HP. Método GetAuthorsHtml usado pelo Item_CommonHoverPanel_Body de exibição para exibir autores.
E agora o painel de foco estava começando a ficar muito bom.
Mas para tornar o painel de foco ainda mais útil, queríamos adicionar uma ação à parte inferior do painel de foco. mostrará como fazer isso.
Próximo artigo desta série
Como adicionar uma ação personalizada ao painel de foco no SharePoint Server