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

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

Liferay DXP 2023.Q4+/Portal GA102+

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

次の手順を実行します：

グローバルメニュー（）を開き、［コントロールパネル］タブに移動し、［オブジェクト］をクリックします。
目的のオブジェクト定義の編集を開始します。

注

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

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

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

注

いくつかのフィールド名はLiferayによって予約されており、使用することはできません。詳細については、予約済みフィールド名を参照してください。
フィールドを選択してください 入力してください。一部のフィールドタイプには、追加の設定オプションが含まれています（例：選択リスト、添付ファイル）。各タイプの概要については、以下の「フィールドタイプのリファレンス」を参照してください。

フィールド作成時に表示されるオプションもあれば、フィールド作成後にのみ表示されるオプションもあります。

ヒント

特定の型に対して、一意の値のみを受け入れるように要求することができます。例えば、ユーザーが既に登録されているメールアドレスを入力できないように設定できます。テキストまたは整数フィールドタイプの場合、 一意の値のみを受け入れる を有効にします。
その項目が必須項目かどうかを判断してください。
［保存］をクリックします。

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

重要

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

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

項目タイプ（UI）	データ型（HEADLESS）	説明
集約	文字列	リレーションシップテーブルの値を用いて計算された読み取り専用の値を格納します。利用可能な関数には、 `count`、 `sum`、 `average`、 `min`、および `max` があります。
添付ファイル	リレーションシップ> Long	ファイルを保存します。デフォルトでは、アップロードできるファイルのサイズは100MBまでです。このフィールドは、ドキュメントとメディアで受け入れられるすべてのファイルタイプをサポートします。
自動インクリメント	文字列	最後に割り当てられた値を `1` だけインクリメントして計算された読み取り専用値を格納します。開始値、プレフィックス、サフィックスを設定できます（例： `foo200bar`、 `foo201bar`、 `foo202bar`、 …）。
ブール値	ブール値	trueまたはfalseの値を格納します。必須項目であるブール値フィールドは、エンドユーザーからtrueの値を要求されます。
日付	日付	日付の値を格納します。
日時	日時	日付と時刻の値を保存します。入力された時刻値をそのまま保存することも、UTCに変換して保存することもできます。 UTCに変換: 時刻をUTCで保存し、ユーザーのタイムゾーンで表示します。入力されたとおりに入力を使用する: タイムゾーンに関係なく、入力されたとおりに時間を保存して表示します。
小数 (以前は Double)	二重線	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バイトに増加しました。
電話番号	文字列	検証され、E.164形式に正規化された電話番号を保存します（例： `+15551234567`）。国ソースの設定が必要です。ユーザーが定義（ユーザーが入力時に国を選択）または固定（国を設定すると、その国コードが適用されます）。
候補リスト	文字列	ピックリストから 1 つの文字列値を格納します。フィールドを追加したら、「詳細設定」タブに移動してデフォルト値を設定してください。この値は、特定の選択リストオプションを選択して手動で設定することも、式ビルダーを使用して動的に設定することもできます。
小数の精度 (以前はBigDecimal)	BigDecimal	丸め処理を行わない高精度な10進数を、最大16桁まで格納します。最大値： `99999999999999.9999999999999999` 最小値： `-99999999999999.9999999999999999`
リレーション	Long	関連するすべてのオブジェクトエントリーの数値IDを格納します。 Objectsは、一対多のリレーションシップの子側のオブジェクトに、リレーションシップフィールドを自動的に追加します。詳細については、オブジェクト関係の定義を参照してください。
リッチテキスト	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。