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

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 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 要素 (Search Connector スキーマ)

その他のリソース

OpenSearch

Microsoft ダウンロード センター