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

 

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

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

Résumé : Découvrez une option d’affichage des valeurs des propriétés managées personnalisées dans SharePoint Server.

Voici les titres des sections de cet article :

• Procédure d’affichage d’une icône personnalisée

• Procédure de recherche du nom d’une propriété gérée

• Procédure de modification d’un modèle d’affichage d’élément afin d’afficher des valeurs à partir de propriétés gérées personnalisées : option 1

• À propos du suivi de clics et de l’amélioration automatique de la pertinence

Procédure d’affichage d’une icône personnalisée

Dans l’article Comprendre le mode d’affichage des résultats de la recherche dans SharePoint Server, nous avons expliqué comment les icônes Word, PDF et Excel sont affichées pour chaque résultat de la recherche. Dans notre scénario de Centre de recherche, nous voulions ajouter l’icône personnalisée suivante en regard de tous les résultats de la recherche appartenant au type de résultat contenu TechNet nouvellement créé :

TN

Pour afficher une icône personnalisée pour des résultats de la recherche, procédez comme suit :

1. Ajouter l’icône personnalisée pour une bibliothèque de SharePoint Server.

   Dans notre scénario de Centre de recherche, nous avons ajouté l’icône personnalisée à la bibliothèque Images.

   

2. Ouvrez le modèle d’affichage d’élément référencé à partir du type de résultat pour lequel vous souhaitez afficher une icône personnalisée.

   Dans notre scénario de Centre de recherche, nous avons également supprimé l’instruction IF : if (ctx.CurrentItem.IsContainer).

   

3. Dans une page de recherche, entrez une requête qui déclenchera le nouveau type de résultat.

4. Dans notre scénario de Centre de recherche, nous avons saisi « type de résultat ». Une icône personnalisée est désormais affichée en regard des résultats de la recherche qui correspondent à des publications TechNet.

   

Ainsi, les utilisateurs de notre Centre de recherche peuvent désormais facilement repérer les résultats de la recherche publiés sur le site TechNet. Nous voulions également ajouter des informations à partir de colonnes de site personnalisées afin que les utilisateurs puissent voir des informations importantes sur chaque résultat de la recherche sans avoir à cliquer dessus.

Dans l’article Comprendre le mode d’affichage des résultats de la recherche dans SharePoint Server, vous avez appris que les colonnes de site sont « transformées » en propriétés gérées lors de l’analyse. Vous avez également appris que seules les propriétés gérées répertoriées dans un modèle d’affichage d’élément peuvent être affichées dans les résultats de la recherche. Ainsi, vous devez ajouter des propriétés gérées à un modèle d’affichage d’élément afin d’afficher des informations personnalisées dans les résultats de votre recherche. Par conséquent, la prochaine étape consiste à trouver le nom de la propriété gérée correspondant à la colonne de site personnalisée à utiliser.

Procédure de recherche du nom d’une propriété gérée

Avant de commencer à rechercher un nom de propriété gérée, il est important que vous en sachiez un peu plus sur la convention d’affectation de noms pour les propriétés gérées. Pour plus d’informations à ce sujet, voir À propos de la convention d’affectation de noms pour les propriétés analysées et gérées créées automatiquement.

En fonction de votre niveau d’autorisation, vous pouvez rechercher des propriétés gérées à partir de trois emplacements :

Niveau d’autorisation	Recherche à partir de cet emplacement
Administrateur de l’application Service de recherche	Administration centrale --> Application de service administré --> Application Service de recherche --> Schéma de recherche
Administrateur de collections de sites	Paramètres du site --> Schéma de recherche (dans la section Administration de la collection de sites)
Propriétaire de collection de sites	Paramètres du site --> Schéma (dans la section Recherche)

Voici les étapes à suivre :

1. Accédez à Paramètres du site --> Schéma de recherche.

   

2. Dans la page Propriétés gérées, dans le champ Propriété gérée, saisissez le nom de la colonne de site pour laquelle vous souhaitez trouver le nom de la propriété gérée. Souvenez-vous que les noms de propriété gérée ne contiennent pas d’espaces. Par conséquent, si le nom de votre colonne de site contient un espace, supprimez-le.

   Dans notre scénario de Centre de recherche, nous voulions trouver le nom de propriété gérée pour la colonne de site Résumé du contenu. Nous avons saisi RésuméContenu dans le champ Propriété gérée et cliqué sur l’icône de la flèche verte.

   

   Un résultat de la recherche a été renvoyé : ContentSummaryOWSMTXT.

   

   Étant donné que la colonne de site Résumé du contenu est de type Plusieurs lignes de texte, nous savions qu’il s’agissait du nom de la propriété gérée que nous voulions utiliser.

3. Répétez les étapes de cette procédure pour trouver les noms de toutes les propriétés gérées à afficher dans les résultats de la recherche.

À présent que vous avez trouvé les noms des propriétés gérées à afficher dans les résultats de la recherche, l’étape suivante consiste à modifier le modèle d’affichage d’élément.

Procédure de modification d’un modèle d’affichage d’élément afin d’afficher des valeurs à partir de propriétés gérées personnalisées : option 1

