オブジェクトエントリーの表示
Liferay DXP 7.4+
Liferay のページ構築機能を使用すると、オブジェクト エントリを動的に表示できます。 たとえば、 コレクション表示、 ではエントリのリストを表示でき、 表示ページ、 ではエントリの詳細ビューを提供できます。 フォーム コンテナーと組み合わせると、表示ページはオブジェクト エントリの編集画面としても機能します。
Liferay DXP 2025.Q4/Portal 2026.Q1 以降では、 ベータ機能フラグ LPD-17564 を有効にして、カスタムオブジェクトまたは変更可能なシステムオブジェクトをフォームコンテナで使用できるかどうかを制御します。 オブジェクト定義では、スイッチャー フォーム コンテナーでのマッピングを有効にするを使用します。
コレクション、表示ページ、フォーム コンテナーは最も柔軟性が高いため、推奨されます。 ただし、他の表示方法も利用できます。
| オブジェクトエントリ表示機能 | Description | オブジェクトエントリビュー |
|---|---|---|
| コレクション | すべてのオブジェクトに対して生成されるコレクション プロバイダー* を使用して、動的コレクション、手動コレクション、または自動コレクションを作成し、コレクション表示フラグメントまたはコレクション ページに表示できます。 これは、公開されたオブジェクト エントリをページに表示するための推奨される方法です。 | リスト表示 |
| 表示ページテンプレート | 最高の ページ作成ツールをすべて使用して、オブジェクト エントリまたはその編集フォームを表示する柔軟なページを作成できます。 | 詳細ビュー 編集画面 |
| フォームコンテナ/ フォームフラグメント | 任意のコンテンツ ページまたは表示ページでフォーム コンテナー フラグメントを使用して、オブジェクトの追加または編集フォームを表示できます。 | 作成画面 編集画面 |
| データセット | Liferay に登録された REST アプリケーションから返されたデータを表示します。 データ セットを使用すると、下書きのエントリや公開済みのエントリを表示および 管理できます。 | リスト表示 詳細表示 作成画面 編集画面 |
| オブジェクトウィジェット | デフォルトのテーブル ビューと編集画面を含む、オブジェクト エントリのウィジェットが自動的に取得されます。 ウィジェットはフル機能を備えていますが、柔軟性が限られており、表示をカスタマイズするにはオブジェクトのレイアウトとビューに依存します。 | リスト表示 詳細表示 作成画面 編集画面 |
| オブジェクトレイアウト | レイアウトを使用すると、オブジェクトのウィジェットのカスタマイズされた詳細ビューを提供できます。 | 詳細ビュー |
| オブジェクトビュー | ビューを使用して、オブジェクトのウィジェットの作成および編集フォームをカスタマイズできます。 | 作成画面 編集画面 |
| 情報テンプレート | FreeMarker テンプレートを作成して、コンテンツ表示フラグメントおよびサブ要素を含むフラグメントにオブジェクト エントリがどのように表示されるかを制御できます。 | 詳細ビュー |
| ナビゲーションメニュー | ナビゲーション メニューにオブジェクト エントリを追加します。 | リスト表示 |
* DXP ユーザーは、オブジェクトで 検索ブループリント コレクション プロバイダー を使用することもできます。 これは、手動および動的なコレクションが利用できないサイトでインスタンス スコープのオブジェクトを表示する場合に特に便利です。
情報テンプレートは、コンテンツ表示フラグメントや、オブジェクトにマッピングできる サブ要素 (テキスト、リッチ テキストなど) を持つその他のフラグメントで使用できます。
これらの統合により、パーソナライズされたユーザーエクスペリエンスを提供しながら、ユーザーはLiferayのWYSIWYGページ構築機能を活用できます。
オブジェクトで表示ページテンプレートを使用する
オブジェクト エントリのフレンドリ URL によって、ユーザーが表示ページにアクセスする方法が決まります。 DXP 2025.Q3+ からは、ニーズに合わせてフレンドリー URL パターンを構成できます。 表示ページ テンプレートを追加すると、フレンドリ URL でエントリにアクセスできるようになります。
オブジェクトエントリフレンドリーURLの操作
Liferay DXP 2025年第4四半期以降に一般公開
オブジェクト定義がフレンドリ URL のカスタマイズを許可するように構成されていない限り、各オブジェクト エントリには、パターン サーバー アドレス/[セパレータ]/[エントリ タイトル フィールド] (例: https://mysite.com/c_member/kyle_parker) に従って専用のフレンドリ URL が自動的に割り当てられます。
セパレーターとエントリ タイトル フィールドによって、フレンドリー URL のコンポーネントが決まります。 どちらもオブジェクト定義で構成可能です。 デフォルトでは、区切り文字は c_object-definition-nameです。 エントリタイトルフィールドは、2025.Q4+ からの ERC にデフォルト設定されます。 以前は、エントリの数値 ID がデフォルトで使用されていました。
リリース機能フラグが有効になっていないオブジェクト定義とエントリでは、 l 区切り文字とエントリ ID: server-address/l/objectEntryId (例: https://mysite.com/l/44337) が使用されます。
機能フラグが有効になった後も、既存の定義とエントリではこの古いパターンが引き続き使用されます。
次のシナリオを考えてみましょう。
-
Foo というオブジェクト定義の区切り文字は
c_fooです。 -
テキスト フィールドは、オブジェクト定義のタイトル フィールドとして構成されます。
-
ユーザーは My Textと入力します。
この場合、エントリの URL は localhost:8080/web/guest/c_foo/my_textです。
デフォルトでは、オブジェクト エントリのタイトル フィールドがローカライズ可能な場合でも、フレンドリー URL は翻訳されません。 URL は常にデフォルトの言語に基づいて生成され、コンテンツは期待どおりに翻訳されます。 Country オブジェクトには、ローカライズ可能な Country Name フィールドがある場合があります。 ユーザーがデフォルト言語で Brazil と入力し、ポルトガル語で Brasil と入力した場合、エントリの両方の言語バリアントのフレンドリ URL は /c_country/brazil になります。
翻訳された（つまり、ロケール固有の）フレンドリー URL を提供するには、オブジェクト定義の SEO セクションで エントリのフレンドリー URL の上書きを許可する を有効にする必要があります。 有効にすると、エントリ作成者は各言語にローカライズされたフレンドリー URL を提供できるようになります。
URL でエントリを表示するには、まずオブジェクトの表示ページ テンプレートを作成する必要があります。
オブジェクトの表示ページテンプレートの作成
-
サイト メニュー (
) を開き、 デザインを展開して、 ページ テンプレートに移動します。 -
［Display Page Templates］タブをクリックします。
-
追加 ボタン (
) をクリックし、 空白 テンプレートを選択します。これにより、モーダルウィンドウが開きます。
-
名前 を入力し、コンテンツ タイプとして目的の オブジェクト を選択します。
-
[保存]をクリックします。
これにより、選択したオブジェクトをデフォルトのマッピング ソースとして空白のテンプレートが作成され、テンプレート編集ページにリダイレクトされます。
-
ページ フラグメントとウィジェットを使用して、オブジェクト エントリの柔軟で動的な表示を作成します。 詳細については、「 表示ページ テンプレートの使用 」を参照してください。
-
ページコメントウィジェットを追加し、エンドユーザーがエントリー表示ページにコメントできるようにします。
注オブジェクト定義のコメントを有効にする必要があります。 そうでない場合は、ウィジェットは表示ページで非表示になります。
-
完了したら、 公開をクリックします。
-
テンプレートの アクション ボタン (
) をクリックし、 デフォルトとしてマークを選択します。このテンプレートは、ユーザーがフレンドリ URL にアクセスするたびにオブジェクトのエントリをレンダリングするために使用されるようになりました。
コメントの有効化
-
グローバル メニュー (
) を開き、 コントロール パネル タブに移動して、 オブジェクトをクリックします。 -
オブジェクト定義を編集します。
-
［Details］タブで、コメントを有効にし、［Save］をクリックします。
オブジェクトの情報テンプレートの作成
情報テンプレートを使用すると、FreeMarker を使用してオブジェクトをテンプレート化できます。
-
サイト メニュー (
) を開き、 デザイン → テンプレート → 情報テンプレートの順に進みます。 -
追加 (
) をクリックします。 -
名前 を入力し、目的の オブジェクトを選択します。
-
[保存]をクリックします。 これにより、テンプレートデザインページにリダイレクトされます。
-
(オプション) アプリケーション バーの [オプション] (
) をクリックし、 [スクリプトのインポート]を選択して、インポートする .ftlファイルを選択します。 これにより、現在のテンプレートがファイルのFreeMarkerスクリプトに置き換えられます。
-
FreeMarker を使用してテンプレートをデザインします。
要素 サイド パネル (
) では、選択したオブジェクトの構造から使用可能なフィールドにアクセスできます。
-
(オプション) プロパティ サイド パネル (
) でテンプレートに説明または画像を追加します。
-
完了したら、 「保存」 をクリックします。
オブジェクト エントリをフラグメント フィールドにマッピングするときに、テンプレートから選択できるようになりました。
ナビゲーションメニューへのエントリの追加
オブジェクトは情報フレームワークと統合されているため、ナビゲーション メニューにオブジェクト エントリを追加して、すばやくアクセスできるようになります。 公開されたすべてのオブジェクトは、メニュー要素の使用可能なソースとして自動的に表示されます。 詳細については、「 ナビゲーション メニュー アプリケーションの使用 」を参照してください。