Actions

Difference between revisions of "Question groups - introduction"

From LimeSurvey Manual

(Add information about relevance and tip about prefill url)
(Marked this version for translation)
 
(42 intermediate revisions by 4 users not shown)
Line 12: Line 12:
  
 
<!--T:19-->
 
<!--T:19-->
To start adding question groups to your survey, access the [[Survey structure|survey structure]] page and locate in the left menu the '''add question group''' button.
+
Groups are a great way to organize your surveys by placing them into categories (groups).  How you categorize your surveys/groups is completely up to you. 
 +
 
 +
<!--T:69-->
 +
To add question groups to your survey:
 +
 
 +
<!--T:63-->
 +
(1) From the [[Survey structure|survey '''structure''']] tab of your survey click '''+Add question group'''.  
  
 
    
 
    
 
<!--T:20-->
 
<!--T:20-->
<center>[[File:Option 2 - create a question group.png]]</center>
+
[[File:Option 2 - create a question group.png]]
  
  
 
<!--T:21-->
 
<!--T:21-->
After you click on it, the add question group panel will be showed up:
+
After you click ''Add question group'', the add question group panel will be displayed.
 +
 
 +
<!--T:64-->
 +
(2) Complete the required fields.
  
  
Line 28: Line 37:
  
 
<!--T:4-->
 
<!--T:4-->
Please note that you can create as many groups as you like!
+
''Add question group'' fields
  
 
<!--T:23-->
 
<!--T:23-->
The following fields will be displayed:
 
 
*'''Title:''' Type in this box the name you wish to give to the question group;
 
*'''Title:''' Type in this box the name you wish to give to the question group;
  
Line 41: Line 49:
  
 
<!--T:10-->
 
<!--T:10-->
*'''Relevance equation:''' You can set a "relevance equation" in this field for the group with the help of the [[Expression Manager|Expression Manager]]. This is helpful for "looping" or other cases where you are repeating similar content multiple times. For example, say you want to ask the same set of follow-up questions for each child in a household and you have asked how many children are there via a question named ''numKids''. Then, for each group of follow-up questions you would have to use relevance equations (which would collect data about the third child) such as: '''numKids == 3''';
+
*'''Relevance equation:''' You can set a "relevance equation" in this field for the group with the help of the [[ExpressionScript - Presentation|ExpressionScript]]. This is helpful for "looping" or other cases where you are repeating similar content multiple times. For example, say you want to ask the same set of follow-up questions for each child in a household and you have asked how many children are there via a question named ''numKids''. Then, for each group of follow-up questions you would have to use relevance equations (which would collect data about the third child) such as: '''numKids == 3''';
  
 
<!--T:11-->
 
