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

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

リリース機能

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

重要

DXP 2025.Q3 以降では、ブループリントによって返されるより多くのフィールドを、コレクション表示フラグメント内のフラグメントにマップできるようになりました。ブループリントが 1 つのコンテンツタイプ (単一のオブジェクトまたは Web コンテンツ構造など) のみを検索するように構成されている場合は、オブジェクト、Web コンテンツ記事、およびドキュメントタイプのタイプフィールドとサブタイプフィールドをマップできます。一部のコンテンツタイプでは、必要なバックエンドフレームワークにフィールドが完全に登録されません。これらのコンテンツタイプでは、フラグメントへのマッピングに使用できるフィールドが制限されています。これには、ブックマークエントリ、動的データリストレコード、メッセージボードメッセージ、フォームレコード、Wiki ページ、およびすべてのフォルダーが含まれます。

DXP 2025.Q3より前は、Liferayのアセットフレームワークに登録されたコンテンツのみがブループリントコレクションプロバイダーによって返されました。フラグメント内の基本情報フィールド（アセットエントリフィールドなど）をマップすることはできましたが、コンテンツのタイプとサブタイプ固有のフィールド（ドキュメント、オブジェクト、Web コンテンツフィールドなど）は使用できませんでした。

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

LPS-129412 のリリース機能フラグを有効にします。
ブループリントを作成し、設定します。
- 2025.Q3+ の場合は、 コレクションプロバイダーとして有効にする スイッチを切り替える必要があります。
- ブループリントのクエリ設定で 検索可能なタイプ を設定します。 2025 年第 3 四半期以降、ここでの選択は、コレクション表示でフラグメントにマッピングできるフィールドに影響します。
  - コレクション表示フラグメントでのマッピングに特定のフィールドを使用するには、単一のコンテンツタイプ (オブジェクトまたは Web コンテンツ構造など) を選択します。
  - 複数のタイプまたはすべてのタイプを選択した場合、すべてのアセットに共通する基本フィールドのみをコレクション表示にマッピングできます。
  - 複数のサブタイプ（複数の Web コンテンツ構造など）を持つ単一のタイプを選択した場合は、親タイプに共通するフィールドのみが使用可能になります。
コンテンツページのエディターで、コレクション表示フラグメントを追加します。

コレクションページを追加するときに、コレクションプロバイダーを使用することもできます。
「コレクションプロバイダー」フィールドでブループリントのコレクションプロバイダーを選択します。
ページ上で、コレクション表示フラグメントを使用し、コレクションプロバイダーを選択して、ブループリントの応答のフィールドをフラグメントにマップします。

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

例: カスタムドキュメントタイプからのファイルエントリの表示

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

LPS-129412 のリリース機能フラグを有効にします。
製品メニュー → ドキュメントとメディア → ドキュメントタイプで、2 つの新しいドキュメントタイプを作成します。
- 1 つのテキストフィールド 猫の写真 タイプ、 猫の名前を作成します。
- 1 つのテキストフィールド 犬の写真 タイプ、 犬の名前を作成します。
注

ブループリントコレクションの表示でこれらのドキュメントタイプのカスタムフィールドを使用するには、ブループリントの検索可能なタイプとして単一のタイプ (ドキュメント) と単一のサブタイプ (例: 猫の写真) を選択する必要があります。 2 番目のサブタイプ (例: 犬の写真) を選択した場合は、ドキュメントタイプの共有フィールドのみが使用可能になります。
製品メニュー → ドキュメントとメディアで、タイプごとに 1 つのエントリを作成します。サンプルの値は自由にカスタマイズできます。
- タイプ: 猫の写真
  - タイトル: ドラマチックにくつろぐプリシラ
  - 猫の名前: プリシラ・テンダーポーズ
  - ファイル: 写真をアップロード
- タイプ: 犬の写真
  - タイトル: ソファの上のFoofi
  - 犬の名前: フーフィー・ヘルナンデス
  - ファイル: 写真をアップロード
アプリケーションメニュー () から、 ブループリントを開きます。
検索可能なタイプを選択するブループリントを追加します。
- タイトル: ペットの写真の設計図
- コレクションプロバイダーとして有効にする: True (スイッチャーを切り替える)
- クエリ設定: ドキュメントを選択し、サブタイプとして両方のドキュメントタイプ (犬の写真と猫の写真) を選択します。
設計図を保存します。
サイトメニュー () から、「ペット」というコンテンツページを追加します。
ページにコレクション表示フラグメントを追加し、 ペットの写真ブループリント コレクションプロバイダーを選択します。
コレクション表示のグリッドドロップゾーンに 見出し フラグメントを追加し、見出しの例のテキストをクリックして右側にマッピングサイドバーを開きます。
一般的なドキュメントフィールドから選択できますが、ドキュメントタイプに追加したペットネームフィールドは選択できません。タイトルを選択します。これは、特定のドキュメントタイプに固有ではない一般的なドキュメントフィールドです。
次に、見出しの下に画像フラグメントを追加し、それをドキュメントの プレビュー画像 フィールドにマップします。
ページを公開すると、コレクションには追加した両方のペットが表示されます。

コレクション表示でカスタムドキュメントタイプのフィールドを使用するには、ブループリントを編集して、1 つのタイプ/サブタイプのペア (例: ドキュメント → 犬の写真) を除くすべてのタイプ/サブタイプのペアを削除する必要があります。次に、コレクションの表示を再構成し (最初からやり直す必要がある場合があります)、カスタムフィールドがマッピングに使用できることを確認します。

例: 将来のイベントを表示する

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

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
}

[ブループリント] タブで、将来のカレンダーイベントのみに一致するブループリントを作成します。
- タイトル: 将来のカレンダーイベントプロバイダーを入力します。
- コレクションプロバイダーとして有効にする: True (スイッチャーを切り替えます)。
- クエリ設定: 検索可能なタイプで カレンダーイベント を選択します。
- クエリ要素: 結果を将来のイベントに制限する 要素を追加します。
設計図を保存します。
サイトメニュー () から、「今後のイベント」というコンテンツページを追加します。
ページにコレクション表示フラグメントを追加し、 将来のカレンダーイベントプロバイダー コレクションプロバイダーを選択します。

箇条書きリストを表示するようにコレクション表示フラグメントを構成します。
ページを公開すると、今後のカレンダーイベントが表示されます。