Dans l’article Comprendre le mode d’affichage des résultats de la recherche dans SharePoint Server, vous avez appris qu’il existe plusieurs façons de modifier un modèle d’affichage d’élément dans le but d’afficher des valeurs de propriétés gérées personnalisées. L’option expliquée dans cette section est très simple. La deuxième option sera décrite dans le prochain article de cette série. Elle ne comprend aucune instruction IF et la mise en surbrillance n’est pas appliquée.

Voici les étapes à suivre :

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

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

   

3. À l’intérieur de la deuxième balise <div> de <body>, utilisez la syntaxe suivante pour ajouter du code qui affichera la valeur de la propriété gérée personnalisée :

   _#= ctx.CurrentItem.<Current item property name> =#
   

   Dans notre scénario de Centre de recherche, nous avons ajouté les éléments suivants au modèle d’affichage d’élément :

   <div>_#= ctx.CurrentItem. ContentSummaryOWSMTXT =#_</div>
   <div>_#= ctx.CurrentItem. owstaxIdTechnicalSubject =#></div>
   

   

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

5. 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. Notez qu’une alerte Synchronisation des propriétés est affichée.

   

   Cette alerte est affichée, car nous avons ajouté des propriétés gérées à un modèle d’affichage d’élément (action effectuée à l’étape 2). Pour mettre à jour les types de résultats avec les propriétés gérées nouvellement ajoutées, cliquez sur Mettre à jour.

   

   Important

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

   Une fois cette modification effectuée, lors de la saisie d’une requête dans notre Centre de recherche, les valeurs de ContentSummaryOWSMTXT et de owstaxIdTechnicalSubject sont affichées dans les résultats de la recherche.

   

   Même si deux propriétés personnalisées sont désormais affichées dans les résultats de la recherche, le résultat n’est pas tout à fait correct. Par exemple, nous voulions afficher les deux propriétés personnalisées entre le titre et le lien, et non en dessous du lien comme c’est actuellement le cas.

Pour mieux comprendre les raisons pour lesquelles les résultats de la recherche sont affichés de cette façon, regardons de plus près le modèle d’affichage d’élément personnalisé :

1. ctx.CurrentItem.csr_Icon pointe vers l’emplacement de l’icône personnalisée. Cette variable est utilisée par le modèle d’affichage Item_CommonItem_Body.

2. _#=ctx.RenderBody(ctx)=#_ appelle le modèle d’affichage Item_CommonItem_Body. (Souvenez-vous de l’article Comprendre comment l’élément Afficher les modèles et positionnement mise en évidence de travail dans SharePoint Server. Le modèle d’affichage Item_CommonItem_Body affiche l’icône personnalisée, le titre et le lien vers l’élément.)

3. _#= ctx.CurrentItem.ContentSummaryOWSMTXT =#_ et _#= ctx.CurrentItem.owstaxIdTechnicalSubject =#_ affichent les valeurs des deux propriétés gérées, ContentSummaryOWSMTXT et owstaxIdTechnicalSubject.

Pour afficher les propriétés personnalisées entre le titre et le lien, vous pouvez ignorer le modèle d’affichage Item_CommonItem_Body en supprimant la référence _#=ctx.RenderBody(ctx)=#_ de votre modèle d’affichage personnalisé. Vous pouvez ensuite ajouter les propriétés dans l’ordre dans lequel vous voulez qu’elles soient affichées, par exemple :

Le résultat de la recherche ressemblera à ceci :

En travaillant un peu plus sur le style, vous pourriez obtenir un assez bon résultat. Mais, en raison de la suppression de la référence à _#=ctx.RenderBody(ctx)=#_, le modèle d’affichage Item_CommonItem_Body n’est plus utilisé pour afficher les résultats. Ce modèle d’affichage (Item_CommonItem_Body) contient certaines fonctionnalités qui permettent d’améliorer automatiquement la pertinence des résultats de la recherche. Par conséquent, avant de supprimer la référence _#=ctx.RenderBody(ctx)=#_, vous devez vous demander si l’amélioration automatique de la pertinence peut être un avantage pour les utilisateurs de votre site de recherche.

À propos du suivi de clics et de l’amélioration automatique de la pertinence

Le modèle d’affichage Item_CommonItem_Body contient une méthode onclick qui suit les tendances de clics des utilisateurs. Ce suivi influe sur la pertinence des résultats de la recherche. Par exemple, un résultat sur lequel les utilisateurs cliquent souvent sera automatiquement affiché plus haut dans les résultats de la recherche.

Important

Si vous voulez que les résultats de la recherche bénéficient de l’amélioration automatique de la pertinence en fonction des tendances de clics des utilisateurs, ne supprimez pas la référence à #=ctx.RenderBody(ctx)=# du modèle d’affichage de l’élément.

Dans le prochain article, nous allons vous expliquer comment conserver cette référence, afficher des propriétés personnalisées entre le titre et le lien dans les résultats de la recherche, et appliquer la mise en surbrillance à vos propriétés personnalisées.

Article suivant de cette série

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