Rechercher des solutions pour SharePoint

La recherche dans SharePoint combine la facilité de configuration et de déploiement avec la scalabilité et l’extensibilité de FAST Search Server sur une seule plateforme de recherche d’entreprise.

SharePoint inclut des modèles courants dans la plateforme de recherche pour vous aider à personnaliser la recherche pour différents scénarios. Par exemple :

• La recherche de vidéos et la recherche de conversation sont incluses en tant que verticales de recherche prêtes à l’emploi.
• Les pages de rubrique et Content-by-Search améliorent les fonctionnalités et les scénarios de gestion de contenu web, tels que les sites pilotés par la recherche et les sites de gestion des connaissances.
• Mes tâches regroupent les tâches de projet afin que les utilisateurs puissent suivre les tâches attribuées dans plusieurs sites dans un emplacement central : leur site OneDrive Entreprise.

Architecture de recherche SharePoint

L’architecture de recherche dans SharePoint comprend des composants et des bases de données qui fonctionnent ensemble.

Composants de recherche dans SharePoint

Composant	Description
Analyse	Analyse les sources de contenu pour collecter les propriétés et les métadonnées et envoie ces informations au composant de traitement du contenu.
Traitement de contenu	Transforme les éléments analysés et les envoie au composant d'index. Ce composant mappe également les propriétés analysées sur les propriétés gérées.
Traitement de l’analyse	Exécute l'analyse de la recherche et l'analyse de l'utilisation.
Index	Reçoit les éléments traités du composant de traitement de contenu et les écrit dans l'index de recherche. En outre, ce composant gère les requêtes entrantes, récupère les informations de l’index de recherche et renvoie le jeu de résultats au composant de traitement des requêtes.
Traitement des requêtes	Analyse les requêtes entrantes. Cela permet d’optimiser la précision, le rappel et la pertinence. Les requêtes sont envoyées au composant d'index, qui renvoie un jeu de résultats de recherche pour la requête.
Administration de la recherche	Exécute les processus système pour la recherche, puis ajoute et initialise de nouvelles instances des composants de recherche.

Rechercher des bases de données dans SharePoint

Database	Description
Analyse	Stocke les informations de suivi et d'historique concernant les éléments analysés tels que les documents et les URL. Il stocke également des informations telles que l’heure de la dernière analyse, l’ID de la dernière analyse et le type de mise à jour (ajout, mise à jour, suppression) lors de la dernière analyse.
Liens	Stocke les informations non traitées qui sont extraites par le composant de traitement de contenu et les informations sur les clics de recherche. Le composant de traitement d'analyse examine ces informations.
Rapports d’analyse	Stocke les résultats de l'analyse de l'utilisation.
Administration de la recherche	Stocke les données de configuration de recherche.

Traitement de l’analyse et du contenu

Le processus d’analyse commence par les différentes sources de contenu (par exemple, HTTP, partages de fichiers et SharePoint). Pour ajouter du contenu à l’index, le robot utilise des connecteurs qui indiquent au robot comment se connecter à la source de contenu et accéder aux éléments de contenu dans la source. Une fois que le robot a trouvé les éléments de contenu, il utilise un gestionnaire de format applicable pour analyser le contenu.

Après avoir récupéré le contenu, le composant d’analyse transmet les éléments analysés au composant de traitement du contenu, qui traite les éléments et les envoie au composant d’index. Cela inclut l’analyse de documents, le mappage des propriétés analysées à leurs propriétés managées associées et le traitement linguistique, comme la détection de langue et l’extraction d’entités. Le composant de traitement de contenu écrit également des informations concernant les liens et les URL dans la base de données de liens.

Traitement des requêtes

Le composant de traitement des requêtes analyse et traite les requêtes de recherche pour optimiser la précision, le rappel et la pertinence, y compris l’exécution d’un traitement linguistique tel que la rupture de mot et la recherche de résultats. La requête traitée est ensuite envoyée au composant d’index, qui retourne un jeu de résultats basé sur la requête traitée au composant de traitement de requête, qui traite à son tour ce jeu de résultats.

Analyse de la recherche

SharePoint analyse à la fois le contenu lui-même (analyse de la recherche) et la façon dont les utilisateurs interagissent avec celui-ci (analyse de l’utilisation), et utilise ces informations pour améliorer la recherche.

L'analyse de la recherche consiste à extraire des informations, telles que des liens, le nombre de fois où les utilisateurs cliquent sur un élément, le texte d'ancrage, les données relatives aux personnes et les métadonnées, provenant de la base de données de liens. L’analytique de recherche constitue la base de la détermination de la pertinence.

