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

  • Studio Pro 9.24.21
  • Community Commons module
  • Data Widgets module
  • Atlas Core module
  • Combo Box widget
  • HTML Element widget
  • Tool Tip widget
  • Accordion widget

Installation

  1. Add the module role Administrator to the user roles that need to configure questionnaires.
  2. Add the module role Reviewer to the user roles that need to be able to review answers from submitted questionnaires.
  3. Add the module role User to the user roles that need to conduct questionnaires.
  4. Add the SNIP_Configuration_Overview to a page that is accessible to a user with the Administrator role. Add SNIP_Configuration_List_Published 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 'Configure'
  2. Add your type of question to the enumeration 'ENUM_ElementConfigurationType'
  3. Create an entity specialized from ElementConfiguration 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 'ACT_ElementConfiguration_Edit'
  7. Now we move to the folder ' Conduct'
  8. Add the render modes belonging to your question type to the enumeration 'ENUM_RenderMode'
  9. If your question has a new input type. Add the input belonging to your question type to the enumeration 'ENUM_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 'SUB_Element_Create' and 'SUB_Option_Create'
  12. If your question has a new input type. Extend the microflow 'SUB_Element_Save' and 'VAL_Element' for handling the new input type
  13. If your question has a new input type. Extend the microflow 'SUB_GetAnswer' for handling the new input type when exporting results

 

Frequently Asked Questions

Releases

Version: 6.2.4
Framework Version: 9.24.21
Release Notes: fixes - there was one remaining database retrieve that could cause the questionnaire not to update properly. changes - minor layout changes
Version: 6.2.3
Framework Version: 9.24.21
Release Notes: Changes - updated list input element to use datagrid 2 for grid or field selection configuration - updated Questionnaire results snippet fixes - Updated permissions for Reviewer and User role to ensure proper functioning of the questionnaire -
Version: 6.2.2
Framework Version: 9.24.21
Release Notes: Changes - spelling correction - minor logic improvements - added exposed workflow actions for creating and submitting Questionnaires - updated Rich Text and HTML Element widgets Fixes - fixed updating question options depending on previous answers. Known issue: option popups currently cannot show depending options
Version: 6.2.1
Framework Version: 9.24.21
Release Notes: Fixed - fixed validation for Table Input element - fixed dependencies not updating properly. Changes - BREAKING CHANGE: Questionnaires are no longer committed during conduction, but only when submitted. When updating to this version, questionnaires that have been started but not submitted, might break. - updated Questionnaire snippets with reusable snippets - updated Configuration pages styling
Version: 6.2.0
Framework Version: 9.24.21
Release Notes: Changes - BREAKING CHANGE: Questionnaires are no longer committed during conduction, but only when submitted. When updating to this version, questionnaires that have been started but not submitted, might break. - updated Questionnaire snippets with reusable snippets - updated Configuration pages styling
Version: 6.1.3
Framework Version: 9.24.17
Release Notes: Changes - added option to withdraw a published Configuration so that the it can be edited again, instead of having to edit a new draft revision.
Version: 6.1.2
Framework Version: 9.24.17
Release Notes: - fixes some delete buttons closing the page when this wasn't necessary - fixes some combo boxes that have the option to clear the value when this wasn't supposed to be an empty value - update to SNIP_Configuration_Overview to add tabs for ReadMe and Published questionnaires
Version: 6.1.1
Framework Version: 9.24.17
Release Notes: Changes - added IsDefault attribute to Configuration to set a Published Configuration as a default for creating Questionnaires - minor changes to configuration pages - upgraded to 9.24.17 Fixes - fixed issue with adding conditional visibility of question when it is newly created.
Version: 6.1.0
Framework Version: 9.24.16
Release Notes: - added new TableConfiguration option to Configuration, allowing you to create two-column tables, where users can fill in answers in second column. - replaced outdated - now showing sequence numbering in questionnaire - added association from Element to Questionnaire and SNIP_Element_ByQuestionnaire snippet to enable showing questionnaire without paging - fixed minor issues
Version: 6.0.1
Framework Version: 9.24.16
Release Notes: - updated widgets to modern alternatives (Data Widgets, Combo Box, Rich Text, Accordion). Please update widgets before importing this module - Removed old/deprecated styling - added option for Reviewer role to see the results of a questionnaire