類似結果
変更通知を受け取る(購読する)
DXP 7.3 および 7.4 にバンドルされています。DXP 7.2 SP2+/FP5+ 用の Liferay Marketplace
類似結果ウィジェットには、ページで選択されたメインアセットに類似した検索結果が表示されます。
主なアセットの概念は重要です。 DXP の特定のウィジェットには、アセット パブリッシャー、ブログ、Wiki などのアセットのリストが表示されます。 ユーザーが表示されたアセットの1つをクリックし、ウィジェットがそのすべてのコンテンツをページ上に表示する場合、それはページのメインアセットです。 類似結果ウィジェットを同じページに配置した場合、 その他の類似クエリによって返されるほど類似したアセットのリストが表示されます。 メインアセットの概念は、Elasticsearch の 入力ドキュメントと同義です。
類似結果は、入力ドキュメント/メインアセットを使用して、クエリに最も一致するものとして自分自身を返すクエリを作成し、この選言クエリ(または OR)を検索エンジンに送信して、一致する結果ドキュメントを返します。 このプロセスは構成可能です。入力ドキュメントを処理する方法、処理されたコンテンツから用語を選択する方法、およびクエリ自体を形成する方法です。 詳細については、Elasticsearch のドキュメントを参照してください。
検索結果ウィジェットの構成
-
追加 (
) をクリックして、フラグメントとウィジェット パネルを開きます。 -
ウィジェット タブの検索カテゴリで、 類似結果 ウィジェットをページ上の任意の場所にドラッグします。
-
ウィジェット ヘッダーの オプション (
) → 構成をクリックします。
注Liferay DXP 2025.Q1/Portal GA132 より前では、設定オプションはウィジェットの右上隅に表示されていました。
使用可能なプロパティの完全なリストについては、 類似の結果構成 を参照してください。
類似結果ウィジェットの使用
類似結果ウィジェットがページに配置されるとどうなるかは、ページに現在表示されているコンテキストとアセットによって異なります。 ページでメインアセットが選択されていない場合、類似結果には何も表示されません。ページのスペースは空白のままです。 サイト管理者には次の情報メッセージが表示されます。
類似の結果は存在しません。
メインアセットのドキュメントが検出されると、ウィジェットには同じアセットタイプの同様の結果が、構成された ウィジェットテンプレートによって指定された形式で表示されます。
2つの使用例を検討して詳細ヘルプを確認してください。
ユースケース1:アセットパブリッシャーページでの類似結果
アセット パブリッシャーでアセットを選択すると、同じアセット タイプの類似結果 (一致する検索ヒットとして返される結果) が表示されます。
この例を構成するには、
-
ウィジェットページを作成します。 [Asset Publisher]ウィジェットと [Similar Results]ウィジェットを追加します。

-
Asset Publisher の設定「表示設定」 に移動し、「Asset Link の動作」を 「完全なコンテンツを表示」に設定します。
これにより、選択したアセット表示がアセットパブリッシャー内でコンテンツ全体を表示します。 新しいページで表示を選択した場合、アセットがネイティブに存在するページにリダイレクトされ、類似結果ウィジェットは役に立たなくなります。
-
以下にリストされているタイプの類似のアセットを複数作成します。 それらが十分に類似していることを確認して、類似結果ウィジェットに結果が表示されるようにします。
「More Like This Query」によって返されるアセットを作成するには、作成するアセットの内容と Similar Results ウィジェットの構成に注意してください。 テストの場合、最小用語頻度と最小文書頻度値を両方とも
1に設定することをお勧めします。- ブログエントリー
- ドキュメントとメディアファイル
- ドキュメントとメディアフォルダー
- Webコンテンツの記事
- Webコンテンツフォルダー
- Wikiページ
- 掲示板スレッド
- 掲示板のメッセージ
- 掲示板カテゴリ
アセットパブリッシャーウィジェットで表示されたアセットをクリックすると、同様の結果が類似結果ウィジェットに表示されます。

類似結果の1つをクリックします。 アセットパブリッシャーはメインアセットを更新し、新しいメインアセットについて類似結果が再計算されます。
ユースケース2:アセット表示ページでの類似結果
これらのウィジェットと付随するアセットは、それらのアセットのリストを表示し、類似結果ウィジェットのメインアセットとして使用するものを選択できます。
| ウィジェット名 | アセットタイプ |
|---|---|
| ブログ | ブログエントリー |
| ドキュメントとメディア | ドキュメントとメディアファイル、フォルダ |
| Wiki | Wikiページ |
| 掲示板 | 掲示板のスレッド、メッセージ、およびカテゴリー |
ブログで類似結果を使用する例を設定するには、
-
ウィジェットページを作成します。 ブログウィジェットと類似結果ウィジェットを追加します。
-
複数の類似したブログエントリを作成します。 それらが類似していることを確認し、類似結果ウィジェットがそれらを結果として返すようにします。
「More Like This Query」によって返されるアセットを作成するには、作成するアセットの内容と Similar Results ウィジェットの構成に注意してください。 テストの場合、最小用語頻度と最小文書頻度値を両方とも
1に設定することをお勧めします。 -
ブログウィジェット内のブログ投稿をクリックします。 ブログエントリが表示され、類似結果ウィジェットに類似エントリへのリンクが表示されます。
-
類似結果の1つをクリックします。 ブログ コンテンツが現在のページのブログ ウィジェットに表示されるようになりました。

