コンテンツ検索 Web パーツでSharePoint高度なクエリを構成して、クラシック ページにコンテンツを表示します。
この Web パーツは、クラシック ページ用に設計されています。 クラシック ページを使用していない場合は、強調表示されたコンテンツ Web パーツ を確認してください。
コンテンツ検索 Web パーツ (CSWP) について
訪問者が CSWP ページを閲覧すると、Web パーツによってクエリが自動的に発行されます。 CSWP 内で検索結果が表示されます。 ほとんどの場合、現在目にしているコンテンツを表示するためにどのような技術が使用されているかを、訪問者が意識することはありません。 訪問者にとって、それらのコンテンツは他の Web ページに似た外観のように感じられます。
CSWP 内でクエリを設定すると、訪問者が CSWP を含むページを閲覧したときに、どのようなコンテンツが表示されるかを定義できます。 既定では、CSWP 内のクエリは、サイト内で最近変更された 3 つのアイテムを表示するように設定されています。 クエリを設定すると、CSWP 内で表示されるアイテムの数と、表示されるコンテンツを変更できます。 たとえば、CSWP で特定のリストから取得した 9 つのアイテムが表示されるように、または訪問者がドキュメント ライブラリ内で過去に作成した 6 つのドキュメントが表示されるように、クエリを設定することができます。
コンテンツ検索 Web パーツを追加する
-
自分が、Web パーツの追加先サイトの SharePoint 編集者グループのメンバーであることを確認してください。
-
Web パーツを追加するページに移動します。
-
[ページ設定
![[サイトの設定] の代わりになる小さな [設定] ギア](https://support.content.office.net/ja-jp/media/a47a06c3-83fb-46b2-9c52-d1bad63e3e60.png)
-
Web パーツを追加するゾーンで、[Web パーツの追加] を選びます。
-
[カテゴリ] リストで、[おすすめコンテンツ] をクリックします。
-
[パーツ] リストで、[コンテンツ検索]、[追加] の順にクリックします。
コンテンツ検索 Web パーツ内で単純なクエリを設定してコンテンツを表示する
CSWP で発行するクエリが単純な場合 (たとえば、検索結果を結果ソースまたは特定のタグに制限する 場合)、[BASICS]タブの構成オプションのみを使用する必要があります。
![コンテンツ検索 Web パーツ内でクエリを設定する場合の [基本] タブ](https://support.content.office.net/ja-jp/media/f8bf8e2f-05ec-4340-907b-92044cde9a68.png)
-
自分が、CSWP を含むサイトの SharePoint 編集者グループのメンバーであることを確認してください。
-
編集する CSWP を含むページに移動します。
-
[ページ設定
-
Web パーツで、Web パーツ メニューの矢印をクリックし、[Web パーツの編集] をクリックします。
-
Web パーツのツール ウィンドウで、[プロパティ] セクションの [検索条件] セクションにある [クエリの変更] をクリックします。
上の図のようなダイアログ ボックスが表示されます。 ここで、次の表で説明するようにクエリを設定できます。
|
クエリの選択 |
[結果 ソースの管理] を選択 して、検索するコンテンツを指定します。 |
||||||||
|---|---|---|---|---|---|---|---|---|---|
|
アプリで制限する |
特定のサイト、ライブラリ、リスト、または URL に結果を制限するためのオプションを一覧から選びます。 |
||||||||
|
タグで制限する |
特定の用語でタグ付けされているコンテンツのみに、結果を制限します。 次のいずれかを選びます。
|
コンテンツ検索 Web パーツ内で高度なクエリを設定してコンテンツを表示する
CSWP で発行するクエリが高度な場合 (たとえば、キーワード クエリ言語(KQL) 構文リファレンス)を使用する場合は、[基本] タブの [詳細設定モード] で使用できる構成オプションを使用する必要があります。
詳細モードでクエリを 構成する場合は、クエリ変数 を使用することもできます 。 クエリ変数は、クエリの実行時に値に置き換えられるプレースホルダーです。 クエリ変数の例として、ページを表示しているユーザーの名前のプレースホルダーである {User.Name} や、URL の最初の値のプレースホルダーである {URLToken.1} があります。これは右から左にカウントされます。
-
自分が、CSWP を含むサイトの SharePoint 編集者グループのメンバーであることを確認してください。
-
編集する CSWP を含むページに移動します。
-
[ページ設定
-
Web パーツのツール ウィンドウで、[プロパティ] セクションの [検索条件] セクションにある [クエリの変更] をクリックします。
-
表示されるダイアログ ボックスで、[詳細モードへの切り替え] をクリックします。
-
次の表の説明に従って、クエリを設定します。
|
[基本] タブ |
|
|---|---|
|
クエリの選択 |
検索先を選んで、検索対象のコンテンツを指定します。 |
|
キーワード フィルター |
キーワード フィルターを使用して、クエリ変数をクエリに追加できます。 使用可能なクエリ変数の一覧については、「SharePoint Server 2013 のクエリ変数」を参照してください。 ドロップダウン リストから定義済みのクエリ変数を選び、[キーワード フィルターの追加] をクリックして、クエリにそのクエリ変数を追加することができます。 |
|
プロパティ フィルター |
プロパティ フィルターを使って、検索スキーマ内で [クエリ可能] に設定されている管理プロパティのコンテンツを照会できます。 [プロパティ フィルター] ドロップダウン リストから管理プロパティを選ぶことができます。 [プロパティ フィルターの追加] をクリックして、フィルターをクエリに追加します。 注: カスタム管理プロパティは、[プロパティ フィルター] の一 覧には表示 されません。 カスタム管理プロパティをクエリに追加するには、[クエリ] テキストボックスにカスタム管理プロパティの名前を入力し、その後にクエリ条件を入力します (例: MyCustomColorProperty:Green) |
|
クエリ テキスト |
キーワード クエリ言語(KQL)を使用してクエリを入力するか、キーワードフィルターリストとプロパティ フィルター リストを使用してクエリを作成します。 キーワード クエリは、フリーテキスト キーワード、プロパティ フィルター、または演算子で構成することができます。 クエリ変数はかっこで囲みます。 クエリの実行時、クエリ変数は値に置き換えられます。 キーワード クエリの最大長は 2,048 文字です。 |
|
[絞り込み条件] タブ |
|---|
|
このタブを使用して、検索結果を、絞り込み条件の値を 1 つ以上含むアイテムのみに制限することができます。 [絞り込み条件を選択] セクションで表示されている検索スキーマで、絞り込み条件として有効になっている管理プロパティです。 この一覧で絞り込み条件の値を選び、[追加] をクリックしてクエリに追加します。 1 つ以上の管理プロパティに対して検索結果をグループとして表示するには、[詳細表示] を選びます。 これは、指定したアイテムに対して複数のバリエーションを表示し、1 つの結果にグループ化したい場合に便利です。 |
|
[並べ替え] タブ |
|---|
|
このタブで、検索結果を並べ替える方法を指定できます。 [並べ替え] ドロップダウン リストで一覧表示されている検索スキーマで、並べ替え可能として設定されている管理プロパティです。 一覧で管理プロパティを選び、[降順] または [昇順] を選びます。 さらに並べ替えレベルを追加するには、[並べ替えレベルの追加] をクリックします。 [並べ替 え] ボックス の一覧 から [順位付け] を選択した場合は、[動的順序ルールの追加] を選択して、ルールと条件を 追加できます。 |
|
[設定] タブ |
|
|---|---|
|
クエリ ルール |
クエリ ルールを使用するかどうかを選びます。 |
|
URL の書き換え |
発行サイトをカタログに接続したときの定義に従って、URL を、各カタログ アイテムに対する相対的なアイテム詳細ページに書き換えたい場合に選びます。 [URL を書き換えない] を選んだ場合は、カタログ アイテムに対応する URL は、接続先カタログのライブラリ アイテムを直接指すようになります。 |
|
読み込み時の動作 |
コンテンツ検索 Web パーツから返された検索結果が Web ページに表示される時間を選択します。 既定のオプションは [非同期] オプションです。ブラウザーからクエリを発行します。 完全なページを受信した後 (非同期) に、エンド ユーザーのブラウザーからクエリが発行されます。 同期オプション [同期オプション:サーバーからのクエリの発行] を選択した場合、クエリはサーバーから発行され、検索結果は SharePoint (同期) から返されるページ応答に含まれます。 同期読み込みにより、検索はクロスサイト リクエスト フォージェリ攻撃に対して脆弱です。 この脆弱性を悪用できるかどうか を慎重に検討した後にのみ、このオプションを選択します。 |
|
優先度 |
他の検索 Web パーツに関連して、この Web パーツで表示されるコンテンツの優先度を選びます。 負荷が大きい時に SharePoint が実行されている場合は、優先度に従って各クエリが実行されます。 |
|
キャッシュ |
ある Active Directory セキュリティ グループのユーザーの検索結果をキャッシュする場合、そのグループを選びます。 セキュリティ グループの検索結果をキャッシュすると、ページの読み込み時間を短縮できます。 注: グループ内のすべてのユーザーで検索結果が同一であるセキュリティ グループだけを選んでください。 詳細については、「コンテンツ検索 Web パーツのキャッシュを使用してページの読み込み速度を向上させる 」を参照してください。 |
|
[テスト] タブ |
|
|---|---|
|
このタブで、CSWP から送信される詳しいクエリをプレビューできます。 |
|
|
クエリ テキスト |
CSWP によって実行されるクエリを表示します。 |
|
[詳細表示] をクリックして詳しい情報を表示します。 |
|
|
クエリ テンプレート |
クエリに適用されるクエリ テンプレートのコンテンツを表示します。 |
|
絞り込み条件 |
クエリに適用される絞り込み条件。[絞り込み条件] タブで定義します。 |
|
グループ化 |
[絞り込み条件] タブの定義に従って、管理プロパティによってグループ化された検索結果を表示します。 |
|
適用されたクエリ ルール |
クエリに適用されるクエリ ルールを表示します。 |
|
クエリ テンプレート変数 |
クエリに適用されるクエリ変数および現在のページに適用される変数の値を表示します。 結果をプレビューするには、[クエリのテスト] をクリックします。 |
|
さまざまなユーザー セグメントの用語に対してクエリがどのように動作するかをテストするには、[ユーザー セグメントの追加] の用語を選びます。 結果をプレビューするには、[クエリのテスト] をクリックします。 |
|
|
クエリ テキスト |
CSWP によって発行されるクエリを表示します。 |
コンテンツ検索 Web パーツ内でコンテンツが表示される方法を制御する
CSWP 内でコンテンツが表示される方法を制御するには、表示テンプレートをカスタマイズする必要があります。 カスタム表示テンプレートを作成する方法については、「SharePoint 2013 Design Manager の表示テンプレート」を参照してください。
ヒント読み込み時間を短縮するためにコンテンツ検索 Web パーツを構成する方法について説明します
CSWP は、クエリを構成するための多くの柔軟性を提供します。 ただし、非常に複雑なクエリを使用する Web パーツを構成する場合、 SharePoint はクエリの解決にさらに取り組む必要があります。この場合、ページの読み込み時間が長くなる可能性があります。 検索の専門用語では、これはクエリの待機時間の増加と同じです。
次のヒントは、クエリの複雑性とページ読み込み時間を短縮するのに役立ちます。
-
複数の OR 演算子を使用しないようにします。 OR 演算子は、AND 演算子よりもクエリの複雑さを増します。 クエリに OR 演算子が含まれている場合は、代わりに AND 演算子を使用するクエリを変更してみてください。
-
ワイルドカード演算子 (*) は使用しないようにします。 代わりに、完全一致を使用するクエリを構成してみてください。
-
キーワード フレーズの使用は避ける。 代わりに、1 つのキーワードを使用してみてください。
-
ユーザー プロパティまたは用語と用語セットのプロパティを含むクエリ変数は使用しないようにします。 これらのプロパティの詳細と例については、「SharePoint Server 2013のクエリ変数」を参照してください。
-
並べ替えレベルや動的順序付けルールなどのユーザー設定の並べ替えを追加しないようにします。 代わりに、[並べ替え] タブの [並べ替え] プルダウン メニューから既定の並べ替えオプションを使用してみてください。
-
クエリ ルール を使用していない場合は、[設定]タブの [クエリ ルールを使用しない]を選択します。
-
CSWP を使用して製品カタログのコンテンツを表示していない場合 は、[設定]タブの [URL を書き換えない]を選択します。
