Questionnaire

Category: Modules
Subcategory: All

Overview

This Questionnaire template allows you to configure complex reflexive questionnaires and spread them to be conducted by your users. Different types of questions (selectable option(s), date and number ranges, free text) can be configured and be rendered in different ways (for instance like a text box, slider, radio buttons, checkboxes etc.). Each question can be marked as required and depending on the type, ranges can be configured where the answer must lie in. Furthermore the visibility of questions and options can be dependent on earlier given answers. In addition the applicability of a range can also be dependent on an earlier given answer. During the development of the configuration the changes are tracked in revision which can always be restored.

Documentation

Demo url

Description

This Questionnaire module allows you to configure complex reflexive questionnaires and spread them to be conducted by your users. Different types of questions (selectable option(s), date and number ranges, free text) can be configured and be rendered in different ways (for instance like a text box, slider, radio buttons, checkboxes etc.). Each question can be marked as required and depending on the type, ranges can be configured where the answer must lie in.

Furthermore the visibility of questions and options can be dependent on earlier given answers. In addition the applicability of a range can also be dependent on an earlier given answer. During the development of the configuration the changes are tracked in revision which can always be restored.

Typical usage scenario

  • Create exams that have to be completed in order to receive a certificate.
  • Create surveys that you send to your (anonymous) users to collect information on a particular topic. you can use the Deeplink module to create personalised links for each questionnaire.

Features and limitations

  • Create many Configurations that contain all elements of your questionnaire. You can add Text, Number, Date and Choice elements to your questionnaire. by adding section and page elements you can create a multi-page survey.

Dependencies

Installation

  1. Add the module role Administrator to the user roles that need to configure questionnaires.
  2. Add the module role User to the user roles that need to conduct questionnaires.
  3. Add the Snip_Configuration to a page that is accessible to a user with the Administrator role. Add Snip_Publications to a page that is accessible to a user with the User role

Configuration

The module is easy to adapt to your wishes. Small adaptations won't influence the behaviour, but when new configuration options are added or existing are removed it will most likely have impact. To give insight to where you need to pay attention to when doing these type of changes there is a short instruction how different types of questions can be added below.

  1. Start in the folder 'ConfigureQuestionnaire'
  2. Add your type of question to the enumeration 'AddElement/ElementConfigType'
  3. Create an entity specialized from ElementConfig for configuring your question type
  4. If your question has options/ranges. Create an entity specialized from OptionConfig for configuring the option belonging to your question type
  5. Create forms for the just created objects (it is easy to use the existing forms as starting point)
  6. Add your just created form to the microflow 'EditDeleteElement/EditElementConfig'
  7. Now we move to the folder ' ConductQuestionnaire'
  8. Add the render modes belonging to your question type to the enumeration 'StartQuestionnaire/RenderMode'
  9. If your question has a new input type. Add the input belonging to your question type to the enumeration 'StartQuestionnaire/InputType'
  10. There are attributes for handling text, date and amount answers, but if the answer to your question differs you can add an attribute to the Element entity
  11. Add your new question and option type to the microflows 'StartQuestionnaire/CreateElement' and 'StartQuestionnaire/CreateOption'
  12. If your question has a new input type. Extend the microflow 'AnswerQuestion/SaveElement' and 'ValidateAnswer/ValidateElement' for handling the new input type
  13. If your question has a new input type. Extend the microflow 'DownloadResults/GetAnswer' for handling the new input type when exporting results

Known Issues

  • There will be some errors related to atlas layouts that can’t be found in Studio Pro 8.x.x. You can resolve applying layouts that you have in your UI Resources.
  • Import and export currently don’t work

Frequently Asked Questions

 

 

 

 

Releases

Version: 5.0.4
Framework Version: 8.12.7
Release Notes: - Upgrade to 8.12.7 for compatibility with Studio Pro 9.x.x
Version: 5.0.3
Framework Version: 8.6.9
Release Notes: - removed default value for attributes of NumberOptionConfig
Version: 5.0.2
Framework Version: 8.6.6
Release Notes: - Checkbox set selector does not change sorting anymore after something has been selected - Fixed issue in configuration of conditional visibility of questions - Thanks to Bart Rikers for the tips!
Version: 5.0.1
Framework Version: 8.6.6
Release Notes: - updated Checkbox and Radio button widgets to latest versions to solve client errors
Version: 5.0.0
Framework Version: 8.6.6
Release Notes: - Upgrade to 8.6.6 - added functionality to add images to your Elements - applied naming convention best practices to all project explorer items - removed unnecessary pages so that you can use snippets instead - restructured folders - removed inline styling -upgraded widgets