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

データ定義の作成

重要

動的データリストは Liferay DXP 7.3 以降では非推奨となり、2024 年に削除される予定です。オブジェクトに置き換えられます。できるだけ早く動的データリストをオブジェクトに移行してください。

データ定義を作成するには：

コンテンツ & データ → 動的データリストに移動します。
右上のオプション（）をクリックし、 データ定義の管理をクリックします。

［データ定義］画面が表示されます。表には、既存のデータ定義が一覧表示されます。連絡先、イベント、在庫などの一般的なユースケースには、いくつかの定義が埋め込まれています。
新しいデータ定義の作成を開始するには、追加 () をクリックします。これにより、［新しいデータ定義］フォームが開きます。
データ定義に名前を付けます。定義の名前は、その定義を使用する動的データリストに入力するすべてのユーザーに表示されることに注意してください。フォームの［詳細］セクションを展開し、説明を入力します。

フォームの詳細セクションには、親データ定義フィールドも含まれています。このオプションのフィールドでは、既存のデータ定義（親）を選択して、新しいデータ定義（子）の基礎を形成できます。子定義は親のフィールドと設定を継承し、その後カスタマイズできます。子定義から動的データリストを作成すると、親定義と子定義のフィールドが含まれます。これにより、共通の定義（親）を特殊な定義（子）の基礎として使用できます。

親定義を選択するには、［Parent Data Definition］フィールドの下にある ［選択］ ボタンをクリックしてから、表示されるダイアログで既存の定義を選択します。
フォームの詳細セクションの下のデータ定義デザイナーで、データ定義のフィールドを追加します。デザイナーのデフォルトの [表示] タブを使用すると、WYSIWYG エディターで定義を作成できます。 [ソース] タブをクリックして、定義の基盤となる JSON を操作することもできますが、WYSIWYG エディターを使用する方がはるかに簡単です。

［表示］タブで、 ［フィールド］タブをクリックします。片側にはフィールドタイプを表すアイコンが表示され、反対側にはデータ定義のキャンバスが表示されます。定義にフィールドタイプを追加するには、そのアイコンをドラッグしてキャンバスにドロップします。キャンバス上に既に存在するフィールドにフィールドをドラッグすると、新しいフィールドを既存のフィールドにネストできます。キャンバス上のフィールドにマウスオーバーすると、フィールドアクションのアイコンが表示されます。複製アイコン () をクリックすると、現在のフィールドの複製が作成され、現在のフィールドの下に追加されます。 ゴミ箱 アイコン () をクリックすると、フィールドが削除されます。使用可能なフィールドの詳細については、フィールドタイプリファレンスを参照してください。
フィールドのプロパティを編集して、使用目的を反映させます。たとえば、テキストフィールドのデフォルトのラベルは Text です。これは、Eメールなどのカスタム値に変更できます。まず、キャンバス上のフィールドを選択します。これにより、左側の［設定］タブが自動的に選択されます。または、フィールドの歯車アイコン () をクリックして、[設定] タブにアクセスすることもできます。

フィールドプロパティを編集するには、［設定］テーブルでその値をダブルクリックし、新しい値を入力します。詳細については、フィールドプロパティリファレンスを参照してください。

データ定義のフィールド値を、サポートされている任意のロケールに翻訳できます。翻訳のフィールド値を指定するには、ロケールを表すフラグを選択し、ロケールのフィールド値を入力します。
完了したら、 [保存] をクリックします。次に、新しいデータ定義がテーブルに表示されます。

項目タイプリファレンス

データ定義を作成するときは、次の項目タイプを使用できます。

項目タイプ	説明
ブール値	チェックボックス
色	色を指定します
日付	日付を入力します。日付を入力します。フィールドを選択するとポップアップ表示されるミニカレンダーを使用するか、有効な形式で日付を入力します。
小数	10進数を入力します。値は`double`として永続化されます。
ドキュメントとメディア	ドキュメントとメディアライブラリからファイルを選択します¹
位置情報	場所をユーザーのフォームエントリに関連付けます。
HTML	WYSIWYGエディターを使用してHTMLコンテンツを記述・表示する領域
整数	整数を入力します。値は`INT`として永続化されます。
ページへのリンク	同じサイト内の別のページにリンクします。
数値	10進数または整数を入力します。入力の種類に応じて、値は、 `double` または `int`として永続されます。
ラジオ	クリックできるオプションを表示します。オプションの数はデフォルトでは3つですが、これはカスタマイズ可能です。一度に選択できるオプションは1つだけです
選択	これはラジオフィールドに似ていますが、オプションが非表示になっており、ドロップダウンメニューからアクセスする必要があります。
テキスト	1行のテキストを入力します。
テキストエリア	これはテキストフィールドに似ていますが、複数行のテキストや段落を区切って入力できます。
Webコンテンツ	Webコンテンツを選択します。

フィールドプロパティリファレンス

次のプロパティを変更できます。これらのプロパティの一部は、特定のフィールドタイプでのみ使用できることに注意してください。

プロパティ	説明
タイプ	フィールドのタイプ (例: テキスト、ラジオなど)。この設定は編集できませんが、表示テンプレートはこれを参照できます
項目ラベル	フィールドの表示名
ラベルを表示	フィールドラベルが表示されているかどうか
必須	ユーザーがフィールドに入力する必要があるかどうか（ブールフィールドでは使用できません）
名前	フィールドの内部識別子。この値を表示テンプレートで使用して、フィールドのデータを読み取ることができます。この値は自動的に生成されますが、必要に応じて変更することができます。
初期値	フィールドのデフォルト値
チップ	ツールチップに表示するテキスト
インデックス可能	フィールドが検索用にインデックスされているかどうか
ローカライズ可能	フィールドを翻訳できるかどうか
繰り返し可能	ユーザーがフィールドのコピーを作成できるかどうか
複数	ユーザーが複数のオプションを選択できるかどうか。これは、選択フィールドでのみ使用できます
オプション	［ラジオ］フィールドと[選択]フィールドで選択できるオプション。オプションを追加したり削除したり、各オプションの表示名と値を編集したりできます