WHAT'S COVERED IN THIS ARTICLE?
- What are Smart Controls?
- What is Client Validation?
- What is a Validation Message?
- How do I add Client Validation to an element?
WHAT ARE SMART CONTROLS?
WHAT IS CLIENT VALIDATION?
Client Validation allows...
- Form builders to prevent illegitimate data to be uploaded to the server.
- Form builders to set multiple validation criteria on an element.
The client validation value must be true for a particular element to pass validation. This smart control is located on the Element Properties menu (on the right-hand side in form builder).
What is a Validation Message?
The Validation Message helps...
- instruct data collectors as to where the error in their data lies.
- enforce complex criteria within your form.
How do I Add Client Validation to an element?
To add Client Validation to your element, please follow the instruction below.
Example: Teachers have to enter students' test results on a form and the score ranges from 0 to 100.
Highlight the element you want to add the Client Validation to. In this example, we will be working with a Number element.
On the right-hand menu, scroll down to the Smart Control section.
In the Client Validation field, enter the following: test_results >= 0 && test_results <= 100. This indicates that the number entered by the user must be greater than or equal to 0 and less than or equal to 100.
Tips: Use || for or and && for and
In the Validation Message field, enter the message you want the user to see if the validation is not true. For example: "Please enter a number between 0 and 100"
PLEASE NOTE: Validation messages MUST be wrapped in quotation marks in order to display on the device correctly.
Test it out on your device. If a user enters a number that is not in the range from 0 to 100, the Validation Message will be shown upon submitting the record.