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

 

**Sapplique à :**SharePoint Server 2013, SharePoint Server 2016

**Dernière rubrique modifiée :**2017-07-24

Résumé : Découvrez une deuxième option d’affichage des valeurs des propriétés managées personnalisées 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 - option 1 de SharePoint Server, nous avons présenté une méthode simple pour ajouter une icône et des valeurs personnalisées à vos résultats de la recherche à partir de deux propriétés gérées personnalisées. Dans cette rubrique, nous allons expliquer une méthode un peu plus approfondie permettant de modifier l’affichage des résultats de la recherche en y incluant des instructions IF et en mettant les résultats en surbrillance. Voici les titres des sections de cet article :

• Stratégie visant à faire d’une pierre deux coups - Version des résultats de la recherche

• Procédure d’affichage des valeurs de propriétés gérées personnalisées avec mise en surbrillance des résultats et d’améliration automatique de la pertinence

Stratégie visant à faire d’une pierre deux coups - Version des résultats de la recherche

Tout d’abord, passons en revue nos objectifs :

• Afficher les valeurs de deux propriétés gérées personnalisées.

• Appliquer la mise en surbrillance des résultats de la recherche aux deux propriétés gérées personnalisées.

• Améliorer automatiquement la pertinence des résultats de la recherche.

Avant d’aborder en détail la réalisation de ces objectifs, nous allons évoquer la stratégie que nous voulons suivre. Si elle devient trop complexe, ne vous laissez pas déconcerter. Généralement, les choses s’éclaircissent avant la fin.

Premièrement, rappelons le mode de fonctionnement de la mise en surbrillance des résultats :

1. Les propriétés gérées qui sont répertoriées dans la section Propriétés correspondantes (JSON) du composant WebPart Résultats de la recherche et la propriété « résumé magique » sont transmises à la propriété HitHighlightedProperties.

2. Toutes les valeurs de la propriété HitHighlightedProperties sont transmises à la propriété HitHighlightedSummary.

3. Une version tronquée des valeurs figurant dans HitHighlightedSummary est affichée dans le composant WebPart Résultats de la recherche suivie de points de suspension.

Gardez également à l’esprit que chaque modèle d’affichage d’élément contient une référence au modèle d’affichage Item_CommonItem_Body et que ce modèle contient une méthode OnClick qui se traduira par une amélioration automatique de la pertinence en fonction des choix de clic de l’utilisateur final.

Par conséquent, notre stratégie est la suivante : créer des variables dans le modèle d’affichage d’élément qui seront transmises par le modèle d’affichage Item_CommonItem_Body et affichées par celui-ci.

Plus précisément, cela signifie que nous devons effectuer les opérations suivantes :

• Ajouter les propriétés gérées personnalisées que nous voulons afficher dans nos résultats de la recherche pour les Propriétés correspondantes dans le composant WebPart Résultats de la recherche.

• Ajouter les propriétés gérées personnalisées à un modèle d’affichage d’élément.

• Dans le modèle d’affichage d’élément, créer une variable qui sera utilisée par la propriété HitHighlightedSummary pour afficher nos deux propriétés gérées personnalisées avec mise en surbrillance des résultats.

• Dans le modèle d’affichage d’élément, laisser la référence _#=ctx.RenderBody(ctx)=#_ de sorte que le modèle d’affichage Item_ComonItem_Body affiche les résultats de la recherche. Nous nous assurons ainsi que la pertinence est automatiquement améliorée.

À présent, nous allons procéder étape par étape, avec des exemples sur la façon dont nous avons appliqué cette procédure à notre scénario de Centre de recherche.

Procédure d’affichage des valeurs de propriétés gérées personnalisées avec mise en surbrillance des résultats et d’amélioration automatique de la pertinence

Tout d’abord, vous devez trouver les noms de propriétés gérées qui correspondent aux colonnes de site personnalisées que vous souhaitez utiliser. Nous avons vu cette procédure dans 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.

Ensuite, vous devez configurer le composant WebPart Résultats de la recherche, voici la procédure à suivre :

1. Sur la page des résultats de la recherche, sélectionnez le menu Paramètres, puis sélectionnez Modifier la page.

2. Dans le composant WebPart Résultats de la recherche, sélectionnez Menu du composant WebPart --> Modifier le composant WebPart.

3. Dans le volet des outils du composant WebPart, développez la section Modèle d’affichage, puis sélectionnez Utiliser un seul modèle pour afficher les éléments. Vous pourrez ainsi modifier le champ Propriétés correspondantes (JSON).

   

4. Dans le champ Propriétés correspondantes (JSON), utilisez le format suivant pour ajouter les propriétés gérées personnalisées pour lesquelles vous souhaitez appliquer la mise en surbrillance des résultats :

   « <nom de la propriété géré> »

   Dans notre scénario de Centre de recherche, nous avons voulu appliquer la mise en surbrillance des résultats aux propriétés gérées ContentSummaryOWSMTXT et owstaxIdTechnicalSubject.

   

