Questionnaire Designer examples

This article describes several useful examples of using the Questionnaire Designer.

Automatically fill fields using On Load rule

You might want that some fields are automatically filled in when a user starts the questionnaire.

1. Open On Load rule editor on a questionnaire.
2. Set up a rule with the following logic:
   1. Add the condition If the questionnaire is new.
   2. Add Step: For the question Date and Time set the value to now.
   3. Add Step: For the question Filled by set the value to the current user.
3. Save the rule, questionnaire, and test it in the application.

Access parent entity from On Load rule

The following example is similar to the example above, however, we want to fill in fields from the parent record of the questionnaire. In this case, it's actually a grandparent: The questionnaire's parent is the appointment from which it was initiated, and we want to add fields from the appointment's account to the questionnaire.

1. Add the regarding lookup component to your questionnaire. You can make it invisible in the app if you want. The component behaves just like a simple question, however, it is filled in automatically by the appointment reference from which the questionnaire is opened.
   
2. Click On Load to open the rule editor.
3. Create a local variable (lookup type) and load the regarding lookup into it.
4. Create a local variable (entity type) and load the parent appointment based on the reference.
   
5. Check if the appointment was loaded successfully, then save the appointment ID to a string variable and use the ID to find the account.
   
6. Check if the account was loaded successfully, then you can start adding steps that fill in questionnaire fields from the related account entity.
   

Show additional question depending on previous answer using On Change rule

When a user answers a question in a certain way, you might want to display additional questions. For example, married users need to provide the name of their partner.

1. Create a group with two questions:
   • A single choice question: Are you married? (Answers: Yes, No.)
   • A text question: Partner name. Invisible by default
2. Select the first question and click On Change.
3. Set up a rule with the following logic:
   1. Add the condition If: If the answer to the are-you-married question is Yes.
   2. Add Step: Then set visibility for the question partner-name to True.
   3. Add Else.
   4. Add Step: Else set visibility for the question partner-name to False.
4. Save the rule, questionnaire, and test it in the application.

Reuse questionnaire answers from related records

You can now use fetch variable {{Regarding}} to access (related) entity of activity, if the activity is regarding the record of the questionnaire. This means that you can reuse previous answers from a specific appointment, or a specific asset if opened through an appointment.

1. Edit a questionnaire template in Questionnaire Designer.
2. Select the top level of the questionnaire to display its properties.
3. Set Reuse Answers to your preferred option other than Never.
4. In the Reuse Fetch, click Modify.
5. The default filter has four conditions.
   • Click Add Condition and add the following condition:
     
   • Click Variable and select Regarding, then click OK.
     
6. Click Save & Close to close the filter editor, then click Save & Close to save the questionnaire template.

Add custom icon for questionnaire group

It is possible to add a custom icon for a question group in questionnaires.

1. Edit an app project in Woodford.
2. Select Design > Images from the Project menu.
3. Create a folder called "Questionnaire".
4. Add an icon with a name that matches the question group name.
5. Save everything and publish the app project.

Tip	You can also add an icon for completed groups. Use the name <group name>-complete​, or -complete as a default fall back if a group-specific image does not exist.