ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

検索バーの候補の設定

7.4 U36+およびGA36+

検索バーの候補は、Liferay の検索バーウィジェットに 入力時に検索 機能を追加します。

ユーザーは通常どおり検索バーに検索キーワードを入力します。キーワードは Liferay によって取り込まれ、検索エンジンに送信され、結果はドロップダウンリストで返されます。入力を続けると、追加のクエリが送信されます。リストから結果の 1 つをクリックするか、虫眼鏡アイコンまたは Enter キーを押して通常どおり検索を実行し、検索結果ウィジェットに結果を表示できます。

設定オプション

インスタンス設定で検索バーの候補が有効になっている場合は、ウィジェットスコープで検索候補を設定できます。

検索バーの候補を構成する主な方法は、検索バーウィジェットの構成を使用することです。

提案を有効にする: 提案はデフォルトで有効になっています。提案をオフにするには、チェックボックスをオフにします。

候補を表示するための文字数のしきい値: 構成された文字数が検索バーに入力されるたびに、クエリが再処理され、結果がそれに応じて更新されます。この設定を調整して、大量の検索リクエストの送信（しきい値を低く設定しすぎると、多くの検索リクエストがトリガーされる）と使いやすさ（しきい値を高く設定しすぎると、最初の提案クエリをトリガーするためにユーザーが大量に入力する必要がある）のバランスを取ります。

提案コントリビューターの設定: 検索エンジンに送信されるクエリを制御するコントリビューターを設定します。この設定は 3 つの値で構成されます。

提案投稿者: デフォルトの投稿者であり、Liferay CE ですぐに使用できる唯一の投稿者は、 基本です。 Liferay DXP では、代わりに 1 人以上の Blueprint コントリビューターを使用するように選択できます。詳細については、検索バーの候補ブループリントを参照してください。
表示グループ名: デフォルトは 候補です。この値は、英語の UI の見出しとして「提案」に解決される言語キーです。言語キーを変更したり、独自の言語キーを追加したりできます。たとえば、 これがあなたが探しているものですにして、翻訳を追加します。複数のブループリントコントリビュータを使用している場合は、それぞれの表示グループ名が一意であることを確認してください。
サイズ: 検索バーのドロップダウンリストに表示する結果の最大数を設定します。デフォルトは 5です。表示スペースは限られているため、サイズを大きな数値に設定してもメリットはありません。

ヒント

検索ブループリントユーザーは、ブループリントを使用して検索バーの候補クエリを制御することを選択できます。 ブループリント がコントリビューターとして選択されると、検索バーウィジェットの構成に追加の構成オプションが表示されます。詳細については、検索バーの候補ブループリントを参照してください。

コントロールパネルで検索バーの候補を設定する

検索バーの候補に影響を与える可能性があるコントロールパネルの構成エントリは 3 つあります。

サービス・アクセス・ポリシー
システム設定の検索候補
システムとインスタンス設定の検索バー

提案サービスアクセスポリシーの設定

サービスアクセスポリシーは、Liferay のサービスへのアクセスを制御します。検索バーの候補に関するポリシーはデフォルトで有効になっており、認証されていないユーザーが候補を返す REST サービスエンドポイントにアクセスできるようになります。つまり、ゲストユーザーが検索バーに入力するときに、検索バーの候補が表示されるようになります。

サービスアクセスポリシーを構成するには、

グローバルメニュー → コントロールパネル → サービスアクセスポリシー (セキュリティセクション内) を開きます。
SEARCH_SUGGESTIONS エントリをクリックします。

ポリシーを無効にすると、ウィジェット設定で提案が有効になっている場合でも、ゲストには提案が表示されません。

提案RESTエンドポイントの構成

検索バーの候補機能を提供する REST エンドポイントは、必要に応じて、システム設定またはインスタンス設定を使用して無効にすることができます。

検索候補エンドポイントを構成するには、

グローバルメニュー → コントロールパネル → 構成セクションのシステムまたはインスタンス設定に移動します。
プラットフォーム → 検索カテゴリで、検索候補エントリを開きます。
設定は 1 つだけあります: 有効。

無効にすると、必要なエンドポイントへの呼び出しは無視されます。したがって、検索バーの候補のその他の構成は考慮されません。実際、検索バーウィジェットの構成では、検索バーの候補設定は表示されません。この機能はシステムまたはインスタンス全体で完全に無効になります。

検索バーでの候補の設定

検索バーの候補のほとんどの構成はウィジェットのスコープ内で行われます。検索バーウィジェットの構成に加えて、システムおよびインスタンススコープで検索バーの候補のデフォルトを構成できます。

システム、インスタンス、またはウィジェットスコープで検索バーの候補を有効または無効にすると、次のようになります。

構成範囲	有効?	検索バーウィジェットの結果
システム設定	✘	すべてのインスタンスのデフォルトを無効に設定します。ウィジェット設定には提案設定は表示されません。
インスタンス設定	✘	ウィジェット設定には提案設定は表示されません。
インスタンス設定	✔	提案が有効になり、ウィジェット構成に設定が表示されます。ウィジェット設定で提案を無効にすることができます。