Validations & Logic
How to specify question length
Question length indicates the maximum number of letters, numbers and symbols allowed to be entered.
After open question’s edit page, select the max length.
How to determine min and max value for a number question
After adding a number question, you can determine min and max value by open edit number page then select the min and max value.
How to add regular expression validation to a question
For the of any text based question, you can find a predefined list of regular expressions based of the question type (Number, Text … ) or you can choose other and write any valid expression.
Open edit page then select the type of Regular expression.
How to change question default visibility
Click on edit icon of any question or control or page, and from the question settings you can uncheck or check the visible option to control whether the question will be shown or not once the user open the survey..
- Default visibility only affects the first display of questions before the user starts to answer and visibility then controlled by the rules.
How to change question default enable option
Open edit page then check the check box Read Only.
How to add unique answer validation to free text question
To add a unique answer, open the edit screen then click on Unique check box and write a message that will appear when repeating the same answer.
How to limit the number of chosen answer in multi check box list
When add checkbox list question, then open edit check box popup, select the max number of answers.
How to add new validation rule
From Logic page, click on NEW RULE.
How to duplicate a rule
From Logic page, click on duplicate icon (
) next to rule you want to duplicate it.
Click Save or change rule description.
How to delete a rule
From Logic page, click on delete icon (
) next to rule you want to delete it.
A popup message appear “Are you sure you want to delete the rule?”, click OK to delete the rule.
How to disable a rule
To disable a rule, click on the rule from Logic page then click on edit icon (
), click on Disabled check box.
How display all rules related to a question
From Logic page, click on get items rule icon (
) next to question you want to display all rules related to it, the rules will appear at left of screen.
- The displayed rules of the question whether the question was part of the condition or actions.
How to change the order of execution of rules added on a specific question
From Logic page, click on sort rules icon (
) next to question you want to change order of execution of rules added on its question.
A popup appear, sort the rules by drag and drop move then click Save.
- The importance of rules sequence per question is in the execution once the user answers the question; for example, if a question has error message rule and skip rule; if the skip rule has true result and executed then error message has false result and rolled back the answer entered by the user then the skip rule executed on a wrong answer.
How to add an error/ warning message validation rule
To display error or warning message to respondents while answering questions, do the following:
- Click New Rule from the upper left of the screen.
- Add Conditions based on questions value or function result or a mathematical equation result
- Click Actions tab.
- Select Error/Warning message from Action Type.
- Insert Message Text in English and Arabic.
The following screen shows an error message if the condition is verified.
How to add a skip logic rule
From Logic page, click on NEW RULE, then select conditions.
After filling the condition, now select actions and choose action type as Hide Question.
In the example above, if the answer to a question “Age?” equal “18”, the “Gender” question will hide.
How to hide/ show a survey statistical unit
From Logic page, click on NEW RULE, then select conditions.
After filling the condition, now select actions and choose action type as Hide Group / Show Group.
In the example above, if the answer to age question equal “18”, the tab 1 group will hide.
- Hide / show group used in grid, matrix, section, tab, and tab group.
How to hide/ show question answers based on a condition
In case to hide/show answer actions, do the following:
- Click New Rule from upper left of screen.
- Add Conditions based on questions value or function result or a mathematical equation result
- Click on Actions tab.
- Select (hide/show) answer from Action Type.
- Select Page.
- Select Questions (multiple answers question).
- Select Answers.
How to apply an action on a question in a specific row in a grid or matrix
From Logic page, click on NEW RULE, then select the condition.
After filling the condition, now select actions that will apply.
Then use (
) to determine where the action will be applied.
In the example above, if the number question in the grid equal “3”, the “text question label?” in this specific row will disable.
How to add a mathematical equation a set the result a specific question
From Logic page, click on NEW RULE, then select conditions.
After filling the condition, now select actions and choose action type as Set Value.
In the example above, if the question number1 “not null” and the question number2 “not null”, the total question will calculate the sum of two questions.
How to execute an action based on the result of a mathematical equation
From Logic page, click on NEW RULE, then select conditions “mathematical operation”.
Then use (
) To determine the calculation process.
After filling the condition, now select actions.
In the example above, If the sum of the two questions is 5000, the system will appear error message.
How to execute an action based on a combination of two or more conditions
When finish adding first condition, click on () to add more conditions.
You can add a set of condition in brackets by click on () icon.
- Use “And/or” condition to connect these conditions with each other
- In the case of “And” condition that means every condition must be met to apply the action, if one condition is not met, the rule will not apply the action.
How to use a predefined function and set it’s result in another question
From Logic page, click on NEW RULE, then select conditions.
After filling the condition, now select action type set value and choose function instead of answer or value then choose the function type and on what question should be applied if applicable.
In the example above, If the label number question in the grid equals “5”, the system will calculate the sum of label question rows and put it in the “total” question.
How to hide/ show a visual control in the survey
From Logic page, click on NEW RULE, then select conditions.
After filling the condition, now select actions and choose action type as Hide Control / Show Control.
In the example above, If the answer to the number question equal “18”, the system will hide the button.
Hide or Show controls used in Buttons, audio, notes, QR code, locate me, and icon.
How to control survey navigation based on a business conditions
From Logic page, click on NEW RULE, then select conditions.
After filling the condition, now select actions and choose action type as Go Action Path, then click on “Action Path” and choose where the system go when click on the button.
Then back to Builder page, open the edit button popup then choose “Add Rule” as the action path.
Then choose action path rule that created in logic page.
Click on Save.
