Configuring the basic settings for a DateTime control - date range

Select a property for the DateTime control to determine the date range that the application's users can select. Set related options to specify the label, default value, helper text, and field visibility for the control.

In the layout of the form that you are editing Adding a DateTime control to a layout
  1. Set the Type to Date range.
    You can modify the fields Property, Label, Label value, Default value, Placeholder, and Helper text for both the From date and To date sections.
  2. In the Property field, press the Down Arrow key, and then select a property whose value you want the user to choose from at run time.
    • To review a property, in the Property field press the Down Arrow key, select a property from the list and click the Open icon.
    • To create a new property, in the Property field enter the new property name, and click the Open icon.
  3. The default setting for the Label option is Use property default, which sets the name of the property as the label for the control.
    To specify a label for the control, clear the Use property default check box and enter the text in the Label value field.
  4. Optional: To make data entry faster, in the Default value field, enter a default entry.
    You can enter a constant value, a property reference, or an expression for a user form or a flow action form that is displayed in read-write mode.
  5. Optional: To specify instructional text or hints within the calendar control field, in the Placeholder field, select one of the following settings:
    • To display the localized DateTime format for this control, select Expected format.
    • To display instructional text within the calendar control field, select Other.

      In the field below, press the Down Arrow key to select existing, preset text.

      Click the Open icon to enter a new instruction or hint.

  6. Optional: To describe the control's purpose to users at run time, in the Helper text field, select one of the following settings:
    • To display the text next to the calendar field, select Always visible / In-line.
    • To add an icon to a control with a text displayed when the user hovers over the icon, selectHelp icon with overlay on hover.

      In the field below, press the Down Arrow key to select existing, preset text.

      Click the Open icon to enter a new instruction or hint.

    • To display the text when the user hovers over the field, select Tooltip (not recommended).

      In the field below, press the Down Arrow key to select existing, preset text.

      Click the Open icon to enter a new instruction or hint.

  7. In the Visibility field, choose when you want to display the property value:
    • Always, If not blank, or Not zeroto display the field or hide it, based on the property value at the time that this section or flow action is first presented or refreshed.
    • To make the visibility dependent on an expression, select Condition (expression).

      In the field below, press the Down arrow key to select a condition.

      Click the Open condition builder icon to open the Condition Builder.

    • To make the visibility dependent on a when rule, select Condition (when rule).

      In the field below, press the Down arrow key to select a when rule.

      Click the Open icon to create a new one.

  8. In the Disable field, specify when the control is not available to users:
    • Always – Always disabled
    • To disable the text input under the specified condition, select Condition (expression). In the field that is displayed, select a condition or click the Open condition builder icon to open the Condition Builder.

      You can define a simple expression based on the comparison of a pair of constants, properties, or both.

    • To disable the text input under the specified when condition, select Condition (when). In the field that is displayed, select a when rule. Click the Open icon to create a when condition or review an existing when condition.
    When you select the Condition (expression) option, you can set the condition to .Color="Red" and combine the expression with a when condition rule or another expression by using the && and || operators.
  9. Optional: To specify when the users have to enter a value for this field to save the form, in the Required field, select one of the following settings:
    • To make the field always required, select Always.

      At run time, the field is marked with an orange asterisk.

    • To make the field required under the specified condition, select Condition (expression). In the field that is displayed, select a condition or click the Open condition builder icon to open the Condition Builder.

      You can define a simple expression based on the comparison of a pair of constants, properties, or both.

    • To make the field required under the when condition, select Condition (when). In the field that is displayed, select a when rule. Click the Open icon to create a when condition or review an existing when condition.
    When you select the Condition (expression) option, you can set the condition to .Color="Red" and combine the expression with a when condition rule or another expression by using the && and || operators.
  10. Click Submit.