共用方式為

搜尋連接器描述架構

  • 發行項

介紹 Windows 檔案總管連結庫和同盟搜尋提供者所使用的搜尋連接器描述架構。 架構會指定 Search Connector Description 檔案 （*.searchConnector-ms） 的結構和需求，以及 searchConnectorDescriptionType Shell 連結庫描述 （*.library-ms） 檔案的元素。

本主題描述與同盟搜尋連接器相關的架構。 如需連結庫和連結庫描述架構的詳細資訊，請參閱 連結庫描述架構。

本主題包含下列各節：

什麼是搜尋連接器？

搜尋連接器會將使用者與儲存在 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 僅供連結庫使用。
描述 描述搜尋連接器。
圖示參考 識別搜尋連接器自定義圖示的位置。
imageLink 識別搜尋連接器的自定義縮圖位置。
作者 識別搜尋連接器的作者。
dateCreated 識別建立搜尋連接器的日期。
templateInfo 指定搜尋連接器的資料夾類型。
locationProvider 指定此搜尋連接器要使用的搜尋提供者。
範圍 指定要包含在搜尋範圍中和排除的位置。
propertyStore 指定此搜尋連接器之 XML 型 IPropertyStore 的位置。 IPropertyStore 支援搜尋連接器的開啟元數據。
includeInStartMenuScope 指定搜尋連接器所代表的位置是否應該包含在 [開始] 選單的搜尋範圍中。
網域 識別搜尋連接器的最上層網域。
支援AdvancedQuerySyntax 指定搜尋連接器是否支援進階查詢語法 （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>

其他資源

  • 如需連結庫描述架構的詳細資訊，請參閱 連結庫描述架構。
  • 如需安裝搜尋連接器的詳細資訊，請參閱在 Windows 中同盟搜尋。

參考

searchConnectorDescriptionType 元素 （搜尋連接器架構）

其他資源

OpenSearch

Microsoft 下載中心