Spring '23 Designer Updates
Validation Editor
Validations have been moved from the “conditions” tab on the right panel of each field and are now present on a separate “validation” tab. The validation editor delivers 2 main features:
- Single and multi-message validations easily configured without technical knowledge of JSON.
- Based on component type, standard or special case validations will be present on the validation tab.
Single Message vs. Multi-Message Validations
Validation (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 required validation is violated:
Form user experience when max character validation is violated:
Validation (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:
- Section
- Expandable Section
- Tabs Container
- Tabs Group
- Dropdown
- Checkbox Group
- Button Group
- Numeric Slider
- Location (Lat/Long)
- Single Checkbox
- Switch
- Radio Buttons
- Image
- Sketch
- Signature
- List
- Dropdown List
- Image Grid
- Grid
- Read-Only Grid
- Table
Special case validations are specific to a component type. These additional validations are in addition to the standard validations.
Numeric Component Validations
- Minimum value (greater than, greater than or equal to)
- 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:
- Integer Input
- Decimal Input
Text Component Validations
- Number of characters (minimum or maximum number of characters)
- Match expression
- Case sensitive (detect capitalization)
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:
- Text Input
- Multi-Line Text Input
Date Component Validations
- Cannot be in the past
- Cannot be the in future
- 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:
- Date
- Date/Time
Duration/Time Component Validations
- Start time
- 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:
- Time
- Duration
The following components do not have a validation tab on the right panel:
- Static Image Grid
- Workflow Transition Button
- Launch URL Button
- Search Button
- Bar Chart
- Pie Chart
- Line Graph
Component Selector Redesign
Form designers can build forms faster with improved component organization and new field type configurations.
The “Component Selector” tab on the left panel has a new look and new features. The new component selector tab includes 3 main updates:
- New drag-and-drop component that was previously only offered as configuration for existing component
- Updated groupings, names, and descriptions
- Expand/collapse all functionality
New Drag-and-Drop Component
The following is newly available in the components list:
Updated Component Groupings, Names, and Descriptions
The following component group names have changed:
The “Graphs & Charts” component group name did not change.
The following component names have changed:
Expand and Collapse All
Click “Expand All” or “Collapse All” at the top of the Component Selector Tab to expand all sections or collapse all sections.
Label Calculations
Form designers can now easily add dynamic labels to all field types
The calculation option for the label field on the right panel presentation properties tab has been applied to additional field types.
The following fields have had calculations added as an available option to field labels:
- Section
- Expandable Section
- Tabs Container
- Tab
- List
- Read-Only Grid
By default, every field will have the label dropdown set to “constant” with the pre-populated label name. If the forms designer selects “calculation” in the label dropdown, then the calculation editor appears. If the forms designer selects “None” in the label dropdown then the label will be removed from the field.