Comment afficher les valeurs des propriétés gérées personnalisées dans le panneau de pointer dans SharePoint Server
S’APPLIQUE À :
2013
2016
2019
Subscription Edition
SharePoint in Microsoft 365
Dans Comment afficher les valeurs des propriétés gérées personnalisées dans les résultats de recherche - Option 2 dans SharePoint Server, nous vous avons montré comment afficher des valeurs de propriétés gérées personnalisées avec mise en surbrillance des résultats et obtenir automatiquement une pertinence améliorée en fonction du comportement de clic de l’utilisateur final. Dans cet article, vous allez apprendre à :
Déterminer le modèle d'affichage de panneau de pointage à modifier
Copier un modèle d'affichage de panneau de pointage existant
Déterminer le modèle d’affichage de panneau de pointage à modifier
Avant de faire quoi que ce soit, nous allons d'abord nous rafraîchir la mémoire sur la manière dont les différents modèles d'affichage sont liés :

Chaque type de résultat contient une référence à un modèle d'affichage d'élément.
Chaque modèle d'affichage d'élément contient une référence à un modèle d'affichage de panneau de pointage.
Chaque modèle d’affichage d’élément contient une référence au modèle d’affichage d’élément courant.
Chaque modèle d’affichage du panneau de pointage référencé contient des références aux trois modèles d’affichage de panneau de pointage courants.
Par défaut, l'affichage du panneau de pointage est formé par les trois modèles d'affichage de panneau de pointage courants. L'illustration ci-dessous montre comment les modèles d'affichage du panneau de pointage courants ont été utilisés pour former le panneau de pointage par défaut dans notre scénario de Centre de recherche.

Pour vous faciliter la vie autant que possible lorsque vous ajoutez des propriétés personnalisées à votre panneau de pointage, nous vous recommandons de laisser ces trois modèles d'affichage de panneau de pointage courants en l'état et de vous concentrer sur le modèle d'affichage de panneau de pointage spécifique du type de résultat (mis en évidence dans l'illustration ci-dessous). C'est ce que nous avons fait dans notre scénario de Centre de recherche et c'est ce que nous allons expliquer dans cet article.

Pour le moment, cette procédure peut sembler déroutante, mais nous allons vous expliquer toutes les étapes nécessaires dans les deux sections suivantes. Entrons donc directement dans le vif du sujet !
Copier un modèle d’affichage de panneau de pointage existant
Souvenez-vous, lorsque nous avons créé le contenu TechNet du modèle d’affichage d’élément personnalisé, nous avons commencé par copier le modèle d’affichage d’élément nommé Item_Default (pour plus d’informations, voir Comment créer un nouveau type de résultat dans SharePoint Server). Le Item_Default d’affichage contient une référence au Item_Default_HoverPanel d’affichage de panneau de pointeur. Étant donné que nous avons copié le Item_Default d’affichage, notre modèle d’affichage de contenu TechNet contient également une référence à la Item_Default_HoverPanel .

Nous voulions utiliser le modèle d'affichage de panneau de pointage Item_Default_HoverPanel comme base lorsque nous avons ajouté les propriétés personnalisées à notre panneau de pointage. Par conséquent, dans notre lecteur réseau mappé, nous avons copié le Item_Default_HoverPanel d’affichage

et lui avons attribué un nouveau nom : TechNet_Content_HoverPanel .

Nous n'avons eu qu'à renommer le fichier HTML, puisque le nom du fichier JavaScript associé a été automatiquement mis à jour.
Dans le modèle d’affichage de contenu TechNet, nous avons modifié la référence dans var hoverUrl afin qu’elle pointe vers le modèle d’affichage nouvellement copié et renommé TechNet_Content_HoverPanel’affichage.

Modifier un modèle d’affichage de panneau de pointage pour afficher les valeurs des propriétés gérées personnalisées
Dans notre scénario de Centre de recherche, le panneau de pointage par défaut ne contient presque pas d'informations supplémentaires sur le résultat de la recherche.

