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

コンテンツの検索

すべてのインデックス付きコンテンツ(別名 Liferay DXPのアセット )を検索結果として返すことができます。 カスタム コンテンツもインデックス付けされる可能性があるため、インストール時に、デフォルトで含まれているもの以外に追加のアセット タイプが含まれる場合があります。 次の画像は、Liferay DXPでインデックスが作成されるさまざまなタイプのコンテンツの例を示しています。

これらのアプリがデプロイされている場合、そのコンテンツはデフォルトで検索可能です。

デフォルトのLiferay DXP設定を使用すると、ユーザーは検索バーに検索語を入力して検索を行うことができます。 検索を実行すると、さまざまな検索ウィジェットが展開された 検索ページ が表示されます。

デフォルトの検索設定では、デフォルトのビューに検索バーが表示され、ユーザーに検索コンテキストの入力を求めます。

検索用語を入力する

Liferay の検索インフラストラクチャは、 サポートされている検索エンジンによって実装された全文検索をサポートしています。

全文検索では、検索クエリに入力されたすべての単語(例えば、 stock market)と、インデックスされた各文書に含まれるすべての単語を比較します。 Elasticsearchのような検索エンジンは、関連性スコアを計算して、最適な結果が最初に返されるようにしています(最近の強気の市場についてのBlog Entryなど)。 株式市場 のような単語を含むものがすべて返されます。

全文検索に加えて、高度な検索構文がサポートされています。 正確な動作は基盤となる検索エンジンによって決まるため、検索エンジンのドキュメントを参照してください。

Elasticsearchのクエリ文字列構文を使用して、特定のフィールドのテキストを検索します。

検索バーの候補: ユーザーの文字入力に合わせて検索

ユーザーが検索フレーズを入力すると、検索バーに自動的に検索候補が表示されます。

検索バーの候補は、ユーザーが検索バーに検索フレーズを入力すると、予備的な結果を返します。

動作の詳細については、 検索バーの候補を参照してください。

検索バーのクエリを引用符で囲むと、検索エンジンはより厳密に一致を生成するようになります。 正確な動作は、検索対象のフィールドの種類によって異なります。

引用全文検索:一致順序の確保

検索バーのクエリを引用符で囲むと、検索された用語がまったく同じ順序で表示される場合にのみ、フィールドと一致します。 検索エンジンは、インデックスされたコンテンツと検索フレーズに対して分析が行われるため、引用されたフレーズを正確に一致させることはできません。

コンテンツ フィールドに次のテキストを含むブログエントリを考えてみましょう。

双方に利益のある存続のための 戦略をテーブルに持ち込み、積極的なコラボレーション を確実にします。

デフォルトの英語アナライザーでは、検索フレーズ 「strategy that ensures」 はこのブログエントリを返します。 検索キーワードとインデックスされたテキストに対して同じ分析が実行され、ステミング、ストップワードの削除、その他のトークン化が考慮されます。 フレーズを引用符で囲むと、フレーズ内の個別のトークンが、相互の相対位置を含め、インデックス付けされたドキュメント フィールド内のトークンと一致することが強制されます。

対照的に、キーワード "strategies ensure" を検索しても、上記のブログエントリドキュメントは返されません。これは、分析によって生成されたトークンの相対的な位置が、検索キーワードとインデックス付けされたコンテンツ間で異なるためです。

返されるコンテンツでトークンの順序が一致するようにするには、検索用語を引用符で囲みます。

引用キーワード検索: 完全一致

分析されていないフィールド (キーワード フィールドなど) を検索する場合、引用符で囲まれた検索フレーズとフィールド値が正確に一致する必要があります。

通常の Liferay 検索では、分析されたフィールドと分析されていないフィールドの両方がインデックス ドキュメントに存在します。 分析されていないフィールドは、その内容が引用符で囲まれた検索フレーズと完全に一致する場合にのみ結果を生成しますが、分析されたフィールドは、そのトークンが引用符で囲まれた検索フレーズのトークンと一致し、同じ相対位置に表示される限り結果を生成します。

プレフィックス検索

プレフィックス検索では、楽器という用語を検索すると、完全な単語を含むドキュメントだけでなく、楽器をプレフィックスとするバリエーションも返します。 たとえば、 楽器楽器、および 楽器 を含む結果も返されます。

lever を検索すると、leverage と leverageing も返されます。

プレフィックス検索は、多くのフィールドですぐに利用できますが、ボンネットの中はもっと複雑です。 フィールドで使用されている分析器や実行された変換など、フィールドマッピングの詳細が最終的な動作を決定します。

ユーザーに結果を確実に表示するもう 1 つの方法は、 検索候補を使用することです。

検索バーの動作はウィジェット設定画面で設定できます。 構成オプションは、表示設定、提案構成、または詳細構成に分類されます。

構成画面で検索バーの動作を構成します。

あるページの上部にグローバルに埋め込まれた検索バーウィジェットを設定すると、サイト内のすべてのページでページトップの検索バーウィジェットが設定されます。 また、 宛先検索ページの 検索バー ウィジェットが異なって設定されている場合は、そちらも上書きされます。 ただし、他のページに手動で設置した検索バーウィジェットを上書きすることはできません。

