12.1.2.1.1.1.3.1. Control 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 Preview: Web View

     • In the web application, mandatory fields are visually distinguished with a light-yellow background color.
       
     • 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. Required 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 Required 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 values in a date format. (In other words, users must specify the earliest and latest dates that can be selected in the control.)
       

   • Required Range 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.
     

*When the Required 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
  • Required 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.