Comment faire pour créer un nouveau type de résultat de SharePoint Server
**Sapplique à :**SharePoint Server 2013, SharePoint Server 2016
**Dernière rubrique modifiée :**2017-07-24
Résumé : Apprenez à créer un nouveau type de résultat de SharePoint Server.
Voici les titres des sections de cet article :
À propos de l’exemple du Centre de recherche dans cette série
Procédure de copie d’un modèle d’affichage d’élément par défaut
Procédure de création d’un type de résultat
À propos de l’exemple du Centre de recherche dans cette série
Pour vous aider à comprendre comment personnaliser l’apparence des résultats affichés, nous allons utiliser des exemples à partir d’un outil utilisé par les éditeurs de contenu au quotidien : une liste interne des publications de Microsoft.
Comme vous le savez, Microsoft publie des milliers d’articles sur TechNet, MSDN et Office.com. Pour simplifier le processus de publication, nous utilisons plusieurs listes SharePoint. Chaque élément contenu dans une liste représente un article ou un fichier multimédia. Pour faciliter la recherche d’informations sur un élément de liste en particulier, nous avons créé un Centre de recherche qui effectue des recherches dans ces listes.
Dans notre première version du Centre de recherche, tous les résultats de la recherche étaient affichés de façon identique, car, par défaut, tous les éléments de la liste appartenaient au même type de résultat d’élément de liste SharePoint. Nous voulions modifier cet aspect pour différencier en un seul coup d’œil dans les résultats de la recherche les articles publiés sur TechNet et les articles publiés sur MSDN. Nous voulions également ajouter des informations importantes concernant chaque résultat de la recherche et faire en sorte que celles-ci soient visibles sans avoir à sélectionner le résultat et à l’ouvrir.
Avant de nous l’avons fait dans SharePoint Server, nous s’est entretenu pour une session de planification. La première tâche est de décider comment nous voulions classer les résultats de la recherche. Nous avons élaboré les catégories suivantes :
| Catégorie | Définition |
|---|---|
Contenu TechNet |
Articles publiés sur la plateforme TechNet |
Contenu MSDN |
Articles publiés sur la plateforme MSDN |
Contenu Office.com |
Articles publiés sur la plateforme Office.com |
Contenu d’images |
Images utilisées dans les publications |
Contenu vidéo |
Vidéos utilisées dans les publications |
Contenu de téléchargement |
Contenu téléchargeable |
Après avoir défini ces catégories, nous devions les distinguer les unes des autres. Les éléments de notre liste contiennent une colonne de site nommée Canal de distribution. Elle contient la valeur de la plateforme sur laquelle un article est publié ; par exemple Bibliothèque TechNet.
.png "Item Distribution Channel")
Nous avons décidé d’utiliser les valeurs de la colonne de site Canal de distribution pour distinguer les catégories entre elles.
Une fois ces décisions prises, nous avons décidé de créer de nouveaux types de résultats pour chaque catégorie. La procédure de création d’un nouveau type de résultat est identique pour toutes les catégories. Ainsi, pour gagner de la place, nous nous concentrerons uniquement sur le processus de création du type de résultat Contenu TechNet.
Procédure de copie d’un modèle d’affichage d’élément par défaut
Avant de créer un nouveau type de résultat, vous devez créer un modèle d’affichage d’élément qui sera utilisé par votre nouveau type de résultat. Pour éviter d’avoir à créer intégralement un modèle d’affichage d’élément, vous pouvez copier un modèle existant. Essayez de copier un modèle d’affichage d’élément qui soit le plus proche possible de votre type de contenu. Voici la procédure à suivre :
Copier un modèle d’affichage d’élément par défaut.
Dans notre scénario, nous voulions personnaliser les résultats de la recherche pour les éléments de liste SharePoint. À partir de la table de référence figurant à la section À propos des types de résultats, nous pouvons déterminer que le modèle d’affichage d’élément par défaut utilisé par le type de résultat Élément de liste SharePoint correspond au fichier nommé Item_Default. Étant donné que nous avons déjà mappé un lecteur réseau, nous pouvions facilement copier le fichier Item_Default dans l’Explorateur Windows.
.png "Copy Item Default")
En actualisant l’Explorateur Windows, nous avons vu que SharePoint Server a créé automatiquement un fichier JavaScript associé.
.png "Java Script Item Default Version")
Renommez le modèle d’affichage de l’élément nouvellement créé.
Dans notre scénario, nous l’avons renommé Contenu TechNet . Encore une fois, nous avons actualisé l’Explorateur Windows pour vérifier que le fichier JavaScript avait été mis à jour en conséquence.
.png "Tech Net Content Files")
Ouvrir le nouveau modèle d’afficher et de modifier la balise < title >. N’oubliez pas que le texte de cette balise est ce qui s’affiche lorsque vous effectuez des configurations dans l’interface utilisateur SharePoint Server.
Dans notre scénario, nous avons remplacé le contenu de la balise <title> par Contenu TechNet.
.png "Tech Net Title Tag")
Enregistrez le nouveau modèle d’affichage d’élément.
À présent que nous avons créé un modèle d’affichage d’élément, nous pouvons passer à la création d’un type de résultat.
Procédure de création d’un type de résultat
En fonction de votre niveau d’autorisation, vous créez un type de résultat sur deux niveaux :
| Niveau d’autorisation | Emplacement où le type de résultat sera ajouté |
|---|---|
Administrateur de collections de sites |
Tous les sites d’une collection de sites |
Propriétaire de collection de sites |
Un seul site |
Pour économiser de l’espace, nous nous contenterons d’aborder la création d’un type de résultat en tant qu’administrateur de collection de sites.
Accédez à Paramètres du site --> Types de résultats de recherche.
.png "Search Result Types")
Au lieu de créer intégralement un type de résultat, nous pouvons faciliter le processus en copiant un type de résultat existant et en le modifiant pour l’adapter à notre nouveau type de résultat. Dans ce cas, nous devons veiller à copier un type de résultat qui ressemble étroitement au type de résultat que nous voulons créer.
Sur la page Gérer les types de résultats, dans le champ de menu de type de résultat, sélectionnez Copier.
Dans notre scénario, nous avons voulu personnaliser les résultats de la recherche pour les éléments de liste SharePoint. Par conséquent, nous avons copié le type de résultat Élément de liste SharePoint.
.png "Copy Share Point List Item")
Sur la page Ajouter un type de résultat, voici les étapes à suivre :
Dans le champ Tapez un nom, saisissez le nom du nouveau type de résultat.
Dans notre scénario, nous avons saisi Contenu TechNet.
Dans le menu À quelle source les résultats doivent-ils correspondre ?, sélectionnez l’origine des résultats que nous avons utilisée pour configurer la requête dans notre composant WebPart Résultat de la recherche.
Dans le menu Quels types de contenus doivent correspondre ? Vous pouvez ignorer cette règle pour rechercher tout le contenu, tous les types de résultats par défaut sont répertoriés.
Dans notre scénario, nous avons choisi Sélectionner une valeur.
Cliquez sur Afficher plus de conditions.
.png "Show More Conditions")
Cette action ouvre un menu vous permettant de spécifier le type de résultat en fonction des valeurs de propriété gérée.
Dans notre scénario, tous les éléments de liste contiennent une colonne de site intitulée Canal de distribution. Comme nous l’avons vu au début, cette colonne de site contient la valeur de la plateforme de publication, par exemple Bibliothèque TechNet . Nous avons utilisé des valeurs de cette colonne de site pour spécifier les éléments de la liste devant appartenir à notre nouveau type de résultat.
Dans le menu Quelles propriétés personnalisées doivent correspondre ?, nous avons choisi DistributionChannelOWSCHCS. DistributionChannelOWSCHCS est la propriété gérée qui représente la colonne de site Canal de distribution. Dans les champs ci-dessous, nous avons saisi toutes les valeurs devant spécifier le nouveau type de résultat Contenu TechNet.
.png "Add Properties")
Dans le menu À quoi doivent ressembler ces résultats ?, sélectionnez le modèle d’affichage devant être utilisé par ce type de résultat.
Dans notre scénario, nous avons sélectionné le modèle d’affichage nouvellement créé :Contenu TechNet.
.png "Apply Tech Net Display Template")
Cliquez sur Enregistrer.
Le type de résultat nouvellement créé est maintenant répertorié sur la page Gérer les types de résultats.
Dans notre scénario, nous pouvions voir que le type de résultat Contenu TechNet avait été créé.
.png "Tech Net Created")
Nous disposons à présent d’un nouveau type de résultat et la tâche suivante consiste à modifier le modèle d’affichage associé à ce type de résultat. Il existe plusieurs façons de faire. Par conséquent, dans les deux articles suivants de cette série, nous allons vous expliquer deux options différentes.