En revanche, l’analyse de l’utilisation consiste à analyser les informations du journal d’utilisation reçues du front-end via le magasin d’événements. L’analytique de l’utilisation constitue la base des rapports d’utilisation et de statistiques.

Les résultats des analyses sont ajoutés aux éléments dans l'index de recherche. En outre, les résultats de l'analyse de l'utilisation sont stockés dans la base de données de création de rapports d'analyse.

Blocs de construction pour personnaliser l’expérience de recherche

La recherche dans SharePoint et SharePoint Online inclut de nouvelles fonctionnalités et des améliorations qui vous permettent de personnaliser l’expérience de recherche. La plupart des améliorations ne nécessitent pas l’écriture de code. La recherche SharePoint inclut des API CSOM et REST pour vous aider lorsque vous avez besoin d’écrire du code pour votre personnalisation, ou si vous souhaitez créer des compléments pour accéder aux résultats de recherche SharePoint en dehors de SharePoint.

Les nouvelles fonctionnalités et améliorations sont les suivantes :

• Site du Centre de recherche
• Composants WebPart centre de recherche
• Origines des résultats
• Règles de requête
• Transformations de requête
• Types de résultats et modèles d’affichage

Site du Centre de recherche

Le Centre de recherche est un site SharePoint configuré pour la recherche. Il s’agit d’un portail dans lequel vous pouvez rechercher du contenu sur l’intranet de votre organization, et il fournit une interface utilisateur centralisée et hautement personnalisable. Cette section décrit les pages et les composants WebPart du Centre de recherche, ainsi que les paramètres de configuration de recherche que vous pouvez modifier pour créer des applications de recherche personnalisées ou des expériences de recherche sans écrire beaucoup de code.

Lorsque vous créez un site Centre de recherche, SharePoint crée une page d’accueil de recherche par défaut et une page de résultats de recherche par défaut. Par ailleurs, plusieurs pages appelées secteurs verticaux de recherche sont également créées. Les secteurs verticaux de recherche sont des pages de résultats de recherche personnalisées pour rechercher des types de contenu spécifiques, tels que Personnes et Vidéos, et qui affichent des résultats de recherche filtrés et mis en forme pour un type de contenu ou une classe spécifique.

Les pages suivantes sont créées dans une collection de sites du Centre de recherche, dans la bibliothèque Pages :

• default.aspx : page d’accueil du Centre de recherche et page dans laquelle les utilisateurs finaux entrent leurs requêtes.
• results.aspx : page de résultats de recherche par défaut du Centre de recherche. Elle représente également la page de résultats de recherche du secteur vertical de recherche Tout.
• peopleresults.aspx : page des résultats de la recherche pour le Personnes vertical de recherche.
• conversationresults.aspx : page des résultats de la recherche pour le vertical de recherche Conversations .
• videoresults.aspx : page des résultats de la recherche pour la recherche de vidéos verticale.
• advanced.aspx : page de recherche dans laquelle les utilisateurs finaux peuvent appliquer des restrictions à leurs expressions de recherche, par exemple, en limitant la recherche à une expression exacte.

Toutes les pages verticales de recherche contiennent le composant WebPart Résultats de la recherche, bien que le composant WebPart soit configuré différemment pour chaque vertical de recherche. Pour chacun d’eux, la requête dans le composant WebPart Résultats de la recherche est dirigée vers une source de résultats spécifique, applicable à ce vertical de recherche. Par exemple, la requête dans le composant WebPart Résultats de la recherche sur la page peopleresults.aspx est limitée à la source de résultats local Personnes Résultats. Comprendre comment les secteurs verticaux de recherche par défaut dans SharePoint sont configurés peut vous aider à créer votre propre vertical de recherche ou à personnaliser le Centre de recherche.

Voici des ressources supplémentaires pour vous aider à travailler avec le Centre de recherche :

• Configurer un centre de recherche de SharePoint Server
• Comment créer une collection de sites du Centre de recherche et activer l’analyse de votre contenu dans SharePoint Server
• Créer un site Centre de recherche dans SharePoint Server
• Gérer le Centre de recherche dans SharePoint Server
• Gérer le Centre de recherche dans SharePoint Online

Composants WebPart centre de recherche

Les pages du Centre de recherche contiennent quatre types de composants WebPart : Zone de recherche, Résultats de la recherche, Navigation de recherche et Affinement.

Composant WebPart Zone de recherche

