Solutions de recherche pour SharePoint

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

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

  • La recherche vidéo et la recherche de conversation sont incluses en tant que secteurs verticaux de recherche pré-intégrés.
  • Les pages de rubrique et contenu par recherche améliorent les fonctionnalités et les scénarios de gestion de contenu web, tels que les sites de recherche et les sites de gestion des connaissances.
  • Mes tâches rassemblent les tâches de projet afin que les utilisateurs peuvent effectuer le suivi des tâches affectées à plusieurs sites dans un emplacement central : leur site OneDrive Entreprise site.

SharePoint architecture de recherche

L’architecture de recherche 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 de 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 (ajouter, mettre à jour, supprimer) au cours 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 que le contenu soit ajouté à 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 au sein de la source. Une fois que le robot a trouvé les éléments de contenu, il utilise un handler de format applicable pour analyser le contenu.

Après avoir récupération du contenu, le composant d’analyse transmet les éléments analyse au composant de traitement de 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 analyser à leurs propriétés gérées associées et le traitement linguistique, tel que 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 le traitement linguistique tel que la cinglisation et la recherche de la recherche de texte. La requête traitée est ensuite envoyée au composant d’index, qui renvoie un jeu de résultats basé sur la requête traitée au composant de traitement des requêtes, qui à son tour traite 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’analyse de la 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 système frontal via le magasin d’événements. L’analyse 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 la personnalisation de l’expérience de recherche

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

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

  • Site Centre de recherche
  • Composants Web Parts du 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 Centre de recherche

Le Centre de recherche est un site SharePoint pour la recherche. Il s’agit d’un portail dans lequel vous pouvez rechercher du contenu sur l’intranet de votre organisation et qui fournit une interface utilisateur centralisée et hautement personnalisable. Cette section décrit les pages et les composants Web Parts 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 des personnes et des vidéos, et ils affichent des résultats de recherche qui sont filtrés et formatés pour un type de contenu ou une classe spécifique.

Les pages suivantes sont créées dans une collection de sites centre de recherche, dans la bibliothèque de 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 pour le Centre de recherche. Elle représente également la page de résultats de recherche du secteur vertical de recherche Tout.
  • peopleresults.aspx La page des résultats de recherche – pour le secteur vertical de recherche de personnes.
  • conversationresults.aspx Page de résultats de recherche pour le – secteur vertical de recherche Conversations.
  • videoresults.aspx La page des résultats de recherche – pour le secteur vertical de recherche vidéos.
  • 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 de secteur vertical de recherche contiennent le volet Web Des résultats de la recherche, bien que ce dernier soit configuré différemment pour chaque secteur vertical de recherche. Pour chacun d’eux, la requête dans le volet Web Des résultats de la recherche est dirigée vers une origine des résultats spécifique, applicable à ce secteur vertical de recherche. Par exemple, la requête dans le partie Web Des résultats de la recherche sur la page peopleresults.aspx est limitée à l’origine des résultats Résultats locaux des personnes. Comprendre comment les secteurs verticaux de recherche par SharePoint sont configurés peut vous aider à créer votre propre secteur vertical de recherche ou à personnaliser le Centre de recherche.

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

Composants Web Parts du Centre de recherche

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

Partie Web De zone de recherche

Le volet Web Zone de recherche affiche une zone de texte dans laquelle les utilisateurs entrent du texte sur lequel effectuer la recherche. Par défaut, le volet Web 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 volet d’outils de la zone de recherche en éditant les propriétés. Vous pouvez ainsi effectuer les opérations suivantes :

  • Modifier l’endroit où les résultats de la recherche sont affichés. Par exemple, vous pouvez afficher les résultats dans un élément Web De résultats de 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 les liens vers une page de préférence de recherche et une page de recherche avancée.
  • Modifiez le modèle d’affichage pour le partie Web.

Pour plus d’informations, voir :

Partie Web De résultats de la recherche

