Visão geral da empresa de pesquisa de consulta da Web do Serviço

Artigo
09/26/2008

Pesquisa da empresa no Microsoft Office do SharePoint Server 2007 expõe funcionalidades suas pesquisa a um serviço da Web XML. Isso permite acessar Pesquisar da empresa osssearchshort resultados a partir de aplicativos cliente e aplicativos da Web outside of o contexto de um site do SharePoint.

Acessar o serviço da Web de consulta

Para acessar o Pesquisar da empresa Query serviço da Web e seus métodos, definido um referência da Web para o seguinte:

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

Dica

Para passo a passo instruções de configuração um referência da Web com Microsoft Visual Studio 2005, consulte Como a: criar uma classe de proxy do serviço da Web para o serviço da Web de consulta de pesquisa da empresa em Visual Studio 2005.

Pesquisa em Windows SharePoint Services also provides a Query Web service for exposing its search functionality, which supports the same Web methods as the Pesquisar da empresa Query Web service, but which returns Pesquisa em Windows SharePoint Services results and which is scoped to the containing site or list. A localidade para o Pesquisa em Windows SharePoint Services Query serviço da Web é:

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

Para obter mais informações, consulte o O serviço da Web de consulta de serviços SharePoint Windows no Windows SharePoint Services 3.0 SDK.

Métodos da Web

A seguinte tabela descreve a disponível métodos da Web no Query serviço da Web.

Nome	Descrição
GetPortalSearchInfo	Retorna uma lista de escopos.
GetSearchMetadata	Retorna uma lista de gerenciado propriedades e os escopos.
Query	Retorna um conjunto de resultados em um seqüência de caracteres XML para a consulta especificada.
QueryEx	Retorna um conjunto de resultados em um objeto DataSet Microsoft ADO.NET para a consulta especificada.
Registration	Retorna o nome de um site especificado.
Status	Retorna disponibilidade do serviço de pesquisa.

Métodos de consulta

The Query Web service includes two methods for retrieving Pesquisar da empresa results: Query and QueryEx.

Ambos os métodos aceitar a entrada mesma, um seqüência de caracteres contendo XML que especifica os parâmetros consulta de pesquisa; No entanto, o formato dos resultados retornados é diferente. O QueryEx QueryEx método retorna os resultados da pesquisa em um objeto System.Data.DataSet System.Data.DataSet, e o Query consulta retorna os resultados da pesquisa em um seqüência de caracteres como XML. Para obter mais informações, consulte retornar os resultados da pesquisa .

Escolhendo o método de serviço da Web de consulta

To return multiple result types—such as relevant, special terms, and high confidence types—in the search results, you must use the QueryEx method.

Criando o XML para a consulta de pesquisa

O formato XML para a consulta pesquisa é definido na esquema Esquema Microsoft.Search.Query para a pesquisa da empresa Microsoft.Search.Query.

O real consulta pesquisa é especificada no elemento Elemento querytext no esquema Microsoft.Search.Query para a pesquisa da empresa querytext. Você pode compilar a consulta pesquisa usando a sintaxe Referência de sintaxe SQL de pesquisa da empresa SQL ou sintaxe Empresa de pesquisa de palavras-chave sintaxe referência de palavra-chave; você especificar a sintaxe usada no tipo QueryText atributo de elemento type.

O seguinte exemplo XML para o elemento QueryText querytext que especifica uma consulta pesquisa usando sintaxe SQL é exemplo de código.

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

Dica

If you are using SQL syntax with the Query method, you must specify the following properties in the SELECT statement of the SQL query: Title, Path, Description, Write, Rank, and Size.

O seguinte exemplo XML para o elemento QueryText querytext que especifica uma consulta pesquisa usando palavras-chave sintaxe é exemplo de código.

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

Você pode especificar quais propriedades para retornar para a consulta palavra-chave usando o elemento Elemento propriedade no esquema Microsoft.Search.Query para a pesquisa da empresa Propriedade.

Se você não fizer isso especificar quaisquer propriedades em XML, Pesquisar da empresa a consulta retorna um conjunto de propriedades usar como padrão.

A seguir estão Conjunto de propriedades retornado para o Query consulta usar como padrão:

Title
Description
Date
Relevance

A seguir estão Conjunto de propriedades retornado para o QueryEx método QueryEx usar como padrão:

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

Retornando os resultados da pesquisa

O QueryEx QueryEx método retorna os resultados da pesquisa em um objeto System.Data.DataSet System.Data.DataSet. O objeto DataSet DataSet contém um objeto System.DataSet.DataTable System.DataSet.DataTable para cada tipo de resultados que é retornado. Os tipos de resultados diferentes que podem ser retornados são:

Relevantes, em um tabela nomeado RelevantResults
Confiança alta, em uma tabela nomeado HighConfidenceResults
Termos especiais, em um tabela nomeado SpecialTermsResults

O Query consulta retorna os resultados da pesquisa em um seqüência de caracteres como XML. O formato para o XML é definido pelo Esquema Microsoft.Search.Response para a pesquisa da empresa e Esquema Microsoft.Search.Response.Document para a pesquisa da empresa Microsoft.Search.Response.Document esquemas. O conjunto completo de resultados da pesquisa está contido no elemento Elemento de resultados no esquema Microsoft.Search.Response para a pesquisa da empresa Resultados da esquema Microsoft.Search.Response Microsoft.Search.Response, com cada individual resultado representado por um elemento Elemento de documento de esquema Microsoft.Search.Response.Document para a pesquisa da empresa documentos da esquema Microsoft.Search.Response.Document Microsoft.Search.Response.Document.

Dica

O com suporte tipo resultado somente pelo Query método é resultados relevantes.