Service Web Query Windows SharePoint Services

Article
02/01/2010

Recherche dans Windows SharePoint Services expose ses fonctionnalités de recherche par le biais d'un service Web. Ce service vous permet d'accéder aux résultats de Rechercher à partir d'applications clientes et d'applications Web en dehors du contexte d'un site SharePoint.

Accès au service Web Query

Pour accéder au service Web RechercherQuery et à ses méthodes, affectez le code suivant à une référence Web :

http:// <Site_Name> /_vti_bin/spsearch.asmx

Remarque : pour obtenir des instructions étape par étape sur la définition d'une référence Web avec Microsoft Visual Studio 2005, voir Procédure : créer une classe proxy de service Web pour le service Web Recherche de Windows SharePoint Services dans Visual Studio.

Méthodes Web

Le tableau suivant décrit les méthodes Web disponibles dans le service Web Query.

Nom	Description
Query	Retourne un jeu de résultats dans une chaîne XML pour la requête spécifiée.
QueryEx	Retourne un jeu de résultats dans un objet Microsoft ADO.NET DataSet pour la requête spécifiée.
Registration	Retourne le nom pour un site spécifié.
Status	Retourne la disponibilité du service de recherche.

Méthodes de requête

Le service Web Query comprend deux méthodes d'extraction des résultats Rechercher : Query et QueryEx.

Les deux méthodes acceptent la même entrée, une chaîne contenant du code XML qui spécifie les paramètres de requête de recherche ; cependant, le format des résultats retournés varie. La méthode QueryEx retourne les résultats de la recherche dans un objet System.Data.DataSet, tandis que la méthode Query retourne les résultats de la recherche dans une chaîne au format XML. Pour plus d'informations, voir « Retour des résultats de recherche », plus loin dans cette rubrique.

Génération du code XML pour la requête de recherche

Le format XML de la requête de recherche est défini dans le schéma Microsoft.Search.Query.

La requête de recherche réelle est spécifiée dans l'élément QueryText. Vous pouvez la générer en utilisant la syntaxe SQL ou la syntaxe de mots clés ; la syntaxe utilisée est spécifiée dans l'attribut type de l'élément QueryText.

Le code suivant est un exemple de données XML pour l'élément QueryText qui spécifie une requête de recherche à l'aide de la syntaxe SQL.

<QueryText language=en-us type='MSSQLFT'>
SELECT Title, Path, Description, Write, Rank, Size FROM Scope() WHERE FREETEXT(DEFAULTPROPERTIES,'SharePoint') ORDER BY Rank
</QueryText>

Remarque :
Si vous utilisez la syntaxe SQL avec la méthode Query, vous devez spécifier les propriétés suivantes dans l'instruction SELECT de la requête SQL : Title, Path,Description,Write, Rank et Size.

Le code suivant est un exemple de données XML pour l'élément QueryText qui spécifie une requête de recherche à l'aide de la syntaxe de mots clés.

<QueryText language=en-us type='STRING'>
SharePoint
</QueryText>

Retour des résultats de recherche

La méthode QueryEx retourne les résultats de recherche dans un objet System.Data.DataSet. L'objet DataSet contient un objet System.DataSet.DataTable pour chaque type de résultat retourné.

La méthode Query retourne les résultats de recherche dans une chaîne au format XML. Le format XML est défini dans les schémas Microsoft.Search.Response et Microsoft.Search.Response.Document. L'ensemble complet des résultats de recherche est contenu dans l'élément Results du schéma Microsoft.Search.Response, chaque résultat individuel étant représenté par un élément Document du schéma Microsoft.Search.Response.Document.