Comment afficher les valeurs des propriétés gérées personnalisées dans les résultats de recherche classiques - Option 2 dans SharePoint Server

S’APPLIQUE À :  yes-img-13 2013  yes-img-16 2016  yes-img-19 2019  yes-img-se Subscription Edition  no-img-sop 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 1 dans SharePoint Server, nous avons montré une méthode simple pour ajouter une icône personnalisée et des valeurs de deux propriétés gérées personnalisées à vos résultats de recherche classiques. Dans cette rubrique, nous allons examiner une méthode un peu plus complète pour modifier l’affichage des résultats de recherche classiques, y compris les instructions if et la mise en surbrillance des résultats. Voici les titres des sections de cet article :

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

Tout d’abord, nous allons dire ce que nous voulons obtenir :

  • 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.

  • Obtenir automatiquement une pertinence améliorée pour nos résultats de recherche classiques.

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 :

Organigramme de mise en surbrillance des éléments correspondants

  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 dans HitHighlightedSummary apparaît dans le volet Web Des résultats de la recherche avec trois points à la fin.

N’oubliez pas également 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 onlick qui améliorera automatiquement la pertinence en fonction du comportement de clic de l’utilisateur.

Référence d'élément courant

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 :

  • Ajoutez les propriétés gérées personnalisées que nous voulons afficher dans nos résultats de recherche classiques aux propriétés mises en surbrillantes dans le volet Web Des 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, laissez la référence de sorte que le Item_ComonItem_Body _#=ctx.RenderBody(ctx)=#_ affichera le résultat de la recherche. Nous nous assurons ainsi que la pertinence est automatiquement améliorée.

Maintenant, nous allons le faire étape par étape, avec des exemples de la façon dont nous l’avons fait pour 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 comment faire dans Comment afficher des valeurs à partir de propriétés gérées personnalisées dans les résultats de recherche - option 1 dans SharePoint Server.

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

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

  2. Dans le volet Web Des résultats de la recherche, sélectionnez Le menu Modifier le site > Web.

  3. Dans le volet d’outils du service Web, sélectionnez pour développer la section Modèles d’affichage, puis sélectionnez Utiliser un seul modèle pour afficher les éléments. Cela vous permet de modifier le champ JSON (Hit-highlighted Properties).

    Utiliser un modèle Sicourir

  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 :

    "<Managed property name>"

    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.

    Propriétés en surbrillantes ajoutées

  5. Sélectionnez Appliquer pour enregistrer les modifications. Fermeture de la section Modèles d’affichage.

  6. Pour rouvrir la section, sélectionnez Modèles d’affichage, puis utilisez les types de résultats pour afficher les éléments.

    Développer la section Modèles d’affichage

  7. Sélectionnez 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 les étapes à 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 apparaissent dans le résultat de 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.

Ajouter des MP

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 :

  1. É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.

    Deux variables

  2. 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 rendus.

    Variable de titre

  3. La dernière étape à suivre 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.

    Variable récapitulatif

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

    Notes

    Vous n’avez pas à faire 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.

    Alerte de synchronisation de propriété

    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, choisissez Mettre à jour.

    MPs mis à 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 :

Détails des résultats de la recherche

  • Une icône personnalisée

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

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

  • La valeur de owstaxIdTechnicalSubject (les mots de la requête ne correspondent pas à la valeur de la propriété, mais en raison de la variable que nous avons créée à l’étape 10, la valeur apparaît.)

  • Un lien vers l’élément de la liste

Nous voulions apporter une petite modification à l’apparition de la valeur pour 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 :

Variable récapitulatif final

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

Résultat final de la recherche

Dans La création d’un typede résultat dans SharePoint Server, nous avions décidé que nous voulions 6 types de résultats différents. Après avoir créé le type de résultat de contenu TechNet et le modèle d’affichage, il était très facile de copier ce travail sur les 5 autres types de résultats.

Et voici le résultat :

Page des résultats de la recherche finale

Maintenant que nous avons modifié l’affichage des résultats de recherche classiques, l’étape suivante consiste à modifier les valeurs affichées dans le panneau de pointer.

Article suivant de cette série

Comment afficher les valeurs des propriétés gérées personnalisées dans le panneau de pointer dans SharePoint Server