Le composant WebPart Zone de recherche affiche une zone de texte dans laquelle les utilisateurs entrent du texte dans lequel effectuer une recherche. Par défaut, le composant WebPart Zone de recherche est utilisé sur la page d’accueil du Centre de recherche (default.aspx), ainsi que sur toutes les pages de résultats de recherche par défaut (results.aspx, peopleresults.aspx, conversationresults.aspx et videoresults.aspx).

Vous pouvez personnaliser le composant WebPart Zone de recherche en modifiant les propriétés dans le volet d’outils du composant WebPart. Vous pouvez ainsi effectuer les opérations suivantes :

• Modifier l’emplacement d’affichage des résultats de la recherche. Par exemple, vous pouvez afficher les résultats dans un composant WebPart Résultats de la recherche personnalisé ou sur une page de résultats de recherche personnalisée.
• Désactiver les suggestions de requête et les suggestions de personne.
• Afficher des liens vers une page de préférences de recherche et une page de recherche avancée.
• Modifiez le modèle d’affichage du composant WebPart.

Pour plus d’informations, consultez l’article suivant :

• Configurer les propriétés du composant WebPart Zone de recherche dans SharePoint Server
• Comment modifier le texte affiché dans le composant WebPart Zone de recherche dans SharePoint Server

Composant WebPart Résultats de la recherche

Le composant WebPart Résultats de la recherche affiche les résultats d’une requête de recherche. Par défaut, le composant WebPart Résultats de la recherche est utilisé sur toutes les pages verticales de recherche par défaut (results.aspx, peopleresults.aspx, conversationresults.aspx et videoresults.aspx). Le composant WebPart Résultats de la recherche envoie également les résultats de la recherche au composant WebPart Affinement et au composant WebPart Navigation dans la recherche. Il doit donc y avoir un composant WebPart Résultats de la recherche sur une page de résultats de recherche pour que les autres composants WebPart de recherche fonctionnent.

Vous pouvez modifier les propriétés du composant WebPart Résultats de la recherche dans le volet d’outils du composant WebPart pour modifier la requête de recherche, ainsi que pour modifier le comportement et l’apparence des résultats sur la page des résultats de la recherche.

En modifiant les valeurs de propriété, vous pouvez effectuer les opérations suivantes :

• Modifiez la source des résultats pour spécifier le contenu à rechercher.
• Ajoutez des variables de requête ou des filtres de propriétés pour personnaliser les résultats de la recherche pour différents utilisateurs ou groupes d’utilisateurs.
• promouvoir ou rétrograder des éléments ou des pages dans les résultats de recherche ;
• modifier le tri des résultats de recherche ;
• modifier le modèle d’affichage.

Pour plus d’informations sur les composants WebPart Résultats de la recherche, consultez :

• Configurer les propriétés du composant WebPart Résultats de la recherche dans SharePoint Server
• Comment configurer le composant WebPart Résultats de la recherche pour utiliser une nouvelle source de résultats dans SharePoint Server

Composant WebPart Navigation de recherche

Le composant WebPart Navigation de recherche affiche des liens qui permettent aux utilisateurs de se déplacer rapidement entre les différents secteurs verticaux de recherche (Tout, Personnes, Conversations et Vidéos). Le composant WebPart Navigation dans la recherche utilise les résultats de recherche du composant WebPart Résultats de la recherche afin que lorsque les utilisateurs choisissent un lien vertical de recherche, les résultats de la recherche sont filtrés et affichés en fonction de la façon dont la verticale de recherche est configurée.

En modifiant les propriétés du composant WebPart Navigation dans le volet d’outils du composant WebPart, vous pouvez personnaliser le composant WebPart comme suit :

• Spécifiez un autre composant WebPart à partir duquel obtenir les résultats.
• Modifiez le nombre de liens verticaux de recherche à afficher.
• Modifier l’apparence et la disposition du composant WebPart.

En outre, dans le ruban, vous pouvez sélectionner Paramètres> du siteParamètres de recherche paramètres pour apporter les modifications suivantes :

• Modifiez les noms d’affichage des liens.
• Modifier l’ordre des liens.

Composant WebPart d’affinement

Le composant WebPart Affinement filtre les résultats de la recherche en catégories appelées affinements. Les utilisateurs peuvent choisir ces affinements pour affiner les résultats de la recherche. Les affinements sont des propriétés managées marquées comme Refinable et Queryable. Pour plus d’informations sur ces paramètres, voir vue d’ensemble des paramètres de propriété managée dans Vue d’ensemble du schéma de recherche dans SharePoint Server.