5. Sélectionnez Appliquer pour enregistrer les modifications. Cette action entraîne la fermeture de la section Modèle d’affichage.

6. Sélectionnez Modèle d’affichage pour rouvrir la section et sélectionnez Utiliser les types de résultats pour afficher les éléments.

   

7. Cliquez sur OK et enregistrez la page.

   Vous devez ensuite ajouter les propriétés gérées personnalisées à un modèle d’affichage d’élément. Voici la marche à suivre :

8. Ouvrez le modèle d’affichage d’élément appartenant au type de résultat pour lequel vous souhaitez personnaliser les résultats de la recherche.

   Dans notre scénario de Centre de recherche, il s’agissait de Contenu TechNet.

9. 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 voulions que les valeurs des propriétés gérées ContentSummaryOWSMTXT et owstaxIdTechnicalSubject soient affichées dans les résultats de la recherche. Pour rendre le fichier plus facile à entretenir, nous avons nommé les propriétés de l’élément actuel de la même façon que les propriétés gérées.

   

   Ensuite, vous devez créer des variables dans le modèle d’affichage d’élément afin qu’elles soient utilisées et affichées par le modèle d’affichage Item_Common_Item_Body. Voici la marche à suivre :

10. Étant donné que vous n’avez aucune garantie que les valeurs de vos propriétés personnalisées contiendront l’un des mots de la requête saisie, et donc que les résultats seront mis en surbrillance, vous devez créer des variables qui garantissent que la valeur de vos propriétés personnalisées s’affichera indépendamment de la mise en surbrillance.

    Les captures d’écran suivantes montrent comment nous avons créé deux de ces variables pour nos propriétés personnalisées, ContentSummaryOWSMTXT et owstaxIdTechnicalSubject.

    

11. En outre, nous avons ajouté une variable similaire pour la propriété Title. Si vous ne l’ajoutez pas, les résultats de la recherche ne seront pas affichés.

    

12. La dernière étape que vous avez à effectuer dans le modèle d’affichage d’élément consiste à créer une variable qui remplacera la propriété HitHighlightedSummary utilisée pour afficher les valeurs.

    

13. Enregistrez le modèle d’affichage d’élément.

14. Notes

    Vous n’êtes pas obligé d’effectuer cette étape si vous utilisez SharePoint Online. Accéder aux paramètres de Site >--> les Types de résultats de recherche. Notez qu’une alerte de Propriété Sync s’affiche.

    

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

    

    Important

    Si vous ne procédez pas à cette mise à jour, les propriétés gérées nouvellement ajoutées ne s’afficheront pas dans les résultats de la recherche.

Une fois ces changements effectués, lorsque les utilisateurs saisissent une requête dans le Centre de recherche, le résultat de la recherche inclut :

1. Une icône personnalisée

2. La valeur de la propriété Title avec mise en surbrillance des résultats

3. La valeur de la propriété ContentSummaryOWSMTXT avec mise en surbrillance des résultats

4. La valeur de la propriété owstaxIdTechnicalSubject. (Les mots de la requête ne correspondent pas à la valeur de la propriété, mais grâce à la variable que nous avons créée à l’étape 10, la valeur est affichée.)

5. Un lien vers l’élément de la liste

Nous voulions modifier légèrement l’affichage de la valeur de la propriété owstaxIdTechnicalSubject. Nous voulions donner aux utilisateurs un peu plus de contexte sur la signification de cette valeur. Par conséquent, nous avons décidé d’ajouter le texte « Objet technique : » avant la valeur. En outre, étant donné que cette valeur n’est pas toujours présente pour tous les éléments de la liste, nous avons décidé qu’elle ne devrait s’afficher que lorsqu’une valeur était présente.

Pour ce faire, nous avons modifié la variable qui remplace la propriété HitHighlightedSummary :

Notez que nous avons ajouté une couleur légèrement différente au texte « Objet technique : ». Suite à cet ajout, le résultat de la recherche final est affiché comme suit :

Dans Comment faire pour créer un nouveau type de résultat de SharePoint Server, nous avions décidé que nous voulions 6 types de résultats différents. Une fois le type de résultat Contenu TechNet et le modèle d’affichage créés, il fut très facile de copier ce travail sur les 5 autres types de résultat.

Et voici le résultat :

Maintenant que nous avons changé le mode d’affichage des résultats de la recherche, l’étape suivante consiste à modifier les valeurs affichées dans le panneau de pointage.

Article suivant de cette série

Comment faire pour afficher les valeurs des propriétés managées personnalisées dans le panneau sensitif dans SharePoint Server