Servicio web de consulta de Windows SharePoint Services
Buscar en Windows SharePoint Services expone sus funcionalidades de búsqueda a través de un servicio web. De este modo, podrá tener acceso a los resultados de Buscar desde aplicaciones cliente y aplicaciones web fuera del contexto de un sitio de SharePoint.
Acceso al servicio web de consulta
Para tener acceso el servicio web de consulta de Buscar y a sus métodos, establezca una referencia web para lo siguiente:
http:// <Site_Name> /_vti_bin/spsearch.asmx
Nota Para obtener instrucciones detalladas sobre cómo establecer una referencia web con Microsoft Visual Studio 2005, consulte Creación de una clase proxy de servicio web para el servicio web de Windows SharePoint Services Search en Visual Studio.
Métodos web
En la siguiente tabla se describen los métodos web disponibles en el servicio web de consulta.
| Nombre | Descripción |
|---|---|
Devuelve un conjunto de resultados en una cadena XML para la consulta especificada. |
|
Devuelve un conjunto de resultados en un objeto DataSet de Microsoft ADO.NET para la consulta especificada. |
|
Devuelve el nombre de un sitio especificado. |
|
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 Buscar: 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 la sección "Devolución de los resultados de la búsqueda" más adelante en este tema.
Creación del código XML para la consulta de búsqueda
El formato del código XML para la consulta de búsqueda se define en el Esquema Microsoft.Search.Query.
La consulta de búsqueda real se especifica en el elemento QueryText. Puede crear la consulta de búsqueda mediante la sintaxis SQL o de palabra clave; especifique la sintaxis que se usa en el atributo type del elemento QueryText.
El siguiente ejemplo de código es un código XML de ejemplo para el elemento QueryText que usa la sintaxis SQL para especificar una consulta de búsqueda.
<QueryText language=en-us type='MSSQLFT'>
SELECT Title, Path, Description, Write, Rank, Size FROM Scope() WHERE FREETEXT(DEFAULTPROPERTIES,'SharePoint') ORDER BY Rank
</QueryText>
Nota
Si usa la sintaxis SQL con el método Query, deberá especificar las propiedades siguientes 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=en-us type='STRING'>
SharePoint
</QueryText>
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 resultado que se devuelve.
El método Query devuelve los resultados de la búsqueda en una cadena con formato XML. El formato para el código XML se define mediante los esquemas Microsoft.Search.Response y Microsoft.Search.Response.Document. El conjunto completo de resultados de la búsqueda se encuentra en el elemento Results del esquema Microsoft.Search.Response, con cada resultado individual representado por un elemento Document del esquema Microsoft.Search.Response.Document.
En esta sección
Referencia
Esquemas Microsoft.Search para el servicio de consulta de búsqueda de Windows SharePoint Services