Vous pouvez modifier les propriétés du composant WebPart Affinement dans le volet d’outils du composant WebPart pour spécifier les éléments suivants :

• Composant WebPart Résultats de la recherche à partir duquel filtrer les résultats de la recherche.
• Affinements à utiliser dans le composant WebPart Affinement.
• Modèle d’affichage appliqué à chaque affinement.
• L’apparence, la disposition et le comportement du composant WebPart Affinement.

Par défaut, le composant WebPart Affinement n’affiche pas le nombre de résultats pour chaque valeur d’affinement. Vous pouvez ajouter des nombres d’affinements en modifiant le modèle d’affichage de l’affinement.

Pour plus d’informations sur cette fonctionnalité, voir Configurer les propriétés du composant WebPart Affinement dans SharePoint Server.

Pour plus d’informations sur le composant WebPart d’affinement et les affinements, consultez :

• Planifier l’utilisation d’affinements sur une page de résultats de recherche dans SharePoint Server
• Comment ajouter des affinements à votre page de résultats de recherche dans SharePoint Server

Origines des résultats

Les origines des résultats permettent de limiter les recherches à certains contenus ou à un sous-ensemble de résultats de recherche. Vous pouvez définir une source de résultats en spécifiant les éléments suivants :

• Un moteur de recherche ou une URL source à partir duquel obtenir les résultats de la recherche ; par exemple, l’index de recherche du service Search SharePoint local.
• Un protocole à utiliser pour obtenir les résultats de la recherche ; par exemple, le protocole OpenSearch .
• Une transformation de requête, qui peut limiter les résultats du fournisseur de recherche ou de l’URL donné à un sous-ensemble spécifique de résultats ; par exemple, à un ensemble de résultats qui a un type de contenu particulier.

SharePoint fournit seize sources de résultats préconfigurées, y compris les résultats SharePoint locaux, les conversations et les éléments liés à l’utilisateur actuel. Vous pouvez afficher des détails sur les sources de résultats à partir de la page Gérer les sources de résultats (Paramètres> du siteRechercher>des sources de résultats).

Dans la page Gérer les sources de résultats , vous pouvez créer de nouvelles sources de résultats de l’une des deux manières suivantes :

• Choisissez Nouvelle source de résultat , puis sélectionnez la source de résultats souhaitée. Pour plus d'informations, voir Configurer des origines de résultats pour la recherche dans SharePoint Server
• Pointez sur la flèche en regard d’une source de résultats existante, choisissez Copier, puis modifiez la copie si nécessaire et enregistrez-la sous un nouveau nom.

Une source de résultats spécifie l’un des quatre protocoles pour obtenir les résultats de la recherche. Si la source des résultats utilise un protocole autre que SharePoint local, la source du résultat doit également spécifier une URL à partir de laquelle obtenir les résultats de la recherche.

Protocoles sources de résultats et leurs fournisseurs

Protocole source des résultats	Fournisseur	URL
SharePoint local	Index de recherche du service Search local.	S/O
SharePoint distant	L’index de recherche d’un service Search hébergé dans une autre batterie de serveurs.	Adresse de la collection de sites racine de la batterie de serveurs SharePoint distante.
OpenSearch 1.0/1.1	Un moteur de recherche externe (tel qu’un moteur de recherche distant ou un flux) qui utilise le protocole OpenSearch pour fournir des résultats de recherche.	URL du flux RSS d’un moteur de recherche qui utilise le protocole OpenSearch.
Exchange	Services Web Exchange (EWS).	URL EWS.

Pour plus d'informations, consultez les articles suivants :

• Présentation des origines de résultats pour la recherche dans SharePoint Server
• À propos des origines des résultats et de la fédération
• Présentation des sources de résultats
• Gérer les origines des résultats

Règles de requête

Utilisez des règles de requête pour personnaliser l’expérience de recherche pour les requêtes qui sont particulièrement importantes pour vos utilisateurs. Dans une règle de requête, vous spécifiez le contexte, les conditions et les actions corrélées. Ensuite, dans le contexte spécifié, et lorsqu’une requête remplit les conditions spécifiées, la recherche effectue ses actions corrélées pour améliorer la pertinence des résultats de la recherche.

En ce qui concerne le contexte, vous pouvez restreindre les requêtes de règle de requête qui sont :

• Effectué sur une source de résultats spécifiée.
• À partir d’une catégorie de rubrique spécifiée.
• Effectué par un utilisateur correspondant à un segment d’utilisateur spécifié.

