Vue d'ensemble du service Web Query de recherche de contenu d'entreprise

Article
02/01/2010

Recherche de contenu d'entreprise dans Microsoft Office SharePoint Server 2007 expose ses fonctionnalités de recherche via un service Web XML. Cela vous permet d'accéder aux résultats de la Recherche de contenu d'entreprise à 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 Query de la Recherche de contenu d'entreprise et à ses méthodes, définissez une référence Web :

http://Server_Name/[sites/][Site_Name/]_vti_bin/search.asmx

Notes

Vous trouverez des instructions détaillées sur la définition d'une référence Web avec Microsoft Visual Studio 2005 dans Procédure : créer une classe proxy de service Web pour le service Web Query de recherche de contenu d'entreprise dans Visual Studio 2005.

Recherche dans Windows SharePoint Services fournit également un service Web Query pour exposer sa fonctionnalité de recherche, qui prend en charge les mêmes méthodes Web que le service Web Query de la Recherche de contenu d'entreprise, mais qui renvoie des résultats de la Recherche dans Windows SharePoint Services et qui se limite au site ou à la liste conteneur. L'emplacement pour le service Web Query de la Recherche dans Windows SharePoint Services est :

http://Server_Name/[sites/][Site_Name/]_vti_bin/spsearch.asmx

Pour plus d'informations, voir Service Web Query Windows SharePoint Services dans le Kit de développement (SDK) Windows SharePoint Services 3.0.

Méthodes Web

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

Nom	Description
GetPortalSearchInfo	Renvoie une liste d'étendues.
GetSearchMetadata	Renvoie une liste de propriétés gérées et d'étendues.
Query	Renvoie un ensemble de résultats dans une chaîne XML pour la requête spécifiée.
QueryEx	Renvoie un ensemble de résultats dans un objet Microsoft ADO.NET DataSet pour la requête spécifiée.
Registration	Renvoie le nom d'un site spécifié.
Status	Renvoie la disponibilité du service de recherche.

Méthodes de requête

Le service Web Query propose deux méthodes pour récupérer les résultats de la Recherche de contenu d'entreprise : 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 la requête de recherche ; toutefois, le format des résultats renvoyés diffère. La méthode QueryEx renvoie les résultats de la recherche dans un objet System.Data.DataSet et la méthode Query renvoie les résultats de la recherche dans une chaîne au format XML. Pour plus d'informations, voir Returning the Search Results.

Choix de la méthode du service Web Query

Pour renvoyer plusieurs types de résultats dans les résultats de la recherche, tels que des termes spéciaux pertinents et des types avec un niveau de confiance élevé, vous devez utiliser la méthode QueryEx.

Création 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 Schéma Microsoft.Search.Query pour la recherche de contenu d'entreprise.

La requête de recherche proprement dite est spécifiée dans l'élément QueryText, élément du schéma Microsoft.Search.Query pour la recherche de contenu d'entreprise. Vous pouvez la créer avec la syntaxe Référence de la syntaxe SQL de recherche de contenu d'entreprise ou la syntaxe Référence de syntaxe de mots-clés Recherche de contenu d'entreprise ; vous spécifiez la syntaxe utilisée dans l'attribut type de l'élément QueryText.

L'exemple de code suivant représente le code XML pour l'élément QueryText qui spécifie une requête de recherche avec la syntaxe SQL.

<QueryText language=xml:lang type='MSSQLFT'>
SELECT Title, Path, Description, Write, Rank, Size FROM Scope() WHERE CONTAINS(Description,'SharePoint')
</QueryText>

Notes

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.

L'exemple de code suivant représente le code XML pour l'élément QueryText qui spécifie une requête de recherche avec la syntaxe de mot clé.

<QueryText language=xml:lang type='STRING'>
SharePoint
</QueryText>

Vous pouvez spécifier les propriétés à renvoyer pour la requête de mot clé à l'aide de l'élément Élément Property du schéma Microsoft.Search.Query de la recherche de contenu d'entreprise.

Si vous ne spécifiez aucune propriété dans la requête XML, la Recherche de contenu d'entreprise renvoie un ensemble de propriétés par défaut.

Les propriétés suivantes sont renvoyées par défaut pour la méthode Query :

Title
Description
Date
Relevance

Les propriétés suivantes sont renvoyées par défaut pour la méthode QueryEx :

WorkId
Rank
Title
Author
Size
Path
Description
Write
SiteName
CollapsingStatus
HitHighlightedSummary
HitHighlightedProperties
ContentClass
IsDocument
PictureThumbnailURL

Renvoi des résultats de la recherche

La méthode QueryEx renvoie les résultats de la recherche dans un objet System.Data.DataSet. L'objet DataSet contient un objet System.DataSet.DataTable pour chaque type de résultat renvoyé. Les différents types de résultats qui peuvent être renvoyés sont les suivants :