Questionnaire

Content Type: Module
Categories: Utility,Communication

Overview

Use this module to configure complex reflexive questionnaires for your users. You can create many different types of questions and render them in multiple ways.

Documentation

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

  • Community Commons module
  • Data Widgets module
  • Atlas Core module
  • Studio Pro 9.24.16
  • Combo Box
  • Tool Tip

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


Frequently Asked Questions

Releases

Version: 6.0.0
Framework Version: 9.24.16
Release Notes: upgrade to 9.24.16f for compatibility with Studio Pro 10 upgraded dependencies and widgets used for compatibility with Studio Pro 10
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