Le tableau suivant répertorie les conditions que vous pouvez spécifier qui entraînent l’exécution d’une règle de requête.

Conditions de règle de requête

Condition	Description
La requête correspond exactement au mot clé	Applique la règle de requête quand la requête correspond exactement à un mot ou à une expression que vous spécifiez.
La requête contient un terme d’action	Applique la règle de requête quand la requête contient un terme sous la forme d'un mot unique ou d'une expression traduisant l'intention de l'utilisateur d'effectuer une opération. Le terme doit figurer au début ou à la fin de la requête et peut être un verbe, une commande ou un filtre.
La requête correspond exactement au dictionnaire	Applique la règle de requête quand la requête correspond exactement à une entrée du dictionnaire. Cette entrée peut être un terme du magasin de termes ou une entrée du dictionnaire des noms de personne.
Requête plus fréquente dans la source	Applique la règle de requête si la requête de l'utilisateur est plus couramment exécutée sur une origine des résultats autre que l'origine des résultats actuelle. Cette condition s'appuie sur une analyse des requêtes entrées par les utilisateurs dans les différentes origines des résultats.
Type de résultat fréquemment sélectionné	Appliquez la règle de requête si la requête se termine souvent par le choix par les utilisateurs des résultats d’un type de résultat particulier. Lorsque vous créez un type de résultat, vous pouvez indiquer que ces sélections doivent être enregistrées pour être utilisées dans les règles de requête.
Correspondance de texte de la requête avancée	Applique la règle de requête si la requête correspond à une expression régulière. Il vous permet également d’utiliser des variantes de la mot clé, du terme d’action et des conditions de dictionnaire expliquées précédemment, mais avec un contrôle plus avancé.

Une règle de requête peut spécifier trois types d’actions :

• Ajoutez des résultats promus (anciennement appelés meilleurs résultats) qui apparaissent au-dessus des résultats classés. Par exemple, pour la requête congé de maladie, une règle de requête peut spécifier un résultat promu particulier, tel qu’un lien vers un site qui a une déclaration de stratégie de l’entreprise concernant le temps d’arrêt du travail.

• Ajoutez un ou plusieurs groupes de résultats, appelés blocs de résultats. Un bloc de résultats contient un petit sous-ensemble de résultats liés à une requête d’une manière particulière. Comme pour les résultats individuels, vous pouvez promouvoir un bloc de résultats ou le classer avec d’autres résultats de recherche.

• Modifiez le classement des résultats en modifiant la requête. Par exemple, pour une requête qui contient la boîte à outils de téléchargement, une règle de requête peut reconnaître le mot téléchargement comme un terme d’action et améliorer les résultats de recherche qui pointent vers un site de téléchargement particulier sur votre intranet.

Pour plus d’informations sur les règles de requête, voir Gérer les règles de requête dans SharePoint Server.

Transformations de requête

Pour fournir des résultats de recherche appropriés pour une requête utilisateur, la requête doit parfois être modifiée. Vous effectuez cette opération avec des transformations de requête. Les valeurs verticales de recherche par défaut incluses dans SharePoint, telles que les vidéos, les Personnes et les conversations, contiennent toutes des transformations de requête prédéfinies pour optimiser l’expérience de recherche pour ce vertical.

Vous pouvez configurer des transformations de requête à trois endroits :

• Dans un composant WebPart, tel qu’un composant WebPart Résultats de la recherche.
• Dans une règle de requête, qui spécifie que certaines actions sont effectuées uniquement si certaines conditions sont remplies.
• Dans la source des résultats que la requête utilise pour obtenir les résultats de la recherche.

Une requête utilisateur est transformée d’abord par le composant WebPart, puis par toutes les règles de requête qui s’appliquent et enfin par la source du résultat. Lorsque vous configurez une transformation dans une source de résultats, vous savez que les modifications de transformation ne seront pas ignorées ou remplacées, car la source de résultat transforme la requête en dernier. Vous pouvez réutiliser une transformation de requête source de résultats dans des composants WebPart ou des blocs de résultats, et vous pouvez créer des règles de requête ou des types de résultats qui sont appliqués uniquement aux résultats de certaines sources de résultats.

Vous pouvez utiliser le Générateur de requêtes pour vous aider à écrire et tester des transformations de requête. Vous pouvez tester la requête à partir du Générateur de requêtes en définissant des valeurs de test temporaires pour les variables de requête, en exécutant la requête et en affichant un aperçu des résultats de la recherche.

Pour plus d’informations sur les transformations de requête, voir Planifier la transformation des requêtes et classer les résultats dans SharePoint Server.

