検索構成のカスタマイズした設定をエクスポートおよびインポートする

  • [アーティクル]

Microsoft 365 のグローバル管理者または SharePoint 管理者は、テナント、サイト コレクション、およびサイト間でカスタマイズされた検索構成設定をエクスポートおよびインポートできます。 エクスポートおよびインポートする設定には、カスタマイズされたすべてのクエリ ルール、結果ソース、結果の種類、ランク付けモデル、サイト検索設定が含まれます。 また、カスタマイズした検索構成設定をSearch Service アプリケーションからエクスポートし、設定をテナント、サイト コレクション、またはサイトにインポートすることもできます。 既定の構成設定をエクスポートすることはできません。

概要

カスタマイズされた検索構成設定をエクスポートする場合、SharePoint は XML 形式の検索構成ファイルを作成します。 この検索構成ファイルには、エクスポートを開始したテナント、サイト コレクション、またはサイト レベルで、エクスポート可能なすべてのカスタマイズされた検索構成設定が含まれます。 サイト コレクションの検索構成ファイルには、サイト コレクション内の個々のサイトからの検索構成設定は含まれません。

検索構成ファイルをインポートすると、SharePoint は、インポートを開始したテナント、サイト コレクション、またはサイトでカスタマイズされた各検索構成設定を作成して有効にします。

次の表は、エクスポートまたはインポートできる設定を示しています。 設定ごとに、カスタマイズされたその他の検索構成設定に対する依存関係が表示されます。 カスタマイズされた検索構成設定が異なるレベルのカスタマイズされた検索構成設定に依存する場合、たとえば、サイトのクエリ ルールがサイト コレクション レベルの検索先に依存する場合は、関連するすべてのレベルで設定をエクスポートおよびインポートする必要があります。

カスタマイズされた検索構成設定 他のカスタマイズされた検索構成設定への依存
クエリ ルール。 これには、結果ブロック、昇格した結果、およびユーザー セグメントが含まれます。
結果ソース、結果の種類、検索スキーマ、ランク付けモデル。
検索先
 検索スキーマ
結果の種類
 検索スキーマ、検索先、表示テンプレート
検索スキーマ
 なし
ランク付けモデル
 検索スキーマ

インポートが失敗する可能性がある条件

検索構成ファイルとインポート先に同じ名前の設定がある場合、この設定が検出されると検索構成ファイルのインポートに失敗します。 ただし、例外があります。

  • 検索構成ファイルを再インポートする場合、検索構成ファイルとターゲットで同じ名前の設定ではインポートに失敗しません。

  • 個々の管理プロパティ設定が検索構成ファイルとターゲット プロパティとで同じ場合、同じ名前の管理プロパティではインポートに失敗しません。

  • クロールされたプロパティに対するエイリアスとマッピングが検索構成ファイルの管理プロパティとターゲットの管理プロパティとで異なる場合、同じ名前の管理プロパティではインポートに失敗しません。 インポートによって、検索構成ファイルの管理プロパティにおけるエイリアスとマッピングがターゲットの管理プロパティにおけるエイリアスとマッピングに追加されます。

検索構成ファイルに無効な文字が含まれる管理プロパティ名またはエイリアスが含まれる場合、そのような管理プロパティ名あるいはエイリアスを処理した時点でインポートに失敗します。

検索スキーマの管理プロパティ名とエイリアスは、サイトとその親サイト コレクションにおいて一意である必要があります。 これは次のことを意味します。

  • ターゲット サイトまたはターゲット サイトの親サイト コレクションの管理プロパティのエイリアスと同じ名前の管理プロパティが検索構成ファイルにある場合、インポートに失敗します。

  • ターゲット サイトまたはターゲット サイトの親サイト コレクションの管理プロパティと同じ名前のエイリアスを持つ管理プロパティが検索構成ファイルにある場合、インポートに失敗します。

注:

インポートが失敗する前に SharePoint によって作成および有効にされたカスタマイズされた検索設定は、有効のままです。

