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

検索ブループリントのコレクション

検索ブループリントを作成すると、それをコレクションプロバイダーとして有効にして、その結果を表示できます。ブループリントのクエリと構成に一致するアセットがコレクションに追加されます。

2025年第3四半期以降、ブループリントで定義する検索可能な型によって、コレクション表示フラグメント内でマッピングできるフィールドが決まります。特定のメタデータにアクセスするには、ブループリントのソースを定義する必要があります。

単一コンテンツタイプ: 特定のタイプ (オブジェクトや特定の Web コンテンツ構造など) を選択して、その固有のカスタムフィールドをマッピングします。
複数またはすべてのタイプ: 複数のタイプを選択した場合、すべてのアセットに共通する基本フィールド (タイトル、作成日など) をマッピングできます。
複数のサブタイプを持つ単一のタイプ: 複数のサブタイプを持つ親タイプ (たとえば、複数の異なる Web コンテンツ構造) を選択した場合、親タイプに共通するフィールドのみが使用可能になります。

重要

DXP 2025.Q3 より前は、コレクションプロバイダーは Liferay の Asset Framework に登録されたコンテンツのみを返していました。基本的なアセット入力フィールド）をフラグメントに<0>マッピングすることはできましたが、コンテンツのタイプやサブタイプ固有のフィールド（ドキュメント、オブジェクト、ウェブコンテンツのフィールドなど）は使用できませんでした。

検索ブループリントをコレクションプロバイダーとして使用する

検索ブループリントのコレクションプロバイダーを使用するには、

Liferay DXP 2026.Q1より前のバージョンでは、LPS-129412のリリース機能フラグを有効にしてください。
ブループリントを作成します。 Liferay DXP 2025.Q3+ では、 コレクションプロバイダーとして有効にする スイッチを切り替える必要があります。

この設定は、設計図の設定タブからいつでも切り替えることができます。詳細については、 Blueprint をコレクションプロバイダーとして有効にするを参照してください。
ブループリントの「クエリビルダー」タブで検索可能な型を定義します。
設計図を保存してください。
コンテンツページにコレクション表示フラグメントを追加し、「コレクションプロバイダー」フィールドでブループリントのコレクションプロバイダーを選択します。

コレクションページを追加する際にも、コレクションプロバイダーを使用できます。
ブループリントのレスポンスからフラグメントにフィールドをマッピングします。

他のコレクションと同様に、コレクションフィルターを使用して、ブループリント駆動コレクションをキーワードまたはカテゴリでフィルタリングできます。

例：カスタム文書タイプからのファイルエントリの表示

ドキュメントとメディアファイルを作成し、コレクション表示フラグメントを使用してコンテンツページにイベントを表示するようにブループリントを設定します。

Liferay DXP 2026.Q1より前のバージョンでは、LPS-129412のリリース機能フラグを有効にしてください。
製品メニュー → コンテンツ & データ → ドキュメントとメディア → ドキュメントの種類 に移動します。
新規をクリックし、 猫の写真 という名前のドキュメントタイプを作成し、 猫の名前 というラベルのテキストフィールドを作成します。
Dog Photos という名前の 2 番目のドキュメントタイプを作成し、 Dog's Name というラベルの付いたテキストフィールドを作成します。

注

これらの文書タイプのカスタムフィールドを設計図コレクションの表示で使用するには、設計図の検索対象タイプとして、単一のタイプ（文書）と単一のサブタイプ（例：猫の写真）を選択する必要があります。 2つ目のサブタイプ（例：犬の写真）を選択した場合、ドキュメントタイプの共有フィールドのみが利用可能になります。
新しいドキュメントタイプを使用してファイルをアップロードするには、 製品メニュー → コンテンツ & データ → ドキュメントとメディア に移動します。
新規をクリックし、タイプごとにエントリを 1 つ作成します。

サンプル値は自由にカスタマイズしてください。
- タイプ: 猫の写真
  - タイトル： プリシラがドラマチックにくつろいでいる
  - 猫の名前： プリシラ・テンダーポーズ
  - ファイル: 写真をアップロード
- タイプ: 犬の写真
  - タイトル： ソファの上のフーフィー
  - 犬の名前： フーフィー・ヘルナンデス
  - ファイル: 写真をアップロード
グローバルメニュー () → アプリケーション → ブループリント に移動します。
Pet Photos Blueprint というタイトルの新しいブループリントを作成し、 Enable as a Collection Provider トグルをアクティブに切り替えます。
クエリビルダータブのソースで、 選択されたタイプ オプションを選択します。
アセットタイプとして ドキュメント を選択し、サブタイプとして 犬の写真 と 猫の写真 を選択します。
設計図を保存してください。
Pets という名前の新しいコンテンツページを作成し、コレクションディスプレイフラグメントを追加します。
ペット写真ブループリント コレクションプロバイダーを選択してください。
コレクションのドロップゾーンに 見出し フラグメントを追加し、テキストをクリックしてマッピングサイドバーを開きます。フラグメントをタイトルフィールドにマッピングします。

複数のサブタイプが選択されているため、「猫の名前」などのカスタムフィールドは非表示になっています。
Image フラグメントを追加し、それをドキュメントのプレビュー画像フィールドにマッピングします。
ページを公開すると、コレクションには追加した両方のペットが表示されます。

コレクション表示でカスタム文書タイプのフィールドを使用するには、ブループリントを編集し、単一のタイプ/サブタイプのペア（例：文書 → 犬の写真）以外すべてを削除する必要があります。次に、コレクションの表示を再構成し（場合によっては最初からやり直す必要があるかもしれません）、カスタムフィールドがマッピングに使用できるようになっていることを確認してください。

例：未来のイベントを表示する

カレンダーイベントを作成し、将来発生するイベントのみを返すようにブループリントを設定します。コレクション表示フラグメントを使用して、コンテンツページにイベントを表示します。

Liferay DXP 2026.Q1より前のバージョンでは、LPS-129412のリリース機能フラグを有効にしてください。
カレンダーウィジェットをページに追加し、3つのイベントを作成します。
- 過去のイベント：終了時刻を現在時刻から5～15分後に設定してください。
- 今後のイベント1：開始時刻を明日に設定する。
- 今後のイベント2：開始時間を来週に設定する。
グローバルメニュー () → アプリケーション → ブループリント に移動します。

「要素」タブで、新規をクリックし、 結果を将来のイベントに制限 という名前の新しいカスタム要素を次の JSON を使用して作成します。

{
   "description_i18n": {
      "en_US": "Limit results to only future events, using the endTime field."
   },
   "elementDefinition": {
      "category": "filter",
      "configuration": {
         "queryConfiguration": {
            "queryEntries": [
               {
                  "clauses": [
                     {
                        "context": "query",
                        "occur": "filter",
                        "query": {
                           "range": {
                              "endTime": {
                                 "gt": "${time.current_date|date_format=timestamp}"
                              }
                           }
                        }
                     }
                  ]
               }
            ]
         }
      },
      "icon": "filter",
      "uiConfiguration": {}
   },
   "title_i18n": {
      "en_US": "Limit Results to Future Events."
   },
   "type": 0
}

［保存］をクリックします。
ブループリントタブで、 Future Calendar Events Provider というタイトルの新しいブループリントを作成し、 Enable as a Collection Provide トグルをアクティブに切り替えます。
クエリビルダータブのソースで、 選択されたタイプ を選択し、 カレンダーイベント をアセットタイプとして選択します。
クエリ要素タブで、 結果を将来のイベントに制限する 要素を追加します。
設計図を保存してください。
Upcoming Events という名前の新しいコンテンツページを作成し、コレクションディスプレイフラグメントを追加します。
将来のカレンダーイベントプロバイダー コレクションプロバイダーを選択します。

コレクション表示フラグメントを設定して、箇条書きリストを表示するようにします。
コレクションのドロップゾーンに 見出し フラグメントを追加し、それをタイトルフィールドにマッピングします。
ページを公開する。

endTimeが現在の日付より大きいイベントのみがコレクションに表示されます。