Introducción al servicio web de consulta del motor de búsqueda Enterprise Search

Artículo
02/01/2010

Enterprise Search de Microsoft Office SharePoint Server 2007 ofrece sus funcionalidades de búsqueda a través de un servicio web XML. Esto le permite tener acceso a resultados de Enterprise Search desde aplicaciones cliente y aplicaciones web situadas fuera del contexto de un sitio de SharePoint.

Acceso al servicio web de consulta

Para obtener acceso al servicio web de consulta de Enterprise Search y a sus métodos, establezca una referencia web a:

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

Nota

Para obtener instrucciones detalladas para establecer una referencia web con Microsoft Visual Studio 2005, consulte Procedimiento para crear una clase proxy de servicio web para el servicio web de consulta del motor de búsqueda Enterprise Search en Visual Studio 2005.

Buscar en Windows SharePoint Services también proporciona un servicio web de consulta para ofrecer su funcionalidad de búsqueda, que admite los mismos métodos web que el servicio web de consulta de Enterprise Search, pero que devuelve los resultados de Buscar en Windows SharePoint Services y cuyo ámbito adscribe al sitio o la lista contenedores. La ubicación del servicio web de consulta de Buscar en Windows SharePoint Services es:

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

Para obtener más información, consulte Servicio web de consulta de Windows SharePoint Services en el SDK de Windows SharePoint Services 3.0.

Métodos web

La siguiente tabla describe los métodos web disponibles en el servicio web de consulta.

Nombre	Descripción
GetPortalSearchInfo	Devuelve una lista de ámbitos.
GetSearchMetadata	Devuelve una lista de propiedades y ámbitos administrados.
Query	Devuelve un conjunto de resultados en una cadena XML para la consulta especificada.
QueryEx	Devuelve un conjunto de resultados en un objeto DataSet de Microsoft ADO.NET para la consulta especificada.
Registration	Devuelve el nombre de un sitio especificado.
Status	Devuelve la disponibilidad del servicio de búsqueda.

Métodos de consulta

El servicio web de consulta incluye dos métodos para recuperar resultados de Enterprise Search: Query y QueryEx.

Ambos métodos aceptan la misma entrada, una cadena que contiene XML que especifica los parámetros de consulta de búsqueda; sin embargo, el formato de los resultados devueltos difiere. El método QueryEx devuelve los resultados de la búsqueda en un objeto System.Data.DataSet y el método Query devuelve los resultados de la búsqueda en una cadena en forma de XML. Para obtener más información, consulte Returning the Search Results.

Elección del método de servicio web de consulta

Para devolver varios tipos de resultados, como términos relevantes, especiales y tipos de confianza alta, en los resultados de la búsqueda se debe usar el método QueryEx.

Creación del XML para la consulta de búsqueda

El formato XML para la consulta de búsqueda se define en el esquema Esquema Microsoft.Search.Query para el motor de búsqueda Enterprise Search.

La consulta de búsqueda real se especifica en el elemento Elemento QueryText del esquema Microsoft.Search.Query para el motor de búsqueda Enterprise Search. Puede crear la consulta de búsqueda mediante la sintaxis Referencia de sintaxis SQL del motor de búsqueda Enterprise Search o Referencia de sintaxis de palabra clave del motor de búsqueda Enterprise Search; la sintaxis que se usa se especifica en el atributo type del elemento QueryText.

El siguiente ejemplo de código es XML de ejemplo para el elemento QueryText que usa la sintaxis SQL para especificar una consulta de búsqueda.

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

Nota

Si se usa sintaxis SQL con el método Query, debe especificar las siguientes propiedades en la instrucción SELECT de la consulta SQL: Title, Path, Description, Write, Rank y Size.

El siguiente ejemplo de código es código XML de ejemplo para el elemento QueryText que usa la sintaxis de palabra clave para especificar una consulta de búsqueda.

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

Puede especificar qué propiedades se han de devolver para la consulta de palabras clave mediante el elemento Elemento Property del esquema Microsoft.Search.Query para el motor de búsqueda Enterprise Search.

Si no especifica ninguna propiedad en la consulta XML, Enterprise Search devuelve un conjunto predeterminado de propiedades.

A continuación se muestra el conjunto predeterminado de propiedades devueltas para el método Query:

Title
Description
Date
Relevance

A continuación se incluye el conjunto predeterminado de propiedades devueltas para el método QueryEx:

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

Devolución de los resultados de la búsqueda

El método QueryEx devuelve los resultados de la búsqueda en un objeto System.Data.DataSet. El objeto DataSet contiene un objeto System.DataSet.DataTable para cada tipo de resultados que se devuelve. Los diferentes tipos de resultados que se pueden devolver son: