Share via

Nouveautés pour les développeurs dans la recherche SharePoint

  • Article

Découvrez les nouvelles fonctionnalités disponibles pour les développeurs dans La recherche dans SharePoint.

Modèle objet de client de recherche pour l'accès pour interroger les fonctionnalités du modèle objet pour en ligne, local et développement mobile

Recherche SharePoint inclut un modèle objet client (CSOM) qui permet d’accéder à la plupart des fonctionnalités de modèle objet de requête pour le développement en ligne, local et mobile. Vous pouvez utiliser le modèle CSOM de recherche pour créer des applications clientes qui s’exécutent sur un ordinateur sur lequel SharePoint n’est pas installé pour renvoyer les résultats de la recherche SharePoint.

Le modèle CSOM de recherche inclut un modèle objet client managé Microsoft .NET Framework et un modèle objet JavaScript, et il est basé sur SharePoint. Tout d'abord, code client accède à la SharePoint CSOM. Ensuite, code client accède à la CSOM de recherche.

Pour utiliser le modèle CSOM managé .NET Framework de recherche, vous devez obtenir une instance ClientContext (située dans l’espace de noms Microsoft.SharePoint.Client dans le Microsoft.SharePoint.Client.dll). Ensuite, utilisez le modèle objet dans l'espace de noms Microsoft.SharePoint.Client.Search.Query le Microsoft.Office.Server.Search.Client.dll. Pour plus d'informations sur la CSOM SharePoint, voir Modèle objet client managé. Pour plus d'informations sur l'objet ClientContext, qui est le point d'entrée à la CSOM, voir Contexte de client en tant qu'objet central.

CSOM de la recherche retourne les données de résultats de recherche à partir du serveur dans la Notation JSON (JavaScript Object). Le json des données des résultats de la recherche contient une collection ResultTableCollection composée d’objets ResultTable qui représentent différents jeux de résultats.

Support de la syntaxe SQL supprimé

Les solutions de recherche personnalisées dans SharePoint ne prennent pas en charge la syntaxe SQL. La recherche dans SharePoint prend en charge la syntaxe FQL et la syntaxe KQL pour les solutions de recherche personnalisées. Vous ne pouvez pas utiliser la syntaxe SQL dans les solutions de recherche personnalisée en utilisant des technologies, y compris le modèle objet serveur de requête, le modèle objet client et le service de recherche REST. Les solutions de recherche personnalisées qui utilisent la syntaxe SQL avec le modèle objet du serveur de requête et le service web Query créés dans les versions antérieures de SharePoint Server ne fonctionnent pas lorsque vous les mettez à niveau vers SharePoint. Requêtes envoyés par le biais de ces applications renverra une erreur. Pour plus d’informations sur l’utilisation de la syntaxe FQL et de la syntaxe KQL, consultez Informations de référence sur la syntaxe KQL (Keyword Query Language) et Informations de référence sur la syntaxe du langage de requête FAST (FQL.md).

Service REST de recherche pour l'exécution à distance des requêtes à partir des applications clientes

SharePoint inclut un service REST (Representational State Transfer) qui vous permet d’exécuter à distance des requêtes sur le service Search SharePoint à partir d’applications clientes à l’aide de n’importe quelle technologie prenant en charge les requêtes web REST. Le service de recherche REST expose les deux systèmes d'extrémité, query et suggestet prendront en charge les opérations GET et POST. Les résultats sont renvoyés au format XML ou JSON.

Voici le point d’accès pour le service : http://server/_api/search/. Vous pouvez également spécifier le site dans l’URL, comme suit : http://server/site/_api/search/. Le service de recherche renvoie les résultats de l'intégralité de la collection de sites, les mêmes résultats sont donc renvoyés pour les deux méthodes d'accès au service.

Vous pouvez également utiliser l’URL qui fait référence à client.svc pour accéder au service, comme suit : http://server/_vti_bin/client.svc/search/. Toutefois, l’utilisation de _api est préférée.

Pour accéder aux métadonnées du service, utilisez le point d'accès suivants :