インポートに失敗した場合は、失敗の原因となった条件を取り除いて、検索構成ファイルを再インポートしてください。 たとえば、インポートするクエリ ルールと同じ名前のクエリ ルールがすでに存在することが [ メモ] 列に表示されている場合は、ターゲットとインポート ファイルのどちらかからそのクエリ ルールを削除してから、ファイルを再インポートします。 この記事 の後半の「インポートが失敗する原因となっている無効な文字 」を参照してください。

カスタマイズした検索構成設定をテナントからエクスポートする

  1. SharePoint 管理センター の[その他の機能] に移動し、組織の管理者権限を持つアカウントでサインインします。

注:

21Vianet (中国) によって運用されている Office 365 を使用している場合は、Microsoft 365 管理センターにサインインし、次に SharePoint 管理センターに移動して [その他の機能] ページを開きます。

  1. [ 検索] で、[開く] を選択します。

  2. [ 検索構成のエクスポート] を選択します。

  3. ダイアログで、[保存] を選択 します。

カスタマイズされた検索構成設定をサイトからエクスポートする

  1. サイトで、[ 設定設定] アイコンを選択し、[ サイトの設定] を選択します。 [サイトの設定] が表示されない場合は、[サイト情報] を選択し、[すべてのサイト設定の表示] を選択します。

  2. [ サイトの設定] ページの [ 検索 ] セクションで、[ 構成のエクスポート] を選択します。

  3. ダイアログで、[保存] を選択 します。

カスタマイズされた検索構成設定をサイト コレクションからエクスポートする

  1. サイトで、[ 設定設定] アイコンを選択し、[ サイトの設定] を選択します。 [サイトの設定] が表示されない場合は、[サイト情報] を選択し、[すべてのサイト設定の表示] を選択します。

  2. [ サイトの設定] ページの [ サイト コレクションの管理 ] セクションで、[ 検索構成のエクスポート] を選択します。

  3. ダイアログで、[保存] を選択 します。

カスタマイズした検索構成設定をテナントにインポートする

  1. SharePoint 管理センター の[その他の機能] に移動し、組織の管理者権限を持つアカウントでサインインします。

注:

21Vianet (中国) によって運用されている Office 365 を使用している場合は、Microsoft 365 管理センターにサインインし、次に SharePoint 管理センターに移動して [その他の機能] ページを開きます。

  1. [ 検索] で、[ 開く] を選択します。

  2. [ 検索構成のインポート] ページで、インポートするファイルを参照します。

  3. [インポート] を選択します。

  4. [ 検索構成リスト] ページで、以下の点を確認します。

  5. インポートした検索構成ファイルがリストにあり、そのエントリの状態が [ 正常にインポートされました] になっている。

    ファイルが正常にインポートされていない場合は、[ メモ ] 列に発生した内容の詳細が表示されます。

  6. [スコープ] 列には、インポートした設定が適切なレベル(つまり、ファイルをインポートする目的のレベル)にあることを示します。 たとえば、サイト レベルではなくサイト コレクション レベルで設定をインポートした場合、[ スコープ ] 列にこの情報が表示されます。 [ 範囲] 列には、検索機能の構成設定がどのレベルに対して有効になっているかが表示されます。 レベルは、テナント (テナント)、サイト コレクション (SPSite)、またはサイト レベル (SPWeb) です。

