12.1.2.1.1.1.3.1. Control Governance – Validation

Users can configure validation properties for controls, such as required field and range validation.

!To configure validation for a control, users must first create a form behavior.

1. Required Field Validator: This is a checkbox which, if selected, allows users to enforce a control as mandatory and trigger a message to appear if the mandatory field is left unfilled.
   • If this checkbox is selected, it will enable the Required Field Validator tab.
     
     • In this tab, users can customize the error message to be displayed when the mandatory field is not filled out. Users can specify this message in different languages as well as designate a default language.

       **Users can determine which languages are available for use in the Settings of the Designer. Currently, however, only five languages are supported on the web server: English, French, German, Arabic, and Hebrew.

   • Required Field Validation Preview: Web View

     • By default, in the DBP web application, mandatory fields are visually distinguished with a light-blue background color.
       

       **Users can customize the color of mandatory fields in the Settings of the web application.

       ---

     • In the event that a user attempts to submit the form without filling out a mandatory field, the specified error message will appear towards the bottom of the page.
       

*When the Required Field Validator checkbox is selected, the form will prevent submission until the required field is completed, ensuring that important information is not missing.

2. Range Validator: This is a checkbox which, if selected, allows users to restrict a control to a specific range of values and trigger a message to appear if the range is not met.
   • If this checkbox is selected, it will enable the Range Validator tab.
     
     • In this tab, users can customize the behavior of range validation. They can specify the minimum and maximum values for the range, and define a custom error message to appear when the input value falls outside of the specified range. Users can specify this message in different languages as well as designate a default language.

       **Users can determine which languages are available for use in the Settings of the Designer. Currently, however, only five languages are supported on the web server: English, French, German, Arabic, and Hebrew.

     • Note: For date picker controls, users will need to specify the maximum and minimum date values using a date picker. (In other words, users must specify the earliest and latest dates that can be selected in the control.)
       

   • Range Validation Preview: Web View

     In the event that a user attempts to submit the form without entering a value within the required range, the specified error message will appear towards the bottom of the page.
     

     
     Note: For date picker controls, dates outside the specified range will be grayed out and inaccessible on the calendar.
     

*When the Range Validator checkbox is selected, the form will prevent submission until the required range is met, ensuring that important information is not entered incorrectly.

3. Apply: This button allows users to save their changes.
4. OK: This button allows users to save their changes and close the window.
5. Cancel: This button allows users to cancel their changes and close the window.

Fields with Configurable Validation

• To ensure the accuracy and completeness of the data entered into the form, certain controls have options for required field and range validation.
  • Required field validation is available for the following controls:
    • Comment
    • Date/Time Picker
    • File Attachment
    • Free Draw
    • Multi-Select Dropdown
    • Multi-Line Textbox
    • Numeric Textbox
    • Password Box
    • Radio-Button List
    • Rich Textbox
    • Single-Select Dropdown
    • Textbox
    • Time Duration
  • Range validation is available for the following controls:
    • Date/Time Picker
    • Numeric Textbox
      

!Users can apply field validation to a specific task in the workflow by changing the control form behavior.