搜索连接器说明架构

介绍Windows资源管理器库和联合搜索提供程序使用的搜索连接器说明架构。 架构指定搜索连接器说明文件的结构和要求, (*.searchConnector-ms) ,以及 Shell 库说明 (*.library-ms) 文件的 searchConnectorDescriptionType 元素。

本主题介绍与联合搜索连接器相关的架构。 有关库和库说明架构的详细信息,请参阅 库说明架构

本主题包含下列部分:

什么是搜索连接器?

搜索连接器将用户与存储在 Web 服务或远程存储位置中的数据连接起来。 使用 Windows 7,用户可以为位置(如 Web 服务)安装搜索连接器,以便直接从Windows资源管理器搜索这些位置。 搜索连接器是搜索连接器说明文件 (*.searchConnector-ms) ,用于指定如何连接到、向位置发送查询以及接收结果。

除了 Web 服务,搜索连接器还可用于搜索协议处理程序创建的本地索引范围。 例如,用户可以使用该电子邮件存储的搜索连接器,使用 MAPI 协议处理程序在本地搜索索引的电子邮件。

搜索连接器说明文件的工作原理是什么?

在用户系统上安装搜索连接器说明文件时,用户可以打开Windows资源管理器,单击导航窗格中的搜索连接器,然后输入搜索查询。 Windows资源管理器使用搜索连接器说明文件中的信息(例如要使用的提供程序和搜索范围)发送查询。 结果以 RSS 或 Atom 源项的形式返回,并向用户显示,就像它们是常规 Shell 项一样。

如何部署搜索连接器说明文件取决于搜索连接器支持的位置类型:

  • 在 Web 服务的 OpenSearch 配置 (*.osdx) 文件中
  • 作为协议处理程序安装的一部分

用户打开 .osdx 文件或安装协议处理程序时,应确保发生以下情况:

  • .searchconnector-ms 文件是在用户的Windows Search 文件夹中创建的, (%userprofile%/Search) 。
  • .searchconnector-ms 文件的快捷方式是在用户 链接 文件夹中创建的, (%userprofile%/Links) 。

什么是搜索连接器说明架构?

搜索连接器说明架构是一个 XML 架构,用于定义搜索连接器说明文件的结构 (*.searchConnector-ms) 。 每个搜索连接器都必须有一个搜索连接器说明文件,该文件指定如何连接到、向位置发送查询以及接收结果。

架构的主要部分是什么?

下表列出了架构的主要部分。

子元素 说明
isSearchOnlyItem 标识搜索连接器支持的位置是仅搜索还是搜索和浏览。
isDefaultSaveLocation 仅用于库使用。
isDefaultNonOwnerSaveLocation 仅用于库使用。
description 描述搜索连接器。
iconReference 标识搜索连接器的自定义图标的位置。
imageLink 标识搜索连接器的自定义缩略图的位置。
author 标识搜索连接器的作者。
dateCreated 标识创建搜索连接器的日期。
templateInfo 指定搜索连接器的文件夹类型。
locationProvider 指定此搜索连接器要使用的搜索提供程序。
作用域 指定要包含在搜索范围和从搜索范围中排除的位置。
propertyStore 指定此搜索连接器的基于 XML 的 IPropertyStore 的位置。 IPropertyStore 支持搜索连接器的打开元数据。
includeInStartMenuScope 指定搜索连接器所表示的位置是否应包含在"开始"菜单的搜索范围中。
domain 标识搜索连接器的顶级域。
supportsAdvancedQuerySyntax 指定搜索连接器是否支持高级查询语法 (AQS) 。
isIndexed 指定是否为搜索连接器表示的位置编制索引。

 

搜索连接器说明文件的示例

下面是联合搜索 Web 服务的搜索连接器说明文件的示例。

<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
  <description>Search MSDN. Powered by live.com</description>
  <isSearchOnlyItem>true</isSearchOnlyItem>
  <domain>https://social.msdn.microsoft.com</domain>
  <supportsAdvancedQuerySyntax>false</supportsAdvancedQuerySyntax>
  <templateInfo>
    <folderType>{8FAF9629-1980-46FF-8023-9DCEAB9C3EE3}</folderType>
  </templateInfo>
  <propertyStore>
    <property name="OpenSearchHTMLRolloverTemplate">https://social.msdn.microsoft.com/Search/?Query={searchTerms}</property>
  </propertyStore>
  <locationProvider clsid="{48E277F6-4E74-4cd6-BA6F-FA4F42898223}">
    <propertyBag>
      <property name="OpenSearchShortName">MSDN</property>
      <property name="OpenSearchQueryTemplate">https://social.msdn.microsoft.com/Search/Feed.aspx?locale=en-US&Query={searchTerms}&format=RSS&StartIndex={startIndex}</property>
      <property name="MaximumResultCount" type="uint32">100</property>
    </propertyBag>
  </locationProvider>
</searchConnectorDescription>

下面是 MAPI 协议处理程序的搜索连接器说明文件的示例。

<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
    <description>Microsoft Outlook</description>
    <isSearchOnlyItem>true</isSearchOnlyItem>
    <includeInStartMenuScope>true</includeInStartMenuScope>
    <templateInfo>
        <folderType>{91475FE5-586B-4EBA-8D75-D17434B8CDF6}</folderType>
    </templateInfo>
    <simpleLocation>
        <url>mapi://{S-1-5-21-2127521184-1604012920-1887927527-2779359}/</url>
    </simpleLocation>
</searchConnectorDescription>

其他资源

参考

searchConnectorDescriptionType 元素 (搜索连接器架构)

其他资源

OpenSearch

Microsoft 下载中心