オブジェクトへのフィールドの追加

Liferay DXP 2023.Q4+/ポータル GA102+

フィールドは、データベースの列を表すデータ定義であり、さまざまな 種類の値を格納します。 デフォルトでは、すべてのオブジェクトに次のシステムフィールド、［Author］、［Create Date］、［External Reference Code］、［ID］、［Modified Date］および［Status］が含まれます。 しかし、新しいフィールドはいつでも追加することができます。

次の手順を実行します：

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

2. 目的のオブジェクト定義の編集を開始します。

   注

   7.4 U47+/GA47+では、システムオブジェクトにフィールドを追加し、Headless API経由でアクセスすることができます。 詳細については、 システム オブジェクトの拡張 を参照してください。

3. フィールド タブに移動し、 追加 ボタン () をクリックします。

   

4. ラベル と フィールド名を入力します。

   ラベル：この値は、オブジェクトUIでフィールドを識別し、フィールドの作成後にローカライズできます。

   フィールド名: この値はバックエンドでのフィールド名を決定し、キャメルケースを使用します。 フィールドが公開されると、この値は変更できません。

   注

   いくつかのフィールド名はLiferayによって予約されており、使用することはできません。 詳細については、 予約済みフィールド名 を参照してください。

5. フィールドを選択 タイプ。 一部のフィールド タイプには追加の構成オプション (例: 選択リスト、添付ファイル) が含まれます。 各タイプの概要については、以下の フィールド タイプ リファレンス を参照してください。

   一部のオプションはフィールドの作成中に表示されますが、その他のオプションはフィールドの作成後にのみ表示されます。

   ヒント

   一部のタイプでは一意の値のみを受け入れるように要求できます。 たとえば、ユーザーが既存の電子メール アドレスを入力できないようにすることができます。 テキストまたは整数フィールド タイプの場合は、 一意の値のみを受け入れるを有効にします。

6. フィールドが必須かどうかを決定します。

7. [保存]をクリックします。

オブジェクトドラフトにフィールドを保存した後、追加の設定オプションにアクセスすることができます。 例えば、フィールドを検索可能にするかどうかを決定したり、テキストフィールドの許容文字数を制限したりすることができます。 利用可能な設定オプションは、フィールドのタイプによって異なります。 ドラフトを公開したり、既に公開されているオブジェクトにフィールドを追加する場合、設定オプションが制限されます。 オブジェクトからカスタム フィールドをいつでも削除できます。

重要

Liferay 7.4 U85/GA85 以前のバージョンでは、ユーザーは公開されたフィールドを削除できません。 公開後は、オブジェクトのサイド テーブルに追加されたフィールド (つまり、 [Initial_Table_Name]_x) のみを削除できます。 詳細については、 オブジェクトのドラフトの公開 を参照してください。

フィールドタイプUIリファレンス

