Form designers can easily add custom validations to fields with the Validation Editor.

Single Message vs. Multi-Message Validations

Single Message

Select Validation (Single Message) if you want one message to show when a field input is invalid. You can add one or more validations (required, min/max characters, etc.) but only have a single message displayed to the form user if what they input is invalid. 

Example

Designer Setup: 

Form user experience when max character validation is violated: 

Multi-Message

Select Validation (Multi-Message) if you want a different message to be displayed for each validation. Only one of the messages will be shown to the form user based on which of the 2 or more validations are violated. You should only use multi-message if you have more than one validation for a particular field. Validation messages are shown in the order that they appear on the validation tab. If more than one validation is violated, only the message for the validation that appears first in the list on the validation tab will be shown. 

Example 

Designer Setup: 

Form User experience when required validation is violated: 

Form user experience when max character validation is violated: 

Standard or Special Case Validations Based on Component Type

Standard validations are applicable to all component types in Mirata. Standard validations include denoting a field as required and adding a validation using a calculation.

The following components have standard validations only: 

1. Section
2. Expandable Section
3. Tabs Container
4. Tabs Group
5. Dropdown
6. Checkbox Group
7. Button Group
8. Numeric Slider
9. Location (Lat/Long)
10. Single Checkbox
11. Switch
12. Radio Buttons
13. Image
14. Sketch
15. Signature
16. List
17. Dropdown List
18. Image Grid
19. Grid
20. Read-Only Grid
21. Table

Special case validations are specific to a component type. These additional validations are in addition to the standard validations. 

Numeric Component Validations

1. Minimum value (greater than, greater than or equal to)
2. Maximum value (less than, less than or equal to)
   

You can select a minimum value, maximum value, or both to denote a range of acceptable values. 

If you check “include this value” for the minimum and/or maximum value the number will be included in the range, implementing a greater than or equal to / less than or equal to validation. 

If a field is required, then it must follow the minimum/maximum value rules. If a field is not required, then the validation will only apply if a value is entered into the field. 

The following components are considered numeric fields: 

1. Integer Input
2. Decimal Input

Text Component Validations

You can select a minimum value, maximum value, or both to denote a range of acceptable characters. 

If a field is required, then it must follow the character count rules. If a field is not required, then the validation will only apply if a value is entered into the field. 

If “show mask” is applied to a match expression, a preview will be shown to the user of the required format (i.e. if you require the format “###-####” for a phone number entry, “___ - ____” will show in the entry field and will disappear as characters are entered).

The following components are considered text fields: 

1. Text Input
2. Multi-Line Text Input

Date Component Validations

1. Cannot be in the past 
2. Cannot be the in future 
3. Set date range
   

If a field is required, then it must follow the date field validation rules. If a field is not required, then the validation will only apply if a date is entered into the field. 

If “today’s date is allowed” is applied, then today’s date is a valid selection for a past or future date restriction. 

If “include this date” is applied, then the beginning date or the end date of the range is a valid selection. You can include this date for the beginning date of the range, the end date of the range, or both.

The following components are considered date fields: 

1. Date
2. Date/Time

Duration/Time Component Validations

1. Start time
2. End time

If a field is required, then it must follow the duration field validation rules. If a field is not required, then the validation will only apply if a value is entered into the field. 

The start time and end time validations are always inclusive. 

The following components are considered duration/time fields: 

1. Time
2. Duration
   

The following components do not have a validation tab on the right panel: 

1. Static Image Grid
2. Workflow Transition Button
3. Launch URL Button
4. Search Button
5. Bar Chart
6. Pie Chart
7. Line Graph