Comment faire pour afficher les valeurs des propriétés managées personnalisées dans le panneau sensitif dans SharePoint Server
**Sapplique à :**SharePoint Server 2013, SharePoint Server 2016
**Dernière rubrique modifiée :**2017-07-24
Résumé : Découvrez comment afficher les valeurs des propriétés managées personnalisées dans le panneau sensitif dans SharePoint Server.
Dans Comment faire pour afficher les valeurs des propriétés managées personnalisées dans les résultats de la recherche – l’option 2 dans SharePoint Server, nous vous avons expliqué comment afficher les valeurs des propriétés gérées personnalisées avec mise en surbrillance des résultats, ainsi que comment améliorer automatiquement la pertinence en fonction des choix du 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
Modifier un modèle d’affichage de panneau de pointage pour afficher les valeurs des propriétés gérées personnalisées
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 modèle d’affichage d’élément personnalisé de Contenu TechNet, nous avons commencé par copier le modèle d’affichage d’élément nommé Item_Default (voir Comment faire pour créer un nouveau type de résultat de SharePoint Server pour plus d’informations). Le modèle d’affichage Item_Default contient une référence au modèle d’affichage de panneau de pointage Item_Default_HoverPanel. Étant donné que nous avons copié le modèle d’affichage Item_Default, notre modèle d’affichage intitulé Contenu TechNet contient également une référence à 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, nous avons copié le modèle d’affichage Item_Default_HoverPanel dans notre lecteur réseau mappé
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 en var hoverUrl afin qu’il pointe vers le modèle d’affichage TechNet_Content_HoverPanel, nouvellement copié et renommé.
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. L’article Comment faire pour afficher les valeurs des propriétés managées personnalisées dans les résultats de la recherche - option 1 de SharePoint Server explique comment faire.
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 à effectuer cette étape si vous utilisez SharePoint Online.
Accédez à Paramètres du site --> Types de résultats de recherche. Remarquez que l’alerte Synchronisation des propriétés est affichée.
Cette alerte s’affiche, car nous avons ajouté de nouvelles propriétés gérées à un modèle d’affichage d’élément (ce que nous 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 procédez pas à la mise à jour, les propriétés gérées nouvellement ajoutées ne seront pas affichées dans votre panneau de pointage.
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 TechNet_Content_HoverPanel. La capture d’écran ci-dessous 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 des colonnes Auteur interne et Contact de soumission étaient affichées différemment. La capture d’écran ne le montre peut-être pas clairement, mais, avec un peu de chance, vous pourrez voir que si la valeur de la colonne Auteur interne a été affichée correctement, celle de Contact de soumission est très longue et contient un GUID peu convivial.
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 la colonne Contact de soumission s’affiche correctement, nous avons copié la méthode HP.GetAuthorsHtml utilisée par le modèle d’affichage Item_CommonHoverPanel_Body 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 faire pour ajouter une action personnalisée au panneau sensitif dans SharePoint Server