Types de résultats et modèles d’affichage

La recherche SharePoint inclut une nouvelle infrastructure de résultats qui facilite la personnalisation de la façon dont les résultats de la recherche sont affichés. Désormais, au lieu d’écrire des XSLT personnalisés pour modifier la façon dont les résultats de la recherche sont affichés, vous pouvez personnaliser l’apparence des types de résultats importants à l’aide de modèles d’affichage et de types de résultats.

Types de résultats

Pour afficher les résultats de la recherche différemment, ces derniers doivent avoir été triés selon des types de résultats différents. Un type de résultat est une classification d’un résultat de recherche qui distingue un résultat de recherche d’un autre. Il se compose d’une collection des éléments suivants :

• Règles : une ou plusieurs caractéristiques ou conditions à comparer à chaque résultat de recherche, telles que la source du résultat ou le type de contenu du résultat de recherche. Conditions de règle peuvent être liées à l'aide de l'égalité, de comparaison et d'opérateurs logiques.

• Propriétés : liste des propriétés gérées pour le résultat de la recherche. Vous devez ajouter des propriétés gérées à la liste des propriétés avant de mapper la propriété gérée à un modèle d’affichage.

• Modèles d’affichage : contrôle la façon dont tous les résultats qui répondent aux conditions s’affichent et se comportent sur une page de résultats de recherche.

La recherche SharePoint inclut plusieurs types de résultats par défaut. Pour les afficher, accédez à Paramètres> de site Collectionde sites Types de résultats de recherche d’administration>. Vous ne pouvez pas modifier les types de résultats par défaut. Vous pouvez créer des types de résultats en copiant ceux existants et en les modifiant.

Pour plus d’informations sur les types de résultats par défaut inclus dans SharePoint, voir Types de résultats et modèles d’affichage utilisés pour afficher les résultats de recherche dans SharePoint Server.

Modèles d’affichage

Les modèles d’affichage définissent la disposition visuelle et le comportement des résultats de recherche. Ils contrôlent les propriétés gérées qui sont affichées dans les résultats de recherche et leur apparence. SharePoint stocke les modèles d’affichage dans le sous-dossier Recherche du dossier Modèles d’affichage de la galerie de pages maîtres. Chaque modèle d'affichage se compose de deux fichiers :

• Version HTML du modèle d’affichage que vous pouvez modifier dans votre éditeur HTML.
• Fichier .js utilisé par SharePoint.

Lorsque vous utilisez des modèles d’affichage, vous modifiez le fichier HTML. Le fichier .js est créé et modifié par SharePoint. Vous ne modifiez pas ce fichier du tout.

Il existe deux types de modèles d'affichage principaux :

• Contrôler les modèles d’affichage : déterminez la structure globale de la façon dont les résultats sont présentés.
• Modèles d’affichage d’élément : déterminez la façon dont chaque résultat de l’ensemble est affiché.

Le modèle d'affichage de contrôle fournit du code HTML afin de structurer la disposition globale souhaitée pour présenter les résultats de recherche. Par exemple, le modèle d'affichage de contrôle peut fournir le code HTML pour un titre et le début ou la fin d'une liste. Le modèle d’affichage de contrôle n’est rendu qu’une seule fois dans le composant WebPart.

Le modèle d'affichage d'élément fournit du code HTML qui détermine l'affichage de chaque élément dans le jeu de résultats. Par exemple, le modèle d'affichage d'élément peut fournir le code HTML pour un élément de liste contenant une image et trois lignes de texte mappées sur des propriétés gérées différentes associées à l'élément. Le modèle d'affichage d'élément est rendu une fois pour chaque élément du jeu de résultats. Ainsi, si le jeu de résultats contient 10 éléments, le modèle d'affichage d'élément crée une section de code HTML dix fois.

Pour plus d’informations sur les modèles d’affichage et leur structure, consultez :

• Packages de conception du Gestionnaire de conception SharePoint
• Composants WebPart de recherche et modèles d’affichage

Pour plus d’informations sur les modèles d’affichage disponibles dans SharePoint, voir Afficher la référence de modèle dans SharePoint Server.

Personnaliser les modèles d’affichage

Si vous souhaitez personnaliser les modèles d’affichage inclus avec SharePoint, créez un modèle d’affichage en copiant le contenu de celui que vous souhaitez modifier, puis personnalisez la nouvelle version. Partir d’une copie d’un modèle d’affichage existant est également le moyen le plus simple d’en créer un, car il garantit que vous commencez avec tous les éléments requis.