<!--T:11-->
<div class="simplebox">[[File:help.png]] '''Note:''' An explanation and example for hiding question groups are available in the [[Expression Manager examples#Hide_question_group_if_answer_from_previous_question_is_Yes_or_No|Expression Manager examples wiki subsection]].</div>
+
<div class="simplebox">[[File:help.png]] '''Note:''' An explanation and example for hiding question groups are available in the [[https://manual.limesurvey.org/ExpressionScript_examples#Hide_question_group_if_answer_from_previous_question_is_Yes_or_No|ExpressionScript examples wiki subsection]].</div>
  
 
<!--T:6-->
 
<!--T:6-->
 
<div class="simplebox">[[File:help.png]] '''Hint:''' Groups can be used to group questions in a survey. If you are going to have multiple groups, you should note that the survey questions will be displayed group by group by default (you can change that from your [[General settings|survey settings]]). To display the groups in a particular order using the group reordering feature. If you have only one group in your survey then the name of this group is irrelevant (except for the survey format).</div>
 
<div class="simplebox">[[File:help.png]] '''Hint:''' Groups can be used to group questions in a survey. If you are going to have multiple groups, you should note that the survey questions will be displayed group by group by default (you can change that from your [[General settings|survey settings]]). To display the groups in a particular order using the group reordering feature. If you have only one group in your survey then the name of this group is irrelevant (except for the survey format).</div>
 +
 +
 +
<!--T:65-->
 +
You can create as many groups as you like!
 +
  
  
Line 54: Line 67:
  
 
<!--T:25-->
 
<!--T:25-->
You may find on the top toolbar the following options:
+
You will find the following options on the top toolbar:
  
  
Line 62: Line 75:
  
 
<!--T:27-->
 
<!--T:27-->
* '''Display/Export''': This function is used to export your whole survey in different formats;
+
* '''Display/Export''': This function is used to export your whole survey in different formats.
* '''Survey participants:''' Clicking on this button will redirect the survey administrator to his/her [[Survey participants|survey participants table]];
+
* '''Survey participants:''' Clicking this button will redirect the survey administrator to his/her [[Survey participants|survey participants table]].
* '''Responses:''' If the survey is active, the button becomes visible. It offers you access to the responses table;
+
* '''Responses:''' If the survey is active, the button becomes visible. It offers you access to the responses table.
 
* '''Import a group:''' Besides the two ways [[Question groups - introduction#Create question group|mentioned above]], new question groups can also be added via the [[Question groups - introduction#Import a question group|import group function]].
 
* '''Import a group:''' Besides the two ways [[Question groups - introduction#Create question group|mentioned above]], new question groups can also be added via the [[Question groups - introduction#Import a question group|import group function]].
 
  
 
==Import a question group== <!--T:28-->
 
==Import a question group== <!--T:28-->
Line 72: Line 84:
  
 
<!--T:29-->
 
<!--T:29-->
You can also import a question group (.lsg file format) that was previously exported from a LimeSurvey survey. First, access the '''add question group''' option and then locate on the top toolbar the import question group function:
+
You can also import a question group (.lsg file format) that was previously exported from a LimeSurvey survey.  
 +
 
 +
 
 +
<!--T:66-->
 +
(1) From the survey '''Structure''' tab, click '''+Add question group'''.
 +
 
 +
<!--T:67-->
 +
(2) Click '''Import a group''' on the top toolbar
  
  
 
<!--T:30-->
 
<!--T:30-->
<center>[[File:Import question group 1.png]]</center>
+
[[File:ImportQuestionGroup.png]]
  
  
 
<!--T:31-->
 
<!--T:31-->
Browse your computer/server and upload the .lsg file that contains the question group you wish to import.
+
(3) '''Browse''' your computer/server and upload the .lsg file that contains the question group you wish to import.
 +
 
 +
 
 +
<!--T:68-->
 +
[[File:ImportQuestionGroupII.png]]
  
 
=Question group actions= <!--T:32-->  
 
=Question group actions= <!--T:32-->  
Line 97: Line 120:
  
 
<!--T:36-->
 
<!--T:36-->
*'''Question group toolbar:''' You may find on the toolbar the following options:
+
*'''Question group toolbar:''' You will find the following options on the toolbar:
**''Preview survey/question group:'' Click on one of the two buttons to either preview your whole survey or only the current question group. If additional languages were added to your survey, the survey/question group can be previewed in each language of the survey. Just simply click on one of the two ''preview'' buttons and select the desired language;
+
**''Preview survey/question group:'' Click one of the two buttons to either preview your whole survey or only the current question group. If additional languages were added to your survey, the survey/question group can be previewed in each language of the survey. Just click one of the two ''preview'' buttons and select the desired language.
**''Edit current question group:'' Click on this button if you wish to edit the title, description, relevance equation, or randomization group of the current question group;
+
**''Edit current question group:'' Click this button to edit the title, description, relevance equation, or randomization group of the current question group.
**''Check survey logic for current question group:'' It helps you see the possible errors that might exist within a question group - it is especially useful when the [[Expression Manager|expression manager]] is employed.
+
**''Check survey logic for current question group:'' This helps you see the possible errors that might exist within a question group - it is especially useful when the [[ExpressionScript - Presentation|ExpressionScript]] is used.
**''Delete current question group:'' If you wish to delete the current question group, click on this button.
+
**''Delete current question group:'' To delete the current question group, click this button.
**''Export this question group:'' If you wish to export this question group to later import it into another LimeSurvey survey, click on this button. The file will be exported in the .lsg format.
+
**''Export this question group:'' If you wish to export this question group to later import it into another LimeSurvey survey, click this button. The file will be exported in the .lsg format.
  
 
<!--T:37-->
 
<!--T:37-->
Line 108: Line 131:
  
 
<!--T:38-->
 
<!--T:38-->
*'''Group quick actions:''' It allows you to quickly perform question-groups-related actions - in our case, the add new question to group option is displayed. To find out more about questions, read our [[Questions - introduction|introductory wiki section on question]].
+
*'''Group quick actions:''' This allows you to quickly perform question-groups-related actions - in our case, the add new question to group option is displayed. To find out more about questions, read our [[Questions - introduction|introductory wiki section on question]].
 
 
  
 
=Preview question group= <!--T:42-->
 
=Preview question group= <!--T:42-->
Line 115: Line 137:
  
 
<!--T:43-->
 
<!--T:43-->
Once you have started to add questions into your group, you may want from time to time to preview how the respective question group looks like. To do that, look for the '''question group''' button that can be accessed from the:
+
Once you have started to add questions into your group, you may want from time to time to preview how the respective question group looks. To do that, look for the '''question group''' button that can be accessed from the:
  
 
<!--T:44-->
 
<!--T:44-->
Line 122: Line 144:
 
*[[Question groups - introduction#Preview question group - question panel|question panel]]
 
*[[Question groups - introduction#Preview question group - question panel|question panel]]
  
{{Note|When preview a group, the relevance of this group is forced to be true.}}
+
<!--T:61-->
 +
{{Note|When previewing a group, the relevance of this group is automatically forced to true.}}
  
{{Hint|Text=You can add [[URL_fields#Prefilling_a_survey_using_GET_parameters|GET params in URL]] to set some previous question answer used in Expression.}}  
+
<!--T:62-->
 +
{{Hint|Text=You can add [[URL_fields#Prefilling_a_survey_using_GET_parameters|GET params in URL]] to prefill questions.}}  
  
 
==Preview question group - survey structure== <!--T:45-->
 
==Preview question group - survey structure== <!--T:45-->
Line 130: Line 154:
  
 
<!--T:46-->
 
<!--T:46-->
Click on the survey structure, select the desired question group, and click on the '''preview question group''' button:
+
Click the survey '''Structure''' tab, select the desired '''Question group''', and click '''preview question group''':
  
  
 
<!--T:47-->
 
<!--T:47-->
 
<center>[[File:Preview q group - survey structure.png]]</center>
 
<center>[[File:Preview q group - survey structure.png]]</center>
 
  
 
==Preview question group - question group panel== <!--T:48-->
 
==Preview question group - question group panel== <!--T:48-->
Line 141: Line 164:
  
 
<!--T:49-->
 
<!--T:49-->
You can preview the question group once you have finished editing it:
+
You can preview the question group once you have finished editing it.
  
  
Line 147: Line 170:
 
<center>[[File:Question group panel - preview.png]]</center>
 
<center>[[File:Question group panel - preview.png]]</center>
  
 
+
==preview question group - question panel== <!--T:51-->
==Preview question group - question panel== <!--T:51-->
 
  
 
<!--T:52-->
 
<!--T:52-->
The question group to which question belongs to can be previewed from the question panel - see the top bar:
+
The question group to which questions belong can be previewed from the question panel - see the top bar:
  
  
Line 161: Line 183:
  
 
<!--T:40-->
 
<!--T:40-->
The question groups and questions can be reordered as many times as you like. For further details, check the following [[Survey structure#Reordering questions and question groups|survey structure wiki subsection]].
+
The question groups and questions can be reordered. For further details, read the [[Survey structure#Reordering questions and question groups|survey structure wiki subsection]].
 
 
  
 
=Example= <!--T:54-->
 
=Example= <!--T:54-->
Line 168: Line 189:
  
 
<!--T:55-->
 
<!--T:55-->
The relevance equation offers us many possibilities to further customize our survey. A simple example is presented below to show how some question groups can be hidden according to the answer provided by the respondent to a prior question (part of another question group). For example, if you want to find out more information about parents that have one child in comparison to those with two or more, using the relevance equation to hide certain questions/question groups could be recommended.
+
The relevance equation offers many possibilities to further customize your survey. A simple example is presented below to show how some question groups can be hidden according to the answer provided by the respondent to a prior question (part of another question group). For example, if you want to find out more information about parents that have one child in comparison to those with two or more, using the relevance equation to hide certain questions/question groups is recommended.
  
  
 
<!--T:56-->
 
<!--T:56-->
Link .lss file: [[Media:Question_groups_simple_example.zip|Question_groups_simple_example.zip]] -> to import it, read the following [[Surveys_-_introduction#Import_a_survey|wiki section]].
+
Link .lss file: [[Media:Question_groups_simple_example.zip|Question_groups_simple_example.zip]] -> For instructions on how to import the file, refer to the following [[Surveys_-_introduction#Import_a_survey|wiki section]].
  
  
Line 183: Line 204:
  
 
<!--T:59-->
 
<!--T:59-->
This is just a simple example to show you how expressions can be used to further customize your survey. For further details, please start reading further about the [[Expression Manager]].  
+
This is just a simple example to show how expressions can be used to further customize your survey. For more details, please read about the [[ExpressionScript - Presentation|ExpressionScript]] functionality.  
  
 
<!--T:60-->
 
<!--T:60-->
 
<div class='simplebox'>[[File:help.png]] '''Notes:'''  
 
<div class='simplebox'>[[File:help.png]] '''Notes:'''  
*There are many ways through which you can hide questions. One way is to use [[Setting conditions|conditions]]. However, for more complex surveys, the [[Expression Manager]] has to be used.
+
*There are several ways to hide questions. One is to use [[Setting conditions|conditions]]. However, for more complex surveys, the [[ExpressionScript - Presentation|ExpressionScript]] has to be used.
 
*If you use expressions, don't forget to look for syntax errors with the help of the logic file.</div>
 
*If you use expressions, don't forget to look for syntax errors with the help of the logic file.</div>
  
 
</translate>
 
</translate>

Latest revision as of 19:20, 9 August 2021

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎italiano • ‎slovenščina • ‎русский • ‎日本語


Help.png Please note that the below explanations and screenshots are based on LimeSurvey 3.


Create question group

Groups are a great way to organize your surveys by placing them into categories (groups). How you categorize your surveys/groups is completely up to you.

To add question groups to your survey:

(1) From the survey structure tab of your survey click +Add question group.


Option 2 - create a question group.png


After you click Add question group, the add question group panel will be displayed.

(2) Complete the required fields.


Add question group panel.png


Add question group fields

  • Title: Type in this box the name you wish to give to the question group;
  • Description: This field allows you to publish an explanatory note for any set of questions. If you add a description, it will be presented along with the survey before commencing any of the questions in that group. If no text is added, then public participants will simply move straightaway to the survey questions. You can use the HTML editor to include images, formatted text, etc. to your liking;
  • Randomization group: To start randomizing a question group, enter a string into the field such as randgroup1. You will need to enter that same string in all question groups that you want to randomize and which will then appear in a random order when taking the survey. Only places inside the same group will be randomly switched!
  • Relevance equation: You can set a "relevance equation" in this field for the group with the help of the ExpressionScript. This is helpful for "looping" or other cases where you are repeating similar content multiple times. For example, say you want to ask the same set of follow-up questions for each child in a household and you have asked how many children are there via a question named numKids. Then, for each group of follow-up questions you would have to use relevance equations (which would collect data about the third child) such as: numKids == 3;
Help.png Note: An explanation and example for hiding question groups are available in the [examples wiki subsection].
Help.png Hint: Groups can be used to group questions in a survey. If you are going to have multiple groups, you should note that the survey questions will be displayed group by group by default (you can change that from your survey settings). To display the groups in a particular order using the group reordering feature. If you have only one group in your survey then the name of this group is irrelevant (except for the survey format).


You can create as many groups as you like!


Add question group toolbar

You will find the following options on the top toolbar:


Add question group - toolbar.png


  • Display/Export: This function is used to export your whole survey in different formats.
  • Survey participants: Clicking this button will redirect the survey administrator to his/her survey participants table.
  • Responses: If the survey is active, the button becomes visible. It offers you access to the responses table.
  • Import a group: Besides the two ways mentioned above, new question groups can also be added via the import group function.

Import a question group

You can also import a question group (.lsg file format) that was previously exported from a LimeSurvey survey.


(1) From the survey Structure tab, click +Add question group.

(2) Click Import a group on the top toolbar.


ImportQuestionGroup.png


(3) Browse your computer/server and upload the .lsg file that contains the question group you wish to import.


ImportQuestionGroupII.png

Question group actions

After the creation of a survey, you can access the newly created group from the survey structure menu. The following page will be displayed:


Question group - after its creation.png


The page is divided into three sections:

  • Question group toolbar: You will find the following options on the toolbar:
    • Preview survey/question group: Click one of the two buttons to either preview your whole survey or only the current question group. If additional languages were added to your survey, the survey/question group can be previewed in each language of the survey. Just click one of the two preview buttons and select the desired language.
    • Edit current question group: Click this button to edit the title, description, relevance equation, or randomization group of the current question group.
    • Check survey logic for current question group: This helps you see the possible errors that might exist within a question group - it is especially useful when the ExpressionScript is used.
    • Delete current question group: To delete the current question group, click this button.
    • Export this question group: If you wish to export this question group to later import it into another LimeSurvey survey, click this button. The file will be exported in the .lsg format.
  • Group quick actions: This allows you to quickly perform question-groups-related actions - in our case, the add new question to group option is displayed. To find out more about questions, read our introductory wiki section on question.

Preview question group

Once you have started to add questions into your group, you may want from time to time to preview how the respective question group looks. To do that, look for the question group button that can be accessed from the:

Help.pngWhen previewing a group, the relevance of this group is automatically forced to true.
Notice.png
 Hint: You can add GET params in URL to prefill questions.


Preview question group - survey structure

Click the survey Structure tab, select the desired Question group, and click preview question group:


Preview q group - survey structure.png

Preview question group - question group panel

You can preview the question group once you have finished editing it.


Question group panel - preview.png

preview question group - question panel

The question group to which questions belong can be previewed from the question panel - see the top bar:


Preview question group - question panel.png

Reordering question groups

The question groups and questions can be reordered. For further details, read the survey structure wiki subsection.

Example

The relevance equation offers many possibilities to further customize your survey. A simple example is presented below to show how some question groups can be hidden according to the answer provided by the respondent to a prior question (part of another question group). For example, if you want to find out more information about parents that have one child in comparison to those with two or more, using the relevance equation to hide certain questions/question groups is recommended.


Link .lss file: Question_groups_simple_example.zip -> For instructions on how to import the file, refer to the following wiki section.


Logic file question groups example.png


The above file contains three question groups, each containing one question. Question group "1kid" is displayed only if the value introduced by the respondent to the question "numkids" is 1. Question group "2ormorekids" is displayed only if the answer to the question "numkids" is >1.

This is just a simple example to show how expressions can be used to further customize your survey. For more details, please read about the ExpressionScript functionality.

Help.png Notes:
  • There are several ways to hide questions. One is to use conditions. However, for more complex surveys, the ExpressionScript has to be used.
  • If you use expressions, don't forget to look for syntax errors with the help of the logic file.