Le volet Web Résultats de la recherche affiche les résultats d’une requête de recherche. Par défaut, le volet Web Des résultats de la recherche est utilisé sur toutes les pages de secteur vertical de recherche par défaut (results.aspx, peopleresults.aspx, conversationresults.aspx et videoresults.aspx). Le composant Web Part Résultats de la recherche envoie également les résultats de la recherche au composant Web Part d’affinement et au composant Web Part Navigation par recherche, de sorte qu’il doit y avoir un composant Web Part Résultats de la recherche sur une page de résultats de recherche pour que les autres composants Web Parts de recherche fonctionnent.

Vous pouvez modifier les propriétés du volet d’outils des résultats de la recherche dans le volet d’outils des résultats de la recherche 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 des propriétés, vous pouvez :

  • Modifiez l’origine 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 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 Web Parts de résultats de recherche, voir :

Partie Web De navigation par recherche

Le volet Web Navigation par recherche affiche des liens qui permet aux utilisateurs de se déplacer rapidement entre les différents secteurs verticaux de recherche (Tout, Personnes, Conversations et Vidéos). Le partie Web De navigation par recherche utilise les résultats de recherche du partie Web De résultats de recherche de sorte 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 le secteur vertical de recherche est installé.

En éditant les propriétés du volet d’outils du volet d’outils de navigation par recherche, vous pouvez personnaliser le volet Web De la manière suivante :

  • Spécifiez un autre élément Web Part à partir duquel obtenir les résultats.
  • Modifier le nombre de liens verticaux de recherche à afficher.
  • Modifiez l’apparence et la mise en page du site Web.

En outre, sur le ruban, vous pouvez sélectionner site Paramètres > recherche Paramètres pour apporter les modifications suivantes :

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

Partie Web De perfectionnement

Le volet Web Perfectionnement 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 gérées marquées comme utilisables dans une recherche dans une recherche et utilisables dans une requête. Pour plus d’informations sur ces paramètres, voir la vue d’ensemble des paramètres de propriété gérée dans Vue d’ensembledu schéma de recherche dans SharePoint Server.

Vous pouvez modifier les propriétés du site Web Part Refinement dans le volet d’outils du volet de l’outil de ce dernier pour spécifier les valeurs suivantes :

  • À partir duquel filtrer les résultats de la recherche.
  • Affinements à utiliser dans le volet Web Perfectionnement.
  • Modèle d’affichage appliqué à chaque affinement.
  • Apparence, disposition et comportement du volet Web Perfectionnement.

Par défaut, le volet Web Perfectionnement n’affiche pas le nombre de résultats pour chaque valeur d’affinement. Vous pouvez ajouter le nombre d’affinements en modifiant le modèle d’affichage de l’affinement.

Pour plus d’informations sur cette fonctionnalité, voir Configure properties of the Refinement web part in SharePoint Server.

Pour plus d’informations sur le volet Web Perfectionnement et les affinements, voir :

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 origine des résultats en spécifiant les données suivantes :

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

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

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

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

Protocoles d’origine des résultats et leurs fournisseurs

Protocole d’origine des résultats Fournisseur URL
SharePoint local Index de recherche du service de recherche local. N/A
SharePoint distant Index de recherche d’un service de recherche 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 fournisseur 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 recherche.
Exchange Exchange Services Web (EWS). URL EWS.

Pour plus d'informations, consultez les articles suivants :

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 répond aux 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 origine des 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 pour qu’une règle de requête s’exécute.

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 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 des conditions de mot clé, de terme d’action et 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 le congé maladie de la requête, 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 d’entreprise concernant les congés.

  • 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 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 téléchargement du mot 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 le faites avec des transformations de requête. Les secteurs verticaux de recherche par défaut inclus dans SharePoint, tels que vidéos, personnes et conversations, contiennent des transformations de requête prédéfinie pour optimiser l’expérience de recherche pour ce secteur vertical.

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

  • Dans un élément Web Part, tel qu’un élément Web Part 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 l’origine des résultats que la requête utilise pour obtenir les résultats de la recherche.

Une requête utilisateur est d’abord transformée par le partie Web, puis par toutes les règles de requête qui s’appliquent, puis par l’origine des résultats. Lorsque vous configurez une transformation dans une origine des résultats, vous savez que les modifications de transformation ne seront pas ignorées ou ignorées, car l’origine des résultats transforme la requête en dernier. Vous pouvez réutiliser une transformation de requête d’origine des résultats dans des composants Web Parts 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 origines des 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 fixant des valeurs de test temporaires pour les variables de requête, en exécutant la requête et en prévisualisation des résultats de la recherche.

