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

コンテンツの検索

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

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

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

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

検索用語を入力する

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

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

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

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

検索バーの候補表示:ユーザーが入力するにつれて検索候補が表示されます

検索バーは、ユーザーが検索語句を入力すると自動的に検索候補を表示します。

検索バーの候補機能は、ユーザーが検索バーに検索語句を入力すると、暫定的な検索結果を表示します。

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

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

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

検索バーのクエリを引用符で囲むと、検索語句が完全に同じ順序で出現する場合にのみ、検索語句がフィールドに一致します。 検索エンジンは引用されたフレーズと完全に一致する結果を表示しません。なぜなら、インデックス化されたコンテンツと検索フレーズの両方に対して分析が行われるからです。

ブログ記事の コンテンツ フィールドにこのテキストが含まれている場合を考えてみましょう。

双方に利益をもたらす生存戦略を提示し、積極的な協力を確実なものにする。

デフォルトの英語アナライザーでは、検索フレーズ "strategy that ensures" でこのブログ記事が返されます。 検索キーワードとインデックス化されたテキストに対しても同様の分析が行われ、語幹抽出、ストップワードの削除、その他のトークン化が考慮されます。 フレーズを引用することで、フレーズ内の個々のトークンが、インデックス付きドキュメントフィールド内のトークンと、それらの相対的な位置も含めて一致することが強制されます。

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

検索語句を引用符で囲むことで、返されるコンテンツ内でトークンの順序が一致するように強制できます。

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

分析対象外のフィールド(キーワードフィールドなど)を検索する場合、引用符で囲まれた検索語句とフィールドの値が完全に一致する必要があります。

通常のLiferay検索では、インデックス文書には分析済みフィールドと未分析フィールドの両方が含まれます。 分析対象外のフィールドは、その内容が引用された検索語句と完全に一致する場合にのみ結果を生成しますが、分析対象のフィールドは、そのトークンが引用された検索語句のトークンと一致し、かつ同じ相対位置にあれば結果を生成します。

プレフィックス検索

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

「レバー」を検索すると、「レバレッジ」と「レバレッジング」も表示されます。

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

ユーザーが結果を確認できるようにするもう 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 を指定してください。 構成されていない場合、または存在しないページを指している場合、ユーザーに表示するには検索バーを構成する必要があるというメッセージが管理者に表示されます。

プレースホルダーテキスト: Liferay DXP 2025.Q4+ では、デフォルトの検索バーのプレースホルダーテキストを置き換えることができます。 言語キー を使用して値をローカライズできます。 デフォルトのプレースホルダーは search-... ですこれは英語で Search… と翻訳されます。

検索提案の設定

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

詳細設定

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

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

Liferay Objectの検索

各オブジェクト定義を検索可能にするには、Details タブで Enable Indexed Search 設定を選択します。 有効にすると、各フィールドを検索可能に設定することもできます。オブジェクトエントリは、検索結果ウィジェットで照会して返すことができます。

重要

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

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

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

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

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

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

    オブジェクトエントリには、タイトルと内容の概要が表示されます。

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

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