次の方法で共有


検索コネクタの説明スキーマ

Windows エクスプローラー ライブラリとフェデレーション検索プロバイダーによって使用される Search Connector Description スキーマについて説明します。 スキーマは、Search Connector Description ファイル (*.searchConnector-ms) およびシェル ライブラリ記述 (*.library-ms) ファイルの searchConnectorDescriptionType 要素の構造と要件を指定します。

このトピックでは、フェデレーション検索コネクタに関連するスキーマについて説明します。 ライブラリとライブラリ記述スキーマの詳細については、「ライブラリ記述 スキーマ」を参照してください。

このトピックのセクションは次のとおりです。

検索コネクタとは

検索コネクタは、Web サービスまたはリモート ストレージの場所に格納されているデータとユーザーを接続します。 Windows 7 では、ユーザーは Web サービスなどの場所の検索コネクタをインストールして、Windows エクスプローラーからそれらの場所を直接検索できます。 検索コネクタは、場所への接続、クエリの送信先、および場所からの結果の受信方法を指定する検索コネクタ記述ファイル (*.searchConnector-ms) です。

Web サービスに加えて、検索コネクタを使用して、プロトコル ハンドラーによって作成されたローカル インデックス スコープを検索できます。 たとえば、ユーザーは、その電子メール ストアの検索コネクタを使用して、MAPI プロトコル ハンドラーでローカルにインデックス付けされたメールを検索できます。

コネクタ記述ファイルの検索のしくみ

Search Connector Description ファイルがユーザーのシステムにインストールされている場合、ユーザーは Windows エクスプローラーを開き、ナビゲーション ウィンドウで検索コネクタをクリックして、検索クエリを入力できます。 Windows エクスプローラーは、使用するプロバイダーや検索範囲など、Search Connector Description ファイルの情報を使用してクエリを送信します。 結果は RSS または Atom フィード項目として返され、通常のシェル項目であるかのようにユーザーに表示されます。

Search Connector Description ファイルの展開方法は、検索コネクタがサポートする場所の種類によって異なります。

  • Web サービスの OpenSearch 構成 (*.osdx) ファイル内
  • プロトコル ハンドラーのインストールの一環として

ユーザーが .osdx ファイルを開くか、プロトコル ハンドラーをインストールするときに、次のことが行われるようにする必要があります。

  • .searchconnector-ms ファイルは、ユーザーの Windows Searches フォルダー (%userprofile%/Searches) に作成されます。
  • .searchconnector-ms ファイルへのショートカットは、ユーザーの Links フォルダー (%userprofile%/Links) に作成されます。

検索コネクタの説明スキーマとは

Search Connector Description スキーマは、Search Connector Description ファイル (*.searchConnector-ms) の構造を定義する XML スキーマです。 各検索コネクタには、接続方法、クエリの送信先、場所からの結果の受信方法を指定する Search Connector Description ファイルが必要です。

スキーマの主要な部分は何ですか?

次の表に、スキーマの主要な部分を示します。

子要素 説明
isSearchOnlyItem 検索コネクタでサポートされている場所が検索専用であるか、検索および参照であるかを識別します。
isDefaultSaveLocation ライブラリの場合のみ使用します。
isDefaultNonOwnerSaveLocation ライブラリの場合のみ使用します。
description 検索コネクタについて説明します。
iconReference 検索コネクタのカスタム アイコンの場所を識別します。
imageLink 検索コネクタのカスタム サムネイルの場所を識別します。
author 検索コネクタの作成者を識別します。
dateCreated 検索コネクタが作成された日付を識別します。
templateInfo 検索コネクタのフォルダーの種類を指定します。
locationProvider この検索コネクタで使用する検索プロバイダーを指定します。
スコープ (scope) 検索範囲に含める場所と検索範囲から除外する場所を指定します。
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 要素 (Search Connector スキーマ)

その他のリソース

OpenSearch

Microsoft ダウンロード センター