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

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

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

このトピックには、次のセクションが含まれています。

検索コネクタとは

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

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

検索コネクタの説明ファイルのしくみ

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

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

  • 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 ライブラリの場合のみ使用します。
説明 検索コネクタについて説明します。
iconReference 検索コネクタのカスタム アイコンの場所を識別します。
imageLink 検索コネクタのカスタム サムネイルの場所を識別します。
作成者 検索コネクタの作成者を識別します。
dateCreated 検索コネクタが作成された日付を識別します。
templateInfo 検索コネクタのフォルダーの種類を指定します。
locationProvider を する この検索コネクタで使用する検索プロバイダーを指定します。
スコープ を する 検索範囲に含める場所と、検索範囲から除外する場所を指定します。
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 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 ダウンロード センターの