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

Découvrez les nouvelles fonctionnalités disponibles pour les développeurs dans 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

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

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

Utilisation de la recherche .NET Framework CSOM géré, vous devez obtenir une instance de ClientContext (située dans l'espace de noms Microsoft.SharePoint.Client 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 pour les données de résultats de recherche contient une ResultTableCollection collection composée d'objets ResultTable qui représentent les jeux de résultats différents.

Support de la syntaxe SQL supprimé

Les solutions de recherche personnalisée dans SharePoint ne permettent pas de SQL syntaxe. 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ée qui utilisent la syntaxe SQL avec le modèle objet serveur de requête et le service web de requête qui ont été créés dans les versions antérieures de SharePoint Server ne fonctionneront pas lorsque vous les mettrez à 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, voir référence de syntaxe KQL (Keyword Query Language) et référence de syntaxe FAST Query Language (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 de recherche SharePoint à partir d’applications clientes à l’aide de toute technologie qui prend en charge les requêtes web REST. Le service de recherche REST expose les deux systèmes d'extrémité, query et suggest et prendront en charge les opérations GET et POST. Les résultats sont renvoyés au format XML ou JSON.

Le point d'accès du service est le suivant : 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 la convention par défaut.

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 SharePoint requêtes REST.

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

Le service web de requête (situé dans le chemin http://server/site/_vti_bin/search.asmx d’accès) est 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 SharePoint recherche, un sac 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"]

SharePoint La recherche inclut les propriétés de requête dans le sac des propriétés, y compris les 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 comprend des améliorations apportées au langage de requête par mot clé, qui sont décrits 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

SharePoint La recherche inclut une nouvelle infrastructure de résultats qui facilite la personnalisation de l’apparence (apparence) de l’interface utilisateur (IU) des résultats de la 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

SharePoint La recherche 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 analyser à 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 l’infrastructure de connecteur de recherche dans SharePoint.

Voir aussi