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

オブジェクトにフィールドを追加する

Liferay DXP 2023.Q4+/Portal GA102+

フィールドは、データベースのカラムを表すデータ定義で、異なるタイプの値を格納します。デフォルトでは、すべてのオブジェクトに以下のシステムフィールドが含まれます：作成者、作成日、外部参照コード、ID、更新日、およびステータス。しかし、新しいフィールドはいつでも追加することができます。

次の手順を実行します：

グローバルメニュー () を開き、 コントロールパネル → オブジェクト に移動します。
目的のオブジェクト定義の編集を開始します。

注記

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

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

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

注記

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

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

ヒント

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

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

重要

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

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

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

予約済みフィールド名

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

項目	説明
`会社ID`	エントリーが作成されたポータルインスタンス。
`作成日`	エントリーが作成された日時。
`外部参照コード`	エントリーの外部参照コード。
`グループID`	エントリーが作成されたサイトID。
`最終公開日`	エントリーが最後に公開された日付。
`変更日`	エントリーが最後に更新された日付。
`MVCCバージョン`	エントリーのMVCCバージョン。
`オブジェクト定義ID`	エントリーのオブジェクトのID。
`オブジェクトエントリID`	エントリーのID。
`状態`	エントリーのワークフローステータス。
`statusByUserId`	ワークフローで割り当てられたユーザーのID。
`ユーザー名によるステータス`	ワークフローで割り当てられたユーザーの名前。
`ステータス日付`	ワークフローステータスが最後に更新された日付。
`ユーザーのメールアドレス`	記事執筆者のメールアドレス。
`ユーザー名`	記事の著者名（ファーストネーム）。
`ユーザーID`	記事作成者のユーザーID。
`ユーザー名（姓）`	記事の著者の姓。
`ユーザー名`	記事作成者のユーザー名。
`UUID`	エントリー固有のユニバーサルID。