項目タイプ（UI）	データ型（HEADLESS）	説明
集約	文字列	リレーションシップテーブルの値を用いて計算された読み取り専用の値を格納します。 利用可能な関数には、 count、 sum、 average、 min、および maxがあります。
添付ファイル	リレーションシップ> Long	ファイルを保存します。デフォルトでは、アップロードできるファイルのサイズは 100 MB 以下です。 このフィールドは、 ドキュメントとメディアで受け入れられるすべてのファイルタイプをサポートします。
自動インクリメント	文字列	最後に割り当てられた値を 1増分して計算された読み取り専用の値を格納します。 開始値、プレフィックス、サフィックスを設定できます (例: foo200bar、 foo201bar、 foo202bar、 …)。
ブール値	ブール値	trueまたはfalseの値を格納します。 必須項目であるブール値フィールドは、エンドユーザーからtrueの値を要求されます。
日付	日付	日付の値を格納します。
日時	日時	日付と時刻の値を格納します。 入力した時間値をそのまま保存することも、UTC に変換することもできます。 UTC に変換: 時間を UTC で保存し、ユーザーのタイムゾーンで表示します。 入力したとおりに入力: タイムゾーンに関係なく、入力した時刻を保存して表示します。
10進数 (、以前は倍精度浮動小数点数)	二重線	16 桁を上限とする10進数値を格納します。 例） 999.9999999999 （合計16桁）
暗号化済み	文字列	暗号化された文字列値を格納します。
式	整数または倍精度	オブジェクト定義の数値フィールドを使用して計算された読み取り専用の値を格納します。 フィールドの作成時に、合計を整数として保存するか小数として保存するかを決定します。 作成後、フィールドを編集して数式を設定します。 使用できる関数には、加算 (+)、減算 (-)、乗算 (*)、除算 (/) などがあります。
整数	整数	9桁までの整数を格納します。 一意の値のみを許可するように選択できます。 最大値： 2147483647 最小値： -2147483648
Long Integer (以前は Long)	Long	16桁までの大きな整数を格納します。 最大値： 9007199254740991 最小値： -9007199254740991
長いテキスト (以前は Clob)	Clob	最大65,000文字をサポートするテキストボックスの値を格納. 長いテキスト フィールドを作成した後、許可される文字数を制限できます。
複数選択の候補リスト	文字列	ピックリストから 1 つ以上の文字列値を格納します。 DXP 2024.Q4.2 以降、すべての組み合わせ選択の最大サイズが 280 バイトから 5000 バイトに増加されました。
候補リスト	文字列	ピックリストから 1 つの文字列値を格納します。 フィールドを追加したら、[詳細設定] タブに移動してデフォルト値を設定します。 この値は、特定のピックリスト オプションを選択して手動で設定するか、式ビルダーを使用して動的に設定できます。
小数の精度 (以前はBigDecimal)	BigDecimal	最大 16 桁の高精度小数を丸めなしで格納します。 最大値： 99999999999999.9999999999999999 最小値： -99999999999999.9999999999999999
リレーション	Long	関連するすべてのオブジェクトエントリーの数値IDを格納します。 オブジェクトは、1 対多の関係の子側のオブジェクトに関係フィールドを自動的に追加します。 詳細については、 オブジェクト関係の定義 を参照してください。
リッチテキスト	Clob	高度な書式設定ツールやメディア要素（画像、動画、音声など）でテキストを格納します。
テキスト（以前は文字列）	文字列	最大 280 文字の単純なテキスト値を格納します。 一意の値のみを許可するように選択できます。 フィールドを作成した後、許可される文字数を制限できます。

予約フィールド名

以下のフィールド名はLiferayによって予約されているため、使用することはできません。 ユーザーがこれらの項目名のいずれかを使用してフィールドを作成しようとすると、Liferayはエラーメッセージを表示します。

項目	説明
companyId	エントリーが作成されたポータルインスタンス。
createDate	エントリーが作成された日時。
externalReferenceCode	エントリーの外部参照コード。
groupId	エントリーが作成されたサイトID。
lastPublishDate	エントリーが最後に公開された日付。
modifiedDate	エントリーが最後に更新された日付。
mvccVersion	エントリーのMVCCバージョン。
objectDefinitionId	エントリーのオブジェクトのID。
objectEntryId	エントリーのID。
status	エントリーのワークフローステータス。
statusByUserId	ワークフローで割り当てられたユーザーのID。
statusByUserName	ワークフローで割り当てられたユーザーの名前。
statusDate	ワークフローステータスが最後に更新された日付。
userEmailAddress	エントリ作成者のメールアドレス。
userFirstName	エントリ作成者の名。
userId	エントリ作成者のユーザー ID。
userLastName	エントリ作成者の姓。
userName	エントリ作成者のユーザー名。
uuid	エントリの一意のユニバーサル ID。

関連トピック

• オブジェクトの作成
• オブジェクトリレーションシップの定義
• オブジェクトレイアウトの設計