表示設定

表示テンプレート: 検索バーのスタイルを設定する ウィジェット テンプレート を選択します。 すぐに使用できる代替テンプレートが 1 つあります: 左揃えアイコン レイアウト。 検索バーの候補を使用する場合は、デフォルトの表示テンプレートを使用する必要があります。

キーワードパラメータ名: 検索で入力したキーワードのパラメータ名を編集します。 たとえば、キーワード データ 検索するときのデフォルトのURLは次のようになります。

http://localhost:8080/web/guest/search?q=data

キーワードパラメータ名を キーワード に変更すると、次のようになります。

http://localhost:8080/web/guest/search?keyword=data

スコープ: このサイト(デフォルト)、すべて、およびユーザーに選択させるの3つのオプションから選択します。 このサイト は、検索が実行されるサイトに関連付けられているアセットのみが検索されることを意味します。 すべてを選択して、検索範囲をすべてのサイトに展開します。 ユーザーが検索するスコープを選択できるようにするには、[ ユーザーに選択させる]を選択します。

ユーザーに検索を実行する範囲を選択させます。

スコープパラメータ名: 検索が行われているスコープのURLパラメータ名を設定します。 このパラメーターは、スコープ ユーザーに を選択させるが選択されている場合にのみURLに表示されます。 デフォルト値は scopeで、単語 data を検索すると、デフォルトURLは次のようになります。

http://localhost:8080/web/guest/search?q=data&scope=this-site

スコープターゲット に変更すると、次の URL が生成されます。

http://localhost:8080/web/guest/search?q=data&target=this-site

宛先ページ: 検索ページへのフレンドリ URL を指定します。 構成されていない場合、または存在しないページを指している場合、ユーザーに表示するには検索バーを構成する必要があるというメッセージが管理者に表示されます。

プレースホルダー テキスト: 2025.Q4+デフォルトの検索バーのプレースホルダー テキストを置き換えます。 [言語キー](../../security-and-administration/administration/configuring-liferay/changing-translations-with-language-override.md#adding-a-language-key-and-translation)を使用して値をローカライズできます。 デフォルトのプレースホルダーはsearch-…で、英語では Search… と翻訳されます。

検索提案の設定

検索バーの候補 が利用可能で有効になっている場合、検索バー ウィジェットの構成に追加の構成が表示されます。 これらの設定オプションについて詳しくは、 検索バーの候補の設定 を参照してください。

詳細設定

高度な検索構文を使用する: Elasticsearch または OpenSearchを使用している場合、これを有効にすると、ユーザーは検索バーにクエリ文字列構文を入力できます。 Solr を使用する場合は、 適切な構文についてはそのドキュメントを参照してください。

ステージングされたサイトからの結果を表示: ステージング環境 からのコンテンツは、この設定に関係なく、ライブサイトでは 検索できません 。 この設定は、ローカルステージングを有効にしたサイトで「すべて」のスコープが構成されている場合に、他のローカルステージングサイトからのコンテンツの検索を可能にします。

Liferay Objectの検索

詳細タブで「インデックス検索を有効にする」設定を選択すると、各 オブジェクト定義 を検索可能にすることができます。 有効にすると、 各フィールド を検索可能として設定することもできます。これにより、オブジェクト エントリ を照会して 、検索結果ウィジェットに返すことができます。

重要

オブジェクトの範囲によって、検索方法が決まります。

  • オブジェクトのスコープが会社の場合、検索バーがすべてを検索するように設定されている場合にのみ、オブジェクトのエントリが検索されます。
  • オブジェクトのスコープがサイトの場合、検索バーがこのサイト内を検索するように構成されていると、オブジェクトのエントリを検索できます。

タイプ ファセットと検索結果ウィジェットは、次の方法で Liferay オブジェクトの検索をサポートします。

  • タイプファセットには自動的に公開オブジェクトが含まれます。

    公開オブジェクトがタイプファセットウィジェットに追加されます。

  • 検索結果ウィジェットには、オブジェクトエントリのタイトルと概要が自動的に表示されます。

    オブジェクト エントリのタイトルとコンテンツの概要が表示されます。

Liferay 7.4 U64+/GA64+ の場合、検索結果でオブジェクトエントリをクリックすると、エントリの 表示ページ(存在する場合)にリダイレクトされます。

Liferay DXP 2024.Q1+/Portal GA112+では、検索ユーザーがアカウントまたは通常スコープのロールで アカウント > アカウントエントリ:表示 権限を持っている場合、 アカウント制限オブジェクト のエントリが検索結果に表示されます。 サイト、組織、アカウントへの管理アクセス権を持つユーザーの検索クエリには多くの権限句が追加されるため、検索パフォーマンスが低下する可能性があります。 システムでこれに気付いた場合は、検索フレームワークの 初期権限チェックで権限句の数を制限することができます。 これを行うには、 権限チェッカーの 権限の有効期限設定を構成します。