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?
Click here for more information on 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.
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.
Can a client validation reference another question in a form?
Could this be used for text area fields for a minimum ammount of text? for example a user MUST fill in at least 50 characters for that field/form to be submitted?
What would be the test to make sure that the number has always one decimal place and between 0 to 30?
Hi Guy, would you be willing to share the details of your validation scenario with us? You can either post below, or send us new request through the Help Desk.
Sorry, I had something else interfering - very hard to debug. I neglected to place the enclosing quotes on the validation message. This causes utter confusion until detected. I am deleting my post. Please feel free to remove the follow-ons. Thanks for responding. BTW, you might be amused that my requirement is to make a non-required element required. I am attempting to do that by adding a required checkbox to say that I have chosen to ignore the other field.
Please sign in to leave a comment.