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

コレクションを使用してオブジェクトエントリを表示する

ライフレイ 7.4 U77+/GA77+

オブジェクト定義を公開すると、Liferay によってコレクションプロバイダーが作成されます。サイトスコープのオブジェクトの場合、オブジェクトの手動コレクションまたは動的コレクションを作成することもできます。これらのコレクションをコレクション表示フラグメントおよびコレクションページと共に使用して、オブジェクトエントリを表示できます。オブジェクトは、フィルタリング、スタイル設定、表示オプションなど、すべてのコレクション表示機能をサポートします。

重要

インスタンススコープのオブジェクトは、手動コレクションまたは動的コレクションでは使用できません。 Liferay DXP では、検索ブループリントとそのコレクションプロバイダーを使用して、ほとんどのユースケースを実現できます。詳細については、検索ブループリントを使用したコレクションを参照してください。
下書きエントリはコレクションに表示できません。オブジェクトエントリを最初に公開する必要があります。

オブジェクトコレクションの使用

新しいコンテンツページまたは表示ページテンプレートを作成します。または、既存のものを編集 ( ) します。

注

コレクションプロバイダーを使用してコレクションページを作成することもできます。詳細については、コレクションとコレクションページを参照してください。
フラグメントとウィジェット () サイドバーから、 コレクション表示 フラグメントをページまたはテンプレートにドラッグアンドドロップします。
［コレクション表示フラグメント］を選択して設定オプションにアクセスし、［General］タブの［Select Collection ］をクリックします。
モーダルウィンドウで、コレクションを選択するか、 コレクションプロバイダー タブをクリックして、オブジェクトのプロバイダーを選択します。

注

Liferay DXP 2024.Q4+/Portal GA129+ それぞれのコレクションプロバイダーを使用して、登録されたシステムオブジェクト（アカウント、コマース注文品目、コマース注文、組織、ユーザーなど）のエントリにアクセスできます。
(オプション) 表示されるオブジェクトエントリをフィルターします。オブジェクト内の任意の選択リストまたはブール値フィールドでフィルタリングできます。

コレクションオプション () をクリックし、 フィルターコレクションを選択します。

次に、必要な フィルター を選択し、適用をクリックします。

目的のコレクションを選択した後、 リストスタイル や ページネーションなどの追加のフラグメントオプションを使用して、オブジェクトエントリの表示方法を決定します。

コレクション表示フラグメントのオブジェクトを選択すると、そのオブジェクトがマッピングソースとして設定されます。コレクション表示にフラグメントを追加すると、そのサブ要素をオブジェクトフィールドにマップして、個々のオブジェクトエントリの柔軟なページ表示を作成できます。これはコレクションページにも当てはまります。

たとえば、コレクション表示フラグメントに見出しを埋め込み、コレクション内の各項目の名前を表示するように構成できます。 1 対多の関係の子側のオブジェクトを操作する場合は、関連する親オブジェクトのフィールドにフラグメントをマップすることもできます。

コレクション表示フラグメント内のフラグメントサブ要素をオブジェクトフィールドにマップします。

各リレーションシップテーブルに対して生成されるリレーションシップコレクションプロバイダーを使用して、リレーションシップテーブルから関連オブジェクトエントリを表示できます。

リレーションシップ収集プロバイダー

ネストされたコレクション表示フラグメントを使用して、コレクションプロバイダーで関係テーブルから関連オブジェクトエントリを表示できます。最上位レベルのコレクション表示では親オブジェクトのコレクションプロバイダーが使用され、ネストされたコレクション表示では各親をその子オブジェクトに関連付けるための特別なリレーションシップコレクションプロバイダーが使用されます。

リレーションシップコレクションプロバイダーは関連アイテムコレクションプロバイダーと呼ばれ、1 対多リレーションシップの親オブジェクトと、多対多リレーションシップの両方のオブジェクトに使用できます。このコレクションプロバイダーは、関係テーブルを持つオブジェクトのネストされたコレクション表示フラグメントにのみ表示されます。

コレクション内の関連オブジェクトを表示できます。

たとえば、国と都市の 1 対多の関係では、ネストされたコレクション表示の都市名フィールドにフラグメントをマッピングすることで、国とその子都市を表示できます。

ネストされたコレクション表示フラグメントを構成するための一般的な手順は次のとおりです。

親オブジェクトのコレクションプロバイダーを使用するように最上位レベルのコレクション表示を構成します。
関係テーブルデータに対して生成された関連アイテムコレクションプロバイダーを使用するように、ネストされたコレクションの表示を構成します。
両方のコレクション表示フラグメントで、グリッド表示スタイルを選択し、それぞれのオブジェクトフィールドにマップされたフラグメントを追加します。

コレクション表示内の関連オブジェクトのフィールドにフラグメントをマッピングするには、

コレクション表示フラグメントでオブジェクトのコレクションプロバイダーを使用します。
別のコレクション表示フラグメントを、最初のコレクション表示内にコレクションアイテムとして埋め込みます。

ヒント

ページ編集メニューの ブラウザ タブを使用すると、ページ階層内でフラグメントをより正確に配置できます。
新しいコレクション表示フラグメントの構成オプションで、 コレクションの選択 をクリックします。
関連アイテムコレクションプロバイダー タブをクリックします。
オブジェクトの関係の名前を持つコレクションプロバイダーを選択します。関連付けられているオブジェクトタイプが、関係の名前の下に表示されます。この例では、関係は 国の都市と呼ばれます。