Dynamic validation for date and datetime nodes in dynamic forms

Date and Datetime nodes ensure dates remain within a valid range, which improves data accuracy and consistency. 

Understand types of validity ranges

Administrators can define one of the validity ranges:

• Static range: Uses Min Date / Max Date or Min Datetime / Max Datetime fields.

• Dynamic range: Uses Min Offset / Max Offset fields and is calculated relative to a reference date.

How validation is prioritized

The system evaluates date constraints in the following order:

1. Min / Max Date or Datetime

   • If at least one of these fields is configured, the system applies static validation only.

   • If Min and/or Max Date/Datetime fields are set, offsets are ignored.

2. Min / Max Offsets

   • Applied only when no Min or Max Date/Datetime is defined.

   • The allowed range is calculated dynamically based on a reference date.

     • The reference date is set when the Dynamic Form is saved for the first time in FIXED status.

     • If the reference date is missing (for example, in a newly created form), the system uses the current date and time.

     • The reference date remains fixed for the lifetime of that Dynamic Form instance.

How offsets change validity range

Offsets define a relative range around the reference date:

• Min Offset: How far back the allowed date/time can be

• Max Offset: How far forward the allowed date/time can be

Offset units depend on the node type:

• Datetime nodes: Units are days and hours.

• Date-only nodes: Units are days only.

Configure Date and Datetime Nodes

To configure these nodes:

1. On the Template page, click + New Node to create a new node.

2. In the Type dropdown, select Date or Datetime.

3. Enter a value in one of these nodes:

   • Min / Max Date or Datetime 

   • Min / Max Offsets

4. Click Save to save your changes.

Choose a valid date

Administrators define the range for Date and Datetime nodes. As a result, technicians need to pick valid dates, or they can receive blocking validation messages for dates disabled in the DatePicker. 

1. The DatePicker enforces the range of the configured Min / Max Date or Datetime. 

   • The range can be static or dynamically calculated.

2. To save the form, technicians must use a date within the listed date range.

3. Validation remains blocked until technicians provide a valid value.