Nous voulions ajouter les valeurs des quatre colonnes de site suivantes au panneau de pointage :
GUID/UUID
Auteur interne
État
Contact de soumission
La capture d'écran ci-dessous illustre le processus de maintenance de ces valeurs pour un élément dans notre liste interne.

Lorsque des propriétés personnalisées sont ajoutées à panneau de pointage, nous devons les ajouter au modèle d’affichage d’élément (mis en évidence dans l’illustration ci-dessous).
Nous préférons le répéter, parce que ce n’est pas vraiment intuitif : lorsque des propriétés personnalisées sont ajoutées à un panneau de pointage, nous devons les ajouter au modèle d’affichage d’élément.

Pour afficher les propriétés personnalisées dans le panneau de pointage, voici la marche à suivre :
Trouvez les noms de propriétés gérées des colonnes de site que vous souhaitez utiliser. Comment afficher les valeurs des propriétés gérées personnalisées dans les résultats de la recherche - Option 1 dans SharePoint Server a montré comment effectuer cette opération.
Ouvrez le modèle d’affichage d’élément qui contient la référence au modèle d’affichage de panneau de pointage que vous souhaitez personnaliser. Dans le modèle d’affichage d’élément, dans la balise ManagedPropertyMapping, utilisez la syntaxe suivante pour ajouter les propriétés gérées personnalisées que vous souhaitez afficher :
'<Current item property name>':<Managed property name>'Dans notre scénario de Centre de recherche, nous avons ajouté quatre propriétés gérées au modèle d’affichage d’élément Contenu TechNet.

-
Notes
Vous n’avez pas besoin d’utiliser cette étape si vous utilisez SharePoint dans Microsoft 365.
Accédez à Paramètres du site > Types de résultats de recherche. Une alerte de synchronisation de propriétés s’affiche.

Cette alerte s’affiche car nous avons ajouté de nouvelles propriétés gérées à un modèle d’affichage d’élément (nous l’avons fait à l’étape 2). Pour mettre à jour les types de résultats avec les propriétés gérées nouvellement ajoutées, choisissez Mettre à jour.

Important
Si vous ne faites pas la mise à jour, les propriétés gérées nouvellement ajoutées n’apparaissent pas dans votre panneau de pointer.
Ouvrez le modèle d’affichage de panneau de pointage que vous souhaitez modifier et utilisez du code HTML pour ajouter les propriétés personnalisées que vous souhaitez afficher.
Dans notre scénario de Centre de recherche, nous avons ouvert le *TechNet_Content_HoverPanel. La capture d’écran suivante montre comment nous avons ajouté nos quatre propriétés personnalisées.

Enregistrez le fichier.
En effectuant une nouvelle recherche et en pointant sur un des résultats de la recherche, nous avons vu que les quatre propriétés personnalisées étaient désormais affichées. Parfait !

Mais nous n'en avons pas encore totalement fini. Les valeurs du rédacteur interne et du contact de soumission sont apparus différemment. La capture d’écran peut ne pas l’afficher clairement, mais nous espérons que vous pouvez voir que la valeur du rédacteur interne s’affiche bien, mais la valeur du contact de soumission était très longue et contenait un GUID peu clair.
Ces deux valeurs proviennent d’une colonne de site de type Personne ou Groupe. La différence est que, dans les paramètres de colonnes de site, la colonne Auteur interne est configurée pour afficher le nom, tandis que la colonne Contact de soumission est configurée pour afficher le nom (avec présence).

Pour que le contact de soumission apparaisse correctement, nous avons copié le hp. Méthode GetAuthorsHtml utilisée par le Item_CommonHoverPanel_Body d’affichage pour afficher les auteurs.

À présent, le panneau de pointage commence à avoir bonne allure.

Toutefois, pour que le panneau de pointage soit encore plus utile, nous voulons ajouter une action tout en bas. Nous allons vous montrer comment faire.
Article suivant de cette série
Comment ajouter une action personnalisée au panneau de pointer dans SharePoint Server