浅尝MOSS Search Query Web Service
SharePoint Server 2007 Search 提供一个 Query Web Service,我们可以通过调用Web Service的方式向非SharePoint站点的客户端应用程序提供搜索功能.
MOSS中搜索服务的URL是:
http://Server_Name/[sites/][Site_Name/]_vti_bin/search.asmx
此Web Service中有两个方法来提交搜索:
| Query |
以XML形式返回指定查询的结果 |
| QueryEx |
以ADO.NET DataSet 对象形式返回指定查询的结果 |
这两种方法不仅返回结果的类型不一样,返回的内容(包含的属性)也不一样.
Query默认返回以下内容:
- Title
- Description
- Date
- Relevance
QueryEx默认返回以下内容:
- WorkId
- Rank
- Title
- Author
- Size
- Path
- Description
- Write
- SiteName
- CollapsingStatus
- HitHighlightedSummary
- HitHighlightedProperties
- ContentClass
- IsDocument
- PictureThumbnailURL
虽然这两种方法的返回值是不同的,但它们的参数却是相同的:QueryXML.
QueryXML的格式如下:
<QueryPacket>
<Query>
<QueryId />
<SupportedFormats>
<Format />
</SupportedFormats>
<Context>
<QueryText language="zh-CN" type="MSSQLFT|STRING">Query Text</QueryText>
<OriginatorContext />
</Context>
<Range>
<StartAt />
<Count />
</Range>
<Properties name="PROPERTY NAME">
<Property />
</Properties>
<SortByProperties>
<SortByProperty />
</SortByProperties>
<EnableStemming />
<TrimDuplicates />
<IncludeSpecialTermResults />
<IgnoreAllNoiseQuery />
<IncludeRelevantResults />
<IncludeHighConfidenceResults />
</Query>
</QueryPacket>
如果不知道这段XML中具体的属性应该怎样填写可以下载MOSS Query Tool( http://www.gotdotnet.com/Community/UserSamples/Details.aspx?SampleGuid=89b3cda7-aad9-4919-8faf-34ef9b28c57b )这个工具,它可以生成XML.
对于这段XML,我们需要注意粗体的部分:
- Language
不同的语言对应不同的切词技术,比如英文可以根据空格来间隔单词,但中文的切词就复杂很多,所以一定要注意要搜索的内容的语种,否则可能出现没有结果的现象. - Type
值可以有两种选择:STRING或MSSQLFT,区别与使用方法如下表所示:
| QueryText type |
QueryText value |
增加搜索范围 |
范例 |
| STRING |
关键字 |
在QueryXML中为Query元素增加子元素Property,每个Property对应一个属性,Property的name特性值就是加入搜索范围的属性名称. |
<Context><QueryText language="zh-CN" type="STRING"><![CDATA[KEYWORDS]]></QueryText></Context><Properties name="PROPERTY_NAME"> <Property /> |
| MSSQLFT |
表示MS SQL 全文检索,Query Text需填写全文检索查询语句(具体的查询语句可以利用上边提到的MOSS Query Tool生成) |
直接在全文检索查询语句中加入属性名称. |
<QueryText language="zh-CN" type="MSSQLFT"><![CDATA[SELECT Title, Rank, Size, Description, Write, Path, PROPERTY_NAME FROM portal..scope() WHERE FREETEXT(DefaultProperties, 'KEYWORDS') ORDER BY "Rank" DESC]]></QueryText> |
最后,在调用Query或者QueryEx方法之前,我们还需要建立"凭证"让客户端通过MOSS的验证.
如果确定客户端和MOSS服务器在同一域中并有权限执行搜索,可以使用默认凭证:
qs.Credentials = System.Net.CredentialCache.DefaultCredentials;
如果客户端不在MOSS域中(比如客户端运行在LINUX等平台中),可以指定搜索用户:
qs.Credentials = new System.Net.NetworkCredential("用户名","密码","域名");
这一步必不可少,而且必须在调用Query或者QueryEx方法之前,否则会提示验证失败.