http://server/_api/$metadata

Pour obtenir des informations générales sur le service REST dans SharePoint, voir Utiliser les opérations de requête OData dans les requêtes REST SharePoint.

Service web de requête de recherche de SharePoint est obsolète.

Le service web Query (situé dans le chemin d’accès http://server/site/_vti_bin/search.asmx) est déconseillé dans SharePoint. Si vous écrivez de nouvelles applications, évitez d'utiliser cette fonctionnalité désapprouvée et au lieu de cela utiliser le nouveau service de requête CSOM ou reste de la requête. Si vous modifiez des applications existantes, nous vous encourage fortement permet de supprimer toute dépendance vis-à-vis de cette fonctionnalité.

Améliorations du modèle objet requête de recherche SharePoint

Propriétés de la requête fournissent des informations sur une requête de recherche. Dans la recherche SharePoint, un conteneur de propriétés a été ajouté aux classes de requête et de résultats pour activer les propriétés de requête définies par l’utilisateur. Vous pouvez accéder à des propriétés de requête existante via la propriété sur un des classes de requête, comme suit :

KeywordQuery.EnableStemming

Ou vous pouvez utiliser le conteneur de propriétés, comme suit :

KeywordQuery.Properties["EnableStemming"]

Vous pouvez accéder à des propriétés personnalisées uniquement à l'aide du conteneur des propriétés, comme suit :

KeywordQuery.Properties["UserDefinedProperty"]

La recherche SharePoint inclut des propriétés de requête dans le conteneur de propriétés, y compris de nouvelles propriétés de requête telles que :

  • BypassResultTypes Spécifie si le type d'élément de résultat de recherche est retourné pour les résultats de requête. Spécifiez true pour ne retourner aucun type de résultat ; dans le cas contraire, false.

  • EnableInterleaving Spécifie si les jeux de résultats générés par l'exécution des actions de règle requête pour ajouter un bloc de résultat sont mélangés avec le jeu de résultats de la requête d'origine. Spécifiez true pour combiner du résultat généré avec le jeu de résultats d'origine ; dans le cas contraire, false.

  • EnableQueryRules Spécifie si les règles de requête sont activés pour cette requête. Spécifiez true afin d'activer les règles de requête pour la requête ; dans le cas contraire, false.

Vous pouvez spécifier une propriété dans le conteneur de propriétés, y compris les propriétés définies par l'utilisateur, en tant que les conditions de règle requête. Vous utilisez des règles de requête pour personnaliser l'expérience de recherche pour les types de requêtes qui sont importants à vos utilisateurs. Lorsqu'une requête répond aux conditions spécifiées dans une règle de requête, la règle spécifie actions afin d'améliorer la pertinence des résultats de la recherche associée.

Améliorations de langue de requête de mot clé

SharePoint inclut des améliorations du langage de requête de mot clé, qui sont décrites dans cette section.

Amélioration de la proximité opérateur

SharePoint Server 2010, l'opérateur NEAR implicite une distance maximum d'émission de jeton de 8 et préservé l'ordre des jetons d'entrée. Dans SharePoint, l’opérateur NEAR ne conserve plus l’ordre des jetons. Désormais, l’opérateur NEAR reçoit un paramètre facultatif qui indique la distance maximale du jeton. Toutefois, la valeur par défaut est toujours 8. Si vous devez utiliser le comportement précédent, utilisez ONEAR.

L'opérateur NEAR peut être utilisé dans les expressions de restriction de propriété, comme illustré dans l'exemple suivant :

"acquisition" NEAR "debt"

Cette requête correspond aux éléments dont les jetons « acquisition » et « passif » apparaissent dans le même document, avec une distance maximum d'émission de jeton de 8 (qui est la valeur par défaut n si aucune valeur ne n'est fourni). L'ordre des jetons n'est pas important pour la correspondance.

Si vous avez besoin d'une distance d'émission de jeton plus petite, vous pouvez spécifier il comme suit :

"acquisition" NEAR(n=3) "debt"

