デフォルトのフィールド値を設定する
Liferay DXP 2026.Q1+
デフォルトのフィールド値を使用することで、手動入力によるエラーを減らし、オブジェクトデータがすべての作成方法で一貫していることを保証できます。 システムは、作成時にフィールドが空白のままになっている場合にのみ、デフォルト値または式を適用します。 ユーザーまたは外部APIが値を指定した場合、デフォルト値は上書きされます。 これにより、データの完全性が確保されるとともに、必要に応じて手動入力も可能になります。 例えば、ステータスフィールドのデフォルト値を オープンに設定することで、ユーザーによる手動入力を必要とせずに、すべての新規チケットが管理フィルターとダッシュボードに確実に取り込まれるようにすることができます。
デフォルト値は、静的な値にすることも、式によって生成することもできます。 デフォルトのステータスやカテゴリなど、すべてのエントリで一定である固定データには、「入力値」を使用してください。 エントリが作成された時点に基づいて変化する動的なデータ（日付フィールドを現在時刻に設定するなど）には、式ビルダー を使用します。
以下のフィールドタイプに対して、デフォルトのフィールド値または式を設定できます。
ブール値: デフォルトで True または False にすることでバイナリ状態を保証します。
日付: 特定の日付をデフォルトにするか、相対日付 (例: 現在の日付) の式を使用します。
数値: 開始整数または小数値を設定します。
選択リスト: リストから特定のオプションを選択して、フィールドの初期値とします。
テキスト: テキスト用の静的文字列を指定します。
オブジェクトフィールドにデフォルト値を追加する
-
詳細 タブに移動します。
-
デフォルト値 を使用するスイッチをアクティブに切り替えます。
-
入力値 または 式ビルダー を選択します。
式ビルダーは、フィールドの種類に応じて表示されます。
-
デフォルト値または式を入力してください。
-
［保存］をクリックします。
使用例：タスク割り当ての自動化
プロジェクト管理アプリケーションでは、デフォルトのフィールド値を使用することで、すべての新規タスクが作成時に正しく分類され、タイムスタンプが即座に付与されるようにすることができます。 これは、ダッシュボードを常にクリーンな状態に保ち、UIとヘッドレスAPIの両方でデータの整合性を確保する上で特に役立ちます。
これを実現するには、タスクオブジェクトで以下のデフォルト値を設定してください。
-
初期ステータスの標準化: ステータス選択リストフィールドをデフォルト値
バックログに設定します。 これにより、作成者による手動入力なしに、新しいタスクが「ToDo」フィルターに表示されるようになります。 -
タイムスタンプの自動化: 式ビルダーを使用して、送信日フィールドを
currentDateに設定します。 これにより、タスクがシステムに入力された日時に関する不変の記録が提供されます。
デフォルトのフィールド値を実装することで、オブジェクトエントリがどのように作成されたかに関わらず、すべてのエントリが信頼性の高いデータセットから開始されることが保証されます。 データの完全性をさらに保護するには、デフォルトのフィールド値と読み取り専用フィールドを組み合わせることを検討してください。 これにより、ユーザーが確認できるものの手動で上書きできない、システム生成のデフォルト値を設定できるため、ビジネスロジックのセキュリティが確保されます。