Actions

Question groups - introduction/es: Difference between revisions

From LimeSurvey Manual

m (Text replace - "ú" to "ú")
(Updating to match new version of source page)
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages /> __TOC__
<languages /> __TOC__


=Creating a group=


Antes de poder [[Adding a question| a&ntilde;adir preguntas]] a tu encuesta, debes crear un grupo. Para crear un nuevo grupo debes presionar el icono A&ntilde;adir [[File:add.png]] situado en la barra de herramientas de LimeSurvey. También puedes importar un grupo que haya sido previamente exportado. No es posible importar grupos desde versiones de LimeSurvey anteriores a la 1.45 (PHPSurveyor).
<div class="simplebox">[[File:help.png]] Please note that the below explanations and screenshots are based on LimeSurvey 3.</div>


Si tu encuesta sólo tiene un grupo, el nombre de dicho grupo en este caso, es irrelevante (con la única excepción de que es el nombre que se utilizará cuando se muestre el grupo). Si, por el contrario, vas a utilizar múltiples grupos, recuerda que las preguntas de las encuestas se mostrarán por grupos (dependiendo de las opciones de configuración de la encuesta). Utiliza la función re-ordenar para mostrar los grupos en un determinado orden.


Puedes crear tantos grupos como quieras.
=Create question group=


Los grupos también pueden incluir una "descripción". Este campo te permite publicar una nota explicativa para cada grupo de preguntas.  Si a&ntilde;ades una descripción, cuando tus usuarios se encuentre utilizando una encuesta pública, LimeSurvey le mostrará esa descripción antes de que comiencen a responder las preguntas que se encuentran en ese grupo. Si no incluyes ningún texto en el campo descripción, los usuarios de tu encuesta podrán empezar a utilizarla directamente no stop. Utiliza el editor HTML para incluir imágenes, texto con formato, etc.


You can create as many groups as you like.
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.


=Using groups for summarizing questions=
 
<center>[[File:Option 2 - create a question group.png]]</center>


Groups can be used to group questions in a survey. If you are going to have multiple groups, you should note that by default the survey questions will be displayed group by group (you can change that at the survey settings). To display the groups in a particular order use the group re-ordering feature. If you have only one group in your survey then the name of this group is irrelevant (except of course for display).


=Group elements=
After you click on it, the add question group panel will be showed up:


Groups can also include a "description". This field allows you to publish an explanatory note for any set of questions. If you add a description, it will be presented at the survey before commencing any of the questions in that group. If you do not include any text here, then public participants will simply move on to the first question in the group with no stop. You can use the HTML editor to include images, formatted text, etc. to your liking.


=Show/Hide groups conditionally=
<center>[[File:Add question group panel.png]]</center>


Starting in version 1.92, you can set a Relevance Equation for the group using [[Expression Manager|Expression Manager]] syntax.  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 asked how many children there are via a question named ''numKids''.  Then, for each group of follow-up questions, you would use relevance equations the following (which would collect data about the third child):  '''numKids >= 3'''


An explanation and example for hiding question groups is available at the [Expression+Manager+Examples#Hide_question_group_if_answer_from_previous_question_is_Yes_or_No|Expression Manager Examples page].
Please note that you can create as many groups as you like!


=Question group randomization=
The following fields will be displayed:
*'''Title:''' Type in this box the name you wish to give to the question group;


Starting in version 2.0 you are now able to randomize the order of question groups. To do that just enter a string into the field 'Randomization group'. You will need to enter that same string in all the other groups who you want to randomize and which will then appear in a random order when taking the survey.
*'''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 <u>inside</u> 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 [[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''';
 
<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]] '''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>
 
 
==Add question group toolbar==
 
 
You may find on the top toolbar the following options:
 
 
<center>[[File:Add question group - toolbar.png]]</center>
 
 
* '''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]];
* '''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 question group==
 
 
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:
 
 
<center>[[File:Import question group 1.png]]</center>
 
 
Browse your computer/server and upload the .lsg file that contains the question group you wish to import.
 
=Question group actions=
 
 
After the creation of a survey, you can access the newly created group from the [[Survey structure|survey structure]] menu. The following page will be displayed:
 
 
<center>[[File:Question group - after its creation.png]]</center>
 
 
The page is divided into three sections:
 
*'''Question group toolbar:''' You may find on the toolbar the following options:
**''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;
**''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;
**''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.
**''Delete current question group:'' If you wish to delete the current question group, click on 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.
 
*'''Group summary:''' The main [[Question groups - introduction#Create question group|question group details are displayed]];
 
*'''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]].
 
 
=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 like. To do that, look for the '''question group''' button that can be accessed from the:
 
*[[Question groups - introduction#Preview question group - survey structure|survey structure menu]]
*[[Question groups - introduction#Preview question group - question group panel|question group 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.}}
 
{{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.}}
 
==Preview question group - survey structure==
 
 
Click on the survey structure, select the desired question group, and click on the '''preview question group''' button:
 
 
<center>[[File:Preview q group - survey structure.png]]</center>
 
 
==Preview question group - question group panel==
 
 
You can preview the question group once you have finished editing it:
 
 
<center>[[File:Question group panel - preview.png]]</center>
 
 
==Preview question group - question panel==
 
The question group to which question belongs to can be previewed from the question panel - see the top bar:
 
 
<center>[[File:Preview question group - question panel.png]]</center>
 
=Reordering question groups=
 
 
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]].
 
 
=Example=
 
 
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.
 
 
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]].
 
 
<center>[[File:Logic file question groups example.png]]</center>
 
 
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 you how expressions can be used to further customize your survey. For further details, please start reading further about the [[Expression Manager]].
 
<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.
*If you use expressions, don't forget to look for syntax errors with the help of the logic file.</div>

Revision as of 21:05, 19 July 2019


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


Create question group

To start adding question groups to your survey, access the survey structure page and locate in the left menu the add question group button.



After you click on it, the add question group panel will be showed up:



Please note that you can create as many groups as you like!

The following fields will be displayed:

  • 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 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;
Note: An explanation and example for hiding question groups are available in the Expression Manager examples wiki subsection.
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).


Add question group toolbar

You may find on the top toolbar the following options:



  • 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 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. First, access the add question group option and then locate on the top toolbar the import question group function:



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

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:



The page is divided into three sections:

  • Question group toolbar: You may find on the toolbar the following options:
    • 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;
    • 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;
    • 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 is employed.
    • Delete current question group: If you wish to delete the current question group, click on 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.
  • 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 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 like. To do that, look for the question group button that can be accessed from the:

When preview a group, the relevance of this group is forced to be true.
 Hint: You can add GET params in URL to set some previous question answer used in Expression.


Preview question group - survey structure

Click on the survey structure, select the desired question group, and click on the preview question group button:



Preview question group - question group panel

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



Preview question group - question panel

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


Reordering question groups

The question groups and questions can be reordered as many times as you like. For further details, check the following survey structure wiki subsection.


Example

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.


Link .lss file: Question_groups_simple_example.zip -> to import it, read the following wiki section.



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 you how expressions can be used to further customize your survey. For further details, please start reading further about the Expression Manager.

Notes:
  • There are many ways through which you can hide questions. One way is to use conditions. However, for more complex surveys, the Expression Manager has to be used.
  • If you use expressions, don't forget to look for syntax errors with the help of the logic file.