Liferayオブジェクトへの移行
ダイナミック・データ・リストは非推奨であり、2024年末までに削除される予定である。 データの損失を防ぎ、同じ機能を実現するために、構造やデータをLiferay Objectsに移行してください。 オブジェクト は、コードを書いたりモジュールをデプロイすることなく、Liferay UIでアプリケーションを構築するためのローコード機能を提供します。 各アプリケーションはLiferayのコアフレームワーク(ヘッドレス、パーミッション、ワークフローなど)と完全に統合されており、UIまたは専用のREST APIからアクセスしてデータエントリーを作成・管理することができます。
ダイナミック・データ・リストを扱うには、データ定義を作成し、それを使ってデータ項目(DDLRecords
)のリストを格納するフォーム(DDLRecordSet
)を作成する。 オブジェクトの使用には、オブジェクト定義の作成、関連付け、公開が含まれます。 パブリッシュされると、アプリケーションにアクセスしてオブジェクト・エントリーを作成することができる。 DDLと比較して、Objectsはデータ構造をモデリングするためのはるかに堅牢で統合されたエクスペリエンスを提供し、カスタムビジネスロジックの実装やユーザーインターフェイスの設計のための追加ツールも含まれています。
データを移行するには
-
ダイナミック・データ・リストのオブジェクト定義を作成します。 リストに選択フィールドやラジオフィールドが含まれている場合は、これらのオプションを定義するためのピックリストも作成する必要があります。
-
データリストのレコードをXMLまたはCSVファイルとしてエクスポートし、JSONファイルに変換します。
-
バッチテンプレートデザイナー を使用して、JSON ファイルをオブジェクト定義にインポートします。
Data Migration Center を使用するには、COMMERCE-8087 beta feature flag を有効にする必要があります。
ダイナミック・データ・リストのオブジェクト定義の作成
-
グローバルメニュー()を開き、 [コントロールパネル] タブで [オブジェクト] をクリックします。
-
目的のオブジェクトフォルダに移動し、 追加 ボタン()をクリックします。
-
ドラフトにこれらの詳細を提供する。
ラベル: Objects admin およびサポートされているアプリケーションコンテキスト(ワークフロー、表示ページテンプレート、フォームなど)でオブジェクトを識別します。
Plural Label :UIにおけるオブジェクト・アプリケーションの表示名を決定します。
オブジェクト名 :オブジェクトの
definition.name
を決定し、公開後に変更することはできません。 -
[保存]をクリックします。
一度作成すると、オブジェクトを編集して、そのスコープやプラットフォーム統合などを設定することができます。 詳しくは Editing Object Drafts を参照してください。
ダイナミック・データ・リストにSelectフィールドとRadioフィールドが含まれている場合、これらのフィールド・オプションを保存するために 、picklists を追加する必要があります。 そうでなければ、 オブジェクト定義にデータフィールド を追加し続けることができる。
ピックリストの追加
-
グローバルメニュー()を開き、 [コントロールパネル]タブで[選択リスト] をクリックします。
-
追加* ()をクリックします。
-
リストの名前を入力します。
-
ピックリストを編集する。
-
[Items]で、 Add() をクリックします。
-
アイテムの名前とキーを入力します。
名前 :アイテムの表示名を決定し、作成後にローカライズすることができます。
キー : オブジェクトフィールドに格納されている項目の値を決定し、キャメルケースを使用する。
Important項目のキー値は、データ・リストの Select または Radio フィールドに設定されたオプション名と一致しなければならない。 SelectフィールドとRadioフィールドがキャメルケースを使用していない場合、オプション名をピックリストのアイテムキーと一致するように更新します。
-
[Save]をクリックします。
-
他の項目を追加するには、上記の手順を繰り返します。
ピックリストを作成したら、オブジェクト定義のデータフィールドに使用することができます。
データフィールドの追加
-
オブジェクト定義の編集を始める。
-
Fields タブに移動し、 Add() をクリックします。
-
ラベル とフィールド名 を入力します。
ラベル :この値はObjects UIでフィールドを識別し、フィールド作成後にローカライズすることができます。
フィールド名 :この値はバックエンドでのフィールド名を決定し、キャメルケースを使用します。 フィールドが公開されると、この値は変更できません。
-
フィールド タイプ を選択します。 どのフィールド・タイプが DDL フィールドと互換性があるかについては、 Field Compatibility Reference を参照してください。
-
フィールドが必須かどうかを判断する。
-
[Save]をクリックします。
-
他のフィールドを追加するには、上記の手順を繰り返します。
データ・フィールドを追加したら、それらを編集して、検索可能性、デフォルト値、ローカライズ可能性などの追加設定を行います。 詳しくは フィールド を参照のこと。
オブジェクト定義の公開
オブジェクト定義を構成し、データ・フィールドを追加したら、オブジェクトをパブリッシュして使用できるようにします。 これを行うには、オブジェクトの Details タブに行き、 Publish をクリックします。 パブリッシュされると、オブジェクトのフォームやディスプレイをデザインできます。 管理インターフェイスを設計するには、 レイアウト および ビュー を参照。 オブジェクトとinfoフレームワークやページビルダーの機能の統合については、 オブジェクトエントリーの表示 および フォームを構築するためのフラグメントの使用 を参照してください。
次に、データ・リストのレコードをエクスポートし、カスタム・オブジェクト定義にインポートします。
データエントリーのエクスポートと変換
-
)を開き、[コンテンツとデータ]を展開し、[ダイナミック・データ・リスト]をクリックします。
-
必要なデータリストの Actions ボタン() をクリックし、 Export を選択します。
Important入れ子のフィールド値はエクスポートされません。
-
CSVまたは XMLを選択し、OK をクリックします。
-
サードパーティのサービスを使ってファイルをJSONに変換する。
JSONファイルの準備ができたら、カスタム・オブジェクト定義にインポートすることができます。
DDLエントリーのインポート
-
グローバルメニュー()を開き、 アプリケーション タブに移動し、 データ移行センター をクリックします。
-
Add () をクリックし、Import File を選択します。
-
インポートの 名前 を入力します。
-
Entity Type(エンティティ・タイプ)では、 カスタム・オブジェクト を選択します。
-
データリストのレコードを含む JSONファイル を選択します。
-
ソース・ファイル・フィールド をオブジェクト定義フィールドにマッピングする。
-
[Next]をクリックします。
-
レコードのフィールドマッピングを確認し、 Start Import をクリックします。
-
インポートが成功したことを確認する。
-
カスタムオブジェクトにエントリが表示されることを確認する。
フィールド互換性リファレンス
DDLフィールド・タイプ | オブジェクト・フィールド・タイプ |
---|---|
ブール値 | ブール値 |
色 | テキストボックス |
日付 | 日付 |
小数 | 小数 |
ドキュメントとメディア | 添付ファイル |
ジオロケーション | テキストボックス |
HTML | リッチテキスト |
整数 | 整数 |
ページへのリンク | リッチテキスト |
数字 | 小数 |
ラジオ | 候補リスト |
選択 | 候補リスト |
テキストボックス | テキストボックス |
テキストエリア | 長いテキスト |
Webコンテンツ | リッチテキスト |