類似結果ウィジェットテンプレート
デフォルトでは、同様の結果は コンパクト レイアウト ウィジェット テンプレートを使用してレンダリングされ、ハイパーリンクされたタイトルのリストが表示されます。
2つのウィジェットテンプレートが最初から用意されています。リストレイアウトとカードレイアウトです。
リストレイアウトです。

カードのレイアウトです。

類似結果のカスタムウィジェットテンプレートを追加する
類似結果表示用の独自のウィジェットテンプレートを作成するには、
-
編集を開始 類似結果 ウィジェットが展開されているページ。
-
ウィジェット ヘッダーの オプション (
) → 構成をクリックします。注Liferay DXP 2025.Q1/Portal GA132 より前では、設定オプションはウィジェットの右上隅に表示されていました。
-
[テンプレートの管理]をクリックして、[ウィジェットテンプレート]画面を表示します。
-
追加 (
) をクリックして、テンプレート作成パレットを開きます。標準の ウィジェット テンプレート 変数に加えて、テンプレート エディターで提供される検索固有の変数を活用します。
-
好みに合わせてテンプレートをデザインしてください。 詳細については、 ウィジェット テンプレート のドキュメントを参照してください。
同じテンプレートエディターには、[サイトメニュー]の[ サイトビルダー] セクションの[ウィジェットテンプレートエントリー]からアクセスできます。
類似結果設定
最初の設定オプションは、[表示設定]というセクションに表示されます。
表示テンプレート: ウィジェット テンプレートを選択して、類似の結果の表示方法を構成します。
[Maximum Item Display]: ウィジェットに表示する結果の最大数を設定します。
詳細設定セクションでは、ウィジェットの動作を微調整するための設定を収集します。 これらの設定の多くは、Elasticsearch の More Like this Queryを構成するために使用されます。
| 詳細設定 | 定義 |
|---|---|
| スコープ 7.4 U17+ で利用可能 | [このサイト](デフォルト)と[すべて]から選択し、現在のサイト(このサイト)のみから類似結果を表示するか、すべてのサイト(すべて)に検索範囲を拡大します。 |
| リンクの動作 7.4 U18+ で利用可能 | クリックした結果を同じ表示ページに表示するには、「コンテンツを表示」(デフォルト) と「新しいページで表示」を選択します。または、クリックした結果をそのコンテキストに表示します (「新しいページで表示」、たとえば別のページの表示ウィジェット)。 |
| 項目 | 別のアセットがメインアセットと一致するかどうかを判断するためにコンテンツが使用されるキーワードまたはテキストフィールドをカンマ区切りのリストで指定します。 |
| 最大クエリ用語数 | メインアセットから展開するクエリ用語の最大数を設定します。 これらは、検索結果をメインアセットに一致させるために使用される用語です。 この値を大きくすると、実行速度が低下することで、返される結果の関連性が高まります。 空白のままにすると、デフォルトは25です。 |
| 最小用語頻度 | 類似結果のマッチングに使用するために、ある用語がインデックスに表示される回数の最小しきい値を設定します。 空白のままにすると、デフォルトは2です。 |
| 最小文書頻度 | その他の類似結果クエリの作成に用語を使用するために、その用語を含むドキュメントの数の最小閾値を設定します。 空白のままにすると、デフォルトは5です。 |
| 最大文書頻度 | Set 類似した結果のマッチングに使用するために、ある用語が出現する可能性のあるインデックス内の文書数の最大閾値。 これを使用して、ストップワードなどの頻繁に使用される単語を無視します。 空白のままにすると、上限は設定されません。 |
| 最小単語長 | 単語の長さの最小値を設定すると、それ以下の単語はその他の類似結果クエリから除外されます。 空白のままにすると、デフォルトは0です。 |
| 最大単語長 | 最大単語長を設定し、それ以上の単語はその他の類似結果クエリから除外されます。 空白のままにすると、上限は設定されません。 |
| ストップワード | 類似の結果を検索する際に無視する、興味のないストップワードの配列 (コンマ区切りのリスト)。 設定されたアナライザでストップワードが許可されている場合、これらは完全にその他の類似結果クエリへの送信を避けることができます。 |
| アナライザー | 入力ドキュメントのフィールドに使用するアナライザーを指定します。 空白のままにすると、デフォルトでフィールド構成の最初のエントリに関連付けられたアナライザーになります。 |
| 最低必須一致 | 選言クエリが形成された後、このパラメータは、一致しなければならない用語の数をコントロールします(デフォルトは 30%)。 受け入れられる構文については、 Elasticsearch ドキュメントを参照してください。 |
| 用語ブースト | tf-idf スコアで用語をブーストする必要がある場合に使用するブースト係数を設定します。 空白の場合、このデフォルトは無効になります (0)。 その他の正の値は、指定されたブーストファクタで用語ブーストを有効にします。 |
| 統合検索キー | このウィジェットが参加している代替検索のキーを入力してください。 |