オブジェクトモデルビルダーの使用
Liferay DXP 2023.Q4+/Portal GA102+
- Liferay DXP 2023.Q4+/Portal GA102+ では、オブジェクト UI にアクセスするには オブジェクト フォルダー → ビュー の権限が必要です。 詳細については、 オブジェクト アプリケーション権限 を参照してください。
- Liferay DXP 2024.Q1/GA112 で、モデルビルダーがリリース機能 から一般提供 (GA) に移行しました。
Liferay Objectsは、複雑なオブジェクト構造を設計するためのモデルビルダーGUIを提供します。 このグラフィカルツールは、各オブジェクト定義をカードとして表示し、オブジェクト定義間の関係を視覚化します。 これを使用すると、オブジェクトアプリケーションでデータモデルを作成、管理、拡張したり、定義、フィールド、リレーションシップをすばやく構成したりできます。

モデルビルダービューにアクセスするには、
ここからオブジェクト定義を作成、編集、管理できます。
モデルビルダービューは、複数のオブジェクト定義とその属性を素早く設定するのに最適です。 これは、オブジェクト間の関係を視覚化および管理する際に特に役立ちます。
オブジェクトの作成
-
目的のオブジェクトフォルダに移動してください。
-
新しいオブジェクトを作成 をクリックします。

-
オブジェクトのドラフト作成にあたり、以下の詳細情報を提供してください。
ラベル: オブジェクト管理およびサポートされているアプリケーション コンテキスト (ワークフロー、表示ページ テンプレート、フォームなど) でオブジェクトを識別します。
複数ラベル: UI でのオブジェクトアプリケーションの表示名を決定します。
オブジェクト名: オブジェクトの
定義名を決定します。公開後は変更できません。 -
をクリックして保存します。
保存すると、定義案が図の中央領域に表示されます。 それをクリックすると、右側のサイドパネルにある設定オプションにアクセスできます。

サイドパネルでは、オブジェクトの詳細を編集したり、連携機能を有効にしたり、追加機能(カテゴリ分け、下書きモードなど)を設定したりできます。
オブジェクト定義にフィールドやリレーションシップを追加することもできます。 ただし、モデルビルダービューからは追加できない設定もあります。 検証、 アクション、 ビュー、 レイアウト、および ステート は、オブジェクトのページ ビューから追加する必要があります。 モデルビルダービューからページビューにアクセスするには、オブジェクトカードの アクション (
) → ページビューで編集 をクリックします。
データフィールドの追加
-
オブジェクト定義については、 フィールドまたはリレーションシップの追加 をクリックしてください。
-
を選択し、フィールド を追加します。

-
ラベル と フィールド名 を入力してください。
ラベル: オブジェクト UI でフィールドを識別し、フィールド作成後にローカライズできます。
フィールド名: バックエンドでのフィールド名を決定し、キャメルケースを使用します。 一度フィールドが公開されると、この値は変更できません。
-
フィールドを選択してください 入力してください。 利用可能なフィールドタイプと構成オプションの詳細については、 フィールドタイプのリファレンス を参照してください。
-
をクリックして保存します。
そのフィールドは定義に即座に追加されます。 デフォルトでは、オブジェクト カードには 5 つのフィールドが表示されますが、 すべてのフィールドを表示 をクリックすると、他のフィールドを表示できます。 さらに、オブジェクトカード内のフィールドを選択すると、右側のパネルにそのフィールドの設定オプションが表示されます。

関係性を定義する
-
オブジェクト定義については、 フィールドまたはリレーションシップの追加 をクリックしてください。
-
を選択し、関係を追加 を選択します。

-
ラベル と 名前 を入力してください。
ラベル: オブジェクト UI で関係を識別し、関係が作成された後でローカライズできます。
名前: バックエンドでのリレーションシップの名前を決定し、キャメルケースを使用します。 一度関係性が公開されると、この値は変更できません。
-
関係 とタイプ を選択し、関係のもう一方の側のオブジェクト定義を選択します。 詳細については、 オブジェクト関係の定義 を参照してください。
-
をクリックして保存します。
保存後、図表領域にはオブジェクト定義間の論理的なつながりが視覚化され、一対多と多対多の関係が区別されます。 関係コネクタをクリックすると、右側のサイドパネルに設定オプションが表示されます。

他のフォルダーにあるオブジェクト定義とのリレーションシップを定義すると、図領域にはそれらのカードが点線の枠線で表示されます。 これは関係性を視覚化するためのものであり、ユーザーがオブジェクト定義を編集する権限を与えるものではありません。 定義を編集するには、オブジェクトのソースフォルダに移動する必要があります。

オブジェクトの管理
モデルビルダーの図領域でオブジェクトカードをドラッグ&ドロップすることで、視覚的に再配置できます。 Liferayは位置情報の更新を自動的に保存します。 さらに、オブジェクト定義をフォルダ間で移動することもできます。
-
目的の保存先フォルダに移動してください。
-
左側のサイドバーにある別のフォルダーのオブジェクトについては、 アクション (
)をクリックしてください。 -
を選択して現在のフォルダーに移動 を選択します。

これにより、定義ファイルが現在のフォルダに移動します。 オブジェクト定義を移動しても、そのオブジェクト間の関係性には影響せず、整理とオブジェクト管理の改善のみを目的としています。

オブジェクトカードの「アクション」(
)をクリックすると、追加の管理オプションにアクセスできます。 利用可能なオプションは次のとおりです。
- ページビューで編集:デフォルトのオブジェクトUIに切り替えます。
- ERCの編集:オブジェクトの外部参照コード(ERC)を更新します。
- JSONとしてエクスポート: JSONオブジェクト定義をダウンロードします。
- 権限の管理: オブジェクト に対して が操作できるロールを決定します。
- オブジェクトを削除: オブジェクト定義 を削除します。

公開オブジェクトドラフト
Model Builderを使用すると、個々のオブジェクト定義だけでなく、複数のオブジェクトを含む複雑なデータモデルも公開できます。
-
オブジェクトの下書きが入っているフォルダに移動してください。
-
をクリックして公開 します。
-
公開する下書きを選択してください。

-
オブジェクトを公開 をクリックします。
選ばれた原稿は一斉に掲載される。
モデルビルダーの利用可能性
Model Builder は、Liferay DXP 2023.Q4/Portal GA102 で リリース機能フラグ の背後でリリースされました。 2024年第1四半期/GA112に一般提供(GA)が開始されました。
| Liferayバージョン | 機能ステータス | 機能フラグ [ラベル] |
|---|---|---|
| 2023.Q4 GA102 | リリース機能 | ✔ [オブジェクトモデルビルダー (LPS-148856)] |
| 2024.Q1+ GA112+ | GA | ✘ |
