オブジェクトエントリーの表示
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.Q4+ が一般提供開始
オブジェクト定義でフレンドリー URL のカスタマイズを許可するように構成されていない限り、各オブジェクトエントリには、 server-address/[separator]/[entry title field] のパターンに従って専用のフレンドリー URL が自動的に割り当てられます (例: https://mysite.com/c_member/kyle_parker)。
区切り文字とエントリタイトルフィールドによって、フレンドリーURLの構成要素が決まります。 どちらもオブジェクト定義で設定可能です。 デフォルトでは、区切り文字は c_object-definition-name です。 エントリタイトルフィールドは、2025年第4四半期以降、デフォルトで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］タブをクリックします。
-
追加 ボタン（
）をクリックし、 空白 テンプレートを選択します。これにより、モーダルウィンドウが開きます。
-
名前 を入力し、コンテンツ タイプとして目的の オブジェクト を選択します。
-
［Save（保存）］をクリックします。
これにより、選択したオブジェクトをデフォルトのマッピングソースとする空白のテンプレートが作成され、テンプレート編集ページにリダイレクトされます。
-
ページフラグメントとウィジェットを使用して、オブジェクトエントリの柔軟で動的な表示を作成します。 詳細については、 表示ページテンプレートの使用 を参照してください。
-
ページコメントウィジェットを追加し、エンドユーザーがエントリー表示ページにコメントできるようにします。
注オブジェクト定義のコメントを有効にする必要があります。 そうでない場合は、ウィジェットは表示ページで非表示になります。
-
完了したら、 公開 をクリックします。
-
テンプレートの アクション ボタン（
）をクリックし、 デフォルトとしてマークを選択します。このテンプレートは、ユーザーがフレンドリーURLにアクセスするたびに、オブジェクトのエントリを表示するために使用されます。
コメントの有効化
-
グローバルメニュー（
）を開き、［コントロールパネル］タブに移動し、［オブジェクト］をクリックします。 -
オブジェクト定義を編集します。
-
［Details］タブで、コメントを有効にし、［Save］をクリックします。
オブジェクトの情報テンプレートの作成
情報テンプレートを使用すると、FreeMarkerでオブジェクトのテンプレートを作成できます。
-
サイトメニュー (
) を開き、 デザイン → テンプレート → 情報テンプレート に移動します。 -
をクリックして を追加（
） -
名前 を入力し、目的の オブジェクト を選択します。
-
［保存］をクリックします。 これにより、テンプレートデザインページにリダイレクトされます。
-
（オプション）アプリケーションバーのオプション（
）をクリックし、 スクリプトのインポートを選択して、インポートする .ftlファイルを選択します。 これにより、現在のテンプレートがファイルのFreeMarkerスクリプトに置き換えられます。
-
FreeMarker を使用してテンプレートをデザインします。
要素 サイドパネル (
) では、選択したオブジェクトの構造から利用可能なフィールドにアクセスできます。
-
（オプション）プロパティサイドパネル（
）でテンプレートに説明または画像を追加します。
-
完了したら、 保存 をクリックしてください。
オブジェクトエントリをフラグメントフィールドにマッピングする際に、テンプレートから選択できるようになりました。
ナビゲーションメニューへのエントリの追加
オブジェクトは情報フレームワークと統合されているため、ナビゲーションメニューにオブジェクトエントリを追加して、すばやくアクセスできるようにすることができます。 公開されたすべてのオブジェクトは、メニュー要素の利用可能なソースとして自動的に表示されます。 詳細については、 ナビゲーションメニューアプリケーションの使用 を参照してください。