iFormBuilder Smart Controls
- 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?
Don't see the Tutorials tab? Talk to a support agent about getting Walk-Me installed in your environment.
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.
STEP 1. With your form loaded in the Form Builder, highlight the element you want to add the Client Validation to. PLEASE NOTE: In this example, we will be working with a Number element.
STEP 2. On the right-hand menu, scroll down to the Smart Control section.
STEP 3. 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.
iFormBuilder Tip: Use || for or and && for and
STEP 4. In the Validation Message field, enter the message you want the user to see if the validation fails. 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.
STEP 5. Save your form.
STEP 6. Test the functionality 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.
PLEASE NOTE: Client Validation will be evaluated whether the field is showing or hiding. Please keep that in mind when you are testing out your forms.