Un autre conseil lors de l’utilisation de modèles d’affichage consiste à mapper un lecteur réseau à la galerie de pages maîtres. Pour plus d’informations, voir Mapper un lecteur réseau à la galerie de pages maîtres SharePoint.

Le fichier HTML utilisé pour un modèle d’affichage est un document HTML entièrement formé avec des head éléments et body . Dans l’élément head , il y a un title élément qui spécifie le nom d’affichage du modèle d’affichage. Le texte de cette balise est affiché lorsque vous effectuez des configurations dans l’interface utilisateur SharePoint . par exemple, lorsque vous configurez un type de résultat.

Après l’élément title , il existe un élément de propriétés de document personnalisé, mso:CustomDocumentProperties. Dans les modèles d’affichage d’élément, cet élément contient un mso:ManagedPropertyMapping élément, qui est l’endroit où les propriétés gérées utilisées par la recherche SharePoint sont mappées aux valeurs utilisées par le modèle d’affichage.

La syntaxe suivante est la suivante : <display template reference name>:<managed property name>, comme illustré dans l’exemple suivant.

<mso:ManagedPropertyMapping msdt:dt="string">'Title':'Title','Path':'Path','Description':'Description'

Dans l’élément body , il existe un script élément dans lequel vous pouvez inclure des ressources externes telles que des fichiers CSS ou des fichiers JavaScript en dehors du modèle d’affichage. Pour obtenir des exemples qui montrent comment inclure des ressources externes dans l’élément script, consultez la section Bloc de script dans les modèles d’affichage du Gestionnaire de conception SharePoint.

L’élément suivant est un div élément . C’est là que vous placez le code HTML ou le script souhaité dans le cadre du modèle d’affichage. Un bon moyen de se familiariser avec la structure du modèle d’affichage consiste à télécharger des copies des modèles d’affichage par défaut pour les résultats de recherche, Control_SearchResults.html (modèle d’affichage de contrôle) et Item_Default.html (modèle d’affichage d’élément).

Voici quelques ressources supplémentaires pour les modèles d’affichage et les types de résultats :

• Personnaliser les types de résultats de recherche dans SharePoint
• Comment faire pour modifier le mode d'affichent des résultats de la recherche dans SharePoint Server
• Présentation de l’affichage des résultats de la recherche dans SharePoint Server
• Comprendre comment les modèles d’affichage d’élément et la mise en surbrillance des correspondances fonctionnent dans SharePoint Server
• Comment créer un type de résultat dans SharePoint Server
• Comment afficher les valeurs des propriétés gérées personnalisées dans les résultats de recherche - option 1 dans SharePoint Server
• Comment afficher les valeurs des propriétés gérées personnalisées dans les résultats de recherche - option 2 dans SharePoint Server

Api de requête et compléments de recherche

La recherche SharePoint inclut des modèles objet client .NET et JavaScript, ainsi qu’un service REST qui permet d’accéder aux résultats de recherche pour le développement en ligne, local et mobile.

API de requête de recherche

API	Chemin d’accès à la bibliothèque de classes ou au schéma	Exemple
CSOM .NET	Microsoft.SharePoint.Client.Search.dll Kit de développement logiciel (SDK) des composants du client SharePoint Server 2013 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI SharePoint Online Client composants SDK %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\16\ISAPI	Recherche de requêtes avec le modèle objet client managé (galerie de code)
CSOM JavaScript	SP.search.js %ProgramFiles%\SharePoint Client Components\Scripts	Recherche de requêtes avec le modèle objet client JavaScript (galerie de code)
Service REST	http://server/_api/search/query http://server/_api/search/postquery http://server/_api/search/suggest	Utilisation du service REST de recherche à partir d’un complément SharePoint (galerie de codes)

Requête de recherche CSOM .NET

Pour utiliser la requête CSOM .NET, créez un instance de la classe T:Microsoft.SharePoint.Client.ClientContext, qui se trouve dans l’espace de noms Microsoft.SharePoint.Client dans le Microsoft.SharePoint.Client.dll. Utilisez ensuite le modèle objet de requête dans l’espace de noms Microsoft.SharePoint.Search.Client.Query .

Voici un exemple simple.

using Microsoft.SharePoint.Client; 
using Microsoft.SharePoint.Client.Search.Query;
…
using (ClientContext clientContext = new ClientContext("http://intranet.contoso.com"))
{
    KeywordQuery keywordQuery = new KeywordQuery(clientContext);
    keywordQuery.QueryText = "Argument";
    SearchExecutor searchExecutor = new SearchExecutor(clientContext);
    ClientResult<ResultTableCollection> results = searchExecutor.ExecuteQuery(keywordQuery);
    clientContext.ExecuteQuery();
}
 

