検索ブループリントを検索ページで使用する

デフォルトでは、検索ページには 検索ブループリント が関連付けられていません。 Liferay 検索エクスペリエンスに影響を与えるには、ブループリントを 検索ページ に適用する必要があります。 サイトに複数の検索ページがある場合は、ブループリントを使用するページごとに個別に構成する必要があるため、各ページで以下の手順に従います。 必要に応じて、ページごとに異なるブループリントを使用できます。

検索ページが検索ブループリントに反応するようにするには、

1. ブループリントを作成します。

2. 検索ページを作成するか、そこに移動します。

3. ［ページにブループリントオプションウィジェット］を追加します。

4. ウィジェットの オプション アイコン () をクリックし、 構成をクリックします。

   注

   Liferay DXP 2025.Q1/Portal GA132 より前では、設定オプションはウィジェットの右上隅に表示されていました。

5. ページのブループリントを選択するには、 [選択]をクリックします。

   

6. ブループリントを選択したら、構成画面で 保存 をクリックします。

これで、ブループリントの機能がページに適用されます。

管理ユーザーは、代わりに 低レベル検索オプション ウィジェットを使用して、検索ページにブループリントを適用できます。 ウィジェットの［設定］を開きます。 ［属性］セクションに、次を追加します。

• キー: search.experiences.blueprint.erc ¹
• 値: [ブループリントの外部参照コード (ERC)]

検索ページで既に「低レベル検索オプション」ウィジェットを使用していない限り、「ブループリント オプション」ウィジェットを使用するとブループリントを設定するのがより便利です。 ブループリントのテストなどのために他の検索コンテキスト属性を設定する必要がある場合は、低レベル検索オプション ウィジェットを使用します。

追加の検索コンテキスト属性の適用

ブループリントは、ブループリントのオプションウィジェットを使用してページに適用するか、上記のように低レベルの検索オプションウィジェットで検索コンテキスト属性を使用して適用されます。 低レベル検索オプション ウィジェットで追加の検索コンテキスト属性を設定できます。 ページの検索に検索コンテキスト属性を設定する必要がある主な理由は2つあります。

1. ブループリントは、カスタム パラメータ (Liferay の検索フレームワークによって設定されていないもの) を定義して応答することができ、これらは低レベル検索オプション ウィジェットで手動で設定できます。

2. 検索コンテキスト属性を設定し、検索リクエストを実行することで、検索ページでブループリントの動作をテストすると便利です。

   すぐに使用できる要素で使用されるパラメータの詳細については、 要素リファレンスを参照してください 。

---

1. Liferay DXP 2023.Q4/Portal GA102より前のバージョンでは、代わりにID: search.experiences.blueprint.idを使用する必要があります。 ブループリント ID または ERC は、ブループリント アプリケーション (グローバル メニュー → アプリケーション → ブループリント (エクスペリエンスの検索)) から見つけることができます。 ブループリントをクリックしてエディターを開きます。

   ↩