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

オブジェクトエントリの表示

Liferay 7.4以降

Liferayのページ構築機能を使用すると、オブジェクトのエントリを動的に表示できます。 例えば、 コレクション表示 はエントリのリストを表示でき、 表示ページ はエントリの詳細ビューを提供できます。 フォームコンテナと組み合わせると、表示ページはオブジェクトエントリの編集画面としても機能します。

オブジェクトの表示には、コレクションと表示ページテンプレートを使用できます。

ヒント

Liferay DXP 2025.Q4 以降では、オブジェクト定義で フォーム コンテナでのマッピングを有効にする スイッチャーを使用して、カスタム オブジェクトまたは変更可能なシステム オブジェクトをフォーム コンテナで使用できるかどうかを制御します。 Liferay DXP 2026.Q3 より前のバージョンでは、CMS リリース機能フラグ (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を手動で翻訳できます。

エントリをそのURLで表示するには、まずそのオブジェクトの表示ページテンプレートを作成する必要があります。

オブジェクトの表示ページテンプレートを作成する

  1. サイトメニュー (Site Menuを開き、 デザインを展開して、 ページテンプレート に移動します。

  2. 表示ページテンプレート タブをクリックします。

  3. 追加 ボタン (Add Button) をクリックし、 空白 テンプレートを選択します。

    これによりモーダルウィンドウが開きます。

  4. という名前 を入力し、 目的のオブジェクト をコンテンツ タイプとして選択します。

    名前を入力し、コンテンツタイプとして目的のオブジェクトを選択してください。

  5. をクリックして保存します。

    これにより、選択したオブジェクトをデフォルトのマッピングソースとする空白のテンプレートが作成され、テンプレート編集ページにリダイレクトされます。

  6. ページフラグメントとウィジェットを使用して、オブジェクトエントリの柔軟で動的な表示を作成します。 詳細については、 表示ページテンプレートの使用 を参照してください。

    フラグメント要素をオブジェクトフィールドにマッピングすることで、個々のエントリの表示ページを動的に生成します。

  7. エンドユーザーがエントリー表示ページにコメントできるように、ページコメントウィジェットを追加してください。

    注記

    オブジェクト定義にコメントを有効にする必要があります。 そうでない場合、ウィジェットは表示ページで非表示になります。

  8. 完了したら、 公開 をクリックします。

  9. テンプレートの アクション ボタン(Actions Button)をクリックし、 デフォルトとしてマークを選択します。

    このテンプレートは、ユーザーがフレンドリーURLにアクセスするたびに、オブジェクトのエントリを表示するために使用されます。

    テンプレートの「アクション」ボタンをクリックし、「デフォルトとしてマーク」を選択します。

コメントを有効にする

  1. グローバルメニュー (Global Menu) を開き、 コントロールパネル → オブジェクト に移動します。

  2. オブジェクト定義を編集します。

  3. 詳細タブでコメントを有効にして、 保存 をクリックします。

    コメントを有効にする。

オブジェクトの情報テンプレートを作成する

情報テンプレートを使用すると、FreeMarkerでオブジェクトのテンプレートを作成できます。

  1. サイトメニュー (Site Menu) を開き、 デザイン → テンプレート → 情報テンプレート に移動します。

  2. をクリックして (Add Button を追加 )

  3. 名前 を入力し、目的の オブジェクト を選択します。

    名前を入力し、目的のオブジェクトを選択してください。

  4. をクリックして保存します。 これにより、テンプレートデザインページにリダイレクトされます。

  5. (オプション)アプリケーションバーのオプション(Options Button)をクリックし、 インポートスクリプトを選択して、インポートする .ftl ファイルを選択します。 これにより、現在のテンプレートがファイルのFreeMarkerスクリプトに置き換えられます。

    .ftlファイルからスクリプトをインポートします。

  6. FreeMarkerを使用してテンプレートをデザインします。

    要素 サイドパネル (Elements) では、選択したオブジェクトの構造から利用可能なフィールドにアクセスできます。

    オブジェクトの構造内で使用可能なフィールドから選択してください。

  7. (オプション)プロパティサイドパネル(Properties)でテンプレートに説明または画像を追加します。

    [Properties]パネルに説明または画像を追加します。

  8. 完了したら、 をクリックして保存 をクリックしてください。

オブジェクトエントリをフラグメントフィールドにマッピングする際に、テンプレートから選択できるようになりました。

フラグメント要素をマッピングする際に、テンプレートを選択してください。

ナビゲーションメニューへの項目の追加

オブジェクトは情報フレームワークと統合されているため、ナビゲーションメニューにオブジェクトエントリを追加して、すばやくアクセスできるようにすることができます。 公開されたすべてのオブジェクトは、メニュー要素の利用可能なソースとして自動的に表示されます。 詳細については、 ナビゲーションメニューアプリケーションの使用 を参照してください。