Vous pouvez maintenant itérer dans les résultats de la recherche. L’exemple suivant écrit le titre de chaque résultat.

foreach (var row in results.Value[0].ResultRows) 
{ 
    Console.WriteLine(row["Title"]); 
}

Service REST de requête de recherche

Le service REST de requête de recherche prend en charge les requêtes HTTP POST et GET . Lorsque vous effectuez un appel au service REST de recherche, vous spécifiez les paramètres de requête avec la requête, et la recherche utilise ces paramètres de requête pour construire la requête de recherche. Avec une requête GET, vous indiquez les paramètres de requête dans l'URL. Pour les requêtes POST, vous transmettez les paramètres de requête au corps au format JavaScript Object Notation (JSON).

Requêtes JSON GET et POST

Verbe	URI
Requêtes GET	http://server/_api/search/query
Requêtes POST	http://server/_api/search/postquery

Exemples de requêtes GET pour le service REST de recherche

Type de demande	URL de la demande
Mots-clés	http://server/site/_api/search/query?querytext='{KQL Query}'
Sélection des propriétés	http://server/site/_api/search/query?querytext='test'&selectproperties='Title,Rank'
Tri	http://server/site/_api/search/query?querytext='test'&sortlist='LastModifiedTime:descending' http://server/site/_api/search/query?querytext='test'&sortlist='LastModifiedTime:descending,Rank:ascending'

Pour obtenir la liste complète des paramètres de requête disponibles et savoir comment les utiliser, voir Principes de base du flux de travail SharePoint.

Pour obtenir un exemple de code, voir Utilisation du service REST de recherche à partir d’un complément SharePoint.

Rechercher des compléments

Les compléments SharePoint (anciennement appelés applications pour SharePoint) sont des fonctionnalités autonomes qui étendent les fonctionnalités d’un site web SharePoint. Les compléments de recherche (anciennement appelés applications de recherche) sont des compléments SharePoint qui utilisent la fonctionnalité de recherche. Dans un complément de recherche, vous pouvez utiliser les API de requête de recherche pour récupérer les résultats de la recherche. En outre, vous pouvez également l’utiliser pour distribuer des configurations de recherche d’une installation SharePoint à une autre.

Pour plus d’informations sur la configuration d’un environnement de développement pour créer des compléments de recherche, voir Configurer un environnement de développement local pour les compléments SharePoint ou Configurer un environnement de développement pour les compléments SharePoint sur Office 365.

Autorisations

Les compléments de recherche nécessitent uniquement des autorisations au niveau de l’utilisateur, où la valeur d’attribut est QueryAsUserIgnoreAppPrincipal. Cette autorisation vous permet d’interroger les compléments de recherche en fonction des autorisations de l’utilisateur. Cela signifie que les résultats de la recherche sont retournés en fonction des listes de contrôle d’accès de l’utilisateur. Pour accorder des autorisations aux compléments pour utiliser la recherche :

1. Dans Explorateur de solutions, ouvrez AppManifest.xml.

2. Sous l’onglet Autorisations , sélectionnez Rechercher l’étendue, puis queryAsUserIgnoreAppPrincipal.

Pour en savoir plus, consultez l’article Autorisations des compléments dans SharePoint.

API de requête

Vous pouvez utiliser le modèle CSOM .NET, le modèle CSOM JavaScript ou le service REST de recherche pour récupérer les résultats de recherche dans un complément de recherche. L’exemple suivant montre comment utiliser la requête .NET CSOM pour récupérer les résultats de recherche dans un complément de recherche.

var spContext = SharePointContextProvider.Current.GetSharePointContext(Context);
using (var clientContext = spContext.CreateUserClientContextForSPHost())
{
    KeywordQuery keywordQuery = new KeywordQuery(clientContext);
    keywordQuery.QueryText = "Argument";
    SearchExecutor searchExecutor = new SearchExecutor(clientContext);
    ClientResult<ResultTableCollection> results = searchExecutor.ExecuteQuery(keywordQuery);
    clientContext.ExecuteQuery();
}

Voir aussi

• Personnalisations de recherche pour SharePoint
• Compléments
• Rechercher des compléments SharePoint
• Ajouter des fonctionnalités de recherche à vos compléments SharePoint
• Développement Office 365 et recommandations de solutions de PnP SharePoint