カスタマイズされた検索構成設定をサイトにインポートする

  1. サイトで、[ 設定設定] アイコンを選択し、[ サイトの設定] を選択します。 [サイトの設定] が表示されない場合は、[サイト情報] を選択し、[すべてのサイト設定の表示] を選択します。

  2. [ サイトの設定] ページの [ 検索 ] セクションで、[ 構成のインポート] を選択します。

  3. [ 検索構成のインポート] ページで、インポートするファイルを参照します。

  4. [インポート] を選択します。

  5. [ 検索構成リスト] ページで、以下の点を確認します。

  6. インポートした検索構成ファイルがリストにあり、そのエントリの状態が [ 正常にインポートされました] になっている。

    ファイルが正常にインポートされていない場合は、[ メモ ] 列に、発生した内容の詳細が表示されます。

  7. [スコープ] 列には、インポートした設定が適切なレベル(つまり、ファイルをインポートする目的のレベル)にあることを示します。 たとえば、サイト レベルではなくサイト コレクション レベルで設定をインポートした場合、[ スコープ ] 列にこの情報が表示されます。 [ 範囲] 列には、検索機能の構成設定がどのレベルに対して有効になっているかが表示されます。 レベルは、テナント (テナント)、サイト コレクション (SPSite)、またはサイト レベル (SPWeb) です。

カスタマイズされた検索構成設定をサイト コレクションにインポートする

  1. サイトで、[ 設定設定] アイコンを選択し、[ サイトの設定] を選択します。 [サイトの設定] が表示されない場合は、[サイト情報] を選択し、[すべてのサイト設定の表示] を選択します。

  2. [ サイトの設定] ページの [ サイト コレクションの管理 ] セクションで、[ 検索構成のインポート] を選択します。

  3. [ 検索構成のインポート] ページで、インポートするファイルを参照します。

  4. [インポート] を選択します。

  5. [ 検索構成リスト] ページで、以下の点を確認します。

  6. インポートした検索構成ファイルが一覧に含まれており、その状態は [正常にインポートされました] です。

    ファイルが正常にインポートされていない場合は、[ メモ ] 列に、発生した内容の詳細が表示されます。

  7. [スコープ] 列には、インポートした設定が適切なレベル(つまり、ファイルをインポートする目的のレベル)にあることを示します。 たとえば、サイト レベルではなくサイト コレクション レベルで設定をインポートした場合、[ スコープ ] 列にこの情報が表示されます。 [ 範囲] 列には、検索機能の構成設定がどのレベルに対して有効になっているかが表示されます。 レベルは、テナント (テナント)、サイト コレクション (SPSite)、またはサイト レベル (SPWeb) です。

インポートが失敗する原因となっている無効な文字

以下に示すいずれかの文字が管理プロパティまたはエイリアスに含まれる場合、そのようなプロパティが含まれるカスタマイズされた検索スキーマのインポートに失敗します。

文字 名前
スペース
:
 コロン
;
 セミコロン
,
 コンマ
(
 左小かっこ
)
 右小かっこ
[
 左大かっこ
]
 右大かっこ
{
 左中かっこ
}
 右中かっこ
%
パーセント
$
ドル記号
_
 下線
+
プラス記号
!
感嘆符
*
アスタリスク
=
等号
&
 アンパサンド
?
疑問符
@
アット マーク
#
番号記号
\
円マーク (バックスラッシュ)
~
チルダ
<
左山かっこ
>
右山かっこ
|
パイプ
`
アクサン グラーブ
^
キャレット
'
 エスケープ シーケンス
"
 エスケープ シーケンス

既知の問題

検索構成リストを読み込むことができない

テナント管理者の検索設定ページに検索構成ファイルをインポートすると、 検索構成リスト が正しく表示されず、"ファイルが見つかりません" というエラーが表示される可能性がある問題が発生する可能性があります。

この問題は、インポートした検索構成ファイルの一覧が UI に表示されるのをブロックするだけで、 インポート 機能を中断しません。 検索構成が正しくインポートされます。

UI からインポートした検索構成ファイルの状態をチェックできないため、SharePoint CSOM API や SharePoint Online REST API などのリストにアクセスする別の方法を選択できます。

古い検索構成 XML ファイルをインポートできません

検索構成ファイルがずっと前にエクスポートされた場合、インポートが失敗する可能性があります。

エクスポートされた検索構成ファイルが古い場合は、最初に新しい検索構成をエクスポートしてから、それを使用して検索構成ファイルの一覧をインポートする必要があります。