カスタムファセット
カスタムファセットは、標準機能の検索ファセットの中でもユニークなものです。 結果を常に単一の静的フィールド (変更日や資産タイプなど) でグループ化するのではなく、使用可能な集計タイプを選択し、結果をグループ化するフィールドを指定できます。 カスタム ファセットを使用すると、ニーズに合わせてまったく新しいファセットを作成できます。 たとえば、「作成日」フィールドのファセットを作成し、独自の日付範囲を指定して、変更されたファセットと同様の機能を持つファセットを作成できます。
オブジェクトのネストされたフィールドや Web コンテンツ構造の使用などの例については、「 カスタム ファセットの例 」の記事を参照してください。
カスタム ファセットを使用する場合は、インデックス内の適切なフィールドとそのタイプを見つけることが重要です。 詳細については、 インデックス付きフィールドの調査 を参照してください。
カスタムファセットの設定
-
ページ上部の 追加 (
) をクリックします。 -
カスタムファセットを見つけて、左側のファセットのコレクションにドラッグします。 カスタムファセットは、ウィジェットの［検索機能］セクションにあります。
-
オプション (
) → 構成をクリックします。
注Liferay DXP 2025.Q1/Portal GA132 より前では、設定オプションはウィジェットの右上隅に表示されていました。
カスタム ファセットの構成オプションについては以下で説明します。
-
完了したら、 「保存」をクリックします。
Liferay DXP 2024.Q4+/Portal GA129+では、カスタムファセットで利用可能な設定が変更され、より多くのカスタマイズを可能にするために並べ替えられました。 範囲と日付範囲の集計タイプがサポートされるようになり、すぐに使用できる表示テンプレートがさらに多く利用できるようになりました。 利用可能な最新の変更がここに表示されます。 古いバージョンを使用している場合は、構成に一部のオプションが欠けていたり、異なる順序で表示される場合があります。
集約設定
集計タイプ: 集計のタイプ (期間、日付範囲、範囲) を選択します。 いずれかの範囲を選択すると、構成に新しいセクション「範囲構成」が表示されます。 詳細については、 範囲の設定 を参照してください。
集約フィールド： 結果を集計するインデックス付きフィールドの名前を入力します。 これは、分析されていないキーワードフィールドでなければなりません。 詳細については、 インデックス付きフィールドの調査 を参照してください。
カスタム ファセットで タイムスタンプ フィールドを使用しないでください。 これはシステム イベントの内部監査に使用され、検索コンテキストにとって意味のあるデータは保存されません。
表示設定
表示テンプレート: デフォルト、 チェックボックス レイアウト、 コンパクト レイアウト、 ラベル レイアウト、および ラジオ ボタン レイアウトから選択します。 詳細については、 「検索ウィジェット表示テンプレートの使用 」を参照してください。
カスタム見出し: このファセットに表示する見出しを入力します。 設定されていない場合は、集計されたフィールド名が表示されます。
カスタムパラメータ名：選択した値のURLパラメーター名を指定します。 設定されていない場合、集約されたフィールド名が使用されます。
最大ターム数：ファセットに一致する用語がいくつ見つかったかに関係なく、表示するファセット用語の最大数を設定します。 これは、用語集約タイプを使用する場合にのみ利用可能です。
頻度の閾値：用語がファセット用語のリストに表示されるために必要な最小頻度を設定します。 たとえば、ファセットの頻度の閾値が3に設定されている場合、一致する結果が2つの用語は用語結果リストに表示されません。
並べ替え: Liferay 7.4 U60+/GA60+ では、ファセット用語の並べ替え戦略を選択できます。用語の頻度による昇順または降順 (デフォルト)、あるいは値による昇順または降順です。 範囲または日付範囲の集計タイプの場合、構成フォームで定義された範囲の順序でファセット用語を並べ替えることができます。 デフォルトのソートでは、ファセット用語のマッチ数が多いものから少ないものへと並べ替えられます。
表示頻度：用語頻度を表示するかどうかを選択します。
詳細設定
統合検索キー： このウィジェットが参加している代替検索のキーを入力します。 設定されていない場合、このウィジェットはデフォルトの検索に参加します。 この値は通常、アプリケーション定義のインデックスの名前です。
範囲の設定
Liferay DXP 2024.Q4+/ポータル GA129+
日付範囲または範囲の集計タイプを選択した場合、構成フォームに「範囲構成」というセクションが表示されます。 ここで、ファセット用語を構成するさまざまな範囲を設定します。 各範囲値は角括弧で囲まれます (例: [過去 1 時間から *] または [0 から 50])。
「入力範囲を表示」チェックボックスの設定により、ファセットにカスタム範囲を追加するかどうかが切り替わります。
日付範囲
日付範囲の集計は日付フィールドで使用されます。 マッピングには日付フィールドがあります。
"createDate" : {
"format" : "yyyyMMddHHmmss",
"type" : "date"
}
デフォルトでは、使用可能な時間範囲は過去 1 時間、24 時間、1 週間、1 か月、または 1 年です。 これらの範囲の開始値は、式を簡略化するために特別なエイリアスによってサポートされています: 過去 1 時間、 過去 24 時間、 過去 1 週間、 過去 1 か月、および 過去 1 年。 すべてのデフォルトの時間範囲は、 * で終わり、 から の値として現在の時刻、 nowに評価されます。
次のエイリアスまたは検索エンジンでサポートされている日付計算構文を使用して日付範囲を作成できます。
値から に一致する結果はファセット用語に含まれますが、 から 値に一致する結果は除外されます。
範囲
範囲集計は数値データに対して実行され、ユーザーは任意の範囲に基づいてファセットを作成できます。 たとえば、コマース製品には、 doubleという型でインデックス付けされた基本価格フィールドがあります。
"basePrice" : {
"type" : "double"
}
これらの設定により、 basePriceの 2 つの範囲が作成されます。1 つは 50 ドル未満のアイテム用、もう 1 つは 50 ドルを超えるアイテム用です。
ラベル: 0-50 範囲: [0 から 50]
ラベル: 0-50 範囲: [50～100000]
日付範囲とは異なり、範囲集計では特殊文字の使用はサポートされていません。 開始値と終了値をハードコードする必要があります。
カスタムファセットと権限
カスタム ファセット表示でカウントされた結果は、結果カウントをより正確にする 最終権限チェック を経由しません。 つまり、 カスタム ファセット カウント は、すぐに使用できるファセットのカウントよりも不正確になる可能性が高くなります。 ゴースト ファセット問題が発生する可能性もあります。ゴースト ファセット問題とは、ユーザーがコンテンツにアクセスする権限を持っていないにもかかわらず、結果数とともにファセット用語全体が表示される問題です。 ファセットをクリックしても、検索結果はより徹底的に権限チェックされるため、結果は表示されません。
ゴースト ファセットを回避するには、カスタム ファセット用のカスタム ウィジェット テンプレートを作成します。 テンプレート コードでは、API 呼び出しを使用して、基になるエントリを取得します。 VIEW 権限がないため取得できないエントリは、収集されたバケットを反復処理するときに表示から除外できます。