Cette requête correspond aux éléments dont les deux jetons « acquisition » et « passif » apparaît dans le même document, avec une valeur maximale d'émission de jeton de 3. L'ordre des jetons n'est pas important pour la correspondance.

Nouvel opérateur ONEAR

L'opérateur ONEAR fournit une fonctionnalité triée près. Il reçoit un paramètre facultatif qui indique le nombre maximal d'émission de jeton distance ; la valeur par défaut est 8.

L'opérateur ONEAR conserve l'ordre des expressions d'entrée. Pour désordonnés proximité, utilisez NEAR.

Vous pouvez utiliser l'opérateur de téléphonie ONEAR dans les expressions de restriction de propriété, comme illustré dans l'exemple suivant :

"acquisition" ONEAR "debt"

Cette requête correspond aux éléments dont les deux jetons « acquisition » et « passif » apparaît dans le même document, avec une distance maximum d'émission de jeton de 8 (qui est la valeur par défaut n si aucune valeur ne n'est fourni). L'ordre des jetons doit correspondre à un élément à renvoyer.

Si vous avez besoin d'une distance d'émission de jeton plus petite, vous pouvez spécifier il comme suit :

"acquisition" ONEAR(n=3) "debt"

Cette requête correspond aux éléments dont les deux jetons « acquisition » et « passif » apparaît dans le même document, avec une valeur maximale d'émission de jeton de 3. L'ordre des jetons doit correspondre à un élément à renvoyer.

Nouvel opérateur XRANK

Dans SharePoint Server 2010, l'opérateur XRANK était disponible uniquement avec le langage FAST Query language (FQL). SharePoint introduit un nouvel opérateur XRANK puissant.

L'opérateur XRANK fournit le contrôle du classement dynamique. Cet opérateur augmente le classement dynamique des éléments en fonction de l'occurrence de certains termes sans modifier les éléments qui correspondent à la requête.

Cadre pour la personnalisation des résultats de la recherche l'interface utilisateur des résultats riches

Recherche SharePoint inclut une nouvelle infrastructure de résultats qui facilite la personnalisation de l’apparence (apparence) de l’interface utilisateur (IU) des résultats de recherche. À présent, au lieu d'écrire une transformation XSLT personnalisée pour changer l'affichent des résultats de la recherche, vous pouvez personnaliser l'apparence des types importants des résultats à l'aide de modèles d'affichage et les types de résultats.

Modèles d’affichage

Modèles d'affichage définissent la disposition visuelle et le comportement d'un type de résultat à l'aide HTML, CSS et JavaScript. Vous pouvez personnaliser les modèles d'affichage existants ou créer des modèles d'affichage à l'aide d'un élément HTML éditeur et les télécharger dans la Galerie de modèles complet.

Types de résultats

Types de résultats définissent comment afficher un ensemble de résultats de la recherche basée sur une collection des options suivantes :

  • Règles Déterminer le moment auquel appliquer un type de résultat, selon les conditions spécifiées. Conditions de règle peuvent être liées à l'aide de l'égalité, de comparaison et d'opérateurs logiques.

  • Propriétés Détermination de la liste des propriétés gérées pour le résultat. Vous devez ajouter des propriétés gérées à la liste avant de vous mappez la propriété gérée à un modèle d'affichage.

  • Modèles d'affichage Définir la disposition visuelle du type de résultat.

Les administrateurs peuvent créer et gérer les types de résultats au niveau du site ou au niveau application de service ; sans codage personnalisé est requis.

Améliorations de framework de connecteur

La recherche SharePoint vous permet de récupérer des informations sur les revendications pour le contenu stocké dans des sources de données externes personnalisées qui sont analysées à l’aide de l’infrastructure du connecteur.

L'infrastructure du connecteur fournit également des exceptions améliorée capture et de journalisation pour vous aider à résoudre les erreurs rencontrées lors de l'analyse de sources de contenu à l'aide des connecteurs personnalisés qui sont construits sur l'infrastructure du connecteur. Pour plus d’informations sur l’infrastructure du connecteur, voir Infrastructure de connecteur de recherche dans SharePoint.

Voir aussi