搜索连接器说明架构

介绍 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 搜索 文件夹 (%userprofile%/Search) 中创建的。
  • 在用户的 Links 文件夹 (%userprofile%/Links) 中创建 .searchconnector-ms 文件的快捷方式。

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

搜索连接器说明架构是一种 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 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 下载中心