Pour plus d’informations sur les transformations de requête, voir Plan to transform queries and order results in SharePoint Server.

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

SharePoint recherche inclut une nouvelle infrastructure de résultats qui facilite la personnalisation de l’affichage des résultats de la recherche. À présent, au lieu d’écrire une XSLT personnalisée pour modifier l’affichage des résultats de recherche, vous pouvez personnaliser l’apparence des types importants de résultats à 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 données suivantes :

  • Règles – Une ou plusieurs caractéristiques ou conditions à comparer à chaque résultat de recherche, telles que l’origine des résultats 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 la maser à un modèle d’affichage.

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

SharePoint recherche inclut plusieurs types de résultats par défaut. Pour les voir, rendez-vous sur Site Paramètres Site Collection Administration > Search Result > Types. Vous ne pouvez modifier aucun des types de résultats par défaut. Vous pouvez créer de nouveaux types de résultats en copiant des types de résultats 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èlesd’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 la recherche. Ils contrôlent les propriétés gérées affichées dans les résultats de la recherche et leur apparition. 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 qui SharePoint utilisé.

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

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

  • Modèles d’affichage de contrôle – Déterminez la structure globale de la présentation des résultats.
  • Modèles d’affichage d’élément – Déterminez comment chaque résultat de l’ensemble s’affiche.

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 affiché 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, voir :

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

Personnaliser les modèles d’affichage

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

Une autre astuce lorsque vous travaillez avec des modèles d’affichage consiste à maîtr un lecteur réseau à la galerie de pages maîtres. Pour plus d’informations, voir Ma cartographier un lecteur réseau sur la SharePoint de pages maîtres.

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

Après title l’élément, 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 é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 mso:ManagedPropertyMapping 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, il existe un élément dans lequel vous pouvez inclure des ressources externes telles que des fichiers CSS ou des fichiers JavaScript en body script dehors du modèle d’affichage. Pour obtenir des exemples qui montrent comment inclure des ressources externes dans l’élément de script, voir la section Bloc de script dans SharePoint modèlesd’affichage du gestionnaire de conception.

L’élément suivant est un div élément. C’est là que vous placez le code HTML ou le script que vous souhaitez dans le cadre du modèle d’affichage. Un bon moyen de vous 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, controlSearchResults.html (le modèle d’affichage de contrôle) et ItemDefault.html (le modèle d’affichage _ _ d’élément).

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

Interroger des API et des modules de recherche

SharePoint recherche inclut des modèles objet client .NET et JavaScript et 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 Bibliothèque de classes ou chemin d’accès 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ête avec le modèle objet client géré (galerie de codes)
CSOM JavaScript SP.search.js
%ProgramFiles%\SharePoint Client Components\Scripts
Recherche de requête 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’SharePoint de recherche (galerie de code)

Requête de recherche CSOM .NET

Pour utiliser le modèle CSOM .NET de requête, créez une instance de T:Microsoft.SharePoint. Classe Client.ClientContext, qui se trouve dans microsoft.SharePoint. Espace de noms client dans le Microsoft.SharePoint.Client.dll. Utilisez ensuite le modèle objet de requête dans Microsoft.SharePoint. Espace de noms 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 appelez le service REST de recherche, vous spécifiez des 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 GET et POST JSON

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 leur utilisation, voir SharePoint de base du flux de travail.

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

Rechercher des compléments

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

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

Autorisations

Les add-ins 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 modules de recherche en fonction des autorisations de l’utilisateur. Cela signifie que les résultats de la recherche sont renvoyés en fonction des ACA de l’utilisateur. Pour accorder des autorisations aux modules de recherche :

  1. Dans l’Explorateur de solutions, ouvrezAppManifest.xml.

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

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

API de requête

Vous pouvez utiliser le CSOM .NET, le CSOM JavaScript ou le service REST de recherche pour récupérer les résultats de recherche dans un module de recherche. L’exemple suivant montre comment utiliser le modèle CSOM .NET de requête pour récupérer les résultats de recherche dans un module 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