共用方式為

搜尋連接器描述架構

  • 發行項

介紹 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 指定此搜尋連接器要使用的搜尋提供者。
範圍 (scope) 指定要包含在搜尋範圍中和排除的位置。
propertyStore 指定此搜尋連接器的 XML 架構 IPropertyStore 位置。 IPropertyStore支援搜尋連接器的開啟中繼資料。
includeInStartMenuScope 指定搜尋連接器所代表的位置是否應該包含在 [開始] 功能表的搜尋範圍中。
域 識別搜尋連接器的最上層網域。
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 下載中心