MoodleDocs - User contributions [en]

Setting up a questionnaire

2014-10-28T07:30:34Z

Rezeau: /* Email */

{{Questionnaire}}

After you have created a questionnaire you can define extra settings in the '''Advanced settings''' link/tab.

==Content options==
===Questionnaire Type===
There are three types of questionnaires:

# ''' Private ''' - belongs to the course it is defined in only. This is the standard Moodle module concept. You create a questionnaire and its questions for the course it is defined in. Editing teachers of that course can change the questionnaire and all teachers can review the results.
# ''' Template ''' - can be copied and edited. This type of questionnaire cannot be used directly, but its content can be copied into a new questionnaire and edited.
# ''' Public ''' - can be shared among courses. If a questionnaire has already been created (in another course on the same Moodle site) with the "public" setting, then you may use that "public" questionnaire in your own course(s). The number of settings available to such questionnaires is limited and you cannot edit its questions nor view the responses. '''''Example'''''.- If a public questionnaire has been created in course A, it can be "used" in courses B, C, ... All the responses from courses A, B, C, ... are collected in the public questionnaire created in course A (the original course where it was created) and are viewable there by the person (admin or teacher) who originally created it.
====Public questionnaire roll out to multiple courses====

It is possible to create a Public questionnaire whose aliases can be placed in several courses. The student responses will only be visible in the course where the original Public questionnaire has been created. There are mainly 2 applications of this setup.

case 1.- An admin may want to see course evaluations by students without the course teachers seeing those evaluations.

case 2.- A teacher teaching several courses may want to "consolidate" the results of several questionnaires (in his various courses) into one unique Public questionnaire.

Here's how you do it (for case1)
<ol>
<li>Create a course that will simply be a shell for any public questionnaires. Give it whatever title you like, e.g. PubQuestCourse. You can hide the course entirely. </li>
<li>Create your questionnaire in this course. Call it e.g. "Public questionnaire01" On the "Advanced settings" page, select '''Public''' for the questionnaire type.</li>
<li>Add questions in this public questionnaire.</li>
<li>Navigate to the course where you want to place an alias of that Public questionnaire.</li>
<li>Add an activity or resource: Questionnaire. Edit all the various settings. Name it e.g. Questionnaire01. For Response options|Type, we suggest you select Respond once.
<li> 
[[File:2014-03-23 15-03-50.jpg]]
 
In the Content options section, in the radio buttons list, under Use public, the title of the public questionnaire you created in the other course (PubQuestCourse) will appear (e.g. Public questionnaire01): check its radio button. Then finish editing (click the Save and return to course button). 
Please note that starting with version 2.6, the Content options section now distinguishes ''Copy existing'' (for questionnaires in current course) from ''Use template'' (template courses may reside in other courses). Also, the course which each existing/available questionnaire belongs to is displayed between square brackets. 
If you are not sure about the actual contents of a questionnaire you would like to "copy" or "use", clicking on its title will link to a Preview pop-up window.</li>
Note.- For options 4-6 above, an admin may ask individual teachers to create those questionnaires based on a public questionnaire in their own courses, giving them detailed instructions on how to proceed. Unfortunately at the moment there is no way to automatically deploy a public questionnaire to other courses, it has to be done "by hand".
<li>Student responses will appear in the original questionnaire (e.g. "Public questionnaire01" in course PubQuestCourse), but will not be visible at all in the "local" questionnaire (alias). Teachers will not be able to respond to it or view their students' responses.</li>
</ol>
'''IMPORTANT''' Please note that when you delete a Public questionnaire, you also delete the links to its "dependent" questionnaires in the other courses on your moodle site. If a Public questionnaire is no longer used, the normal procedure is to go to all the other courses that "use" that Public questionnaire and delete them first.

====Template questionnaire used in multiple courses====

When the responses to your questionnaire should remain accessible in the course in which it resides, but the questionnaire itself will follow a standard format with the same questions, use a template-type of questionnaire. So instead of re-creating the questions for each questionnaire, you can apply the template questionnaire to each one you create.

Here's how you do it:
<ol>
<li>Create a course that will simply be a shell for any template questionnaires. Give it whatever title you like e.g. TempQuestCourse. You can hide the course entirely. </li>
<li>Create your questionnaire in this course. On the "Advanced settings" page, select '''Template''' for the questionnaire type.</li>
<li>Add questions in this template questionnaire.</li>
<li>Navigate to the course where you want to place an alias of that Template questionnaire.</li>
<li>Add an activity or resource: Questionnaire. Edit all the various settings. Name it e.g. Questionnaire02.</li>
<li> 
[[File:10-10-2013 10-07-55.jpg]]
 
In the Content options section, in the radio buttons list, under Copy existing, the title of the Template questionnaire you created in the other course (TempQuestCourse) will appear (e.g. Template questionnaire01): check its radio button. Then finish editing (click the Save and return to course button).</li>
</ol>

If you don't want your teachers to view or alter questionnaire responses, just define this in the Define Roles settings for Questionnaires. In Define Roles, you can limit teachers from being able to delete responses from the questionnaire, or be able to submit their own questionnaires or view responses.

===Title/Sub-title===

Title of the questionnaire, which will appear at the top of every page. By default Title is set to the questionnaire Name, but you can edit it as you like.

===Additional Info===

Text to be displayed at the top of the first page of the questionnaire. (i.e. instructions, background info, etc.)

==Submission options==

===Confirmation URL/page===

Heading (in bold) and body text for the "Confirmation" page displayed after a user completes this questionnaire. (URL, if present, takes precedence over confirmation text.) If you leave this field empty, a default message will be displayed upon questionnaire completion (''Thank you for completing this Questionnaire'').
===Email===
Sends a copy of each submission to the specified address or addresses.
You can provide more than one address by separating them with commas. Each address must be separated from the next by a comma only (''no blank space'' before or after the comma).
Leave blank for no email backup.

[[Category:Teacher]]

URL resource settings

2014-10-13T14:25:03Z

Rezeau: /* Display */

{{URL}}
==Adding a URL resource to your course==

# Turn editing on.
#From the the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu),choose URL. All settings may expanded by clicking the "Expand all/Collapse all" link top right.

==General==

[[File:urlgeneral25.png]]

===Name===
Whatever you type here will form the link learners click on to view the URL so it is helpful to give it a name that suggests its purpose.
===Description===
Add a description of your page here. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.
===Display description on the course page===
If this box is ticked, the description will appear on the course page just below the name of the URL.

==Content==

[[File:Url.png]]

# Either enter the URL in the external URL field or click the "Choose a link" button to open the file picker and choose a URL YouTube, Picasa etc (depending on which [[Repositories|repositories]] are enabled for the site.

==Appearance==
(These settings are collapsed by default)

[[File:urlappearance.png]]

===Display===

* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
* ''Embed'' - Show the Moodle page with heading, blocks and footer. Show the title/description of the item and display the file directly in the page as well
* ''Open'' - No Moodle heading, blocks, footer or description - just show the file in the web browser (e.g. shows image, PDF, flash animation, taking up the whole browser window)
* ''In pop-up'' - Same as 'Open', but opens a new browser window to show this file (without the Moodle heading, blocks, etc) - this browser window also does not have all the menus in it.

The above options are the default display options. Additional display options (see below) may be enabled by an administrator in ''Site administration > Plugins > Activity modules > URL''.

===Pop-up width/height===
If your URL is to be displayed in a pop-up, specify the width and height here.

===Display URL name/description===
To show the resource name and/or description when clicking to access the URL, simply tick the appropriate checkboxes.

==URL variables==
(These settings are collapsed by default.)

[[File:url.png]]

This section allows you to pass internal information as part of the URL.

This is useful if the URL is actually an interactive web page that takes parameters, and you want to pass something like the name of the current user, for example.

==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Drag and Drop a URL==
Alternatively, if an administrator has enabled the experimental feature drag and drop upload of text/links in ''Settings > Site administration > Development > Experimental > [[Experimental settings]]'', a link can be dragged into a section of the course and given a name, as shown in the images below.

{|
| [[File:dragURL.png|thumb|Adding a URL using drag and drop]]
|}

==URL module capabilities==

* [[Capabilities/mod/url:view|View URL resource]]
* [[Capabilities/mod/url:addinstance|Add a new URL resource]]

==Site administration settings==

The URL module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > URL''.

===Frame height===

Here you can specify the height of the top frame (containing the navigation) if you choose the "in frame" display option. Note:If your theme has a large header then the height should be increased to prevent horizontal and vertical scrollbars.

===Require activity description===

This setting allows you to turn off the requirement for users to type something into the description box.

===Password===

Here you can add a password that will connect your users to a secure site. [http://moodle.org/mod/forum/discuss.php?d=189842#p826416 See this forum post] for more details.

===Include role names in parameters===

===Available display options===

This setting allows you to add different ways the resource may be displayed on the course page. There are a number of defaults but you can add or change them here. Other display options are:
* ''In frame'' - show the Moodle heading and the file description, with the file displayed in a resizeable area below
* ''New window'' - very much like 'in pop-up', but the new window is a full browser window, with menus and address bar, etc.
[[File:Display.gif]]

===Default values for activity settings===

Here you can set the defaults for this resource.

==See Also==
* [http://youtu.be/X32dao-UENQ The Moodle URL Resource] MoodleBites video on YouTube

[[de:Link/URL konfigurieren]]
[[fr:Paramètres de l'URL]]
[[es:Configuraciones del recurso URL]]

Lesson settings

2014-10-08T14:10:20Z

Rezeau: /* Progress bar */

{{Lesson}}
=Lesson administration settings=

This page explains the settings involved when first creating a lesson.
To add a lesson to your Moodle course page:
*With the editing turned on, in the section you wish to add your lesson, click the "Add an activity or resource" link (or, if not present, the "Add an activity" drop down menu) and choose ''Lesson'' All settings may expanded by clicking the "Expand all" link top right.

==General==
{|
|[[File:addlessontitle.png|thumb|274px|General settings expanded by default]]
|}

===Name===
Whatever you type here will form the link learners click on to view the lesson so it is helpful to give it a name that suggests its purpose.

==Appearance==
(These settings are collapsed by default)
{|
|[[File:lessonappearance.png|thumb|404px|Appearance settings expanded]]
|}
===File pop===
If you want to include a link to a file on the lesson page for students to refer to, upload it here.
===Progress bar===
Choose this to show a bar at the bottom of the page showing how far into the lesson the student has got.
* For lessons containing '''only''' ''Content pages'', once a lesson has been taken to the end, if that same lesson is re-taken, the progress bar will not be "reset", i.e. it will show a 100% progress from page 1!

* For lessons containing ''Question pages'' and set to "Re-take" '''Yes''', the progress bar is always "reset" at 0% upon re-take.

* Note that the Lesson Progress bar only works correctly for lessons with a "straightforward" navigation, such as page 1 -> page 2 -> page n -> end of lesson. It is not guaranteed to work with pages "jumping all over the place".

===Display ongoing score===
Choose this to let students see their score as they work through the lesson.
===Display left menu===
Choose this if you want to show a list of the pages in the Lesson so a student can see what is coming up.
===Minimum grade to display menu===
Choose this if you want the student to go through the lesson once and get a grade before they can (on review) see and navigate through all the different pages.
===Slideshow===
Please note that slideshow mode currently does not work for Moodle 2. There is a tracker issue and patch here MDL-36673
===Maximum Number of Answers===
Here you can set the default number of answer boxes available when you add your question or content pages. For instance, if you are only going to use True/False, you would only need 2. You can change this at any time so it's not crucial.
===Use default feedback===
Choose this if you want to show a set phrase regardless of their answer. If you have set your own default feedback such as "well done; correct" or "never mind; better luck next time" etc it will appear. If you have not, then Moodle's default feedback will appear.

===Link to next activity===
Choose this to give students a link to another activity when they reach the end of the lesson. ''(Note: this can also be achieved using [[Conditional activities]])''
==Availability==
(These settings are collapsed by default)
{|
|[[File:lessonavailability.png|thumb|470px|Availability settings expanded]]
|}
===Available from/Deadline===
Here you can set a start and end date and time for your Lesson.
===Time limit===
[[Image:Lesson Timer.png|right]]
This allows you to set a time limit on the lesson. Students will see a countdown counter as they work. The timer does not stop them doing the lesson when the time is up, but correct answers are no longer scored.

===Password protected lesson===
*Change to "Yes" and enter the password if you want students only to access it when they know the password.

==Prerequisite lesson==
(These settings are collapsed by default)
{|
|[[File:prereqlesson.png|thumb|460px|Prerequisite lesson settings expanded]]
|}

===Dependent on===
This allows access to the lesson to be dependent on students' performance in another lesson in the same course. ''(Note: this can also be achieved with [[Conditional activities]])''
===Time spent===
Decide here how long you want the student to have spent in the chosen previous lesson
===Completed===
Check this box if you want the student to have completed a previous lesson (according to [[Activity completion]] settings)
===Grade better than===
Enter the grade from the previous lesson which you want the student to have exceeded before they can attempt the current lesson.

==Flow control==
(These settings are collapsed by default)
{|
|[[File:flowcontrol.png|thumb|450px|Flow control settings expanded]]
|}

===Allow Student Review===
This puts a "Review Lesson" button on the last screen of the lesson to encourage the students to navigate through the lesson again from the start.
:Note that the students will not be able to ''change'' their answers, only ''view'' them.

===Provide option to try a question again===
*This displays a button after an incorrectly answered question so that the student can try again (but not get credit for it)
:''TIP:'' Leave this off if you are using essay questions.
===Maximum Number of Attempts===
*Decide here how many times you want students to be able to attempt each question. When they reach the maximum, they will be taken automatically to the next page.
===Action after a Correct Answer===
Choose here where you want a student to be sent to if they get a question right. See [[Using Lesson]] for more details on this setting. The options are:
**the next part of the Lesson (default setting)
**a random, unexpected page
**a random page which they have not yet answered.
===Number of pages to show===
You only need this if you have set "Action after a correct answer" to show an unseen or unanswered page. Otherwise, all pages will be seen

==Grade==
(These settings are collapsed by default.)
{|
|[[File:lessongrade.png|thumb|450px|Grade settings expanded]]
|}

Set a grade and grade category here.

===Practice lesson===
Use this if you don't need the lesson to be scored/graded but just need students to work through some pages. Set this to Yes to have the same ungraded type Lesson in earlier versions of Moodle.

===Custom Scoring===
Use this to give a particular number score (negative or positive) to each answer
===Re-takes allowed===
Choose this if you want your students to be able to do the lesson more than once.
:Note that this setting only applies to lessons containing ''Question pages''. Lessons consisting '''only''' of ''Content pages'' can be re-taken even if 'Re-takes allowed' is set to ''No''.
====Handling of re-take====
If you allow your students to re-take the lesson, then decide here if the grade for all lesson attempts is the mean or the maximum.

:Note that the Question Analysis always uses the answers from the first tries of the lesson. Re-takes by students are ignored.

===Minimum Number of Questions===
Set here the minimum number of questions that will be used to calculate a student's score. Students will be told how many they have answered and how many more they need to answer.
*If you are using Content pages, then set this to 0.
*If you use this setting, then add some explanatory text at the start of the lesson so the student knows how many questions they must answer as a minimum. (They may answer more.

==Common module settings==
(These settings are collapsed by default.)

See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

The Restrict access and Activity completion settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Site administration settings==

The lesson module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Lesson''.

'''NOTE:''' ''The slideshow settings below do not work. See MDL-36673''

===Slideshow width===
Sets the width of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowwidth, Default 640.

===Slideshow height===
Sets the height of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowheight, Default 480.

===Slideshow background colour===
Background colour to for the slideshow if it is enabled.
*Variable name: lesson_slideshowbgcolor, Default #FFFFFF.

===Popup window width===
Sets the width of the popup displayed for a linked media file
*Variable name: lesson_mediawidth, Default 640.

===Popup window height===
Sets the height of the popup displayed for a linked media file
*Variable name: lesson_mediaheight, Default 480.

===Show close button:===
Displays a close button as part of the popup generated for a linked media file
*Variable name: lesson_mediaclose, Default No.

===Number of high scores displayed===
Sets the number of high scores to display
*Variable name: lesson_maxhighscores, Default: 10

===Maximum number of answers===
Default maximum number of answers per page for site
*Variable name: lesson_maxanswers, Default: 4.

===Action after correct answer===
The default action to take after a correct answer
*Variable name: lesson_defaultnextpage, Default: Normal - follow lesson path

==See also==
*[http://youtu.be/cUDV0WE5ZYY Moodle 2.x Lesson (part 1)] MoodleBites video on YouTube
*[http://youtu.be/Mfj-8w-Ze0A Moodle 2.x Lesson (part 2)] MoodleBites video on YouTube
*[http://youtu.be/jXjqHtgC9c0 Moodle 2.x Lesson (part 3)] MoodleBites video on YouTube

[[de:Lektion konfigurieren]]
[[fr:Ajouter/modifier une leçon]]
[[ja:レッスンの設定]]
[[es:Configuraciones de lección]]

Lesson settings

2014-10-08T13:39:21Z

Rezeau: /* Allow Student Review */

{{Lesson}}
=Lesson administration settings=

This page explains the settings involved when first creating a lesson.
To add a lesson to your Moodle course page:
*With the editing turned on, in the section you wish to add your lesson, click the "Add an activity or resource" link (or, if not present, the "Add an activity" drop down menu) and choose ''Lesson'' All settings may expanded by clicking the "Expand all" link top right.

==General==
{|
|[[File:addlessontitle.png|thumb|274px|General settings expanded by default]]
|}

===Name===
Whatever you type here will form the link learners click on to view the lesson so it is helpful to give it a name that suggests its purpose.

==Appearance==
(These settings are collapsed by default)
{|
|[[File:lessonappearance.png|thumb|404px|Appearance settings expanded]]
|}
===File pop===
If you want to include a link to a file on the lesson page for students to refer to, upload it here.
===Progress bar===
Choose this to show a bar at the bottom of the page showing how far into the lesson the student has got.
===Display ongoing score===
Choose this to let students see their score as they work through the lesson.
===Display left menu===
Choose this if you want to show a list of the pages in the Lesson so a student can see what is coming up.
===Minimum grade to display menu===
Choose this if you want the student to go through the lesson once and get a grade before they can (on review) see and navigate through all the different pages.
===Slideshow===
Please note that slideshow mode currently does not work for Moodle 2. There is a tracker issue and patch here MDL-36673
===Maximum Number of Answers===
Here you can set the default number of answer boxes available when you add your question or content pages. For instance, if you are only going to use True/False, you would only need 2. You can change this at any time so it's not crucial.
===Use default feedback===
Choose this if you want to show a set phrase regardless of their answer. If you have set your own default feedback such as "well done; correct" or "never mind; better luck next time" etc it will appear. If you have not, then Moodle's default feedback will appear.

===Link to next activity===
Choose this to give students a link to another activity when they reach the end of the lesson. ''(Note: this can also be achieved using [[Conditional activities]])''
==Availability==
(These settings are collapsed by default)
{|
|[[File:lessonavailability.png|thumb|470px|Availability settings expanded]]
|}
===Available from/Deadline===
Here you can set a start and end date and time for your Lesson.
===Time limit===
[[Image:Lesson Timer.png|right]]
This allows you to set a time limit on the lesson. Students will see a countdown counter as they work. The timer does not stop them doing the lesson when the time is up, but correct answers are no longer scored.

===Password protected lesson===
*Change to "Yes" and enter the password if you want students only to access it when they know the password.

==Prerequisite lesson==
(These settings are collapsed by default)
{|
|[[File:prereqlesson.png|thumb|460px|Prerequisite lesson settings expanded]]
|}

===Dependent on===
This allows access to the lesson to be dependent on students' performance in another lesson in the same course. ''(Note: this can also be achieved with [[Conditional activities]])''
===Time spent===
Decide here how long you want the student to have spent in the chosen previous lesson
===Completed===
Check this box if you want the student to have completed a previous lesson (according to [[Activity completion]] settings)
===Grade better than===
Enter the grade from the previous lesson which you want the student to have exceeded before they can attempt the current lesson.

==Flow control==
(These settings are collapsed by default)
{|
|[[File:flowcontrol.png|thumb|450px|Flow control settings expanded]]
|}

===Allow Student Review===
This puts a "Review Lesson" button on the last screen of the lesson to encourage the students to navigate through the lesson again from the start.
:Note that the students will not be able to ''change'' their answers, only ''view'' them.

===Provide option to try a question again===
*This displays a button after an incorrectly answered question so that the student can try again (but not get credit for it)
:''TIP:'' Leave this off if you are using essay questions.
===Maximum Number of Attempts===
*Decide here how many times you want students to be able to attempt each question. When they reach the maximum, they will be taken automatically to the next page.
===Action after a Correct Answer===
Choose here where you want a student to be sent to if they get a question right. See [[Using Lesson]] for more details on this setting. The options are:
**the next part of the Lesson (default setting)
**a random, unexpected page
**a random page which they have not yet answered.
===Number of pages to show===
You only need this if you have set "Action after a correct answer" to show an unseen or unanswered page. Otherwise, all pages will be seen

==Grade==
(These settings are collapsed by default.)
{|
|[[File:lessongrade.png|thumb|450px|Grade settings expanded]]
|}

Set a grade and grade category here.

===Practice lesson===
Use this if you don't need the lesson to be scored/graded but just need students to work through some pages. Set this to Yes to have the same ungraded type Lesson in earlier versions of Moodle.

===Custom Scoring===
Use this to give a particular number score (negative or positive) to each answer
===Re-takes allowed===
Choose this if you want your students to be able to do the lesson more than once.
:Note that this setting only applies to lessons containing ''Question pages''. Lessons consisting '''only''' of ''Content pages'' can be re-taken even if 'Re-takes allowed' is set to ''No''.
====Handling of re-take====
If you allow your students to re-take the lesson, then decide here if the grade for all lesson attempts is the mean or the maximum.

:Note that the Question Analysis always uses the answers from the first tries of the lesson. Re-takes by students are ignored.

===Minimum Number of Questions===
Set here the minimum number of questions that will be used to calculate a student's score. Students will be told how many they have answered and how many more they need to answer.
*If you are using Content pages, then set this to 0.
*If you use this setting, then add some explanatory text at the start of the lesson so the student knows how many questions they must answer as a minimum. (They may answer more.

==Common module settings==
(These settings are collapsed by default.)

See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

The Restrict access and Activity completion settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Site administration settings==

The lesson module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Lesson''.

'''NOTE:''' ''The slideshow settings below do not work. See MDL-36673''

===Slideshow width===
Sets the width of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowwidth, Default 640.

===Slideshow height===
Sets the height of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowheight, Default 480.

===Slideshow background colour===
Background colour to for the slideshow if it is enabled.
*Variable name: lesson_slideshowbgcolor, Default #FFFFFF.

===Popup window width===
Sets the width of the popup displayed for a linked media file
*Variable name: lesson_mediawidth, Default 640.

===Popup window height===
Sets the height of the popup displayed for a linked media file
*Variable name: lesson_mediaheight, Default 480.

===Show close button:===
Displays a close button as part of the popup generated for a linked media file
*Variable name: lesson_mediaclose, Default No.

===Number of high scores displayed===
Sets the number of high scores to display
*Variable name: lesson_maxhighscores, Default: 10

===Maximum number of answers===
Default maximum number of answers per page for site
*Variable name: lesson_maxanswers, Default: 4.

===Action after correct answer===
The default action to take after a correct answer
*Variable name: lesson_defaultnextpage, Default: Normal - follow lesson path

==See also==
*[http://youtu.be/cUDV0WE5ZYY Moodle 2.x Lesson (part 1)] MoodleBites video on YouTube
*[http://youtu.be/Mfj-8w-Ze0A Moodle 2.x Lesson (part 2)] MoodleBites video on YouTube
*[http://youtu.be/jXjqHtgC9c0 Moodle 2.x Lesson (part 3)] MoodleBites video on YouTube

[[de:Lektion konfigurieren]]
[[fr:Ajouter/modifier une leçon]]
[[ja:レッスンの設定]]
[[es:Configuraciones de lección]]

Lesson settings

2014-10-08T13:20:41Z

Rezeau: /* Re-takes allowed */

{{Lesson}}
=Lesson administration settings=

This page explains the settings involved when first creating a lesson.
To add a lesson to your Moodle course page:
*With the editing turned on, in the section you wish to add your lesson, click the "Add an activity or resource" link (or, if not present, the "Add an activity" drop down menu) and choose ''Lesson'' All settings may expanded by clicking the "Expand all" link top right.

==General==
{|
|[[File:addlessontitle.png|thumb|274px|General settings expanded by default]]
|}

===Name===
Whatever you type here will form the link learners click on to view the lesson so it is helpful to give it a name that suggests its purpose.

==Appearance==
(These settings are collapsed by default)
{|
|[[File:lessonappearance.png|thumb|404px|Appearance settings expanded]]
|}
===File pop===
If you want to include a link to a file on the lesson page for students to refer to, upload it here.
===Progress bar===
Choose this to show a bar at the bottom of the page showing how far into the lesson the student has got.
===Display ongoing score===
Choose this to let students see their score as they work through the lesson.
===Display left menu===
Choose this if you want to show a list of the pages in the Lesson so a student can see what is coming up.
===Minimum grade to display menu===
Choose this if you want the student to go through the lesson once and get a grade before they can (on review) see and navigate through all the different pages.
===Slideshow===
Please note that slideshow mode currently does not work for Moodle 2. There is a tracker issue and patch here MDL-36673
===Maximum Number of Answers===
Here you can set the default number of answer boxes available when you add your question or content pages. For instance, if you are only going to use True/False, you would only need 2. You can change this at any time so it's not crucial.
===Use default feedback===
Choose this if you want to show a set phrase regardless of their answer. If you have set your own default feedback such as "well done; correct" or "never mind; better luck next time" etc it will appear. If you have not, then Moodle's default feedback will appear.

===Link to next activity===
Choose this to give students a link to another activity when they reach the end of the lesson. ''(Note: this can also be achieved using [[Conditional activities]])''
==Availability==
(These settings are collapsed by default)
{|
|[[File:lessonavailability.png|thumb|470px|Availability settings expanded]]
|}
===Available from/Deadline===
Here you can set a start and end date and time for your Lesson.
===Time limit===
[[Image:Lesson Timer.png|right]]
This allows you to set a time limit on the lesson. Students will see a countdown counter as they work. The timer does not stop them doing the lesson when the time is up, but correct answers are no longer scored.

===Password protected lesson===
*Change to "Yes" and enter the password if you want students only to access it when they know the password.

==Prerequisite lesson==
(These settings are collapsed by default)
{|
|[[File:prereqlesson.png|thumb|460px|Prerequisite lesson settings expanded]]
|}

===Dependent on===
This allows access to the lesson to be dependent on students' performance in another lesson in the same course. ''(Note: this can also be achieved with [[Conditional activities]])''
===Time spent===
Decide here how long you want the student to have spent in the chosen previous lesson
===Completed===
Check this box if you want the student to have completed a previous lesson (according to [[Activity completion]] settings)
===Grade better than===
Enter the grade from the previous lesson which you want the student to have exceeded before they can attempt the current lesson.

==Flow control==
(These settings are collapsed by default)
{|
|[[File:flowcontrol.png|thumb|450px|Flow control settings expanded]]
|}

===Allow Student Review===
This puts a "Review Lesson" button on the last screen of the lesson to encourage the student to navigate through the lesson again from the start. Be sure to check other settings to allow them to change their answers.
===Provide option to try a question again===
*This displays a button after an incorrectly answered question so that the student can try again (but not get credit for it)
:''TIP:'' Leave this off if you are using essay questions.
===Maximum Number of Attempts===
*Decide here how many times you want students to be able to attempt each question. When they reach the maximum, they will be taken automatically to the next page.
===Action after a Correct Answer===
Choose here where you want a student to be sent to if they get a question right. See [[Using Lesson]] for more details on this setting. The options are:
**the next part of the Lesson (default setting)
**a random, unexpected page
**a random page which they have not yet answered.
===Number of pages to show===
You only need this if you have set "Action after a correct answer" to show an unseen or unanswered page. Otherwise, all pages will be seen

==Grade==
(These settings are collapsed by default.)
{|
|[[File:lessongrade.png|thumb|450px|Grade settings expanded]]
|}

Set a grade and grade category here.

===Practice lesson===
Use this if you don't need the lesson to be scored/graded but just need students to work through some pages. Set this to Yes to have the same ungraded type Lesson in earlier versions of Moodle.

===Custom Scoring===
Use this to give a particular number score (negative or positive) to each answer
===Re-takes allowed===
Choose this if you want your students to be able to do the lesson more than once.
:Note that this setting only applies to lessons containing ''Question pages''. Lessons consisting '''only''' of ''Content pages'' can be re-taken even if 'Re-takes allowed' is set to ''No''.
====Handling of re-take====
If you allow your students to re-take the lesson, then decide here if the grade for all lesson attempts is the mean or the maximum.

:Note that the Question Analysis always uses the answers from the first tries of the lesson. Re-takes by students are ignored.

===Minimum Number of Questions===
Set here the minimum number of questions that will be used to calculate a student's score. Students will be told how many they have answered and how many more they need to answer.
*If you are using Content pages, then set this to 0.
*If you use this setting, then add some explanatory text at the start of the lesson so the student knows how many questions they must answer as a minimum. (They may answer more.

==Common module settings==
(These settings are collapsed by default.)

See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

The Restrict access and Activity completion settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Site administration settings==

The lesson module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Lesson''.

'''NOTE:''' ''The slideshow settings below do not work. See MDL-36673''

===Slideshow width===
Sets the width of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowwidth, Default 640.

===Slideshow height===
Sets the height of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowheight, Default 480.

===Slideshow background colour===
Background colour to for the slideshow if it is enabled.
*Variable name: lesson_slideshowbgcolor, Default #FFFFFF.

===Popup window width===
Sets the width of the popup displayed for a linked media file
*Variable name: lesson_mediawidth, Default 640.

===Popup window height===
Sets the height of the popup displayed for a linked media file
*Variable name: lesson_mediaheight, Default 480.

===Show close button:===
Displays a close button as part of the popup generated for a linked media file
*Variable name: lesson_mediaclose, Default No.

===Number of high scores displayed===
Sets the number of high scores to display
*Variable name: lesson_maxhighscores, Default: 10

===Maximum number of answers===
Default maximum number of answers per page for site
*Variable name: lesson_maxanswers, Default: 4.

===Action after correct answer===
The default action to take after a correct answer
*Variable name: lesson_defaultnextpage, Default: Normal - follow lesson path

==See also==
*[http://youtu.be/cUDV0WE5ZYY Moodle 2.x Lesson (part 1)] MoodleBites video on YouTube
*[http://youtu.be/Mfj-8w-Ze0A Moodle 2.x Lesson (part 2)] MoodleBites video on YouTube
*[http://youtu.be/jXjqHtgC9c0 Moodle 2.x Lesson (part 3)] MoodleBites video on YouTube

[[de:Lektion konfigurieren]]
[[fr:Ajouter/modifier une leçon]]
[[ja:レッスンの設定]]
[[es:Configuraciones de lección]]

Questionnaire module

2014-05-14T21:07:27Z

Rezeau: /* See also */

{{Questionnaire}}

The Moodle '''Questionnaire module''' is a survey-like type of activity. It is a contributed module which can be downloaded from the [http://moodle.org/plugins/view.php?plugin=mod_questionnaire Moodle Plugins Directory]. It allows teachers to create a wide range of questions to get student feedback e.g. on a course or activities. The goals of the Questionnaire module are quite different from those of the Moodle '''Lesson''' or '''Quiz''' modules. With Questionnaire you do not test or assess the student, you ''gather data''.

==Summary of features==
Please look at the [[Adding/editing a questionnaire]] and [[Editing Questionnaire questions|Adding Questions]] pages for more information.

===Types of questions===
*Check Boxes
*Date Box
*Dropdown choices
*Essay box - HTML editor possible, set width and height of box
*Numeric - can set length and number of decimal places
*Radio buttons - have labels you determine for each question
*Scale - can customize in many ways
*Text box
*Yes/no
You can also place:
*Page breaks
*Labels - might be used to give an overview of next set of questions

===Types of reports===
*Responses can be viewed by everyone or select group
*Responses can be exported

==See also==
* The Questionnaire plugin can be downloaded from the [http://moodle.org/plugins/view.php?plugin=mod_questionnaire Moodle Plugins Directory].
*Discussions: please create or find a discussion topic in the [http://moodle.org/mod/forum/view.php?f=469 Questionnaire Forum]
*[http://en.wikipedia.org/wiki/Statistical_survey Statistical_survey] From Wikipedia, the free encyclopedia.

'''Moodle 2.8''' will hopefully have a new module that combines the best of Questionnaire, Feedback and Survey into an upgrade for the Survey module. See [https://docs.moodle.org/en/Development:Survey_2_brainstorm Development: Survey 2 brainstorm]

[[Category:Contributed code]]

[[es:Módulo cuestionario]]
[[fr:Questionnaire]]

Glossary export to quiz

2014-04-23T09:37:23Z

Rezeau: /* Installation */

{{Infobox plugin
|type = Block
|entry = https://moodle.org/plugins/view.php?plugin=block_glossary_export_to_quiz
|tracker =
|discussion = https://moodle.org/mod/forum/discuss.php?d=162866
|maintainer = [[User:Joseph Rézeau|Joseph Rézeau]]
|float = right
}}

== Installation ==

For more information see [[Installing add-ons]]

== Overview ==
A block to export a Glossary's entries to the Quiz Questions bank. Exports concepts & definitions to SHORTANSWER or MULTICHOICE questions.

==Export entries from Glossary to moodle quiz XML file==

# Go to your course's front page and go into Edit mode and click on the Configuration icon to configure the Export Glossary to Quiz block.
# Use the dropdown list to select the glossary that you want to use to export its entries to the quiz questions bank. If that glossary contains categories, you can select only one category to export its entries. To cancel your choice or to reset the block, simply leave the dropdown list on the Choose... position.
# Maximum number of entries to export. Leave empty to export all entries from selected Glossary or Category. This option can be useful for exporting a limited number of entries from very large glossaries.
# Glossary entries can be exported to the Quiz Questions bank either as multiple choice or short answer questions.
## Multiple choice questions will consist of the following elements:
### question text = glossary entry definition
### correct answer = glossary entry concept
### distracters = 3 glossary entry concepts randomly selected from the glossary (or glossary category) that you have selected.
### You have a choice of 4 types of numbering for the exported multiple choice questions:<ul><li> a. b. c. (the default numbering type)</li><li>A. B. C. D.</li><li>1. 2. 3.</li><li>no numbering</li></ul>
##Short answer questions
### Case insensitive. Student responses will be accepted as correct regardless of the original glossary entry concept case (uppercase or lowercase).Example: original entry "Moodle". Accepted correct responses: "Moodle", "moodle".
### Case sensitive. Student responses will be only be accepted as correct it the case of the original glossary entry concept is used.Example: original entry "Moodle". Accepted correct response: "Moodle".
# When done, click OK.
# You are back in the course homepage, but now the block displays the settings you have selected.
# Click on the [Export n entries] link.
# Now you are on page Your course -> Glossaries -> (e.g.) Demo -> Glossary -> Export entries to Quiz (XML)
# Click on the Export entries to file button.
# At the prompt, save file to your computer. Its name is e.g. Demo_Glossary.xml.
# Go back to the course's homepage. You see that the the Export Glossary to Quiz block has been reset.

==Import to the quiz questions bank==
# Turn editing on
# In Administration block, click Questions
# On the Edit questions page, Click the Import tab
# Set these settings:<ul><li>File format : Moodle XML format</li><li>General</li><li>Category Default</li><li>Get category from file (check it)</li><li>Import from file upload...</li></ul>
# Go to the file you saved to your computer in step A 10 (Demo_Glossary.xml. and click Upload this file button.
# If all goes well, the imported questions should get displayed on the next screen.
# Click Continue.
# On the next page, the Question bank displays the new category name (formed on the name of the exported Glossary, plus the name of its category if you selected one of the glossary's categories) and of course all the questions that were imported (of the SHORTANSWER type).
# You can use the SHORTANSWER or the MULTICHOICE questions in a quiz.
{{New features}}
You can use the SHORTANSWER questions to create one or more Random Short-Answer MATCHING questions.

Glossary export to quiz

2014-04-23T09:27:04Z

Rezeau: /* Import to the quiz questions bank */

{{Infobox plugin
|type = Block
|entry = https://moodle.org/plugins/view.php?plugin=block_glossary_export_to_quiz
|tracker =
|discussion = https://moodle.org/mod/forum/discuss.php?d=162866
|maintainer = [[User:Joseph Rézeau|Joseph Rézeau]]
|float = right
}}

== Installation ==

# Download the ''Glossary export to quiz'' installation file and unzip it to the '''\blocks''' directory in your Moodle folder.
# Be sure that the final name of the directory is: glossary_export_to_quiz, the full path in your Moodle installation will be blocks/glossary_export_to_quiz
# Login to Moodle as Administrator and click Notifications under Site Administration.

For more information see [[Installing plugins]]

== Overview ==
A block to export a Glossary's entries to the Quiz Questions bank. Exports concepts & definitions to SHORTANSWER or MULTICHOICE questions.

==Export entries from Glossary to moodle quiz XML file==

# Go to your course's front page and go into Edit mode and click on the Configuration icon to configure the Export Glossary to Quiz block.
# Use the dropdown list to select the glossary that you want to use to export its entries to the quiz questions bank. If that glossary contains categories, you can select only one category to export its entries. To cancel your choice or to reset the block, simply leave the dropdown list on the Choose... position.
# Maximum number of entries to export. Leave empty to export all entries from selected Glossary or Category. This option can be useful for exporting a limited number of entries from very large glossaries.
# Glossary entries can be exported to the Quiz Questions bank either as multiple choice or short answer questions.
## Multiple choice questions will consist of the following elements:
### question text = glossary entry definition
### correct answer = glossary entry concept
### distracters = 3 glossary entry concepts randomly selected from the glossary (or glossary category) that you have selected.
### You have a choice of 4 types of numbering for the exported multiple choice questions:<ul><li> a. b. c. (the default numbering type)</li><li>A. B. C. D.</li><li>1. 2. 3.</li><li>no numbering</li></ul>
##Short answer questions
### Case insensitive. Student responses will be accepted as correct regardless of the original glossary entry concept case (uppercase or lowercase).Example: original entry "Moodle". Accepted correct responses: "Moodle", "moodle".
### Case sensitive. Student responses will be only be accepted as correct it the case of the original glossary entry concept is used.Example: original entry "Moodle". Accepted correct response: "Moodle".
# When done, click OK.
# You are back in the course homepage, but now the block displays the settings you have selected.
# Click on the [Export n entries] link.
# Now you are on page Your course -> Glossaries -> (e.g.) Demo -> Glossary -> Export entries to Quiz (XML)
# Click on the Export entries to file button.
# At the prompt, save file to your computer. Its name is e.g. Demo_Glossary.xml.
# Go back to the course's homepage. You see that the the Export Glossary to Quiz block has been reset.

==Import to the quiz questions bank==
# Turn editing on
# In Administration block, click Questions
# On the Edit questions page, Click the Import tab
# Set these settings:<ul><li>File format : Moodle XML format</li><li>General</li><li>Category Default</li><li>Get category from file (check it)</li><li>Import from file upload...</li></ul>
# Go to the file you saved to your computer in step A 10 (Demo_Glossary.xml. and click Upload this file button.
# If all goes well, the imported questions should get displayed on the next screen.
# Click Continue.
# On the next page, the Question bank displays the new category name (formed on the name of the exported Glossary, plus the name of its category if you selected one of the glossary's categories) and of course all the questions that were imported (of the SHORTANSWER type).
# You can use the SHORTANSWER or the MULTICHOICE questions in a quiz.
{{New features}}
You can use the SHORTANSWER questions to create one or more Random Short-Answer MATCHING questions.

Regular Expression Short-Answer question type

2014-04-21T12:58:01Z

Rezeau: /* Inserting RegExp sub-questions in Cloze type questions */

===The RegExp Short Answer Question===

* '''IMPORTANT NOTE'''
** The RegExp Short Answer question described in this documentation page is a 3rd-party plugin, which allows you to create questions for the '''''Quiz''''' activity. It is ''different'' from the "Use regular expressions" option in the '''''Lesson''''' module.
** The documentation for the "Use regular expressions" option in the '''''Lesson''''' module is to be found at: [https://docs.moodle.org/en/Short_answer_analysis Short answer analysis].

Like the Short Answer question, the RegExp Short Answer question expects the respondent to answer an "open" question with a word or a short phrase. However, the RegExp system system gives you access to a more powerful system for ''analyzing the student's answers'' with the aim of ''providing more relevant immediate feedback''.

===Correct answer matching a regular expression pattern===

It is not possible to give complete examples of the vast possibilities offered by this system, and the following are just some possibilities.

===='''Example 1.'''====

Suppose your question was "What are the colors of the French flag?". In the Answer 1 box you would type the "best" answer, e.g. "it's blue, white and red". For more details, see [[#firstcorrect|First correct answer]] below.

*In the Answer 2 box you would type this regular expression: "it's blue, white(,| and) red" (quotes should not be typed, of course).
* If [[#casesensivity|Case sensivity]] is set to "No", this will match any of those 4 responses:
it's blue, white, red
it's blue, white and red
It's blue, white, red
It's blue, white and red

===='''Example 2'''.====

Question: "What are blue, red and yellow?".
* Answer 1: "they are colours".
* Answer 2: "(|they('| a)re )colou?rs".
* This will match any of those 6 responses:
colours
colors
they're colours
they're colors
they are colours
they are colors

'''''Note'''''.- The beginning of this regular expression "(|they('| a)re )" will match either nothing or "they're " or "they are ". In "colou?r", the question-mark means: the preceding character (or parenthesized group of characters) zero or one time; it is used here to match British English as well as US spelling.

===='''Example 3.'''====

Question: "Name an animal whose name consists of 3 letters and the middle letter is the vowel ''a''".
* Answer 1: "cat"
* Answer 2: "[bcr]at".
* This will match: bat, cat or rat.

'''''Note'''''.- In Regular Expression syntax, the inclusion of characters between square brackets means than ANY of those characters can be used. So, in the above example, the regular expression "[bcr]at" is the exact equivalent of "(b|c|r)at". Be careful NOT to include the pipe character as separator in your [...] regular expressions. For instance, "[b|c|r]at" will NOT WORK CORRECTLY.

===='''Example 4.'''====

The 'permutation' feature (introduced in regexp version '''2012102900''' for Moodle 2.3+)

Question: "What are the colours of the French flag (in any order)".
* Answer 1: "it's blue, white and red"
* Answer 2: <nowiki>"it's [[_blue_, _white_(,| and) _red_]]".</nowiki>
Upon saving the question, Answer 2 will be automatically re-written as Answer 2b:

it's (blue, white(,| and) red|blue, red(,| and) white|white, red(,| and) blue|white, blue(,| and) red|red, blue(,| and) white|red, white(,| and) blue)

and it will match all the following answers:
it's blue, white, red
it's blue, white and red
it's blue, red, white
it's blue, red and white
it's white, red, blue
it's white, red and blue
it's white, blue, red
it's white, blue and red
it's red, blue, white
it's red, blue and white
it's red, white, blue
it's red, white and blue

'''''Note'''''.- This 'permutation feature' has been asked quite a few times by regexp users. It is definitely ''not'' possible to obtain it by using standard Regular Expressions syntax.

It is possible (but tedious) to write a regular expression including all the possible permutations - as in Answer 2b above - but the ''ad hoc'' syntax I am offering makes it easier to write... provided you strictly adhere to that syntax!

Include within double square brackets the part of the Answer which will contain 'permutable' words or phrases. You are actually allowed to have a maximum of 2 such sets of 'permutable' words or phrases. But you cannot embed one set within another!

Then, use pairs of underscores (the _ character) to delimit each 'permutable' word or phrase. You can still use any of the accepted Regular Expressions characters, as explained here, in your Answers which contain one (or two) such sets of 'permutable' words or phrases. If your Answer does not contain an even number of underscores, an Error warning will be displayed upon clicking the Show Alternate Answers button or when trying to Save your question.

===='''Example 5.'''====

Another 'permutation' example

Question: "Quote the English proverb that is an encouragement to hard, diligent work."

* Answer 1: "Early to bed and early to rise makes an ma healthy, wealthy and wise"
* Answer 2: "Early to <nowiki>[[_bed_ and early to _rise_]], makes a man [[_healthy_, _wealthy_ and _wise_]]</nowiki>"

Upon saving the question, Answer 2 will be automatically re-written as Answer 2b:

Early to (bed and early to rise|rise and early to bed) makes a man (healthy, wealthy and wise|healthy, wise and wealthy|wealthy, wise and healthy|wealthy, healthy and wise|wise, healthy and wealthy|wise, wealthy and healthy)

and it will match all the following answers:

Early to bed and early to rise makes a man healthy, wealthy and wise
Early to bed and early to rise makes a man healthy, wise and wealthy
Early to bed and early to rise makes a man wealthy, wise and healthy
Early to bed and early to rise makes a man wealthy, healthy and wise
Early to bed and early to rise makes a man wise, healthy and wealthy
Early to bed and early to rise makes a man wise, wealthy and healthy
Early to rise and early to bed makes a man healthy, wealthy and wise
Early to rise and early to bed makes a man healthy, wise and wealthy
Early to rise and early to bed makes a man wealthy, wise and healthy
Early to rise and early to bed makes a man wealthy, healthy and wise
Early to rise and early to bed makes a man wise, healthy and wealthy
Early to rise and early to bed makes a man wise, wealthy and healthy

===Escaping metacharacters===

====Definition====
In the Regular Expressions syntax, a number of special characters or ''meta characters'' have special functions; but it is possible to force these special characters to be interpreted as normal (or ''literal'') characters by preceding them with a so-called ''escape'' character, the backslash "\".
Below is a (partial) list of those ''meta characters'':

'''. ^ $ * ( ) [ ] + ? | { } \ /'''

====In Accepted Answers====

* '''Accepted Answers''' are Answers which have a grade greater than zero, i.e. are ''totally'' (grade = 100%) or ''partially'' (grade > 0% < 100%) ''correct Answers''.

In those Answers, if you need to use one or more ''meta characters'' for their ''literal'' value, you '''must''' ''escape'' them (i.e. precede them with a backslash).

'''Example 1.-''' If you want to accept the answer "This computer costs 1000$ in the US.", you must write the Answer as "This computer costs 1000\$ in the US\.".

'''Example 2.-''' If you want to accept the answer "Desktop computers are (usually) more powerful than laptops.", you must write the Answer as "Desktop computers are $usually$ more powerful than laptops\.".

* You can mix metacharacters that have a special function with others that have a literal value, within one Answer.
'''Example 3.-''' If you want to accept both answers "Computers are (usually) cheaper than cars." and "Computers are (usually) less expensive than cars.", you must write the Answer as ""Computers are $usually$ (cheaper|less expensive) than cars."".
* In the '''Accepted Answers''' boxes you can only enter regular expressions which can generate a finite number of sentences. That is why you will not be allowed to use some ''meta characters'' which match a potentially infinite number of sentences.
* List of ''meta characters'' which you '''can''' use for their RegExp functions:

'''( ) [ ] ? |'''

* List of ''meta characters'' which you '''cannot''' use for their RegExp functions, and can only be used for their ''literal'' value (and must be ''escaped'').

'''. ^ $ * + { } \ /'''

* The question mark (?) can be used either for its RegExp function OR, if escaped, for its ''literal'' value.

'''Example 4.-''' "Do you like Jack(ie)?\?" will accept both "Do you like Jack?" and "Do you like Jackie?".

====In Incorrect Answers====

* '''Incorrect Answers''' are Answers which have a grade equal to zero (or None).
When you write those Incorrect Answers, you can use the whole range of ''meta characters'' for their special function value:

'''. ^ $ * ( ) [ ] + ? | { } \ /'''

For examples of use, see '''Detecting missing required words or character strings''' below.

====Answers Validation====

When you validate your Question, the question engine checks the validity of your expression, according to the features explained above. If an error is found, an ERROR message is displayed above the erroneous Answer(s) and you cannot save the Question until that error has been corrected.

The validation system also checks that your parentheses and square brackets are correctly balanced.

'''Note.-''' The faulty Answer text is "underlined" with the list of errors, as shown below.

[[Image:Errors_en.jpg]]

===Detecting missing required words or character strings===

This is a powerful feature of the RegExp question type. It will analyse the student's answer for words that are required for the answer to be correct. There are 2 ways to do this.
* Use what is called "negative lookahead assertion" in regular expressions syntax: '''^(?!.*required.*)'''
* or use an ''ad hoc'' pseudo-syntax provided in RegExp (an initial double hyphen): '''--.*required.*'''.
In the examples below, we shall be using the 'ad hoc' RegExp pseudo-syntax, and sometimes give the "negative lookahead assertion" equivalent for anyone interested.

Any Teacher Answer which begins with a double hyphen will analyse the student’s response to find out whether the following string is present or absent. If present, the analysis continues to the next question; if absent, the analysis stops and the relevant feedback message is displayed.

'''Example 4. ''' Question "What are the colors of the French flag?".

* Teacher Answer 2: --.*blue.*
* Sample student Response: "it's red and white"
* Feedback 2: The color of the sky is missing!

Here, the . (dot) stands for “any character” and the * (asterisk) means “preceding special character repeated any number of times”. The Teacher Answer 2 regular expression above means: check whether the character string "blue", preceded with anything and followed by anything is absent from the student's answer. Please note that the use of the asterisk is different in Moodle's "normal" Short Answer question type and in the RegExp question type.

Actually, this syntax is not sufficient to track the absence of the word "blue" in a student's answer such as "it's blueish, white and red". To make sure that we want to track the absence of "blue" as a word(and not just as part of a word), we must use the metacharacter \b which is an anchor which matches at a position that is called a "word boundary". Hence the new version of our Example 4:

'''Example 4b. ''' Question "What are the colors of the French flag?".

* Teacher Answer 2: --.*\bblue\b.*
* Sample student Response: "it's blueish, white and red"
* Feedback 2: The color of the sky is missing!

'''Note.-'''
Using the "negative lookahead assertion" syntax mentioned at the beginning of this section, Teacher Answer 2 would look like this:
* Teacher Answer 2: '''^(?!'''.*\blue\b.*''')'''

'''Example 5.''' Question: "Name an animal whose name consists of 3 letters and the middle letter is the vowel ''a''".
* Teacher Answer: "--^[bcr]". '''OR''' * Teacher Answer: "--^(b|c|r)".
* Sample student Response: "dog"
* Feedback: "Your answer should start with one of these letters: b, c or r"

'''Note.-'''
In regular expressions syntax, the caret ^ stands for "beginning of character string to be matched", while the dollar sign $ stands for "end of character string".

'''Example 6.''' Question "What are the colors of the French flag?".

* Teacher Answer: "--.*(blue|red|white).*"
* Sample student Response #1: "It's black and orange."
* Feedback: "You have not even found one of the colors of the French flag!"
* Sample student Response #2: "It's blue and orange."
* Feedback: None, the analysis continues to the next Teacher Answer expression.

'''''Explanation'''''.- The regular expression looks for a missing word among those listed between brackets and separated by the | sign. As soon as one of those words is found, the "missing condition" is considered false, and the response analysis continues to the next Answer's regular expression.

'''Note.-'''
Using the "negative lookahead assertion" syntax, Teacher Answer would look like this: '''^(?!.*(blue|red|white).*)'''

'''Example 7.''' Question "What are the colors of the French flag?".

* Teacher Answer: "--.*('''&&'''blue'''&&'''red'''&&'''white).*"
* Sample student Response #1: "It's blue and orange."
* Feedback: "You have not found all the colors of the French flag".
* Sample student Response #2: "white blue red".
* Feedback: None, the analysis continues to the next Teacher Answer expression.

'''''Explanation'''''.- The regular expression looks for a missing word among all of those listed between brackets and separated by the && double character combination. Only if all of those words are present, will the "missing condition" be considered false, and the response analysis continue to the next Answer's regular expression. Please note that the list of parenthesized words must begin with the && character sequence.

'''Note.-'''
Using the "negative lookahead assertion" syntax, Teacher Answer would look like this: '''(^(?!.*(blue).*)|^(?!.*(white).*)|^(?!.*(red).*))'''

===Editing a regular expression question===

[[Image:settings01.jpg]]

====Help Button Mode====

Selecting a mode other than ''None'' will display a button to enable the student to get the next letter or word (including the very first letter or word).

In ''Adaptive mode'' the button displayed will say "Buy next letter" or "Buy next word" according to the mode selected by the teacher. For setting the "cost" of buying a letter or word, see the ''Penalty for incorrect tries and Buying a letter or word'' settings further down the Edit form.

In ''Adaptive No penalty'' mode the button displayed will say "Get next letter" or "Get next word"

By default the Help button mode value is set at '''None'''. The Help button will only be available to quizzes that have their '''Question behaviour''' mode set to ''Adaptive'' or ''Adaptive (no penalties)'' as it does not make sense to enable the Help button for non-adaptive tests.

====Case sensitivity====

The editing form features a ''Case sensitivity'' setting, which is valid for ''all of the answers'' of the current question. You should not add an '''/i''' parameter at the end of your regular expressions. You may need to edit questions authored in 1.9 when you upgrade to 2.0 and remove any '''/i''' parameters from your regular expressions.

====Show alternate answers to student====
Show all correct alternative answers to student when on review page? If there are a lot of automatically generated correct alternative answers, displaying them all can make the review page quite long. So, you may wish to ''not'' display all those alternative correct answers. The first correct answer will always be displayed, under the label "The best correct answer is:"

====First correct answer====

For Answer 1 you must enter an answer text which a) is the "best" possible answer; b) is '''not''' a regular expression or - more exactly - ''will not be interpreted as a regular expression'' but "as is" and c) has a Grade value of 100%. You will notice that when you create a new RegExp question the Grade value for Answer 1 is already automatically set at 100% and cannot be changed.

Note.- There are two ways to enter an answer containing meta characters, according to whether this is Answer 1 or any of the subsequent Answers. Exemple question: how much did your computer cost?

Answer 1: It cost $1,000.

Answer 2: It cost ( me)?\$1,000\.

In Anwer 1 you just type the expected answer "as is". The text in Answer 2 will be interpreted as a regular expression, and thus you need to escape the two meta characters (the $ sign and the end-of-sentence full stop). Note that here I have added the optional pronoun "me".

====Other answers====

Any answers with a Grade higher than 0% must be entered as valid regular expressions ''which can yield acceptable alternative answers'' (regardless of the Grade being less than 100%).

For example, you cannot enter the following Answer with a grade greater than zero:

.*blue, white(,| and) red.*

The reason is that this expression would accept as correct (with a non-null grade) an infinity of answers, many of which would be incorrect, e.g.: "My hat it blue, white, red and orange", "The French flag is blue, white, red, black and nice" etc.

If you try to do so, validation of your question will fail and an error message will be displayed to tell you where you went wrong.

This means that some regular expressions, which are perfectly valid and would correctly analyse the student's (correct) answer are not recommended. The only case where they would work is a) if your question's '''Display Hint Button''' is set at No and b) your quiz '''Adaptative Mode''' is set at No. This means that you must ''not'' enter as an answer with a grade higher than 0% a regular expression beginning with a double hyphen "--", used for detecting missing character strings.

====Show/Hide alternate answers====

When you are creating (or modifying) a RegExp question, you may want to make sure that all the alternative correct answers that you have created in the Answers fields will work. You can click the '''Show alternate answers''' button to calculate and display all the correct answers in the form you are editing. This may take quite some time on your server, depending on the number and complexity of the regular expressions you have entered in the Answer fields!

On the other hand, it is the recommended way to check that your "correct answers" expressions are correctly written. Here is an example.

Please remember that only Answers regular expressions with a score greater than zero will be used to calculate those alternative answers.

Please note that clicking the '''Show alternate answers''' button will perform an analysis of all the regular expressions you entered in the Answers field. If a syntax error is detected at this stage, the alternative correct answers will ''not'' be displayed, and an ''ad hoc'' error message will displayed above the faulty regular expression.

[[Image:showhidealternateanswers.jpg]]

===Previewing questions in popup window (teacher only)===

When the teacher previews a question in the popup preview question window they can display all of the acceptable alternative answers. Those alternative answers are automatically generated from the regular expressions you have entered when creating the question which carry a grade higher than 0%. The very first acceptable answer is printed as is at the top of the list. This is followed by all the other alternative acceptable answers, consisting of a) the Grade attributed; b) a reminder of the regular expression you entered and c) a list of all alternative answers.

[[Image:alternate_answers.jpg]]

===Automatic formatted extra feedback===
Please note that the RegExp question can be used in any '''Question behaviour''' mode. However, it is advised to create quizzes containing only RegExp questions or containing other types of questions, but ''preferably'' if the quiz's '''''Question behaviour / How questions behave''''' setting is set to ''Adaptive mode'' (with or without penalty).

When a student (or teacher in Preview Question mode) submits a response to a RegExp question, 3 types of feedback messages are displayed (in Adaptive mode).

* (line 3) The standard correct/incorrect Quiz message (plus the color associated with either state).
* (line 2) The Feedback message entered by the question creator for each Teacher Answer.
* (line 1) An extra feedback system is automatically provided, displaying the student's submitted response, with the following format codes:
** the beginning of the student's submitted response which best matches one of the Alternate Answers is displayed in blue;
** any words from the submitted response which are present in the potential Alternate Answers following the initial correct part submitted are colored in red;
** any words not present in the potential Alternate Answers following the initial correct part submitted are colored in red and formatted as strike-through.
The meaning of those colors etc. may need to be explained to the student before they take the quiz, especially the difference between "red" and "red plus strike-through".

[[Image:regexp_colored_feedback_21.jpg]]

===Feedback given by the Help button===

Each time a student clicks the '''Buy/Get next letter/word''' button to buy/get a letter/word, that letter or word is added to his response. The last line of the feedback zone shows the following information: added letter/word; penalty cost (if applicable); total penalties so far (if applicable). Note that if the total of penalties exceeds 1 (i.e. 100%), that total is displayed in red.

When the teacher views the quiz results, on the ''''Review Attempt'''' pages, ''''History of responses'''' section, the response history shows ''Submit (with a request for help)'' with the response states before and after the letter/word was added.

[[Image:21-addedletterhistory.jpg]]

----
[[Image:21-addedwordhistory.jpg]]
----
If the student clicked the '''Buy/Get next word''' button while his current submitted answer contained the beginning of a (correct) word, the full correct word is displayed in the Answer field, and the feedback message says "''Completed'' word" rather than "''Added'' word".

[[Image:21-completedwordhistory.jpg]]

===Display right answers===

If your Quiz settings ''Review options'' are set to display the Right answer (During the attempt or Immediately after the attempt etc.), and your question's ''Show alternate answers to student'' setting is set to '''Yes''', when the student has submitted his attempt, and is reviewing his answers, all of the possible answers will be displayed, as shown in this screenshot. Correct responses with a grade < 100% are also listed, with their grade value.

Please note that the ''teacher'' will always be able to see that "other accepted answers" section when reviewing the Quiz answers.

[[Image:23 correct responses.jpg]]

===Inserting RegExp sub-questions in Cloze type questions===

{| class="nicetable"
|-
!Important notice
|-
|
The RegExp question type is '''''not''''' recognized by the standard Moodle Cloze question type. If you want to use it you'll have to replace 2 files (''renderer.php'' and ''questiontype.php'') on your ''<yourmoodle>/question/type/multianswer'' with the hacked files available from the links below.

https://raw.github.com/rezeau/moodle/multianswer_regexp-26/question/type/multianswer/questiontype.php

https://raw.github.com/rezeau/moodle/multianswer_regexp-26/question/type/multianswer/renderer.php

Note.- If you are interested in comparing the 2 "standard" Moodle 2.6 multianswer files with the "RegExp hacked" files, go to

https://github.com/rezeau/moodle/compare/MOODLE_26_STABLE...multianswer_regexp-26
|}

Syntax for inserting RegExp sub-questions in Cloze type questions.

Use '''REGEXP''' or shorter '''RX''' coding for questions which ignore case

* The colors of the French flag are {:REGEXP:=blue, white and red#Correct!}.
* The colors of the French flag are {:RX:=blue, white and red#Correct!}.

Will accept "blue, white and red" as a correct answer as well as "Blue, White and Red"

use '''REGEXP_C''' or shorter '''RXC''' coding for questions in which case matters
* The colors of the French flag are {:REGEXP_C:=blue, white and red#Correct!}.
* The colors of the French flag are {:RXC:=blue, white and red#Correct!}.

Will not accept "Blue, White and Red" as a correct answer (wrong capital letters).

Please note that, as explained above, the very first answer ''must'' be Graded 100% (in Cloze type question syntax, all correct is either '''=''' or '''100%''') and it must ''not'' be a regular expression.

Please note that the syntax of the sub-questions inside a Cloze-type question must be followed exactly and that you must never ever copy and paste any question text from e.g. a word-processor into the Cloze-type question editing window. Quite often Cloze-type questions yield errors because extraneous blank spaces, new lines, or any odd formatting character has made its way into the question text.

Note that the ''Hint'' button is not available for a RegExp question embedded in a Cloze-type question.

==See also==
====Downloads====
* Download [http://moodle.org/plugins/view.php?plugin=qtype_regexp the Regexp question type] from the Moodle Plugins repository.
* IMPORTANT : Starting with the 2.2 version of REGEXP, if you want the Help feature, you must also download and install the following 2 "question behaviours" from the Moodle Plugins repository: [http://moodle.org/plugins/view.php?plugin=qbehaviour_regexpadaptivewithhelp RegExp Adaptive mode with Help] and [http://moodle.org/plugins/view.php?plugin=qbehaviour_regexpadaptivewithhelpnopenalty RegExp Adaptive mode with Help (no penalties)].

====Installation====
-------------------------------
If you have downloaded the zip archive from the new moodle.org plugins page

1.- Unzip the zip archive to your local computer.

2.- This will give you a folder named "regexp".

3.- GO TO STEP 4 below
---

If you have downloaded the zip archive from https://github.com/rezeau/moodle-qtype_regexp ('''for latest developments''')

1.- Unzip the zip archive to your local computer.

2.- This will give you a folder named something like "rezeau-moodle_qtype_regexp-ff8c6a1". The end of the name may vary.

3.- ***Rename*** that folder to "regexp".

---

4.- Upload the regexp folder to <yourmoodle>/question/type/ folder.

5.- Visit your Admin/Notifications page so that the new question type gets installed.

====Learn more about regular expressions====

*[http://www.regular-expressions.info/tutorial.html Regular Expressions Tutorial] A complete introduction to the topic.
*[http://www.regexplanet.com/simple/index.html Regular Expression Test Page] Test your regular expressions on a variety of "answers".

====Other Moodle question types based on regular expressions====
[https://docs.moodle.org/dev/The_OU_PMatch_algorithm The OUP's PMatch]

[https://docs.moodle.org/20/en/Preg_question_type Oleg Sychev's Preg question type]

[[Category:Quiz]]
[[Category:Questions]]
[[Category:Contributed code]]

[[fr:question/type/regexp]]
[[es:Tipo de pregunta respuesta corta de expresión regular]]

Viewing Questionnaire responses

2014-04-10T07:20:32Z

Rezeau: /* The CSV file (how to use it) */

{{Questionnaire}}

== All responses ==
On the Questionnaire Report page, users with the necessary permissions can view a statistical Summary of all the responses given to a Questionnaire instance so far.

===Responses display by question type===

====Numeric====

[[Image:05-08-2013 16-34-46.jpg]]

Column 1 displays the number of similar responses. Column 2 displays the responses given. The Total and Average cells are self-explanatory.

====Yes/No====

[[Image:05-08-2013 16-41-00.jpg]]

This screenshot shows that out of 5 respondents who responded to this questionnaire, one did not answer this Yes/No question (which was not set as Required). 3 respondents answered Yes (75%) and 1 answered No (25%). Please note that the percentages are calculated on the actual responses, not the total of those who submitted the questionnaire.

====Radio buttons====

[[Image:05-08-2013 16-46-07.jpg]]

This screenshot shows that 5 our 5 respondents who submitted this questionnaire answered that question (which was Required).

====Check boxes====

[[Image:05-08-2013 16-50-19.jpg]]

This screenshot shows for instance that the Forum and Glossary activities are favoured by 4 respondents (out of 5 who responded), accounting for 27% of the choices each.

====Rate question====

[[Image:05-08-2013 16-54-34.jpg]]

The statistics for Rate questions display 2 tables.

The '''top table''' displays the Average rank for each feature. In this screenshot, the "Formatting your course" feature of Moodle was rated on average 1.4 on the 1 to 4 scale of difficulty, i.e. that feature was rated as between "Very..." and "Easy..." to use.
When creating that Rate question, the following values were entered for each "possible answer":

* 4=Very easy to use
* 3=Easy to use
* 2=Somewhat difficult to use
* 1=Difficult to use

That is to say that the highest "mark" or "value" was given to the easiest choice.
So, the average values (between parentheses) immediately after the average ranks are here the inverse of the average ranks.

The '''bottom table''' displays for each feature the number and percentage of respondents who selected each choice. For instance, for the "Formatting your course" feature, 3 respondents (60% of respondents to that question) selected the "Very easy to use" choice, and 2 respondents (40% of respondents to that question) selected the "Easy to use" choice. Nobody selected the "Difficult" choices for that feature.

====Essay question====

[[Image:05-08-2013 19-04-02.jpg]]
If the questionnaire is set to "full name" (i.e. non anonymous), the respondent's name will be displayed next to their Essay response. Click on the respondent's name to view their full submission.

===Group filtering===

[[Image:16-10-2013 13-45-08.jpg]]

If the questionnaire is set to '''Group Mode''': ''Visible groups'', or is set to ''Separate groups'' and the current user has the ''moodle/site:accessallgroups capability'' (in the current context), and groups have been defined in the current course, then the user has access to a dropdown list of groups. This dropdown list enables the user to "filter" the questionnaire responses by groups. If the setting is '''Group Mode''': ''Separate groups'', then users who do not have the ''moodle/site:accessallgroups'' capability (usually students, or non-editing teachers, etc.) will only be able to view the responses of the group(s) they belong to.

* ''All participants'' includes responses from all the people who answered the questionnaire, including people not belonging to any group.

'''Important'''.- After you have used the dropdown list to select a "set of people" for displaying their responses, the "filter" remains active for the following operations: '''Download in text format''', '''Delete ALL Responses''' and '''View by Response'''. For example, if you selected to display '''All Responses''' for group "Sparrows" and then click on the '''Delete ALL Responses''' tab link, a confirmation message will ask you to confirm that you want to delete all responses for members of group "Sparrows" and only responses of those participants.

'''Note'''.- If a participant belongs to more than one group, then deleting all the responses for ''one of the Groups'' he belongs to will of course delete his responses from ''all the other groups'' he belongs to.

===List of responses===
==== View Individual Responses ====

If the questionnaire '''Respondent Type''' was set as “fullname”, users with the necessary permissions (usually only teachers or tutors) can view each response individually.
On the List of responses page, each respondent's name is displayed, in alphabetical order of the family name.
Upon mouseover, a tooltip displays the submission time-stamp. This is especially useful in case the questionnaire is set to answer more than once and some students have submitted more than one response.
Click on a respondent's name to display their submission to the questionnaire.

====Individual Responses Navigation====
[[File:05-08-2013 18-46-20.jpg]]

When you are viewing a respondent's individual response, use the navigation bar at the top to go to the Previous (in alphabetical order) or Next response. You can go back to the List of responses page at any time.

==== Print this Response ====
Opens printer-friendly window with current Response.

==== Delete this Response ====
Deletes current response.

=== Order Responses ===
When displaying All Responses you can order the choices by number of responses (the Average column) for the following 4 types of questions.

* single choices radio button
* single choices drop-down list
* multiple choices (check boxes)
* rate questions (including Likert scales).

When you arrive on the All Responses page, by default all responses are ordered in the order that the questionnaire creator entered the question choices. You can choose to order them by ascending or descending order.

=== Delete All Responses ===
Deletes all responses in current questionnaire instance. Can be used to “reset” a questionnaire if you no longer need the current data.

=== Download in text format ===
This feature enables you to save all the responses of a questionnaire to a text file (CSV). This file can then be imported into a spreadsheet (e.g. MS Excel or Open Office Calc) or a statistical package for further processing the data.

====Options for text download====
On the '''Download in text format''' page you have a set of 2 options which only concern the output of the radio buttons/single answer question type. Here is how these options work.

Question text: What is your favorite color? Choice: blue, green, red.

{| style="border-spacing:0;"
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| selected color
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border:0.092cm double #808080;padding:0.049cm;"| red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice codes
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 1
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 2
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| 3

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice text
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice codes + Include choice text
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 1 : blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 2 : green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| 3 : red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| No Include box ticked = same as include choice text box ticked
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| red

|}
Note that these output options are over-ridden in case you used the "hidden" option when you created your radio button questions, i.e. the named values will be exported as data.

{| style="border-spacing:0;"
| style="width:33%; border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.132cm;"| ''Possible answers: ''

Red=the color of blood

Blue=the color of the sky

Black=opposite of white
| style="width:33%; border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.132cm;"| '''What is your favorite color?'''

the color of blood

the color of the sky

opposite of white
| style="width:33%; border:0.092cm double #808080;padding:0.132cm;"| ''Irrespective of the Include choice codes/text options selected on the Download in text format page, this will output the values '''Red''', '''Blue''' or '''Black''' to the CSV file.''

|}

====The CSV file (how to use it)====
The text format available here is of the so-called CSV (comma separated values) type. However, for more universal use, the '''tab''' (tabulation) separator is used, rather than the comma or semi-colon.

When you click on the '''Download in text format''' button, a window opens, asking you whether you'd like to save the data file or open it. Select ''save''. The data file is named after the name of the current quiz, however you can save it under a different name. The proposed data file extension is *.txt, but you ''can'' rename it. Note that you ''must'' rename it with a *.csv extension for import into ''Open Office Calc'' or ''LibreOffice Calc''.

Then go to your external software, and open the file into it. The following operations depend on the software you are using and on a number of other parameters. If you are using a non-ascii language interface in Moodle or you are using the English language but some of your questionnaire questions (or responses) have non-ascii characters in them, then ''Excel'' (or ''Open Office Calc'') might be able to ''automatically detect'' that your file is UTF-8 encoded, and decode it accordingly. Please note that if most of your data file is using standard ascii characters and only a very small number of non-ascii characters are present, the automatic detection will not work, and you will have to ''manually'' select the UTF-8 encoding in the list provided by your software.

At the top of the "table" imported into e.g. ''Excel'', the first line contains the names of all the question fields. This is followed by one line per response. The first 7 fields are as follows (in the English version):

{| style="border-spacing:0;"
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Response
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Submitted on:
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Institution
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Department
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Course
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Group
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| ID
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Full name
| style="border:0.092cm double #808080;padding:0.079cm;"| Username

|}
The submitted_date field contains the date (and time, i.e. hour minutes seconds) when the response was submitted by respondent. For example: 15/09/2007 15:57. Normally you should be able to use Excel cell formatting to display such dates at will, in your own language formatting conventions, including the seconds, and if you wish full day or months names, while retaining the sorting facility.

If the questionnaire was set as "anonymous responses", the ID and Username will be empty and the Full name field will display "Anonymous".

== Your responses ==
On the Questionnaire Report page, users with the necessary permissions can view their own responses on the page entitled “Your results”. Usually students will be allowed to view their own responses.

If the questionnaire's settings allow more than one response and more than one response have been entered by the current user, then all of the features of the “View All responses” explained above apply.

However, it is not possible to delete individual responses in this “Your responses” view. And the Download as text format is not available to users with the student role.

=== All your responses ===
This provides a view of all of a respondent's responses, on successive dates. This feature may be useful if a questionnaire is used as a kind of portfolio.

== Show Non-Respondents ==

This feature allows the teacher to see students who have not yet responded. A reminder message can be sent to individuals or to everyone that hasn’t submitted responses.

The list of "non-respondents" can be filtered by Group (if Groups are enabled for this course and activity).

If the questionnaire's '''Save/Resume answers''' is set to Yes, then the list shows those students who have started but not yet submitted their questionnaire responses.

[[Image:05-08-2013 16-15-58.jpg]]

[[fr:Voir_les_réponses_du_Questionnaire]]
[[es:Viendo respuestas de un cuestionario]]

Questionnaire index view

2014-03-23T15:52:40Z

Rezeau:

{{Questionnaire}}
When the Activities block is activated in a course which contains one or more questionnaire instances, clicking on the Questionnaire link in that block will display a list of all those questionnaire instances, with relevant information.
=Student view=
[[Image:2014-03-23 16-09-06.jpg]]
* If a questionnaire has a due/closing date, that date will be displayed. (1)
* If a questionnaire is set to "Save and Resume" and a student has saved their progress, the latest Saved date will be displayed. (2)
* When a questionnaire has been submitted, the Submission date will be displayed. (3)

=Teacher view=
* If a questionnaire has a due/closing date, that date will be displayed.
* The number of responses submitted is displayed.
* The questionnaire type is displayed.
** For Public questionnaires, there are two cases.
{{New features}}
[[Image:2014-03-23 16-28-37.jpg]] 
Case#1 (screenshot above) If the public questionnaire was originally created in the current course, and if it is being used in (i.e. it has been "copied" to) other courses, a list of those copies (and the name of the other courses using that original questionnaire) is displayed. 
[[Image:2014-03-23 16-34-29.jpg]] 
Case#2 (screenshot above) If the public questionnaire was originally created in another course, and if it is being used in (i.e. it has been "copied" to) the current course, the name of that original questionnaire is displayed (as well as the full name of the course where it was created). 
'''Note'''.- If the current user (teacher) is enrolled as teacher in those other courses (where the original questionnaire or copies of the current original one is/are located), then the name of the questionnaires is an active link to the Preview page of the questionnaires in the other courses. If the current user is an Admin, then all links are active.

Questionnaire index view

2014-03-23T15:50:37Z

Rezeau: /* Teacher view */

When the Activities block is activated in a course which contains one or more questionnaire instances, clicking on the Questionnaire link in that block will display a list of all those questionnaire instances, with relevant information.
=Student view=
[[Image:2014-03-23 16-09-06.jpg]]
* If a questionnaire has a due/closing date, that date will be displayed. (1)
* If a questionnaire is set to "Save and Resume" and a student has saved their progress, the latest Saved date will be displayed. (2)
* When a questionnaire has been submitted, the Submission date will be displayed. (3)

=Teacher view=
* If a questionnaire has a due/closing date, that date will be displayed.
* The number of responses submitted is displayed.
* The questionnaire type is displayed.
** For Public questionnaires, there are two cases.
{{New features}}
[[Image:2014-03-23 16-28-37.jpg]] 
Case#1 (screenshot above) If the public questionnaire was originally created in the current course, and if it is being used in (i.e. it has been "copied" to) other courses, a list of those copies (and the name of the other courses using that original questionnaire) is displayed. 
[[Image:2014-03-23 16-34-29.jpg]] 
Case#2 (screenshot above) If the public questionnaire was originally created in another course, and if it is being used in (i.e. it has been "copied" to) the current course, the name of that original questionnaire is displayed (as well as the full name of the course where it was created). 
'''Note'''.- If the current user (teacher) is enrolled as teacher in those other courses (where the original questionnaire or copies of the current original one is/are located), then the name of the questionnaires is an active link to the Preview page of the questionnaires in the other courses. If the current user is an Admin, then all links are active.

Template:Questionnaire

2014-03-23T15:49:14Z

Rezeau:

<div class="navtrail">[[Main page]] ► [[Managing a Moodle course]] ► [[Activities]] ► [[Questionnaire]] ► [[{{PAGENAME}}]]</div>
<div class="sideblock right" style="width: 12em;">
<div class="header">[[Questionnaire]]</div>
<div class="content">
* [[Adding/editing a questionnaire]]
* [[Setting up a questionnaire|Advanced settings]]
* [[Editing Questionnaire questions|Adding questions]]
* [[Viewing Questionnaire responses|Viewing responses]]
* [[Questionnaire Conditional branching|Conditional branching]]
* [[Questionnaire Personality test|Personality test]]
* [[Questionnaire_index_view|Index View]]
</div>
</div>

mod/questionnaire/index

2014-03-23T15:43:59Z

Rezeau: Redirected page to Questionnaire index view

#REDIRECT [[Questionnaire_index_view]]

Questionnaire index view

2014-03-23T15:42:34Z

Rezeau: /* Teacher view */

When the Activities block is activated in a course which contains one or more questionnaire instances, clicking on the Questionnaire link in that block will display a list of all those questionnaire instances, with relevant information.
=Student view=
[[Image:2014-03-23 16-09-06.jpg]]
* If a questionnaire has a due/closing date, that date will be displayed. (1)
* If a questionnaire is set to "Save and Resume" and a student has saved their progress, the latest Saved date will be displayed. (2)
* When a questionnaire has been submitted, the Submission date will be displayed. (3)

=Teacher view=
* If a questionnaire has a due/closing date, that date will be displayed.
* The number of responses submitted is displayed.
* The questionnaire type is displayed.
** For Public questionnaires, there are two cases.
[[Image:2014-03-23 16-28-37.jpg]] 
Case#1 (screenshot above) If the public questionnaire was originally created in the current course, and if it is being used in (i.e. it has been "copied" to) other courses, a list of those copies (and the name of the other courses using that original questionnaire) is displayed. 
[[Image:2014-03-23 16-34-29.jpg]] 
Case#2 (screenshot above) If the public questionnaire was originally created in another course, and if it is being used in (i.e. it has been "copied" to) the current course, the name of that original questionnaire is displayed (as well as the full name of the course where it was created). 
'''Note'''.- If the current user (teacher) is enrolled as teacher in those other courses (where the original questionnaire or copies of the current original one is/are located), then the name of the questionnaires is an active link to the Preview page of the questionnaires in the other courses. If the current user is an Admin, then all links are active.

File:2014-03-23 16-34-29.jpg

2014-03-23T15:37:19Z

Rezeau:

File:2014-03-23 16-28-37.jpg

2014-03-23T15:30:06Z

Rezeau:

Questionnaire index view

2014-03-23T15:27:58Z

Rezeau: /* Student view */

When the Activities block is activated in a course which contains one or more questionnaire instances, clicking on the Questionnaire link in that block will display a list of all those questionnaire instances, with relevant information.
=Student view=
[[Image:2014-03-23 16-09-06.jpg]]
* If a questionnaire has a due/closing date, that date will be displayed. (1)
* If a questionnaire is set to "Save and Resume" and a student has saved their progress, the latest Saved date will be displayed. (2)
* When a questionnaire has been submitted, the Submission date will be displayed. (3)

=Teacher view=
* If a questionnaire has a due/closing date, that date will be displayed.
* The number of responses submitted is displayed.
* The questionnaire type is displayed.
** For Public questionnaires, there are two cases.
*** If the public questionnaire was originally created in the current course, and if it is being used in (i.e. it has been "copied" to) other courses, a list of those copies (and the name of the other courses using that original questionnaire) is displayed.
*** If the public questionnaire was originally created in another course, and if it is being used in (i.e. it has been "copied" to) the current course, the name of that original questionnaire is displayed (as well as the full name of the course where it was created).
*** Note.- If the current user (teacher) is enrolled as teacher in those other courses (where the original questionnaire or copies of the current original one is/are located), then the name of the questionnaires is an active link to the Preview page of the questionnaires in the other courses.

File:2014-03-23 16-09-06.jpg

2014-03-23T15:27:01Z

Rezeau:

Questionnaire index view

2014-03-23T15:22:19Z

Rezeau:

When the Activities block is activated in a course which contains one or more questionnaire instances, clicking on the Questionnaire link in that block will display a list of all those questionnaire instances, with relevant information.
=Student view=
* If a questionnaire has a due/closing date, that date will be displayed.
* If a questionnaire is set to "Save and Resume" and a student has saved their progress, the latest Saved date will be displayed.
* When a questionnaire has been submitted, the Submission date will be displayed.
=Teacher view=
* If a questionnaire has a due/closing date, that date will be displayed.
* The number of responses submitted is displayed.
* The questionnaire type is displayed.
** For Public questionnaires, there are two cases.
*** If the public questionnaire was originally created in the current course, and if it is being used in (i.e. it has been "copied" to) other courses, a list of those copies (and the name of the other courses using that original questionnaire) is displayed.
*** If the public questionnaire was originally created in another course, and if it is being used in (i.e. it has been "copied" to) the current course, the name of that original questionnaire is displayed (as well as the full name of the course where it was created).
*** Note.- If the current user (teacher) is enrolled as teacher in those other courses (where the original questionnaire or copies of the current original one is/are located), then the name of the questionnaires is an active link to the Preview page of the questionnaires in the other courses.

Questionnaire index view

2014-03-23T14:24:37Z

Rezeau: Created page with "TODO"

TODO

mod/questionnaire/index

2014-03-23T14:19:07Z

Rezeau: Created page with "TODO"

TODO

Setting up a questionnaire

2014-03-23T14:15:11Z

Rezeau: /* Public questionnaire roll out to multiple courses */

{{Questionnaire}}

After you have created a questionnaire you can define extra settings in the '''Advanced settings''' link/tab.

==Content options==
===Questionnaire Type===
There are three types of questionnaires:

# ''' Private ''' - belongs to the course it is defined in only. This is the standard Moodle module concept. You create a questionnaire and its questions for the course it is defined in. Editing teachers of that course can change the questionnaire and all teachers can review the results.
# ''' Template ''' - can be copied and edited. This type of questionnaire cannot be used directly, but its content can be copied into a new questionnaire and edited.
# ''' Public ''' - can be shared among courses. If a questionnaire has already been created (in another course on the same Moodle site) with the "public" setting, then you may use that "public" questionnaire in your own course(s). The number of settings available to such questionnaires is limited and you cannot edit its questions nor view the responses. '''''Example'''''.- If a public questionnaire has been created in course A, it can be "used" in courses B, C, ... All the responses from courses A, B, C, ... are collected in the public questionnaire created in course A (the original course where it was created) and are viewable there by the person (admin or teacher) who originally created it.
====Public questionnaire roll out to multiple courses====

It is possible to create a Public questionnaire whose aliases can be placed in several courses. The student responses will only be visible in the course where the original Public questionnaire has been created. There are mainly 2 applications of this setup.

case 1.- An admin may want to see course evaluations by students without the course teachers seeing those evaluations.

case 2.- A teacher teaching several courses may want to "consolidate" the results of several questionnaires (in his various courses) into one unique Public questionnaire.

Here's how you do it (for case1)
<ol>
<li>Create a course that will simply be a shell for any public questionnaires. Give it whatever title you like, e.g. PubQuestCourse. You can hide the course entirely. </li>
<li>Create your questionnaire in this course. Call it e.g. "Public questionnaire01" On the "Advanced settings" page, select '''Public''' for the questionnaire type.</li>
<li>Add questions in this public questionnaire.</li>
<li>Navigate to the course where you want to place an alias of that Public questionnaire.</li>
<li>Add an activity or resource: Questionnaire. Edit all the various settings. Name it e.g. Questionnaire01. For Response options|Type, we suggest you select Respond once.
<li> 
[[File:2014-03-23 15-03-50.jpg]]
 
In the Content options section, in the radio buttons list, under Use public, the title of the public questionnaire you created in the other course (PubQuestCourse) will appear (e.g. Public questionnaire01): check its radio button. Then finish editing (click the Save and return to course button). 
Please note that starting with version 2.6, the Content options section now distinguishes ''Copy existing'' (for questionnaires in current course) from ''Use template'' (template courses may reside in other courses). Also, the course which each existing/available questionnaire belongs to is displayed between square brackets. 
If you are not sure about the actual contents of a questionnaire you would like to "copy" or "use", clicking on its title will link to a Preview pop-up window.</li>
Note.- For options 4-6 above, an admin may ask individual teachers to create those questionnaires based on a public questionnaire in their own courses, giving them detailed instructions on how to proceed. Unfortunately at the moment there is no way to automatically deploy a public questionnaire to other courses, it has to be done "by hand".
<li>Student responses will appear in the original questionnaire (e.g. "Public questionnaire01" in course PubQuestCourse), but will not be visible at all in the "local" questionnaire (alias). Teachers will not be able to respond to it or view their students' responses.</li>
</ol>
'''IMPORTANT''' Please note that when you delete a Public questionnaire, you also delete the links to its "dependent" questionnaires in the other courses on your moodle site. If a Public questionnaire is no longer used, the normal procedure is to go to all the other courses that "use" that Public questionnaire and delete them first.

====Template questionnaire used in multiple courses====

When the responses to your questionnaire should remain accessible in the course in which it resides, but the questionnaire itself will follow a standard format with the same questions, use a template-type of questionnaire. So instead of re-creating the questions for each questionnaire, you can apply the template questionnaire to each one you create.

Here's how you do it:
<ol>
<li>Create a course that will simply be a shell for any template questionnaires. Give it whatever title you like e.g. TempQuestCourse. You can hide the course entirely. </li>
<li>Create your questionnaire in this course. On the "Advanced settings" page, select '''Template''' for the questionnaire type.</li>
<li>Add questions in this template questionnaire.</li>
<li>Navigate to the course where you want to place an alias of that Template questionnaire.</li>
<li>Add an activity or resource: Questionnaire. Edit all the various settings. Name it e.g. Questionnaire02.</li>
<li> 
[[File:10-10-2013 10-07-55.jpg]]
 
In the Content options section, in the radio buttons list, under Copy existing, the title of the Template questionnaire you created in the other course (TempQuestCourse) will appear (e.g. Template questionnaire01): check its radio button. Then finish editing (click the Save and return to course button).</li>
</ol>

If you don't want your teachers to view or alter questionnaire responses, just define this in the Define Roles settings for Questionnaires. In Define Roles, you can limit teachers from being able to delete responses from the questionnaire, or be able to submit their own questionnaires or view responses.

===Title/Sub-title===

Title of the questionnaire, which will appear at the top of every page. By default Title is set to the questionnaire Name, but you can edit it as you like.

===Additional Info===

Text to be displayed at the top of the first page of the questionnaire. (i.e. instructions, background info, etc.)

==Submission options==

===Confirmation URL/page===

Heading (in bold) and body text for the "Confirmation" page displayed after a user completes this questionnaire. (URL, if present, takes precedence over confirmation text.) If you leave this field empty, a default message will be displayed upon questionnaire completion (''Thank you for completing this Questionnaire'').
===Email===
Sends a copy of each submission to the specified address or addresses.
You can provide more than one address by separating them with commas.
Leave blank for no email backup.

[[Category:Teacher]]

File:2014-03-23 15-03-50.jpg

2014-03-23T14:07:30Z

Rezeau:

Question types

2014-02-11T13:48:12Z

Rezeau: /* Description */

{{Questions}}You may add a variety of different types of questions in the Quiz and Lesson modules. This page is about [[Quiz module]] question types; some will be similar to [[Lesson questions]] types, which are fewer in number and function differently. The standard quiz question types are listed below with brief descriptions. '''Please use the links on the right side of this page to find more detailed information about standard questions types.'''

==Standard question types==

=== Calculated ===
Calculated questions offer a way to create individual numerical questions by the use of wildcards that are substituted with individual values when the quiz is taken. [[Calculated_question_type|More on the Calculated question type]]

===Calculated multi-choice===
===Calculated simple===

=== Description ===
This question type is not actually a question. It just prints some text (and possibly graphics) without requiring an answer. This can be used to provide some information to be used by a subsequent group of questions, for example. [[Description_question_type|More on the Description question type]]

=== Essay ===
This allows students to write at length on a particular subject and must be manually graded.

It is possible for a teacher to create a template to scaffold the student's answer in order to give them extra support. The template is then reproduced in the text editor when the student starts to answer the question. See Youtube video [http://youtu.be/BAZa66WvyWQ Essay scaffold with the Moodle quiz]

{|
| [[File:templatebox.png|thumb|Response template in question set up screen]]
| [[File:quiztemplate.png|thumb|What the student sees]]
|
|}

=== Matching ===
A list of sub-questions is provided, along with a list of answers. The respondent must "match" the correct answers with each question. [[Matching_question_type|More on the Matching question type]]

=== Embedded Answers ([http://en.wikipedia.org/wiki/Cloze_test Cloze Test] / Gap Fill) ===
These very flexible questions consist of a passage of text (in Moodle format) that has various answers embedded within it, including multiple choice, short answers and numerical answers. [[Embedded_Answers_(Cloze)_question_type|More on the Embedded Answers question type]]

=== Multiple choice ===
With the [[Multiple Choice question type]] you can create single-answer and multiple-answer questions, include pictures, sound or other media in the question and/or answer options (by inserting HTML) and weight individual answers.

=== Short Answer ===
In response to a question (that may include an image), the respondent types a word or phrase. There may several possible correct answers, with different grades. Answers may or may not be sensitive to case. [[Short-Answer_question_type|More on the Short Answer question type]]

=== Numerical ===
From the student perspective, a numerical question looks just like a short-answer question. The difference is that numerical answers are allowed to have an accepted error. This allows a continuous range of answers to be set. [[Numerical_question_type|More on the Numerical question type]]
===Random short-answer matching===
=== True/False ===
In response to a question (that may include an image), the respondent selects from two options: True or False. [[True/False_question_type|More on the True/False question type]]

==Third-party question types==

Besides the standard question types that are part of the core Moodle distribution, there are a number of [https://moodle.org/plugins/browse.php?list=category&id=29 question type add-ons] in [https://moodle.org/plugins the add-ons database].

Some of those add-ons have additional documentation in [[Third-party_question_types|Third-party question types]]:

==See also==
[[Lesson questions]]

[[Category:Quiz]]
[[Category:Teacher]]
[[Category:Lesson]]

[[ca:Tipus_de_preguntes]]
[[es:Tipos de preguntas]]
[[eu:Galdera-motak]]
[[fr:Types de questions]]
[[ja:問題タイプ]]

Adding/editing a questionnaire

2014-02-11T13:43:00Z

Rezeau: /* ALL Response viewing */

{{Questionnaire}}

==Timing==

Set the date window for when users can complete the questionnaire. You can leave the boxes unchecked if you want the questionnaire to be continually available.

==Response options==
===Type===

Select whether users will be allowed to respond once, daily, weekly, monthly or an unlimited number of times ('''many''').

===Respondent Type===

You can display your users' full names with each response by setting this to "fullname". You can hide your users' identities from the responses by setting this to "anonymous".

Once the "anonymous" option has been set in a questionnaire, it's impossible to revert to the "fullname" option, for obvious privacy reasons. So be careful when you set your questionnaire to "anonymous".

'''Note'''.- If your Moodle course allows guests, they will only be allowed to respond to a questionnaire whose responses have been set to ''anonymous''.

===Respondent Eligibility===

Decide whether everyone can answer or whether you want to restrict it to tutor only or student only responses. For restricted access options remember to assign the correct roles either at the course or activity level. For example, if you put a questionnaire on the front page, intended for teachers only, then you will have to let Moodle know which users are teachers.

===ALL Responses viewing===

====WHEN====

You can specify '''when''' Students can see the responses of ALL respondents to submitted questionnaires (i.e. the general statistics tables).

''' Students can view ALL responses -> '''

# ''' After answering the questionnaire'''.
# ''' After the questionnaire is closed'''.
# ''' Always.'''

====WHO (Which role can see what)====

Starting with Questionnaire version 2.'''5''', the ''"WHO" can view the ALL Responses report'' page settings have been moved to the Roles and Permissions settings.

As with all other Roles and capabilities settings in Moodle, you can set those permissions at site level, course level or activity level.

The following table sums up the correlation between the Questionnaire Response Options Settings and the Permissions settings. As you can see, the Roles and Permissions settings can OVERRIDE the Response options settings.

[[Image:2014-02-11_14-26-23.jpg]]

===Save/Resume answers===

Setting this option allows users to save their answers to a questionnaire before submitting them. Users can leave the questionnaire unfinished and resume from the save point at a later date.

===Allow branching questions===

The Conditional Branching feature enables the Questionnaire creator to "branch" the respondent to different pages according to their choice of response to Yes/No, Dropdown boxes or Radio button questions. This option is enabled by default when you create a new questionnaire. If you do not plan to use this feature in the questionnaire, you should set it to No.

===Submission grade===
Unlike the Quiz or Lesson Moodle activities the questionnaire activity is not meant to test the student's knowledge and therefore the responses cannot/should not be graded as correct or incorrect. However, in order to encourage the students to complete a questionnaire, you may choose to award the student a grade (on a 1-100 scale) upon completion.

==Content Options==

Select one of the radio button options. 'Create new' is the default.

'' You can create questionnaires using three different methods: ''
:''' Create New: '''
::This option allows you to create a completely new questionnaire from scratch.
:''' Copy Existing: '''
::This option copies a pre-existing questionnaire's content to a new questionnaire, pre-seeding the content. You can copy questionnaires belonging to the course, or ones specifically marked as 'template'.
:''' Use Public: '''
::If a questionnaire has already been created (in another course on the same Moodle site) with the "public" setting, then you may use that "public" questionnaire in your own course(s). The number of settings available to such questionnaires is limited and you cannot edit its questions nor view the responses. ''''' Example '''''.- If a public questionnaire has been created in course A, it can be "used" in courses B, C, ... All the responses from courses A, B, C, ... are collected in the public questionnaire created in course A (the original course where it was created) and are viewable there by the person (admin or teacher) who originally created it.

[[Category:Teacher]]

[[fr:Ajouter/modifier un questionnaire]]

Adding/editing a questionnaire

2014-02-11T13:42:22Z

Rezeau: /* Response viewing */

{{Questionnaire}}

==Timing==

Set the date window for when users can complete the questionnaire. You can leave the boxes unchecked if you want the questionnaire to be continually available.

==Response options==
===Type===

Select whether users will be allowed to respond once, daily, weekly, monthly or an unlimited number of times ('''many''').

===Respondent Type===

You can display your users' full names with each response by setting this to "fullname". You can hide your users' identities from the responses by setting this to "anonymous".

Once the "anonymous" option has been set in a questionnaire, it's impossible to revert to the "fullname" option, for obvious privacy reasons. So be careful when you set your questionnaire to "anonymous".

'''Note'''.- If your Moodle course allows guests, they will only be allowed to respond to a questionnaire whose responses have been set to ''anonymous''.

===Respondent Eligibility===

Decide whether everyone can answer or whether you want to restrict it to tutor only or student only responses. For restricted access options remember to assign the correct roles either at the course or activity level. For example, if you put a questionnaire on the front page, intended for teachers only, then you will have to let Moodle know which users are teachers.

===ALL Response viewing===

====WHEN====

You can specify '''when''' Students can see the responses of ALL respondents to submitted questionnaires (i.e. the general statistics tables).

''' Students can view ALL responses -> '''

# ''' After answering the questionnaire'''.
# ''' After the questionnaire is closed'''.
# ''' Always.'''

====WHO (Which role can see what)====

Starting with Questionnaire version 2.'''5''', the ''"WHO" can view the ALL Responses report'' page settings have been moved to the Roles and Permissions settings.

As with all other Roles and capabilities settings in Moodle, you can set those permissions at site level, course level or activity level.

The following table sums up the correlation between the Questionnaire Response Options Settings and the Permissions settings. As you can see, the Roles and Permissions settings can OVERRIDE the Response options settings.

[[Image:2014-02-11_14-26-23.jpg]]

===Save/Resume answers===

Setting this option allows users to save their answers to a questionnaire before submitting them. Users can leave the questionnaire unfinished and resume from the save point at a later date.

===Allow branching questions===

The Conditional Branching feature enables the Questionnaire creator to "branch" the respondent to different pages according to their choice of response to Yes/No, Dropdown boxes or Radio button questions. This option is enabled by default when you create a new questionnaire. If you do not plan to use this feature in the questionnaire, you should set it to No.

===Submission grade===
Unlike the Quiz or Lesson Moodle activities the questionnaire activity is not meant to test the student's knowledge and therefore the responses cannot/should not be graded as correct or incorrect. However, in order to encourage the students to complete a questionnaire, you may choose to award the student a grade (on a 1-100 scale) upon completion.

==Content Options==

Select one of the radio button options. 'Create new' is the default.

'' You can create questionnaires using three different methods: ''
:''' Create New: '''
::This option allows you to create a completely new questionnaire from scratch.
:''' Copy Existing: '''
::This option copies a pre-existing questionnaire's content to a new questionnaire, pre-seeding the content. You can copy questionnaires belonging to the course, or ones specifically marked as 'template'.
:''' Use Public: '''
::If a questionnaire has already been created (in another course on the same Moodle site) with the "public" setting, then you may use that "public" questionnaire in your own course(s). The number of settings available to such questionnaires is limited and you cannot edit its questions nor view the responses. ''''' Example '''''.- If a public questionnaire has been created in course A, it can be "used" in courses B, C, ... All the responses from courses A, B, C, ... are collected in the public questionnaire created in course A (the original course where it was created) and are viewable there by the person (admin or teacher) who originally created it.

[[Category:Teacher]]

[[fr:Ajouter/modifier un questionnaire]]

Adding/editing a questionnaire

2014-02-11T13:34:18Z

Rezeau: /* Response viewing */

{{Questionnaire}}

==Timing==

Set the date window for when users can complete the questionnaire. You can leave the boxes unchecked if you want the questionnaire to be continually available.

==Response options==
===Type===

Select whether users will be allowed to respond once, daily, weekly, monthly or an unlimited number of times ('''many''').

===Respondent Type===

You can display your users' full names with each response by setting this to "fullname". You can hide your users' identities from the responses by setting this to "anonymous".

Once the "anonymous" option has been set in a questionnaire, it's impossible to revert to the "fullname" option, for obvious privacy reasons. So be careful when you set your questionnaire to "anonymous".

'''Note'''.- If your Moodle course allows guests, they will only be allowed to respond to a questionnaire whose responses have been set to ''anonymous''.

===Respondent Eligibility===

Decide whether everyone can answer or whether you want to restrict it to tutor only or student only responses. For restricted access options remember to assign the correct roles either at the course or activity level. For example, if you put a questionnaire on the front page, intended for teachers only, then you will have to let Moodle know which users are teachers.

===Response viewing===

====WHEN====

You can specify '''when''' Students can see the responses of all respondents to submitted questionnaires (general statistics tables).

''' Students can view ALL responses -> '''

# ''' After answering the questionnaire'''. This allows students to see all responses after answering a questionnaire that is set to '''''respond once only'''''. If a questionnaire is set to respond more than once, then students cannot see all responses unless you use one of the next two options.
# ''' After the questionnaire is closed'''.
# ''' Always.'''

====WHO (Which role can see what)====

Starting with Questionnaire version 2.'''5''', the ''"WHO" can view the ALL Responses report'' page settings have been moved to the Roles and Permissions settings.

As with all other Roles and capabilities settings in Moodle, you can set those permissions at site level, course level or activity level.

The following table sums up the correlation between the Questionnaire Response Options Settings and the Permissions settings:

[[Image:2014-02-11_14-26-23.jpg]]

===Save/Resume answers===

Setting this option allows users to save their answers to a questionnaire before submitting them. Users can leave the questionnaire unfinished and resume from the save point at a later date.

===Allow branching questions===

The Conditional Branching feature enables the Questionnaire creator to "branch" the respondent to different pages according to their choice of response to Yes/No, Dropdown boxes or Radio button questions. This option is enabled by default when you create a new questionnaire. If you do not plan to use this feature in the questionnaire, you should set it to No.

===Submission grade===
Unlike the Quiz or Lesson Moodle activities the questionnaire activity is not meant to test the student's knowledge and therefore the responses cannot/should not be graded as correct or incorrect. However, in order to encourage the students to complete a questionnaire, you may choose to award the student a grade (on a 1-100 scale) upon completion.

==Content Options==

Select one of the radio button options. 'Create new' is the default.

'' You can create questionnaires using three different methods: ''
:''' Create New: '''
::This option allows you to create a completely new questionnaire from scratch.
:''' Copy Existing: '''
::This option copies a pre-existing questionnaire's content to a new questionnaire, pre-seeding the content. You can copy questionnaires belonging to the course, or ones specifically marked as 'template'.
:''' Use Public: '''
::If a questionnaire has already been created (in another course on the same Moodle site) with the "public" setting, then you may use that "public" questionnaire in your own course(s). The number of settings available to such questionnaires is limited and you cannot edit its questions nor view the responses. ''''' Example '''''.- If a public questionnaire has been created in course A, it can be "used" in courses B, C, ... All the responses from courses A, B, C, ... are collected in the public questionnaire created in course A (the original course where it was created) and are viewable there by the person (admin or teacher) who originally created it.

[[Category:Teacher]]

[[fr:Ajouter/modifier un questionnaire]]

File:2014-02-11 14-26-23.jpg

2014-02-11T13:29:20Z

Rezeau:

Questionnaire Personality test

2014-02-01T16:53:56Z

Rezeau: /* Chart types */

{{Questionnaire}}
{{New features}}
==Overview==

===Definition===
A personality test is a tool that attempts to measure a person's social interaction skills and patterns of behavior. (US legal definition).

In the Moodle Questionnaire add-on, the "personality test" feature enables a questionnaire creator to attribute different "values" to the answers to certain types of questions. Those values can be added into scores - globally or in several "sections" - and relevant feedback messages based on those scores can be displayed to the respondent.

Given the particular nature of the "personality test" feature, great care should be exercised when using it in questionnaires.

===Organization===
The following question types can be used with the "personality test" feature: ''Radio buttons'', ''Dropdown Box'', ''Rate'' and ''Yes/No''. In order for the answers to those questions to be "scored", they ''must'' have a '''question name''', must be '''required''' and each of their choices must have a '''value'''. For the ''Yes/No'' question, the default values are 1 for a Yes answer and 0 for a No.

===Settings===
See the examples below.

==Global Feedback example==

Adapted from [http://www.personalitytest.net/funtest/hrdept.htm www.personalitytest.net]

===Questions===
*Create Q1 as a ''Radio Buttons'' (or Dropdown Box) question type
**'''Question Name''': ''feel your best''
**'''Response Required''': ''Yes''. We are giving question Q1 a '''name''' and setting it as '''Required''' because we plan to use it in the Personality test feedback.
**'''Question Text''': When do you feel your best?
**'''Possible answers''':
***2=In the morning
***4=During the afternoon and early evening
***6=Late at night
Each possible answer choice begins with a value ''immediately followed'' by the equal sign (=) ''immediately followed'' by the choice words(*). The values attributed to the various choices must be carefully considered in order to obtain a coherent "score" when they are added up in the feedback score calculation. Here we are using the values as given in the "personality fun test" of our example.

(*) '''No space''' before nor after the equal sign (=).

Continue to create all 10 questions in the sample questionnaire.

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select the first option available, i.e. Global Feedback.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.
Now click the '''Save settings and edit Feedback Sections''' button.
====Editing Questionnaire Feedback Sections====
On this page is displayed the full list of the questions available for the Feedback report. Since we have selected the Global feedback option, all those questions have been default-set in Section 1, the only section available here. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
Normally, you have nothing to change on that page. However you might want to remove one or several questions from the list by clicking the 0 radio button instead of the (Section) 1 button.
Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Global Feedback heading=====
* This begins with a list of the names of all the questions that are used in this Global Feedback section.
* The ''Label'' text box should be kept as short as possible. It will be displayed in the Feedback report and - when the Chart feature is avaiblable in a later version of Questionnaire - will be used in the Charts.
* In the ''Heading'' field you may type a brief heading text. You may use 2 variables in this heading, $scorepercent and $oppositescorepercent. One example is: "You scored $scorepercent in this questionnaire."
=====Global Feedback messages=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, still taken from our sample Personality "Fun" test.
*Feedback Score boundary
**100%
**Feedback : Others see you as someone they should "handle with care" You're seen as vain, self-centered, and who is extremely dominant. Others may admire you, wishing they could be more like you, but don't always trust you, hesitating to become too deeply involved with you.

*Feedback Score boundary
**94%
**Feedback : Others see you as an exciting, highly volatile, rather impulsive personality; a natural leader, who's quick to make decisions, though not always the right ones. [etc.]

*Feedback Score boundary
**85%
etc.

This starts with 3 default boundaries and associated messages, but you may add more boundaries if needed.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 12-21-49.jpg]]

# This table shows the global score for respondent plus, if any, the average global score for all participants. If the questionnaire is set to "separate groups", this box may show the average global score for the group that the actual respondent belongs to.
# In the first box of the Feedback Report we see the Heading text, which may include the value of the $scorepercent variable.
# In the second box we see the "personalized" feedback message, relevant to the Feedback score boundaries that the actual respondent's score sits in.

On the View all Responses page, the Feedback report heading will be displayed, together with the average Global score for All participants. If the questionnaire is set to "visible" or "separate groups", the average global score for the current group will be displayed.

[[File:03-12-2013 13-42-07.jpg]]

==Several sections Feedback example==
A simplistic "health habits" questionnaire.
===Questions===
*Create Q1 as a ''Rate'' question type
**'''Question Name''': ''sports''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you practise these sports?
**'''Possible answers''':
***0=never
***1=once a month
***2=every week
***3=every day
***cycling
***running
***swimming
***walking

*Create Q2 as a ''yes/no'' question type
**'''Question Name''': ''fruit and vegetables''
**'''Response Required''': ''Yes''.
**'''Question Text''': Do you regularly eat fresh fruit and vegetables?

*Create Q3 as a ''Radio buttons'' question type
**'''Question Name''': ''smoking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you smoke?
**'''Possible answers''':
***3=never
***2=less than one packet per month
***1=one packet per week
***0=one packet per day

*Create Q4 as a ''Radio buttons'' question type
**'''Question Name''': ''drinking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you drink alcohol?
**'''Possible answers''':
***3=never
***2=less than one glass per month
***1=one glass per week
***0=one glass per day

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select 2 Feedback sections.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.

[[File:03-12-2013 14-23-55.jpg]]

Now click the '''Save settings and edit Feedback Sections''' button.

====Editing Questionnaire Feedback Sections====

On this page is displayed the full list of the questions available for the Feedback report. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
By default, the questions are not set into any Feedback Section (all radio buttons are set at 0). You now have to set each question into one of the 2 Sections you decided to display in your questionnaire's Feedback Report. At this stage, those 2 Feedback Sections have not yet been named, so you really have to be careful and make a mental note of "which is which". Suppose you want Section 1 to be related to your respondents' practise of sport, you would put question 1 into section 1 (click radio button 1 for that question). Now suppose you want your second section to be related to "healthy attitude" towards food, drinking and smoking; click all the remaining radio buttons "2" for questions 2, 3 and 4.

Suppose you get it wrong and you mistakenly put all of your questions in Section 1. Upon clicking on the "Save" button, this error message would be displayed:
''You must select at least ONE question per section!
Section(s) not selected: 2''

Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Feedback heading for section 1/2=====
You will now get a screen very similar to the one you get for Global Feedback messages (as in our previous example). But you will get several screens, one per section.

* Questions in this section:
** sports
* Label: Physical activity
* Heading: Your "physical activity" score is $scorepercent.
=====Feedback messages for section 1/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You must be very fit. Congratulations!

*Feedback Score boundary
**66%
**Feedback: Your physical activity is only average. Come on!

*Feedback Score boundary
**33%
**Feedback: You seem to be a real couch potato. Make an effort!

When finished, click the '''Next section (2/2)''' button.

=====Feedback heading for section 2/2=====
* Questions in this section:
** fruit and vegetables
** smoking
** drinking
* Label: Healthy habits
* Heading: Your "healthy habits" score is $scorepercent.

=====Feedback messages for section 2/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You seem to have quite healthy habits. Continue!

*Feedback Score boundary
**66%
**Feedback: You seem to have not very healthy habits. Make an effort to cut down on drinking and smoking.

*Feedback Score boundary
**33%
**Feedback: You seem to have not terribly healthy habits. You must make a serious effort.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 14-53-07.jpg]]

This report is similar to the Global Feedback report in our previous example, except that now the score is separated into 2 sections.

==Bipolar results==
Some "personality tests" aim at detecting a bipolar characteristic in respondents' character. For example, whether an individual's profile is rather visual or auditory, global or analytic, extrovert or introvert etc. See Julian Rotter's theory of [http://en.wikipedia.org/wiki/Julian_Rotter#Locus_of_control Locus of Control].

In such cases, you can enter the section labels as a set of 2 opposed (bipolar) concepts, separated by a pipe character.

[[File:03-12-2013 14-58-51.jpg]]

In a questionnaire based on the Locus of Control theory, this "bipolar" heading will give the following kind of report:

[[File:03-12-2013 15-13-09.jpg]]

==Chart display==

===Site settings===
Upon installing or updating the Questionnaire plugin, its "site settings" page is displayed. On that ''Site administration ► Plugins ► Activity modules ► Questionnaire'' page, an admin can choose to enable the Chart feature site-wide. The default is ''No'' (do not enable). The Questionnaire Chart feature currently uses the [http://www.rgraph.net/ RGraph] libraries, which are licensed under the MIT type of open source license.

===Chart types===
Navigate to the ''Advanced settings'' page and click the ''Feedback options'' button.

You can choose to display or not the table of scores in the Feedback report.

The Chart type drop down list that is available is dependent on the number of feedback sections in your questionnaire.

* Global Feedback (i.e. one section only): Bipolar bars or Vertical Progress bar.
* 2 Sections: Bipolar bars or Horizontal bars or Rose.
* More than 2 sections: Bipolar bars or Horizontal bars or Radar or Rose.

Your choice of Chart type depends on the type of questions in your questionnaire. It's up to you to find out the most suitable Chart type. The Bipolar bars type is only suited when your feedback sections include Bipolar_results (see above).

The selected Chart will be displayed on the All Responses page. It will be constructed with all participants' results or, if the questionnaire is set to Visible Groups, with the results of the currently selected group.

On an Individual Responses page, the current user's current results Chart will be displayed, and also the All participants (or current group) results Chart.

Some samples illustrating the complete Chart types that can be used are displayed below.

Vertical Progress bar

[[File:02-01-2014 11-44-28.jpg]]

Bipolar bars

[[File:02-01-2014 11-40-05.jpg]]

Horizontal bars

[[File:02-01-2014 11-42-27.jpg]]

Radar

[[File:02-01-2014 11-37-47.jpg]]

Rose

[[File:02-01-2014 11-38-58.jpg]]

[[fr:Questionnaire_test_de_personnalité]]

Questionnaire Conditional branching

2014-01-26T11:18:19Z

Rezeau: /* Individual Responses Report */

{{Questionnaire}}
==Overview==

===Definition===
Conditional branching (or Skip logic) is a feature that changes what question or page a respondent sees next based on how they answer the current question. Conditional branching creates a custom path through the survey that varies based on a respondent’s answers.

===Organization===
In the Questionnaire plugin, the Conditional branching path is organized through ''pages'', containing one or more "child" questions depending on a "parent" question.

===Settings===
If you want to use the Conditional branching feature in a Questionnaire, when you create or edit the questionnaire, in the Response options section of the settings, you must set the '''Allow branching questions''' option to ''Yes''. Please note that this option is set to ''No'' by default.

==A simple example==

===The flow we want to obtain===

*Page 1
**Question 1 Do you own a car? Yes/No.
***Answer Yes -> go to page 2
***Answer No -> go to page 5 (i.e. skip over irrelevant questions in pages 2 through 4)
*Page 2
**Question 2: What is the color of your car?
**Question 3: Did you buy it new or second-hand?
***Answer new -> go to page 3
***Answer second-hand -> go to page 4
*Page 3
**Question 4: Did you pay your new car cash or did you get a bank loan?
*Page 4
**Question 5: Did you buy your second-hand car from a garage or directly from its previous owner?
*Page 5
**Question 6: Do you sometimes use public transport to go to work?
etc.

===Procedure to obtain that flow===

*Create Q1 as a Yes/No question.
**'''Question Name''': ''own car''. Note that you ''must'' give your question a name, as this name will be used later on in the Questionnaire to build the list of available Parent questions. Please keep this name as short as possible.
**'''Response Required''': ''Yes''. Since you plan to use question Q1 as a Parent question, it would not make sense to set it as non-required.
**'''Question Text''': ''Do you own a car?''
**Save Q1. No Page break will be inserted at this stage because you have not yet used a Parent question to create one or more Child questions.

*Create Q2 as a Text Box question type
**'''Question Name''': optional
**'''Response Required''': ''Yes'' or ''No'' (depending on what you want to do with that question's answers later on).
**'''Parent Question''' : ''own car->Yes''. The Parent question (Q1) option offers 2 choices, since it is a Yes/No question.
**'''Question Text''': ''What is the colour of your car?''
**Save Q2. Upon saving Child question Q2 you notice that a Page break has been automatically inserted between the Parent question Q1 and its Child question Q2.

*Create Q3 as a Radio Buttons (or Dropdown Box) question type
**'''Question Name''': ''car status''
**'''Response Required''': ''Yes''. We are giving question Q3 a name and setting it as Required because we plan to use it as a Parent question.
**'''Parent Question''': own car->Yes
**'''Question Text''': Did you buy it new or second-hand?
**'''Possible answers''':
***''new::I bought it new''
***''used::I bought it second-hand''.
**Please note that in the Possible answers field we are using the "short label" feature. You should use this feature if the full text of your Possible answers choices is fairly long.
**Save Q3. Upon saving Child question Q3 you notice that no Page break has been inserted. This is because both Q2 and Q3 are Child questions of the same Parent question Q1 and thus will be displayed on the same page of the questionnaire.

*Create Q4 as a Radio Buttons question type
**'''Question Name''': optional
**'''Response Required''': Yes or No
**'''Parent Question''': car status->new

**Please note that the list of potential Parent question choices displays the "short label" that we entered for the Possible answers in Q3, instead of the full text.

**'''Question Text''': How did you pay for your new car?
**'''Possible answers''':
***''I paid cash''
***''I got a bank loan''
**Save Q4. Upon saving Child question Q4 you notice that a Page break has been automatically inserted between Parent question Q3 and its Child question Q4.

*Create Q5 as a Radio Buttons question type
**'''Question Name''': optional
**'''Response Required''': Yes or No
**'''Parent Question''': car status->used
**'''Question Text''': Where did you buy your second-hand car?
**'''Possible answers''':
***''I bought it from a garage''
***''I bought it directly from its previous owner''
**Save Q5. Upon saving Child question Q5 you notice that a Page break has been automatically inserted between Child question Q4 and Child question Q5 because these two question do not have the same Parent question.

*Create Q6 as YES/NO question type.
**'''Question Name''': optional
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Do you sometimes use public transport to go to work?
**Save Q6. Upon saving question Q6 you notice that a Page break has been automatically inserted between Child question Q5 and question Q6.

Now continue creating questions normally, until you want to use Conditional branching again.

Here is what your Manage questions section will look like after you have created those first 6 questions.

[[Image:07-08-2013 17-49-53.jpg]]

==Operations on Conditional branching questions==
===Move===
By using the standard Moodle "Move" icon you can move your questionnaire questions to different positions. However, due to the special nature of the questionnaire flow when using the Conditional branching feature, there are restrictions on the new positions that you can move our questions to.

*You cannot move a Parent question ''below'' any of its Child questions.

*You cannot move a Child question ''above'' its Parent question.

*You cannot remove those Page breaks which are needed to ensure a correct flow of dependent questions.

[[Image:07-08-2013 18-04-16.jpg]]

Those restrictions will show on the Manage questions screen where the Move icon is replaced with a "Forbidden" (Moodle "block") icon. They will also operate when you are in "Move question" mode, where the Move to here icon/placeholder will not be displayed in the "forbidden" positions.

===Edit===
Using the standard Moodle "Edit" icon you may edit any question. However, for those questions which have both a Parent question and one or more Child questions, you cannot change their Parent question & Choice, as that might ruin the consequent flow. The only way to change their Parent is to edit their Child question(s) first.

[[Image:07-08-2013 18-12-59.jpg]]

===Delete===
You cannot Delete those Page breaks which have been automatically inserted when adding Child questions.

If you try to Delete a Parent question, you will get a warning with the list of its Child questions. If you answer Yes to the warning, the Parent question will be deleted, together with all its Child (and Grand-Child questions).

[[Image:07-08-2013 18-20-29.jpg]]

===Setting as Required/Not required===

As said above, you would normally set all potential Parent questions as Required. However, there might be cases where you want to leave the respondent the choice to respond or not. If you set a question as Not required, then the usual "No answer" button will be displayed (for Yes/No and Radio Buttons questions). If the respondent does not answer a Parent question, all of its Child questions will be skipped over.

==Previewing Questionnaire==

The Previewing Questionnaire page is useful for a Questionnaire creator to test it out before making it available in a course. In the case of a Conditional branching questionnaire, the Preview is especially useful as it will mimic the flow that a respondent will see, by selecting the various choices offered by the Parent questions.

When a Conditional branching questionnaire is first displayed on the Preview page, only those pages containing "top" parent questions are displayed, as well as pages containing questions that do not have a Parent question.

When a choice is made in the Parent questions, the Child question(s) corresponding to that choice is/are displayed.

The following screnshots illustrate the various possible sequences that can be displayed. In this example, we have set Question 3 as Non-required.

[[File:07-08-2013 18-52-40.jpg]]

The only 2 questions displayed are those with no Parent: Q1 and Q6.

[[File:07-08-2013 18-54-36.jpg]]

Upon clicking on Q1 'No', nothing changes in the display, because in our questionnaire we do not have any Child question dependent on that choice.

[[File:08-08-2013 19-07-13.jpg]]

It is possible for a teacher previewing a questionnaire to "Submit the preview". This will mimic the behaviour of the real Submit questionnaire process: any required question that has not been responded to or any response that does not conform to the question's conditions will be marked with a Warning.

[[File:08-08-2013 18-56-25.jpg]]

If all the required questions have been correctly filled in, then upon submitting the preview, a "correct" message will be displayed.

*To simulate a new questionnaire flow, you can either click the Preview link in your course's navigation bar, or the Preview link in the Questionnaire Administration block or the Reset link at the bottom of the Preview window.

[[File:08-08-2013 22-45-33.jpg]]

Upon clicking the ''Yes'' radio button in answer to Q1, questions Q2 and Q3 on Page 2, which depend on that Q1 ''Yes'' choice are automatically displayed. In "Answer the questions" mode, the respondent would be taken to Page 2 of the questionnaire. Now, if we click on the I bought it new radio button of Q3, Q4 on Page 3 will be displayed, etc.

== Individual Responses Report ==

Branching questionnaire reports display the same as non-Branching ones. The only notable difference is with the Individual Responses Report, where it is possible to view the particular path that a respondent took through the various conditional questions. Here are 2 examples.

[[File:08-08-2013 23-40-12.jpg]]

Respondent "Michael Cane" said he owns a red car, bought it new and paid cash for it. He was not presented with Q5, which is displayed between parentheses and greyed out.

[[File:08-08-2013 23-43-18.jpg]]

Respondent "John Doe" said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

[[fr:Questionnaire_branchement_conditionnel]]

Viewing Questionnaire responses

2014-01-26T11:15:56Z

Rezeau: /* Show Non-Respondents */

{{Questionnaire}}

== All responses ==
On the Questionnaire Report page, users with the necessary permissions can view a statistical Summary of all the responses given to a Questionnaire instance so far.

===Responses display by question type===

====Numeric====

[[Image:05-08-2013 16-34-46.jpg]]

Column 1 displays the number of similar responses. Column 2 displays the responses given. The Total and Average cells are self-explanatory.

====Yes/No====

[[Image:05-08-2013 16-41-00.jpg]]

This screenshot shows that out of 5 respondents who responded to this questionnaire, one did not answer this Yes/No question (which was not set as Required). 3 respondents answered Yes (75%) and 1 answered No (25%). Please note that the percentages are calculated on the actual responses, not the total of those who submitted the questionnaire.

====Radio buttons====

[[Image:05-08-2013 16-46-07.jpg]]

This screenshot shows that 5 our 5 respondents who submitted this questionnaire answered that question (which was Required).

====Check boxes====

[[Image:05-08-2013 16-50-19.jpg]]

This screenshot shows for instance that the Forum and Glossary activities are favoured by 4 respondents (out of 5 who responded), accounting for 27% of the choices each.

====Rate question====

[[Image:05-08-2013 16-54-34.jpg]]

The statistics for Rate questions display 2 tables.

The '''top table''' displays the Average rank for each feature. In this screenshot, the "Formatting your course" feature of Moodle was rated on average 1.4 on the 1 to 4 scale of difficulty, i.e. that feature was rated as between "Very..." and "Easy..." to use.
When creating that Rate question, the following values were entered for each "possible answer":

* 4=Very easy to use
* 3=Easy to use
* 2=Somewhat difficult to use
* 1=Difficult to use

That is to say that the highest "mark" or "value" was given to the easiest choice.
So, the average values (between parentheses) immediately after the average ranks are here the inverse of the average ranks.

The '''bottom table''' displays for each feature the number and percentage of respondents who selected each choice. For instance, for the "Formatting your course" feature, 3 respondents (60% of respondents to that question) selected the "Very easy to use" choice, and 2 respondents (40% of respondents to that question) selected the "Easy to use" choice. Nobody selected the "Difficult" choices for that feature.

====Essay question====

[[Image:05-08-2013 19-04-02.jpg]]
If the questionnaire is set to "full name" (i.e. non anonymous), the respondent's name will be displayed next to their Essay response. Click on the respondent's name to view their full submission.

===Group filtering===

[[Image:16-10-2013 13-45-08.jpg]]

If the questionnaire is set to '''Group Mode''': ''Visible groups'', or is set to ''Separate groups'' and the current user has the ''moodle/site:accessallgroups capability'' (in the current context), and groups have been defined in the current course, then the user has access to a dropdown list of groups. This dropdown list enables the user to "filter" the questionnaire responses by groups. If the setting is '''Group Mode''': ''Separate groups'', then users who do not have the ''moodle/site:accessallgroups'' capability (usually students, or non-editing teachers, etc.) will only be able to view the responses of the group(s) they belong to.

* ''All participants'' includes responses from all the people who answered the questionnaire, including people not belonging to any group.

'''Important'''.- After you have used the dropdown list to select a "set of people" for displaying their responses, the "filter" remains active for the following operations: '''Download in text format''', '''Delete ALL Responses''' and '''View by Response'''. For example, if you selected to display '''All Responses''' for group "Sparrows" and then click on the '''Delete ALL Responses''' tab link, a confirmation message will ask you to confirm that you want to delete all responses for members of group "Sparrows" and only responses of those participants.

'''Note'''.- If a participant belongs to more than one group, then deleting all the responses for ''one of the Groups'' he belongs to will of course delete his responses from ''all the other groups'' he belongs to.

===List of responses===
==== View Individual Responses ====

If the questionnaire '''Respondent Type''' was set as “fullname”, users with the necessary permissions (usually only teachers or tutors) can view each response individually.
On the List of responses page, each respondent's name is displayed, in alphabetical order of the family name.
Upon mouseover, a tooltip displays the submission time-stamp. This is especially useful in case the questionnaire is set to answer more than once and some students have submitted more than one response.
Click on a respondent's name to display their submission to the questionnaire.

====Individual Responses Navigation====
[[File:05-08-2013 18-46-20.jpg]]

When you are viewing a respondent's individual response, use the navigation bar at the top to go to the Previous (in alphabetical order) or Next response. You can go back to the List of responses page at any time.

==== Print this Response ====
Opens printer-friendly window with current Response.

==== Delete this Response ====
Deletes current response.

=== Order Responses ===
When displaying All Responses you can order the choices by number of responses (the Average column) for the following 4 types of questions.

* single choices radio button
* single choices drop-down list
* multiple choices (check boxes)
* rate questions (including Likert scales).

When you arrive on the All Responses page, by default all responses are ordered in the order that the questionnaire creator entered the question choices. You can choose to order them by ascending or descending order.

=== Delete All Responses ===
Deletes all responses in current questionnaire instance. Can be used to “reset” a questionnaire if you no longer need the current data.

=== Download in text format ===
This feature enables you to save all the responses of a questionnaire to a text file (CSV). This file can then be imported into a spreadsheet (e.g. MS Excel or Open Office Calc) or a statistical package for further processing the data.

====Options for text download====
On the '''Download in text format''' page you have a set of 2 options which only concern the output of the radio buttons/single answer question type. Here is how these options work.

Question text: What is your favorite color? Choice: blue, green, red.

{| style="border-spacing:0;"
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| selected color
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border:0.092cm double #808080;padding:0.049cm;"| red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice codes
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 1
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 2
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| 3

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice text
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice codes + Include choice text
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 1 : blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 2 : green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| 3 : red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| No Include box ticked = same as include choice text box ticked
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| red

|}
Note that these output options are over-ridden in case you used the "hidden" option when you created your radio button questions, i.e. the named values will be exported as data.

{| style="border-spacing:0;"
| style="width:33%; border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.132cm;"| ''Possible answers: ''

Red=the color of blood

Blue=the color of the sky

Black=opposite of white
| style="width:33%; border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.132cm;"| '''What is your favorite color?'''

the color of blood

the color of the sky

opposite of white
| style="width:33%; border:0.092cm double #808080;padding:0.132cm;"| ''Irrespective of the Include choice codes/text options selected on the Download in text format page, this will output the values '''Red''', '''Blue''' or '''Black''' to the CSV file.''

|}

====The CSV file (how to use it)====
The text format available here is of the so-called CSV (comma separated values) type. However, for more universal use, the '''tab''' (tabulation) separator is used, rather than the comma or semi-colon.

When you click on the '''Download in text format''' button, a window opens, asking you whether you'd like to save the data file or open it. Select ''save''. The data file is named after the name of the current quiz, however you can save it under a different name. The proposed data file extension is *.txt, but you ''can'' rename it. Note that you ''must'' rename it with a *.csv extension for import into ''Open Office Calc''.

Then go to your external software, and open the file into it. The following operations depend on the software you are using and on a number of other parameters. If you are using a non-ascii language interface in Moodle or you are using the English language but some of your questionnaire questions (or responses) have non-ascii characters in them, then ''Excel'' (or ''Open Office Calc'') might be able to ''automatically detect'' that your file is UTF-8 encoded, and decode it accordingly. Please note that if most of your data file is using standard ascii characters and only a very small number of non-ascii characters are present, the automatic detection will not work, and you will have to ''manually'' select the UTF-8 encoding in the list provided by your software.

At the top of the "table" imported into e.g. ''Excel'', the first line contains the names of all the question fields. This is followed by one line per response. The first 7 fields are as follows (in the English version):

{| style="border-spacing:0;"
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Response
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Submitted on:
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Institution
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Department
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Course
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Group
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| ID
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Full name
| style="border:0.092cm double #808080;padding:0.079cm;"| Username

|}
The submitted_date field contains the date (and time, i.e. hour minutes seconds) when the response was submitted by respondent. For example: 15/09/2007 15:57. Normally you should be able to use Excel cell formatting to display such dates at will, in your own language formatting conventions, including the seconds, and if you wish full day or months names, while retaining the sorting facility.

If the questionnaire was set as "anonymous responses", the ID and Username will be empty and the Full name field will display "Anonymous".

== Your responses ==
On the Questionnaire Report page, users with the necessary permissions can view their own responses on the page entitled “Your results”. Usually students will be allowed to view their own responses.

If the questionnaire's settings allow more than one response and more than one response have been entered by the current user, then all of the features of the “View All responses” explained above apply.

However, it is not possible to delete individual responses in this “Your responses” view. And the Download as text format is not available to users with the student role.

=== All your responses ===
This provides a view of all of a respondent's responses, on successive dates. This feature may be useful if a questionnaire is used as a kind of portfolio.

== Show Non-Respondents ==

This feature allows the teacher to see students who have not yet responded. A reminder message can be sent to individuals or to everyone that hasn’t submitted responses.

The list of "non-respondents" can be filtered by Group (if Groups are enabled for this course and activity).

If the questionnaire's '''Save/Resume answers''' is set to Yes, then the list shows those students who have started but not yet submitted their questionnaire responses.

[[Image:05-08-2013 16-15-58.jpg]]

[[fr:Voir_les_réponses_du_Questionnaire]]

Editing Questionnaire questions

2014-01-26T11:14:19Z

Rezeau: /* Manage questions */

{{Questionnaire}}

==Editing questions==
* On the Questionnaire '''Editing Questions''' page is displayed a drop-down list of the question types available and a list of the questions already created for the current questionnaire instance (if any).
* Using the standard Moodle icons you can change the order of the questions in the questionnaire, edit or delete questions.

==Common options==
===Question Name===

====Questionnaires '''not''' using the Conditional Branching or the Personality Test features====

You can ''optionally'' enter a '''Question Name''' for each question.

If your questionnaire does not use the "Conditional Branching" or the "Personality Test" feature, the '''Question Name''' is only used when you export responses to CSV/Excel format. If you never export to CSV, then you needn't worry about Question names. If you plan to regularly export your questionnaire data to CSV, then you have a choice of two options for question naming.

=====Option 1: significant names=====

In the '''Question Name ''' box, enter ''meaningful'', ''short'' and '''''different''''' question names for all of the questions within one questionnaire. In the CSV export file, all those question names will be prefixed with the question's actual number (= position) in the quiz. Examples:

{| border="1"
! scope="col" | question number (position) in the questionnaire
! scope="col" | question name entered by teacher
! scope="col" | field header in csv export
|-
|
<div style="text-align: center">5</div>
| favorite colors
| Q05_favorite colors
|-
|
<div style="text-align: center">6</div>
| why_use_Moodle
| Q06_why_use_moodle
|-
|
<div style="text-align: center">7</div>
|
user-friendliness

'' (rate question with 3 possible answers: Moodle, WebCT and Blackboard) ''
|
Q07_user-friendliness->Moodle Q07_user-friendliness->WebCT Q07_user-friendliness->Blackboard
|}

=====Option 2: leave the Question Name boxes blank=====

For each un-named question, CSV export will automatically generate a question name. This is required for table header fields in the CSV and subsequent Excel tables or any statistics package you might be using. The question name generated will be based on the question number in the actual Quiz (excluding ''Section Text'' pseudo-questions, of course) e.g. Q01, Q02, ... Q99. For questions with multiple answers, such as rate-type or Likert type questions, a sub-question number will be generated (Q02_1, Q02_2, Q02_3, etc.). This type of "short-name" naming scheme is advisable for exporting your data to a statistics software. Of course, it's up to you to have your own system for remembering which abbreviated question name corresponds to which question in your questionnaire!

{| width="100%" border="1"
! style="width: 33%" scope="col" | question number (position) in the questionnaire
! style="width: 33%" scope="col" | question name entered by teacher
! style="width: 33%" scope="col" | field header in csv export
|-
|
<div style="text-align: center">5</div>
| style="background-color: #CCCCCC" |
| Q05
|-
|
<div style="text-align: center">6</div>
| style="background-color: #CCCCCC" |
| Q06
|-
|
<div style="text-align: center">7</div>
| style="background-color: #CCCCCC" |
|
Q07_1 Q07_2 Q07_3
|}

It is quite possible (but maybe not advisable) to mix the two systems, and have within one questionnaire both named and un-named questions.

====Questionnaires using the Conditional Branching feature====

If you need a question to be used as the "parent" of one or more subsequent questions in your questionnaire, then you '''must''' name that "parent question". Only those (radio buttons, dropdown list or yes/no) questions with a ''name'' will appear in the Parent question dropdown list when adding a new question, as shown on the following screenshots.

[[Image:05-08-2013 15-26-11.jpg]]

[[Image:05-08-2013 15-34-55.jpg]]

For more information, see [[Questionnaire_Conditional_branching|Conditional branching]].

===Response Required===
If you select '''''Yes''''', response to this question will be required, i.e. the respondent will not be able to submit the questionnaire until this question has been answered. If the respondent tries to submit a questionnaire with unanswered required questions (or, in the case of a questionnaire with more than one section, to go to the next page), a warning message will be displayed with a list of all the missing ''required ''questions in the questionnaire (or on the actual page).

Default.- '''''No'''''.

'''Note'''.- When you create new questions in sequence (one after the other), this parameter is carried over to subsequent questions. E.g. if you create question #1 with '''Response Required''' = '''''Yes''''', then the '''Response Required''' parameter will be pre-set to '''''Yes''''' for question #2, etc. You can of course change this parameter at any time.

In the ''Manage Questions'' section of the Questions editing page, once a question has been created, you can use the green and red dots to switch its Required state, as a shortcut alternative of editing the question.

[[Image:05-08-2013 15-49-48.jpg]]

===Parent Question===

See [[Questionnaire_Conditional_branching|Conditional branching]]

===Question Text===
Enter your question text in this box. The HTML editor is available, which means that you can display not only formatted text but also images or other media in a questionnaire's questions text.

==Question Types==

Select the type of question from the drop-down list and click on the '''Add selected question type''' button.

===---Page Break---===

Use this to insert page breaks in longish questionnaires. Note that if a page contains questions with required response the respondent will not be allowed to navigate to the next page unless those required responses have been given.

If your questionnaire uses the Conditional branching feature, then page breaks will be ''automatically'' inserted when you add "parent" or "child" questions. Page breaks which are needed to ensure a correct "Conditional branching" flow cannot be moved or deleted. Their Move and Delete icons are disabled.

[[Image:05-08-2013 15-58-09.jpg]]

===Check Boxes===
Check boxes allow the user to select multiple answers from a list of options.

==== Question editing interface ====

[[Image:05-08-2013 14-58-42.jpg]]

==== Options ====

{| style="width: 100%" border="1" cellpadding="5"
! style="width: 50%" scope="col" | Editing Mode
! style="width: 50%" scope="col" | Questionnaire View
|-
|
{| style="width: 300"
| colspan="2" valign="top" | Question text: What are your favorite hobbies?

Possible answers:
|-
| style="border: #666666 thin solid" |
Watching TV Dancing Computing !other=Another hobby:
|}
|
[[Image:05-08-2013 13-29-49.jpg]]
|}

You may enter <tt>“!other”</tt> on a line to create an '''''optional''''' ''fill in the blank'' option. An<tt><nowiki>!other</nowiki></tt> box defaults to using the prompt ''Other: '', (or the equivalent translation for ''Other'' in the current language being used). You may change this default prompt by using the format: <tt>“!other=''prompt text”''</tt> as shown in the example above.

'''Notes.-'''

# At the moment the length of the ''fill in the blank'' input text box is set to 25 characters and is not customizable through the online interface.
# You may provide more than one <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option for a Check Boxes question, but this might cause problems so it is ''not recommended''.
# When a respondent answers a''' Check Boxes''' question which has been created as '''Required''', and the '''Min. forced responses '''and''' Max. forced responses''' parameters have been used, then a warning message will be displayed if respondent does not check the required number of boxes.
# Note that, if the <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option has been created, then if it is checked by the respondent, it will count in the total of minimum/maximum required check boxes.
# If a respondent checks a ''fill in the blank'' option '''check box''' and leaves the text field empty, ''that box will be unchecked'' (upon navigating to the next page or upon submitting the questionnaire).
# If a respondent has cheked ''a fill in the blank'' option '''check box''' and has filled in the text field, and later on changes his mind and unckecks that box, the ''fill in the blank'' text field will be automatically emptied (cool, ain't it?).

===Date===

''Use the day/month/year format, e.g. for March 14th, 1945: '''14/3/1945'''''

Use this question type if you expect the response to be a correctly formatted date. The format will depend upon the language currently being used by the questionnaire respondent. For example 4/21/2007 (US); 21/4/2007 (UK); 21-4-2007 (France); etc. An example will be displayed in the questionnaire. If an "impossible" or wrongly formatted date is entered, it will either be re-written or reformatted correctly (if possible) or an error message will be displayed to the respondent. In order for dates to be correctly exported to spreadsheets such as Excel, respondent must enter ''a date in the 1902 to 2037 range''. If a date outside this range is expected from respondents, then use the '''Text Box''' question type instead. The date question type will accept dates consisting only of a month plus a year (e.g. 12/2008 for december 2008) or only a year (e.g. 2008). However, for spreadsheet processing compatibility, such incomplete dates will be automatically transformed to complete dd/mm/yy dates, e.g. 12/2008 -> '''01/'''12/2008 and 2008 -> '''01/01/'''2008. You may have to explain this pecularity to your questionnaire users beforehand.

===Dropdown Box===

There is no real advantage to using the '''Dropdown Box''' over using the '''Radio Buttons''' except perhaps for longish lists of options, to save screen space.

===Essay Box===
====Question editing interface====
[[Image:2014-01-24_15-37-29.jpg]]

====Settings====
This question will display a plain text box with '''x''' ''Textarea columns'' (or area ''width'') and '''y''' ''Textarea rows'' (number of text ''lines'').

If you leave both x and y to their default '''0''' value (or if you set it to '''0'''), then moodle's '''HTML editor''' will be displayed with standard height and width (if available in the course/user context & user profile).

===Label===

This is not a question but a (short) text which will be displayed to introduce a series of questions.

===Numeric===

Use this question type if you expect the response to be a correctly formatted number. By using the '''Max. digits allowed '''and '''Nb of decimal digits '''parameters you can specify the length and number of decimal places required.

=== Radio Buttons ===
====Question editing interface====
[[Image:05-08-2013 15-03-17.jpg]]

====Radio buttons Alignment====
[[Image:05-08-2013 13-35-04.jpg]]

====Possible answers====
You must fill in one answer per line in the '''Possible answers''' box.

Examples:

{| border="1" cellpadding="5"
! style="width: 250" scope="col" valign="top" | Editing Mode
! style="width: 243" scope="col" valign="top" | Questionnaire View
! style="width: 434" scope="col" valign="top" | (optional horizontal display)
|-
| valign="top" |
'' 1.Possible answers''<nowiki>: </nowiki>

Red Blue Black
| valign="top" |
''' What is your favorite color? ''' Red Blue Black
| valign="top" |
''' What is your favorite color? ''' Red Blue Black
|-
| valign="top" |
'' 2.Possible answers''<nowiki>: </nowiki>

Red Blue Black !other
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Other:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Other:
|-
| valign="top" |
'' 3.Possible answers:''

Red Blue Black !other=Another color:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Another color:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Another color:
|-
| valign="top" |
| valign="top" | Questionnaire View
| valign="top" | ''''' Text data export '''''
|-
| valign="top" |
'' 4.Possible answers: ''

red::the color of blood blue::the color of the sky black::opposite of white
| valign="top" |
''' What is your favorite color? ''' the color of blood the color of the sky opposite of white
| valign="top" |
'' The "values" red, blue and black will be exported to the columns instead of standard 1, 2 and 3 numbers. See [[Viewing_Questionnaire_responses#Download_in_text_format|Download in text format]]. ''
|-
| valign="top" |
'' 5.Possible answers:''

0=Never 1=Once a year 3=Once a month 5=Once a week 7=Once a day
| valign="top" |
''' How often do you practise a sport? '''Never Once a year Once a month Once a week Once a day
| valign="top" |
{{New features}}
|}

You may enter <tt>“!other”</tt> on a line to create an '''''optional''''' ''fill in the blank'' option. An <tt><nowiki>!other</nowiki></tt> box defaults to using the prompt ''Other:'', (or the equivalent translation for ''Other'' in the current language being used). You may change this default prompt by using the format: <tt>“!other=''prompt text”''</tt> as shown in Example #3 above.

'''Notes'''

# At the moment the length of the ''fill in the blank'' input text box is set to 25 characters and is not customizable through the online interface.
# It does not make sense to provide more than one <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option for a Radio Buttons question.
# If a respondent checks a ''fill in the blank'' option '''radio button''' and leaves the text field empty, ''a warning message will be displayed'' (upon navigating to the next page or upon submitting the questionnaire).
# If a respondent has checked a ''fill in the blank'' option '''radio button''' and has filled in the text field, and later on changes his mind and clicks a different radio button in the same question, the ''fill in the blank'' text field previously entered will be automatically emptied.
# Example #4 shows a possible "hidden" option, for exporting - in responses - named values as data instead of standard numbers. If you never export your data for studying it in stats packages you won't need this option.
# If you plan to use the ''''"Personality Test"'''' feature in your questionnaire, the number preceding each choice will be used to calculate the "score" of the section that includes this question. See https://docs.moodle.org/27/en/mod/questionnaire/personality_test#Questions

=== Rate (scale 1..5) ===
==== Example: ====
{{New features}}
The Rate question now features extra "not yet answered" radio buttons. This is especially useful in Rate questions with a long list of choices.
[[File:03-12-2013 15-23-57.jpg]]

In case the respondent forgets to check some radio buttons, upon moving to next page or submitting, the error message will be completed with highlighting of the "not yet answered" radio buttons.

[[File:03-12-2013 15-26-58.jpg]]

==== Question editing interface: ====

[[Image:05-08-2013 14-26-37.jpg]]

==== Number of scale items ====
''' Nb of scale items '''is the ''number of items'' to be used in your rate scale. You would normally use a value of 3 to 5. Default value: '''5'''.

==== Type of rate scale ====
* ''' Normal ''' (default value)
* ''' N/A columns ''' : Choose this if you want an '''N/A''' column to be added to the right of your Rate scale items columns.
* ''' No duplicate choices'''<nowiki>: Choose this if you want </nowiki>''to prevent duplicate choices in each degree '''column'''''.
** This is useful if you want the respondent to rank a number of items on a 1 to n scale and to force each rank to be unique. Example: order items A, B and C in order of preference will accept: ''A1, B3 and C2'' or ''A3, B2 and C1'', but ''it will not be possible'' for the respondent to enter: ''A1, B1, C2'' or ''A1, B2, C2,'' etc.
** Used in conjunction with [[#anchor_one|named degrees]], this '''No duplicate choices''' option can also be useful if you want the respondent to match items with named degrees, e.g. the colors ''red, blue, yellow'' with a set of physiological responses: ''excitement, tranquillity, concentration'' where '''one''' color can only match '''one''' physiological response.
* '''Osgood'''<nowiki>: Choose this to create a question of the </nowiki>[http://en.wikipedia.org/wiki/Semantic_differential Osgood's semantic differential] type. This parameter must be used in conjunction with [[#anchor_one|named degrees]].

====Possible answers====
Examples.

{| style="width: 100%" border="1" cellpadding="5"
! style="width: 50%" scope="col" valign="top" | Editing Mode
! style="width: 50%" scope="col" valign="top" | Questionnaire View
|-
| valign="top" |
''' Ex. 1 Rate''' (single line) Possible answers -> '''Enter a blank space or a short "label".''' '''Settings: ''' ''' Nb of scale items ''' = 5 (5 columns numbered 1...5);'''''Type of rate scale''''' = ''Normal'' (N/A column not needed here). 
| valign="top" |
[[Image:05-08-2013_13-53-43.jpg]]
|-
| valign="top" |
''' Ex. 2 Rate ''' (several lines) Possible answers.

Blackboard Desire2Learn Moodle Sakai WebCT

''' Settings: '' Nb of scale items ''''' = 4 (4 columns numbered 1...4) ''''' Type of rate scale ''''' = '' N/A column ''
| valign="top" |
[[Image:05-08-2013 13-50-05.jpg]]
|-
| valign="top" |
''' Ex. 2a Rate ("ordering") '''

This option makes it impossible to click more than one radio button per column; it is thus equivalent to an "ordering" question type.

''' Settings: ''' ''''' Nb of scale items ''''' = 3 (3 columns numbered 1...3) ''''' Type of rate scale''''' = ''No duplicate choices''
| valign="top" |
[[Image:05-08-2013 13-59-31.jpg]]
|-
| valign="top" |
''' Ex. 3 Rate ''with named degrees '' ''' Possible answers.

4=Very easy to use 
3=Easy to use 
2=Somewhat difficult to use 
1=Difficult to use 
Formatting Your Course 
Laying out Your Course 
Number of Clicks to Access Needed Content 
Adding Content 
Ability to Add/Change Themes/Appearance 
Overall Navigation of Moodle 

''' Settings: ''' ''''' Nb of scale items ''''' = 4 (4 named columns) ''''' Type of rate scale ''''' = '' Normal '' (N/A column not needed here)
| valign="top" |
[[Image:05-08-2013 14-04-00.jpg|800px|thumb|left]]
|-
| valign="top" |
''' Ex. 3b Rate ''with named degrees '' ''' Possible answers.

4=Very easy to use 
3=Easy to use 
2=Somewhat difficult to use 
1=Difficult to use 
formatting::Formatting Your Course 
layout::Laying out Your Course 
clicks::Number of Clicks to Access Needed Content 
addcontent::Adding Content 
appearance::Ability to Add/Change Themes/Appearance 
navigation::Overall Navigation of Moodle 

| valign="top" |
If the choice options text is fairly long, you may use shorter "labels" immediately followed by two colons (::).
The labels "formatting", "layout", "clicks" etc. will be saved to the columns headings in the Download as text format operation, instead of the longer labels which will be displayed to the questionnaire respondent.

'''Please note''' that in former versions of Questionnaire the separator between "short label" and "options text" used to be the equal sign (=). In Questionnaire 2.5 and later, please use two colons (::) as a separator.
|-
| valign="top" |
''' Ex. 4 [http://en.wikipedia.org/wiki/Semantic_differential Osgood's Semantic differential] '''' ''' Possible answers.

1=-- 2=- 3=± 4=+ 5=++ weak|strong cold|warm cowardly|brave

''' Settings: ''' ''''' Nb of scale items ''''' = 5 (5 named columns) ''''' Type of rate scale ''''' = ''Osgood''

''' Note.- ''' To separate the pairs of words you must use a pipe character '''<nowiki>|</nowiki>'''
| valign="top" |
[[Image:05-08-2013 14-06-54.jpg]]
|}

'''Notes.-''' '''named degrees'''

For this question type you have two display options. The default option displays the [http://en.wikipedia.org/wiki/Likert_scale Likert] scale degrees as numbers (1...5). If you prefer to have named degrees instead of numbers, you'll have to enter those names in the '''''Possible answers''''' list (see '''''Example 3 ''''' above). On each line of "possible answers" enter the degree number, ''immediately followed'' by the equal sign '''<nowiki>=</nowiki>''' ''immediately followed'' by the name you want to give to that degree.

{{New features}}

If you plan to use the "Personality Test" feature in your questionnaire, the number preceding each named degree will be used to calculate the "score" of the section that includes this question. See https://docs.moodle.org/27/en/mod/questionnaire/personality_test#Questions_2.

If ''the number of named degrees'' in the possible answers list ''is different from the number determined by the value you entered'' in the '''Nb of scale items''' field, this will be automatically adjusted when you save the question. If you decide to use named degrees for your Likert scale, it is recommended (but not obligatory) to start your list of possible answers with the named degrees, and then to enter the various ''items'' to be scaled.

Example #3b shows a possible "hidden" option, for exporting - in responses - shorter label instead of the longer text values. If you never export your data for studying it in stats packages you won't need this option. Please note that the example is provided here for the '''Rate ''with named degrees''''' question sub-type but it works for all Rate question sub-types except Osgood which requires short left and right options anyway.

===Text Box===

For the Text Box question type, enter the Input Box length and the Maximum text length of text to be entered by respondent.

Default values are 20 characters for the Input Box width and 25 characters for the maximum length of text entered.

===Yes/No===

==Manage questions==

In the '''Manage questions''' section of the Edit Questions page, you can conduct a number of operations on a Questionnaire's questions. Normally you should never add questions or delete questions in a questionnaire that is live in a moodle course, and which some students may have already responded to.

You can Move a question to a different position in the Questionnaire. If your questionnaire contains some "conditional branching" questions, you may not be able to move some of the parent or child questions to some positions which would ruin the branching.

You can Edit a question, but again, be extra careful when editing questions once students have started to complete a questionnaire.

If you try to Delete a child or parent question (in a Conditional branching questionnaire), you will be warned of the possible consequences of those deletions.

By clicking on the Green or Red dots, you can switch the "Response required" status of questions.

Please note that the numbers in front of each question in this interface are ''not'' the question numbers that will be displayed when answering the questionnaire. Here, these numbers indicate the question's position, and even non-real questions such as Labels and Page Breaks have a position number.

----
[[Category:Teacher]]

[[fr:Ajouter_des_questions]]

Questionnaire Conditional branching

2014-01-25T16:46:36Z

Rezeau: /* Previewing Questionnaire */

Viewing Questionnaire responses

2014-01-24T22:49:15Z

Rezeau: /* Group filtering */

{{Questionnaire}}

== All responses ==
On the Questionnaire Report page, users with the necessary permissions can view a statistical Summary of all the responses given to a Questionnaire instance so far.

===Responses display by question type===

====Numeric====

[[Image:05-08-2013 16-34-46.jpg]]

Column 1 displays the number of similar responses. Column 2 displays the responses given. The Total and Average cells are self-explanatory.

====Yes/No====

[[Image:05-08-2013 16-41-00.jpg]]

This screenshot shows that out of 5 respondents who responded to this questionnaire, one did not answer this Yes/No question (which was not set as Required). 3 respondents answered Yes (75%) and 1 answered No (25%). Please note that the percentages are calculated on the actual responses, not the total of those who submitted the questionnaire.

====Radio buttons====

[[Image:05-08-2013 16-46-07.jpg]]

This screenshot shows that 5 our 5 respondents who submitted this questionnaire answered that question (which was Required).

====Check boxes====

[[Image:05-08-2013 16-50-19.jpg]]

This screenshot shows for instance that the Forum and Glossary activities are favoured by 4 respondents (out of 5 who responded), accounting for 27% of the choices each.

====Rate question====

[[Image:05-08-2013 16-54-34.jpg]]

The statistics for Rate questions display 2 tables.

The '''top table''' displays the Average rank for each feature. In this screenshot, the "Formatting your course" feature of Moodle was rated on average 1.4 on the 1 to 4 scale of difficulty, i.e. that feature was rated as between "Very..." and "Easy..." to use.
When creating that Rate question, the following values were entered for each "possible answer":

* 4=Very easy to use
* 3=Easy to use
* 2=Somewhat difficult to use
* 1=Difficult to use

That is to say that the highest "mark" or "value" was given to the easiest choice.
So, the average values (between parentheses) immediately after the average ranks are here the inverse of the average ranks.

The '''bottom table''' displays for each feature the number and percentage of respondents who selected each choice. For instance, for the "Formatting your course" feature, 3 respondents (60% of respondents to that question) selected the "Very easy to use" choice, and 2 respondents (40% of respondents to that question) selected the "Easy to use" choice. Nobody selected the "Difficult" choices for that feature.

====Essay question====

[[Image:05-08-2013 19-04-02.jpg]]
If the questionnaire is set to "full name" (i.e. non anonymous), the respondent's name will be displayed next to their Essay response. Click on the respondent's name to view their full submission.

===Group filtering===

[[Image:16-10-2013 13-45-08.jpg]]

If the questionnaire is set to '''Group Mode''': ''Visible groups'', or is set to ''Separate groups'' and the current user has the ''moodle/site:accessallgroups capability'' (in the current context), and groups have been defined in the current course, then the user has access to a dropdown list of groups. This dropdown list enables the user to "filter" the questionnaire responses by groups. If the setting is '''Group Mode''': ''Separate groups'', then users who do not have the ''moodle/site:accessallgroups'' capability (usually students, or non-editing teachers, etc.) will only be able to view the responses of the group(s) they belong to.

* ''All participants'' includes responses from all the people who answered the questionnaire, including people not belonging to any group.

'''Important'''.- After you have used the dropdown list to select a "set of people" for displaying their responses, the "filter" remains active for the following operations: '''Download in text format''', '''Delete ALL Responses''' and '''View by Response'''. For example, if you selected to display '''All Responses''' for group "Sparrows" and then click on the '''Delete ALL Responses''' tab link, a confirmation message will ask you to confirm that you want to delete all responses for members of group "Sparrows" and only responses of those participants.

'''Note'''.- If a participant belongs to more than one group, then deleting all the responses for ''one of the Groups'' he belongs to will of course delete his responses from ''all the other groups'' he belongs to.

===List of responses===
==== View Individual Responses ====

If the questionnaire '''Respondent Type''' was set as “fullname”, users with the necessary permissions (usually only teachers or tutors) can view each response individually.
On the List of responses page, each respondent's name is displayed, in alphabetical order of the family name.
Upon mouseover, a tooltip displays the submission time-stamp. This is especially useful in case the questionnaire is set to answer more than once and some students have submitted more than one response.
Click on a respondent's name to display their submission to the questionnaire.

====Individual Responses Navigation====
[[File:05-08-2013 18-46-20.jpg]]

When you are viewing a respondent's individual response, use the navigation bar at the top to go to the Previous (in alphabetical order) or Next response. You can go back to the List of responses page at any time.

==== Print this Response ====
Opens printer-friendly window with current Response.

==== Delete this Response ====
Deletes current response.

=== Order Responses ===
When displaying All Responses you can order the choices by number of responses (the Average column) for the following 4 types of questions.

* single choices radio button
* single choices drop-down list
* multiple choices (check boxes)
* rate questions (including Likert scales).

When you arrive on the All Responses page, by default all responses are ordered in the order that the questionnaire creator entered the question choices. You can choose to order them by ascending or descending order.

=== Delete All Responses ===
Deletes all responses in current questionnaire instance. Can be used to “reset” a questionnaire if you no longer need the current data.

=== Download in text format ===
This feature enables you to save all the responses of a questionnaire to a text file (CSV). This file can then be imported into a spreadsheet (e.g. MS Excel or Open Office Calc) or a statistical package for further processing the data.

====Options for text download====
On the '''Download in text format''' page you have a set of 2 options which only concern the output of the radio buttons/single answer question type. Here is how these options work.

Question text: What is your favorite color? Choice: blue, green, red.

{| style="border-spacing:0;"
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| selected color
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border:0.092cm double #808080;padding:0.049cm;"| red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice codes
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 1
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 2
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| 3

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice text
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| Include choice codes + Include choice text
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 1 : blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| 2 : green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| 3 : red

|-
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| No Include box ticked = same as include choice text box ticked
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| blue
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.049cm;"| green
| style="border-top:none;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:0.092cm double #808080;padding:0.049cm;"| red

|}
Note that these output options are over-ridden in case you used the "hidden" option when you created your radio button questions, i.e. the named values will be exported as data.

{| style="border-spacing:0;"
| style="width:33%; border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.132cm;"| ''Possible answers: ''

Red=the color of blood

Blue=the color of the sky

Black=opposite of white
| style="width:33%; border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.132cm;"| '''What is your favorite color?'''

the color of blood

the color of the sky

opposite of white
| style="width:33%; border:0.092cm double #808080;padding:0.132cm;"| ''Irrespective of the Include choice codes/text options selected on the Download in text format page, this will output the values '''Red''', '''Blue''' or '''Black''' to the CSV file.''

|}

====The CSV file (how to use it)====
The text format available here is of the so-called CSV (comma separated values) type. However, for more universal use, the '''tab''' (tabulation) separator is used, rather than the comma or semi-colon.

When you click on the '''Download in text format''' button, a window opens, asking you whether you'd like to save the data file or open it. Select ''save''. The data file is named after the name of the current quiz, however you can save it under a different name. The proposed data file extension is *.txt, but you ''can'' rename it. Note that you ''must'' rename it with a *.csv extension for import into ''Open Office Calc''.

Then go to your external software, and open the file into it. The following operations depend on the software you are using and on a number of other parameters. If you are using a non-ascii language interface in Moodle or you are using the English language but some of your questionnaire questions (or responses) have non-ascii characters in them, then ''Excel'' (or ''Open Office Calc'') might be able to ''automatically detect'' that your file is UTF-8 encoded, and decode it accordingly. Please note that if most of your data file is using standard ascii characters and only a very small number of non-ascii characters are present, the automatic detection will not work, and you will have to ''manually'' select the UTF-8 encoding in the list provided by your software.

At the top of the "table" imported into e.g. ''Excel'', the first line contains the names of all the question fields. This is followed by one line per response. The first 7 fields are as follows (in the English version):

{| style="border-spacing:0;"
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Response
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Submitted on:
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Institution
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Department
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Course
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Group
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| ID
| style="border-top:0.092cm double #808080;border-bottom:0.092cm double #808080;border-left:0.092cm double #808080;border-right:none;padding:0.079cm;"| Full name
| style="border:0.092cm double #808080;padding:0.079cm;"| Username

|}
The submitted_date field contains the date (and time, i.e. hour minutes seconds) when the response was submitted by respondent. For example: 15/09/2007 15:57. Normally you should be able to use Excel cell formatting to display such dates at will, in your own language formatting conventions, including the seconds, and if you wish full day or months names, while retaining the sorting facility.

If the questionnaire was set as "anonymous responses", the ID and Username will be empty and the Full name field will display "Anonymous".

== Your responses ==
On the Questionnaire Report page, users with the necessary permissions can view their own responses on the page entitled “Your results”. Usually students will be allowed to view their own responses.

If the questionnaire's settings allow more than one response and more than one response have been entered by the current user, then all of the features of the “View All responses” explained above apply.

However, it is not possible to delete individual responses in this “Your responses” view. And the Download as text format is not available to users with the student role.

=== All your responses ===
This provides a view of all of a respondent's responses, on successive dates. This feature may be useful if a questionnaire is used as a kind of portfolio.

== Show Non-Respondents ==

This feature allows the teacher to see students who have not yet responded. A reminder message can be sent to individuals or to everyone that hasn’t submitted responses.

The list of "non-respondents" can be filtered by Group (if Groups are enabled for this course and activity).

If the questionnaire's '''Save/Resume answers''' is set to Yes, then the list shows those students who have started but not yet submitted their questionnaire responses.

[[Image:05-08-2013 16-15-58.jpg]]

Editing Questionnaire questions

2014-01-24T14:41:15Z

Rezeau: /* Question editing interface */ Updated to current interface

File:2014-01-24 15-37-29.jpg

2014-01-24T14:40:48Z

Rezeau:

Editing Questionnaire questions

2014-01-24T11:06:11Z

Rezeau: /* Check Boxes */

{{Questionnaire}}

==Editing questions==
* On the Questionnaire '''Editing Questions''' page is displayed a drop-down list of the question types available and a list of the questions already created for the current questionnaire instance (if any).
* Using the standard Moodle icons you can change the order of the questions in the questionnaire, edit or delete questions.

==Common options==
===Question Name===

====Questionnaires '''not''' using the Conditional Branching or the Personality Test features====

You can ''optionally'' enter a '''Question Name''' for each question.

If your questionnaire does not use the "Conditional Branching" or the "Personality Test" feature, the '''Question Name''' is only used when you export responses to CSV/Excel format. If you never export to CSV, then you needn't worry about Question names. If you plan to regularly export your questionnaire data to CSV, then you have a choice of two options for question naming.

=====Option 1: significant names=====

In the '''Question Name ''' box, enter ''meaningful'', ''short'' and '''''different''''' question names for all of the questions within one questionnaire. In the CSV export file, all those question names will be prefixed with the question's actual number (= position) in the quiz. Examples:

{| border="1"
! scope="col" | question number (position) in the questionnaire
! scope="col" | question name entered by teacher
! scope="col" | field header in csv export
|-
|
<div style="text-align: center">5</div>
| favorite colors
| Q05_favorite colors
|-
|
<div style="text-align: center">6</div>
| why_use_Moodle
| Q06_why_use_moodle
|-
|
<div style="text-align: center">7</div>
|
user-friendliness

'' (rate question with 3 possible answers: Moodle, WebCT and Blackboard) ''
|
Q07_user-friendliness->Moodle Q07_user-friendliness->WebCT Q07_user-friendliness->Blackboard
|}

=====Option 2: leave the Question Name boxes blank=====

For each un-named question, CSV export will automatically generate a question name. This is required for table header fields in the CSV and subsequent Excel tables or any statistics package you might be using. The question name generated will be based on the question number in the actual Quiz (excluding ''Section Text'' pseudo-questions, of course) e.g. Q01, Q02, ... Q99. For questions with multiple answers, such as rate-type or Likert type questions, a sub-question number will be generated (Q02_1, Q02_2, Q02_3, etc.). This type of "short-name" naming scheme is advisable for exporting your data to a statistics software. Of course, it's up to you to have your own system for remembering which abbreviated question name corresponds to which question in your questionnaire!

{| width="100%" border="1"
! style="width: 33%" scope="col" | question number (position) in the questionnaire
! style="width: 33%" scope="col" | question name entered by teacher
! style="width: 33%" scope="col" | field header in csv export
|-
|
<div style="text-align: center">5</div>
| style="background-color: #CCCCCC" |
| Q05
|-
|
<div style="text-align: center">6</div>
| style="background-color: #CCCCCC" |
| Q06
|-
|
<div style="text-align: center">7</div>
| style="background-color: #CCCCCC" |
|
Q07_1 Q07_2 Q07_3
|}

It is quite possible (but maybe not advisable) to mix the two systems, and have within one questionnaire both named and un-named questions.

====Questionnaires using the Conditional Branching feature====

If you need a question to be used as the "parent" of one or more subsequent questions in your questionnaire, then you '''must''' name that "parent question". Only those (radio buttons, dropdown list or yes/no) questions with a ''name'' will appear in the Parent question dropdown list when adding a new question, as shown on the following screenshots.

[[Image:05-08-2013 15-26-11.jpg]]

[[Image:05-08-2013 15-34-55.jpg]]

For more information, see [[Questionnaire_Conditional_branching|Conditional branching]].

===Response Required===
If you select '''''Yes''''', response to this question will be required, i.e. the respondent will not be able to submit the questionnaire until this question has been answered. If the respondent tries to submit a questionnaire with unanswered required questions (or, in the case of a questionnaire with more than one section, to go to the next page), a warning message will be displayed with a list of all the missing ''required ''questions in the questionnaire (or on the actual page).

Default.- '''''No'''''.

'''Note'''.- When you create new questions in sequence (one after the other), this parameter is carried over to subsequent questions. E.g. if you create question #1 with '''Response Required''' = '''''Yes''''', then the '''Response Required''' parameter will be pre-set to '''''Yes''''' for question #2, etc. You can of course change this parameter at any time.

In the ''Manage Questions'' section of the Questions editing page, once a question has been created, you can use the green and red dots to switch its Required state, as a shortcut alternative of editing the question.

[[Image:05-08-2013 15-49-48.jpg]]

===Parent Question===

See [[Questionnaire_Conditional_branching|Conditional branching]]

===Question Text===
Enter your question text in this box. The HTML editor is available, which means that you can display not only formatted text but also images or other media in a questionnaire's questions text.

==Question Types==

Select the type of question from the drop-down list and click on the '''Add selected question type''' button.

===---Page Break---===

Use this to insert page breaks in longish questionnaires. Note that if a page contains questions with required response the respondent will not be allowed to navigate to the next page unless those required responses have been given.

If your questionnaire uses the Conditional branching feature, then page breaks will be ''automatically'' inserted when you add "parent" or "child" questions. Page breaks which are needed to ensure a correct "Conditional branching" flow cannot be moved or deleted. Their Move and Delete icons are disabled.

[[Image:05-08-2013 15-58-09.jpg]]

===Check Boxes===
Check boxes allow the user to select multiple answers from a list of options.

==== Question editing interface ====

[[Image:05-08-2013 14-58-42.jpg]]

==== Options ====

{| style="width: 100%" border="1" cellpadding="5"
! style="width: 50%" scope="col" | Editing Mode
! style="width: 50%" scope="col" | Questionnaire View
|-
|
{| style="width: 300"
| colspan="2" valign="top" | Question text: What are your favorite hobbies?

Possible answers:
|-
| style="border: #666666 thin solid" |
Watching TV Dancing Computing !other=Another hobby:
|}
|
[[Image:05-08-2013 13-29-49.jpg]]
|}

You may enter <tt>“!other”</tt> on a line to create an '''''optional''''' ''fill in the blank'' option. An<tt><nowiki>!other</nowiki></tt> box defaults to using the prompt ''Other: '', (or the equivalent translation for ''Other'' in the current language being used). You may change this default prompt by using the format: <tt>“!other=''prompt text”''</tt> as shown in the example above.

'''Notes.-'''

# At the moment the length of the ''fill in the blank'' input text box is set to 25 characters and is not customizable through the online interface.
# You may provide more than one <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option for a Check Boxes question, but this might cause problems so it is ''not recommended''.
# When a respondent answers a''' Check Boxes''' question which has been created as '''Required''', and the '''Min. forced responses '''and''' Max. forced responses''' parameters have been used, then a warning message will be displayed if respondent does not check the required number of boxes.
# Note that, if the <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option has been created, then if it is checked by the respondent, it will count in the total of minimum/maximum required check boxes.
# If a respondent checks a ''fill in the blank'' option '''check box''' and leaves the text field empty, ''that box will be unchecked'' (upon navigating to the next page or upon submitting the questionnaire).
# If a respondent has cheked ''a fill in the blank'' option '''check box''' and has filled in the text field, and later on changes his mind and unckecks that box, the ''fill in the blank'' text field will be automatically emptied (cool, ain't it?).

===Date===

''Use the day/month/year format, e.g. for March 14th, 1945: '''14/3/1945'''''

Use this question type if you expect the response to be a correctly formatted date. The format will depend upon the language currently being used by the questionnaire respondent. For example 4/21/2007 (US); 21/4/2007 (UK); 21-4-2007 (France); etc. An example will be displayed in the questionnaire. If an "impossible" or wrongly formatted date is entered, it will either be re-written or reformatted correctly (if possible) or an error message will be displayed to the respondent. In order for dates to be correctly exported to spreadsheets such as Excel, respondent must enter ''a date in the 1902 to 2037 range''. If a date outside this range is expected from respondents, then use the '''Text Box''' question type instead. The date question type will accept dates consisting only of a month plus a year (e.g. 12/2008 for december 2008) or only a year (e.g. 2008). However, for spreadsheet processing compatibility, such incomplete dates will be automatically transformed to complete dd/mm/yy dates, e.g. 12/2008 -> '''01/'''12/2008 and 2008 -> '''01/01/'''2008. You may have to explain this pecularity to your questionnaire users beforehand.

===Dropdown Box===

There is no real advantage to using the '''Dropdown Box''' over using the '''Radio Buttons''' except perhaps for longish lists of options, to save screen space.

===Essay Box===
====Question editing interface====
[[Image:05-08-2013 15-11-45.jpg]]
====Settings====
This question will display a plain text box with '''x''' ''Textarea columns'' (or area ''width'') and '''y''' ''Textarea rows'' (number of text ''lines'').

If you leave both x and y to their default '''0''' value (or if you set it to '''0'''), then moodle's '''HTML editor''' will be displayed with standard height and width (if available in the course/user context & user profile).

===Label===

This is not a question but a (short) text which will be displayed to introduce a series of questions.

===Numeric===

Use this question type if you expect the response to be a correctly formatted number. By using the '''Max. digits allowed '''and '''Nb of decimal digits '''parameters you can specify the length and number of decimal places required.

=== Radio Buttons ===
====Question editing interface====
[[Image:05-08-2013 15-03-17.jpg]]

====Radio buttons Alignment====
[[Image:05-08-2013 13-35-04.jpg]]

====Possible answers====
You must fill in one answer per line in the '''Possible answers''' box.

Examples:

{| border="1" cellpadding="5"
! style="width: 250" scope="col" valign="top" | Editing Mode
! style="width: 243" scope="col" valign="top" | Questionnaire View
! style="width: 434" scope="col" valign="top" | (optional horizontal display)
|-
| valign="top" |
'' 1.Possible answers''<nowiki>: </nowiki>

Red Blue Black
| valign="top" |
''' What is your favorite color? ''' Red Blue Black
| valign="top" |
''' What is your favorite color? ''' Red Blue Black
|-
| valign="top" |
'' 2.Possible answers''<nowiki>: </nowiki>

Red Blue Black !other
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Other:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Other:
|-
| valign="top" |
'' 3.Possible answers:''

Red Blue Black !other=Another color:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Another color:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Another color:
|-
| valign="top" |
| valign="top" | Questionnaire View
| valign="top" | ''''' Text data export '''''
|-
| valign="top" |
'' 4.Possible answers: ''

red::the color of blood blue::the color of the sky black::opposite of white
| valign="top" |
''' What is your favorite color? ''' the color of blood the color of the sky opposite of white
| valign="top" |
'' The "values" red, blue and black will be exported to the columns instead of standard 1, 2 and 3 numbers. See [[Viewing_Questionnaire_responses#Download_in_text_format|Download in text format]]. ''
|-
| valign="top" |
'' 5.Possible answers:''

0=Never 1=Once a year 3=Once a month 5=Once a week 7=Once a day
| valign="top" |
''' How often do you practise a sport? '''Never Once a year Once a month Once a week Once a day
| valign="top" |
{{New features}}
|}

You may enter <tt>“!other”</tt> on a line to create an '''''optional''''' ''fill in the blank'' option. An <tt><nowiki>!other</nowiki></tt> box defaults to using the prompt ''Other:'', (or the equivalent translation for ''Other'' in the current language being used). You may change this default prompt by using the format: <tt>“!other=''prompt text”''</tt> as shown in Example #3 above.

'''Notes'''

# At the moment the length of the ''fill in the blank'' input text box is set to 25 characters and is not customizable through the online interface.
# It does not make sense to provide more than one <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option for a Radio Buttons question.
# If a respondent checks a ''fill in the blank'' option '''radio button''' and leaves the text field empty, ''a warning message will be displayed'' (upon navigating to the next page or upon submitting the questionnaire).
# If a respondent has checked a ''fill in the blank'' option '''radio button''' and has filled in the text field, and later on changes his mind and clicks a different radio button in the same question, the ''fill in the blank'' text field previously entered will be automatically emptied.
# Example #4 shows a possible "hidden" option, for exporting - in responses - named values as data instead of standard numbers. If you never export your data for studying it in stats packages you won't need this option.
# If you plan to use the ''''"Personality Test"'''' feature in your questionnaire, the number preceding each choice will be used to calculate the "score" of the section that includes this question. See https://docs.moodle.org/27/en/mod/questionnaire/personality_test#Questions

=== Rate (scale 1..5) ===
==== Example: ====
{{New features}}
The Rate question now features extra "not yet answered" radio buttons. This is especially useful in Rate questions with a long list of choices.
[[File:03-12-2013 15-23-57.jpg]]

In case the respondent forgets to check some radio buttons, upon moving to next page or submitting, the error message will be completed with highlighting of the "not yet answered" radio buttons.

[[File:03-12-2013 15-26-58.jpg]]

==== Question editing interface: ====

[[Image:05-08-2013 14-26-37.jpg]]

==== Number of scale items ====
''' Nb of scale items '''is the ''number of items'' to be used in your rate scale. You would normally use a value of 3 to 5. Default value: '''5'''.

==== Type of rate scale ====
* ''' Normal ''' (default value)
* ''' N/A columns ''' : Choose this if you want an '''N/A''' column to be added to the right of your Rate scale items columns.
* ''' No duplicate choices'''<nowiki>: Choose this if you want </nowiki>''to prevent duplicate choices in each degree '''column'''''.
** This is useful if you want the respondent to rank a number of items on a 1 to n scale and to force each rank to be unique. Example: order items A, B and C in order of preference will accept: ''A1, B3 and C2'' or ''A3, B2 and C1'', but ''it will not be possible'' for the respondent to enter: ''A1, B1, C2'' or ''A1, B2, C2,'' etc.
** Used in conjunction with [[#anchor_one|named degrees]], this '''No duplicate choices''' option can also be useful if you want the respondent to match items with named degrees, e.g. the colors ''red, blue, yellow'' with a set of physiological responses: ''excitement, tranquillity, concentration'' where '''one''' color can only match '''one''' physiological response.
* '''Osgood'''<nowiki>: Choose this to create a question of the </nowiki>[http://en.wikipedia.org/wiki/Semantic_differential Osgood's semantic differential] type. This parameter must be used in conjunction with [[#anchor_one|named degrees]].

====Possible answers====
Examples.

{| style="width: 100%" border="1" cellpadding="5"
! style="width: 50%" scope="col" valign="top" | Editing Mode
! style="width: 50%" scope="col" valign="top" | Questionnaire View
|-
| valign="top" |
''' Ex. 1 Rate''' (single line) Possible answers -> '''Enter a blank space or a short "label".''' '''Settings: ''' ''' Nb of scale items ''' = 5 (5 columns numbered 1...5);'''''Type of rate scale''''' = ''Normal'' (N/A column not needed here). 
| valign="top" |
[[Image:05-08-2013_13-53-43.jpg]]
|-
| valign="top" |
''' Ex. 2 Rate ''' (several lines) Possible answers.

Blackboard Desire2Learn Moodle Sakai WebCT

''' Settings: '' Nb of scale items ''''' = 4 (4 columns numbered 1...4) ''''' Type of rate scale ''''' = '' N/A column ''
| valign="top" |
[[Image:05-08-2013 13-50-05.jpg]]
|-
| valign="top" |
''' Ex. 2a Rate ("ordering") '''

This option makes it impossible to click more than one radio button per column; it is thus equivalent to an "ordering" question type.

''' Settings: ''' ''''' Nb of scale items ''''' = 3 (3 columns numbered 1...3) ''''' Type of rate scale''''' = ''No duplicate choices''
| valign="top" |
[[Image:05-08-2013 13-59-31.jpg]]
|-
| valign="top" |
''' Ex. 3 Rate ''with named degrees '' ''' Possible answers.

4=Very easy to use 
3=Easy to use 
2=Somewhat difficult to use 
1=Difficult to use 
Formatting Your Course 
Laying out Your Course 
Number of Clicks to Access Needed Content 
Adding Content 
Ability to Add/Change Themes/Appearance 
Overall Navigation of Moodle 

''' Settings: ''' ''''' Nb of scale items ''''' = 4 (4 named columns) ''''' Type of rate scale ''''' = '' Normal '' (N/A column not needed here)
| valign="top" |
[[Image:05-08-2013 14-04-00.jpg|800px|thumb|left]]
|-
| valign="top" |
''' Ex. 3b Rate ''with named degrees '' ''' Possible answers.

4=Very easy to use 
3=Easy to use 
2=Somewhat difficult to use 
1=Difficult to use 
formatting::Formatting Your Course 
layout::Laying out Your Course 
clicks::Number of Clicks to Access Needed Content 
addcontent::Adding Content 
appearance::Ability to Add/Change Themes/Appearance 
navigation::Overall Navigation of Moodle 

| valign="top" |
If the choice options text is fairly long, you may use shorter "labels" immediately followed by two colons (::).
The labels "formatting", "layout", "clicks" etc. will be saved to the columns headings in the Download as text format operation, instead of the longer labels which will be displayed to the questionnaire respondent.

'''Please note''' that in former versions of Questionnaire the separator between "short label" and "options text" used to be the equal sign (=). In Questionnaire 2.5 and later, please use two colons (::) as a separator.
|-
| valign="top" |
''' Ex. 4 [http://en.wikipedia.org/wiki/Semantic_differential Osgood's Semantic differential] '''' ''' Possible answers.

1=-- 2=- 3=± 4=+ 5=++ weak|strong cold|warm cowardly|brave

''' Settings: ''' ''''' Nb of scale items ''''' = 5 (5 named columns) ''''' Type of rate scale ''''' = ''Osgood''

''' Note.- ''' To separate the pairs of words you must use a pipe character '''<nowiki>|</nowiki>'''
| valign="top" |
[[Image:05-08-2013 14-06-54.jpg]]
|}

'''Notes.-''' '''named degrees'''

For this question type you have two display options. The default option displays the [http://en.wikipedia.org/wiki/Likert_scale Likert] scale degrees as numbers (1...5). If you prefer to have named degrees instead of numbers, you'll have to enter those names in the '''''Possible answers''''' list (see '''''Example 3 ''''' above). On each line of "possible answers" enter the degree number, ''immediately followed'' by the equal sign '''<nowiki>=</nowiki>''' ''immediately followed'' by the name you want to give to that degree.

{{New features}}

If you plan to use the "Personality Test" feature in your questionnaire, the number preceding each named degree will be used to calculate the "score" of the section that includes this question. See https://docs.moodle.org/27/en/mod/questionnaire/personality_test#Questions_2.

If ''the number of named degrees'' in the possible answers list ''is different from the number determined by the value you entered'' in the '''Nb of scale items''' field, this will be automatically adjusted when you save the question. If you decide to use named degrees for your Likert scale, it is recommended (but not obligatory) to start your list of possible answers with the named degrees, and then to enter the various ''items'' to be scaled.

Example #3b shows a possible "hidden" option, for exporting - in responses - shorter label instead of the longer text values. If you never export your data for studying it in stats packages you won't need this option. Please note that the example is provided here for the '''Rate ''with named degrees''''' question sub-type but it works for all Rate question sub-types except Osgood which requires short left and right options anyway.

===Text Box===

For the Text Box question type, enter the Input Box length and the Maximum text length of text to be entered by respondent.

Default values are 20 characters for the Input Box width and 25 characters for the maximum length of text entered.

===Yes/No===

==Manage questions==

In the '''Manage questions''' section of the Edit Questions page, you can conduct a number of operations on a Questionnaire's questions. Normally you should never add questions or delete questions in a questionnaire that is live in a moodle course, and which some students may have already responded to.

You can Move a question to a different position in the Questionnaire. If your questionnaire contains some "conditional branching" questions, you may not be able to move some of the parent or child questions to some positions which would ruin the branching.

You can Edit a question, but again, be extra careful when editing questions once students have started to complete a questionnaire.

If you try to Delete a child or parent question (in a Conditional branching questionnaire), you will be warned of the possible consequences of those deletions.

By clicking on the Green or Red dots, you can switch the "Response required" status of questions.

Please note that the numbers in front of each question in this interface are ''not'' the question numbers that will be displayed when answering the questionnaire. Here, these numbers indicate the question's position, and even non-real questions such as Labels and Page Breaks have a position number.

----
[[Category:Teacher]]

[[es:Editando preguntas de un cuestionario]]

Editing Questionnaire questions

2014-01-24T10:36:22Z

Rezeau: /* Possible answers */

{{Questionnaire}}

==Editing questions==
* On the Questionnaire '''Editing Questions''' page is displayed a drop-down list of the question types available and a list of the questions already created for the current questionnaire instance (if any).
* Using the standard Moodle icons you can change the order of the questions in the questionnaire, edit or delete questions.

==Common options==
===Question Name===

====Questionnaires '''not''' using the Conditional Branching or the Personality Test features====

You can ''optionally'' enter a '''Question Name''' for each question.

If your questionnaire does not use the "Conditional Branching" or the "Personality Test" feature, the '''Question Name''' is only used when you export responses to CSV/Excel format. If you never export to CSV, then you needn't worry about Question names. If you plan to regularly export your questionnaire data to CSV, then you have a choice of two options for question naming.

=====Option 1: significant names=====

In the '''Question Name ''' box, enter ''meaningful'', ''short'' and '''''different''''' question names for all of the questions within one questionnaire. In the CSV export file, all those question names will be prefixed with the question's actual number (= position) in the quiz. Examples:

{| border="1"
! scope="col" | question number (position) in the questionnaire
! scope="col" | question name entered by teacher
! scope="col" | field header in csv export
|-
|
<div style="text-align: center">5</div>
| favorite colors
| Q05_favorite colors
|-
|
<div style="text-align: center">6</div>
| why_use_Moodle
| Q06_why_use_moodle
|-
|
<div style="text-align: center">7</div>
|
user-friendliness

'' (rate question with 3 possible answers: Moodle, WebCT and Blackboard) ''
|
Q07_user-friendliness->Moodle Q07_user-friendliness->WebCT Q07_user-friendliness->Blackboard
|}

=====Option 2: leave the Question Name boxes blank=====

For each un-named question, CSV export will automatically generate a question name. This is required for table header fields in the CSV and subsequent Excel tables or any statistics package you might be using. The question name generated will be based on the question number in the actual Quiz (excluding ''Section Text'' pseudo-questions, of course) e.g. Q01, Q02, ... Q99. For questions with multiple answers, such as rate-type or Likert type questions, a sub-question number will be generated (Q02_1, Q02_2, Q02_3, etc.). This type of "short-name" naming scheme is advisable for exporting your data to a statistics software. Of course, it's up to you to have your own system for remembering which abbreviated question name corresponds to which question in your questionnaire!

{| width="100%" border="1"
! style="width: 33%" scope="col" | question number (position) in the questionnaire
! style="width: 33%" scope="col" | question name entered by teacher
! style="width: 33%" scope="col" | field header in csv export
|-
|
<div style="text-align: center">5</div>
| style="background-color: #CCCCCC" |
| Q05
|-
|
<div style="text-align: center">6</div>
| style="background-color: #CCCCCC" |
| Q06
|-
|
<div style="text-align: center">7</div>
| style="background-color: #CCCCCC" |
|
Q07_1 Q07_2 Q07_3
|}

It is quite possible (but maybe not advisable) to mix the two systems, and have within one questionnaire both named and un-named questions.

====Questionnaires using the Conditional Branching feature====

If you need a question to be used as the "parent" of one or more subsequent questions in your questionnaire, then you '''must''' name that "parent question". Only those (radio buttons, dropdown list or yes/no) questions with a ''name'' will appear in the Parent question dropdown list when adding a new question, as shown on the following screenshots.

[[Image:05-08-2013 15-26-11.jpg]]

[[Image:05-08-2013 15-34-55.jpg]]

For more information, see [[Questionnaire_Conditional_branching|Conditional branching]].

===Response Required===
If you select '''''Yes''''', response to this question will be required, i.e. the respondent will not be able to submit the questionnaire until this question has been answered. If the respondent tries to submit a questionnaire with unanswered required questions (or, in the case of a questionnaire with more than one section, to go to the next page), a warning message will be displayed with a list of all the missing ''required ''questions in the questionnaire (or on the actual page).

Default.- '''''No'''''.

'''Note'''.- When you create new questions in sequence (one after the other), this parameter is carried over to subsequent questions. E.g. if you create question #1 with '''Response Required''' = '''''Yes''''', then the '''Response Required''' parameter will be pre-set to '''''Yes''''' for question #2, etc. You can of course change this parameter at any time.

In the ''Manage Questions'' section of the Questions editing page, once a question has been created, you can use the green and red dots to switch its Required state, as a shortcut alternative of editing the question.

[[Image:05-08-2013 15-49-48.jpg]]

===Parent Question===

See [[Questionnaire_Conditional_branching|Conditional branching]]

===Question Text===
Enter your question text in this box. The HTML editor is available, which means that you can display not only formatted text but also images or other media in a questionnaire's questions text.

==Question Types==

Select the type of question from the drop-down list and click on the '''Add selected question type''' button.

===---Page Break---===

Use this to insert page breaks in longish questionnaires. Note that if a page contains questions with required response the respondent will not be allowed to navigate to the next page unless those required responses have been given.

If your questionnaire uses the Conditional branching feature, then page breaks will be ''automatically'' inserted when you add "parent" or "child" questions. Page breaks which are needed to ensure a correct "Conditional branching" flow cannot be moved or deleted. Their Move and Delete icons are disabled.

[[Image:05-08-2013 15-58-09.jpg]]

===Check Boxes===
Check boxes allow the user to select multiple answers from a list of options.

==== Question editing interface ====

[[Image:05-08-2013 14-58-42.jpg]]

{| style="width: 100%" border="1" cellpadding="5"
! style="width: 50%" scope="col" | Editing Mode
! style="width: 50%" scope="col" | Questionnaire View
|-
|
{| style="width: 300"
| colspan="2" valign="top" | Question text: What are your favorite hobbies?

Possible answers:
|-
| style="border: #666666 thin solid" |
Watching TV Dancing Computing !other=Another hobby:
|}
|
[[Image:05-08-2013 13-29-49.jpg]]
|}

You may enter <tt>“!other”</tt> on a line to create an '''''optional''''' ''fill in the blank'' option. An<tt><nowiki>!other</nowiki></tt> box defaults to using the prompt ''Other: '', (or the equivalent translation for ''Other'' in the current language being used). You may change this default prompt by using the format: <tt>“!other=''prompt text”''</tt> as shown in the example above.

'''Notes.-'''

# At the moment the length of the ''fill in the blank'' input text box is set to 25 characters and is not customizable through the online interface.
# You may provide more than one <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option for a Check Boxes question, but this might cause problems so it is ''not recommended''.
# When a respondent answers a''' Check Boxes''' question which has been created as '''Required''', and the '''Min. forced responses '''and''' Max. forced responses''' parameters have been used, then a warning message will be displayed if respondent does not check the required number of boxes.
# Note that, if the <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option has been created, then if it is checked by the respondent, it will count in the total of minimum/maximum required check boxes.
# If a respondent checks a ''fill in the blank'' option '''check box''' and leaves the text field empty, ''that box will be unchecked'' (upon navigating to the next page or upon submitting the questionnaire).
# If a respondent has cheked ''a fill in the blank'' option '''check box''' and has filled in the text field, and later on changes his mind and unckecks that box, the ''fill in the blank'' text field will be automatically emptied (cool, ain't it?).

===Date===

''Use the day/month/year format, e.g. for March 14th, 1945: '''14/3/1945'''''

Use this question type if you expect the response to be a correctly formatted date. The format will depend upon the language currently being used by the questionnaire respondent. For example 4/21/2007 (US); 21/4/2007 (UK); 21-4-2007 (France); etc. An example will be displayed in the questionnaire. If an "impossible" or wrongly formatted date is entered, it will either be re-written or reformatted correctly (if possible) or an error message will be displayed to the respondent. In order for dates to be correctly exported to spreadsheets such as Excel, respondent must enter ''a date in the 1902 to 2037 range''. If a date outside this range is expected from respondents, then use the '''Text Box''' question type instead. The date question type will accept dates consisting only of a month plus a year (e.g. 12/2008 for december 2008) or only a year (e.g. 2008). However, for spreadsheet processing compatibility, such incomplete dates will be automatically transformed to complete dd/mm/yy dates, e.g. 12/2008 -> '''01/'''12/2008 and 2008 -> '''01/01/'''2008. You may have to explain this pecularity to your questionnaire users beforehand.

===Dropdown Box===

There is no real advantage to using the '''Dropdown Box''' over using the '''Radio Buttons''' except perhaps for longish lists of options, to save screen space.

===Essay Box===
====Question editing interface====
[[Image:05-08-2013 15-11-45.jpg]]
====Settings====
This question will display a plain text box with '''x''' ''Textarea columns'' (or area ''width'') and '''y''' ''Textarea rows'' (number of text ''lines'').

If you leave both x and y to their default '''0''' value (or if you set it to '''0'''), then moodle's '''HTML editor''' will be displayed with standard height and width (if available in the course/user context & user profile).

===Label===

This is not a question but a (short) text which will be displayed to introduce a series of questions.

===Numeric===

Use this question type if you expect the response to be a correctly formatted number. By using the '''Max. digits allowed '''and '''Nb of decimal digits '''parameters you can specify the length and number of decimal places required.

=== Radio Buttons ===
====Question editing interface====
[[Image:05-08-2013 15-03-17.jpg]]

====Radio buttons Alignment====
[[Image:05-08-2013 13-35-04.jpg]]

====Possible answers====
You must fill in one answer per line in the '''Possible answers''' box.

Examples:

{| border="1" cellpadding="5"
! style="width: 250" scope="col" valign="top" | Editing Mode
! style="width: 243" scope="col" valign="top" | Questionnaire View
! style="width: 434" scope="col" valign="top" | (optional horizontal display)
|-
| valign="top" |
'' 1.Possible answers''<nowiki>: </nowiki>

Red Blue Black
| valign="top" |
''' What is your favorite color? ''' Red Blue Black
| valign="top" |
''' What is your favorite color? ''' Red Blue Black
|-
| valign="top" |
'' 2.Possible answers''<nowiki>: </nowiki>

Red Blue Black !other
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Other:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Other:
|-
| valign="top" |
'' 3.Possible answers:''

Red Blue Black !other=Another color:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Another color:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Another color:
|-
| valign="top" |
| valign="top" | Questionnaire View
| valign="top" | ''''' Text data export '''''
|-
| valign="top" |
'' 4.Possible answers: ''

red::the color of blood blue::the color of the sky black::opposite of white
| valign="top" |
''' What is your favorite color? ''' the color of blood the color of the sky opposite of white
| valign="top" |
'' The "values" red, blue and black will be exported to the columns instead of standard 1, 2 and 3 numbers. See [[Viewing_Questionnaire_responses#Download_in_text_format|Download in text format]]. ''
|-
| valign="top" |
'' 5.Possible answers:''

0=Never 1=Once a year 3=Once a month 5=Once a week 7=Once a day
| valign="top" |
''' How often do you practise a sport? '''Never Once a year Once a month Once a week Once a day
| valign="top" |
{{New features}}
|}

You may enter <tt>“!other”</tt> on a line to create an '''''optional''''' ''fill in the blank'' option. An <tt><nowiki>!other</nowiki></tt> box defaults to using the prompt ''Other:'', (or the equivalent translation for ''Other'' in the current language being used). You may change this default prompt by using the format: <tt>“!other=''prompt text”''</tt> as shown in Example #3 above.

'''Notes'''

# At the moment the length of the ''fill in the blank'' input text box is set to 25 characters and is not customizable through the online interface.
# It does not make sense to provide more than one <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option for a Radio Buttons question.
# If a respondent checks a ''fill in the blank'' option '''radio button''' and leaves the text field empty, ''a warning message will be displayed'' (upon navigating to the next page or upon submitting the questionnaire).
# If a respondent has checked a ''fill in the blank'' option '''radio button''' and has filled in the text field, and later on changes his mind and clicks a different radio button in the same question, the ''fill in the blank'' text field previously entered will be automatically emptied.
# Example #4 shows a possible "hidden" option, for exporting - in responses - named values as data instead of standard numbers. If you never export your data for studying it in stats packages you won't need this option.
# If you plan to use the ''''"Personality Test"'''' feature in your questionnaire, the number preceding each choice will be used to calculate the "score" of the section that includes this question. See https://docs.moodle.org/27/en/mod/questionnaire/personality_test#Questions

=== Rate (scale 1..5) ===
==== Example: ====
{{New features}}
The Rate question now features extra "not yet answered" radio buttons. This is especially useful in Rate questions with a long list of choices.
[[File:03-12-2013 15-23-57.jpg]]

In case the respondent forgets to check some radio buttons, upon moving to next page or submitting, the error message will be completed with highlighting of the "not yet answered" radio buttons.

[[File:03-12-2013 15-26-58.jpg]]

==== Question editing interface: ====

[[Image:05-08-2013 14-26-37.jpg]]

==== Number of scale items ====
''' Nb of scale items '''is the ''number of items'' to be used in your rate scale. You would normally use a value of 3 to 5. Default value: '''5'''.

==== Type of rate scale ====
* ''' Normal ''' (default value)
* ''' N/A columns ''' : Choose this if you want an '''N/A''' column to be added to the right of your Rate scale items columns.
* ''' No duplicate choices'''<nowiki>: Choose this if you want </nowiki>''to prevent duplicate choices in each degree '''column'''''.
** This is useful if you want the respondent to rank a number of items on a 1 to n scale and to force each rank to be unique. Example: order items A, B and C in order of preference will accept: ''A1, B3 and C2'' or ''A3, B2 and C1'', but ''it will not be possible'' for the respondent to enter: ''A1, B1, C2'' or ''A1, B2, C2,'' etc.
** Used in conjunction with [[#anchor_one|named degrees]], this '''No duplicate choices''' option can also be useful if you want the respondent to match items with named degrees, e.g. the colors ''red, blue, yellow'' with a set of physiological responses: ''excitement, tranquillity, concentration'' where '''one''' color can only match '''one''' physiological response.
* '''Osgood'''<nowiki>: Choose this to create a question of the </nowiki>[http://en.wikipedia.org/wiki/Semantic_differential Osgood's semantic differential] type. This parameter must be used in conjunction with [[#anchor_one|named degrees]].

====Possible answers====
Examples.

{| style="width: 100%" border="1" cellpadding="5"
! style="width: 50%" scope="col" valign="top" | Editing Mode
! style="width: 50%" scope="col" valign="top" | Questionnaire View
|-
| valign="top" |
''' Ex. 1 Rate''' (single line) Possible answers -> '''Enter a blank space or a short "label".''' '''Settings: ''' ''' Nb of scale items ''' = 5 (5 columns numbered 1...5);'''''Type of rate scale''''' = ''Normal'' (N/A column not needed here). 
| valign="top" |
[[Image:05-08-2013_13-53-43.jpg]]
|-
| valign="top" |
''' Ex. 2 Rate ''' (several lines) Possible answers.

Blackboard Desire2Learn Moodle Sakai WebCT

''' Settings: '' Nb of scale items ''''' = 4 (4 columns numbered 1...4) ''''' Type of rate scale ''''' = '' N/A column ''
| valign="top" |
[[Image:05-08-2013 13-50-05.jpg]]
|-
| valign="top" |
''' Ex. 2a Rate ("ordering") '''

This option makes it impossible to click more than one radio button per column; it is thus equivalent to an "ordering" question type.

''' Settings: ''' ''''' Nb of scale items ''''' = 3 (3 columns numbered 1...3) ''''' Type of rate scale''''' = ''No duplicate choices''
| valign="top" |
[[Image:05-08-2013 13-59-31.jpg]]
|-
| valign="top" |
''' Ex. 3 Rate ''with named degrees '' ''' Possible answers.

4=Very easy to use 
3=Easy to use 
2=Somewhat difficult to use 
1=Difficult to use 
Formatting Your Course 
Laying out Your Course 
Number of Clicks to Access Needed Content 
Adding Content 
Ability to Add/Change Themes/Appearance 
Overall Navigation of Moodle 

''' Settings: ''' ''''' Nb of scale items ''''' = 4 (4 named columns) ''''' Type of rate scale ''''' = '' Normal '' (N/A column not needed here)
| valign="top" |
[[Image:05-08-2013 14-04-00.jpg|800px|thumb|left]]
|-
| valign="top" |
''' Ex. 3b Rate ''with named degrees '' ''' Possible answers.

4=Very easy to use 
3=Easy to use 
2=Somewhat difficult to use 
1=Difficult to use 
formatting::Formatting Your Course 
layout::Laying out Your Course 
clicks::Number of Clicks to Access Needed Content 
addcontent::Adding Content 
appearance::Ability to Add/Change Themes/Appearance 
navigation::Overall Navigation of Moodle 

| valign="top" |
If the choice options text is fairly long, you may use shorter "labels" immediately followed by two colons (::).
The labels "formatting", "layout", "clicks" etc. will be saved to the columns headings in the Download as text format operation, instead of the longer labels which will be displayed to the questionnaire respondent.

'''Please note''' that in former versions of Questionnaire the separator between "short label" and "options text" used to be the equal sign (=). In Questionnaire 2.5 and later, please use two colons (::) as a separator.
|-
| valign="top" |
''' Ex. 4 [http://en.wikipedia.org/wiki/Semantic_differential Osgood's Semantic differential] '''' ''' Possible answers.

1=-- 2=- 3=± 4=+ 5=++ weak|strong cold|warm cowardly|brave

''' Settings: ''' ''''' Nb of scale items ''''' = 5 (5 named columns) ''''' Type of rate scale ''''' = ''Osgood''

''' Note.- ''' To separate the pairs of words you must use a pipe character '''<nowiki>|</nowiki>'''
| valign="top" |
[[Image:05-08-2013 14-06-54.jpg]]
|}

'''Notes.-''' '''named degrees'''

For this question type you have two display options. The default option displays the [http://en.wikipedia.org/wiki/Likert_scale Likert] scale degrees as numbers (1...5). If you prefer to have named degrees instead of numbers, you'll have to enter those names in the '''''Possible answers''''' list (see '''''Example 3 ''''' above). On each line of "possible answers" enter the degree number, ''immediately followed'' by the equal sign '''<nowiki>=</nowiki>''' ''immediately followed'' by the name you want to give to that degree.

{{New features}}

If you plan to use the "Personality Test" feature in your questionnaire, the number preceding each named degree will be used to calculate the "score" of the section that includes this question. See https://docs.moodle.org/27/en/mod/questionnaire/personality_test#Questions_2.

If ''the number of named degrees'' in the possible answers list ''is different from the number determined by the value you entered'' in the '''Nb of scale items''' field, this will be automatically adjusted when you save the question. If you decide to use named degrees for your Likert scale, it is recommended (but not obligatory) to start your list of possible answers with the named degrees, and then to enter the various ''items'' to be scaled.

Example #3b shows a possible "hidden" option, for exporting - in responses - shorter label instead of the longer text values. If you never export your data for studying it in stats packages you won't need this option. Please note that the example is provided here for the '''Rate ''with named degrees''''' question sub-type but it works for all Rate question sub-types except Osgood which requires short left and right options anyway.

===Text Box===

For the Text Box question type, enter the Input Box length and the Maximum text length of text to be entered by respondent.

Default values are 20 characters for the Input Box width and 25 characters for the maximum length of text entered.

===Yes/No===

==Manage questions==

In the '''Manage questions''' section of the Edit Questions page, you can conduct a number of operations on a Questionnaire's questions. Normally you should never add questions or delete questions in a questionnaire that is live in a moodle course, and which some students may have already responded to.

You can Move a question to a different position in the Questionnaire. If your questionnaire contains some "conditional branching" questions, you may not be able to move some of the parent or child questions to some positions which would ruin the branching.

You can Edit a question, but again, be extra careful when editing questions once students have started to complete a questionnaire.

If you try to Delete a child or parent question (in a Conditional branching questionnaire), you will be warned of the possible consequences of those deletions.

By clicking on the Green or Red dots, you can switch the "Response required" status of questions.

Please note that the numbers in front of each question in this interface are ''not'' the question numbers that will be displayed when answering the questionnaire. Here, these numbers indicate the question's position, and even non-real questions such as Labels and Page Breaks have a position number.

----
[[Category:Teacher]]

[[es:Editando preguntas de un cuestionario]]

Editing Questionnaire questions

2014-01-24T10:27:34Z

Rezeau: /* Questionnaires not using the Conditional Branching feature */

{{Questionnaire}}

==Editing questions==
* On the Questionnaire '''Editing Questions''' page is displayed a drop-down list of the question types available and a list of the questions already created for the current questionnaire instance (if any).
* Using the standard Moodle icons you can change the order of the questions in the questionnaire, edit or delete questions.

==Common options==
===Question Name===

====Questionnaires '''not''' using the Conditional Branching or the Personality Test features====

You can ''optionally'' enter a '''Question Name''' for each question.

If your questionnaire does not use the "Conditional Branching" or the "Personality Test" feature, the '''Question Name''' is only used when you export responses to CSV/Excel format. If you never export to CSV, then you needn't worry about Question names. If you plan to regularly export your questionnaire data to CSV, then you have a choice of two options for question naming.

=====Option 1: significant names=====

In the '''Question Name ''' box, enter ''meaningful'', ''short'' and '''''different''''' question names for all of the questions within one questionnaire. In the CSV export file, all those question names will be prefixed with the question's actual number (= position) in the quiz. Examples:

{| border="1"
! scope="col" | question number (position) in the questionnaire
! scope="col" | question name entered by teacher
! scope="col" | field header in csv export
|-
|
<div style="text-align: center">5</div>
| favorite colors
| Q05_favorite colors
|-
|
<div style="text-align: center">6</div>
| why_use_Moodle
| Q06_why_use_moodle
|-
|
<div style="text-align: center">7</div>
|
user-friendliness

'' (rate question with 3 possible answers: Moodle, WebCT and Blackboard) ''
|
Q07_user-friendliness->Moodle Q07_user-friendliness->WebCT Q07_user-friendliness->Blackboard
|}

=====Option 2: leave the Question Name boxes blank=====

For each un-named question, CSV export will automatically generate a question name. This is required for table header fields in the CSV and subsequent Excel tables or any statistics package you might be using. The question name generated will be based on the question number in the actual Quiz (excluding ''Section Text'' pseudo-questions, of course) e.g. Q01, Q02, ... Q99. For questions with multiple answers, such as rate-type or Likert type questions, a sub-question number will be generated (Q02_1, Q02_2, Q02_3, etc.). This type of "short-name" naming scheme is advisable for exporting your data to a statistics software. Of course, it's up to you to have your own system for remembering which abbreviated question name corresponds to which question in your questionnaire!

{| width="100%" border="1"
! style="width: 33%" scope="col" | question number (position) in the questionnaire
! style="width: 33%" scope="col" | question name entered by teacher
! style="width: 33%" scope="col" | field header in csv export
|-
|
<div style="text-align: center">5</div>
| style="background-color: #CCCCCC" |
| Q05
|-
|
<div style="text-align: center">6</div>
| style="background-color: #CCCCCC" |
| Q06
|-
|
<div style="text-align: center">7</div>
| style="background-color: #CCCCCC" |
|
Q07_1 Q07_2 Q07_3
|}

It is quite possible (but maybe not advisable) to mix the two systems, and have within one questionnaire both named and un-named questions.

====Questionnaires using the Conditional Branching feature====

If you need a question to be used as the "parent" of one or more subsequent questions in your questionnaire, then you '''must''' name that "parent question". Only those (radio buttons, dropdown list or yes/no) questions with a ''name'' will appear in the Parent question dropdown list when adding a new question, as shown on the following screenshots.

[[Image:05-08-2013 15-26-11.jpg]]

[[Image:05-08-2013 15-34-55.jpg]]

For more information, see [[Questionnaire_Conditional_branching|Conditional branching]].

===Response Required===
If you select '''''Yes''''', response to this question will be required, i.e. the respondent will not be able to submit the questionnaire until this question has been answered. If the respondent tries to submit a questionnaire with unanswered required questions (or, in the case of a questionnaire with more than one section, to go to the next page), a warning message will be displayed with a list of all the missing ''required ''questions in the questionnaire (or on the actual page).

Default.- '''''No'''''.

'''Note'''.- When you create new questions in sequence (one after the other), this parameter is carried over to subsequent questions. E.g. if you create question #1 with '''Response Required''' = '''''Yes''''', then the '''Response Required''' parameter will be pre-set to '''''Yes''''' for question #2, etc. You can of course change this parameter at any time.

In the ''Manage Questions'' section of the Questions editing page, once a question has been created, you can use the green and red dots to switch its Required state, as a shortcut alternative of editing the question.

[[Image:05-08-2013 15-49-48.jpg]]

===Parent Question===

See [[Questionnaire_Conditional_branching|Conditional branching]]

===Question Text===
Enter your question text in this box. The HTML editor is available, which means that you can display not only formatted text but also images or other media in a questionnaire's questions text.

==Question Types==

Select the type of question from the drop-down list and click on the '''Add selected question type''' button.

===---Page Break---===

Use this to insert page breaks in longish questionnaires. Note that if a page contains questions with required response the respondent will not be allowed to navigate to the next page unless those required responses have been given.

If your questionnaire uses the Conditional branching feature, then page breaks will be ''automatically'' inserted when you add "parent" or "child" questions. Page breaks which are needed to ensure a correct "Conditional branching" flow cannot be moved or deleted. Their Move and Delete icons are disabled.

[[Image:05-08-2013 15-58-09.jpg]]

===Check Boxes===
Check boxes allow the user to select multiple answers from a list of options.

==== Question editing interface ====

[[Image:05-08-2013 14-58-42.jpg]]

{| style="width: 100%" border="1" cellpadding="5"
! style="width: 50%" scope="col" | Editing Mode
! style="width: 50%" scope="col" | Questionnaire View
|-
|
{| style="width: 300"
| colspan="2" valign="top" | Question text: What are your favorite hobbies?

Possible answers:
|-
| style="border: #666666 thin solid" |
Watching TV Dancing Computing !other=Another hobby:
|}
|
[[Image:05-08-2013 13-29-49.jpg]]
|}

You may enter <tt>“!other”</tt> on a line to create an '''''optional''''' ''fill in the blank'' option. An<tt><nowiki>!other</nowiki></tt> box defaults to using the prompt ''Other: '', (or the equivalent translation for ''Other'' in the current language being used). You may change this default prompt by using the format: <tt>“!other=''prompt text”''</tt> as shown in the example above.

'''Notes.-'''

# At the moment the length of the ''fill in the blank'' input text box is set to 25 characters and is not customizable through the online interface.
# You may provide more than one <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option for a Check Boxes question, but this might cause problems so it is ''not recommended''.
# When a respondent answers a''' Check Boxes''' question which has been created as '''Required''', and the '''Min. forced responses '''and''' Max. forced responses''' parameters have been used, then a warning message will be displayed if respondent does not check the required number of boxes.
# Note that, if the <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option has been created, then if it is checked by the respondent, it will count in the total of minimum/maximum required check boxes.
# If a respondent checks a ''fill in the blank'' option '''check box''' and leaves the text field empty, ''that box will be unchecked'' (upon navigating to the next page or upon submitting the questionnaire).
# If a respondent has cheked ''a fill in the blank'' option '''check box''' and has filled in the text field, and later on changes his mind and unckecks that box, the ''fill in the blank'' text field will be automatically emptied (cool, ain't it?).

===Date===

''Use the day/month/year format, e.g. for March 14th, 1945: '''14/3/1945'''''

Use this question type if you expect the response to be a correctly formatted date. The format will depend upon the language currently being used by the questionnaire respondent. For example 4/21/2007 (US); 21/4/2007 (UK); 21-4-2007 (France); etc. An example will be displayed in the questionnaire. If an "impossible" or wrongly formatted date is entered, it will either be re-written or reformatted correctly (if possible) or an error message will be displayed to the respondent. In order for dates to be correctly exported to spreadsheets such as Excel, respondent must enter ''a date in the 1902 to 2037 range''. If a date outside this range is expected from respondents, then use the '''Text Box''' question type instead. The date question type will accept dates consisting only of a month plus a year (e.g. 12/2008 for december 2008) or only a year (e.g. 2008). However, for spreadsheet processing compatibility, such incomplete dates will be automatically transformed to complete dd/mm/yy dates, e.g. 12/2008 -> '''01/'''12/2008 and 2008 -> '''01/01/'''2008. You may have to explain this pecularity to your questionnaire users beforehand.

===Dropdown Box===

There is no real advantage to using the '''Dropdown Box''' over using the '''Radio Buttons''' except perhaps for longish lists of options, to save screen space.

===Essay Box===
====Question editing interface====
[[Image:05-08-2013 15-11-45.jpg]]
====Settings====
This question will display a plain text box with '''x''' ''Textarea columns'' (or area ''width'') and '''y''' ''Textarea rows'' (number of text ''lines'').

If you leave both x and y to their default '''0''' value (or if you set it to '''0'''), then moodle's '''HTML editor''' will be displayed with standard height and width (if available in the course/user context & user profile).

===Label===

This is not a question but a (short) text which will be displayed to introduce a series of questions.

===Numeric===

Use this question type if you expect the response to be a correctly formatted number. By using the '''Max. digits allowed '''and '''Nb of decimal digits '''parameters you can specify the length and number of decimal places required.

=== Radio Buttons ===
====Question editing interface====
[[Image:05-08-2013 15-03-17.jpg]]

====Radio buttons Alignment====
[[Image:05-08-2013 13-35-04.jpg]]

====Possible answers====
You must fill in one answer per line in the '''Possible answers''' box.

Examples:

{| border="1" cellpadding="5"
! style="width: 250" scope="col" valign="top" | Editing Mode
! style="width: 243" scope="col" valign="top" | Questionnaire View
! style="width: 434" scope="col" valign="top" | (optional horizontal display)
|-
| valign="top" |
'' 1.Possible answers ''<nowiki>: </nowiki>

Red Blue Black
| valign="top" |
''' What is your favorite color? ''' Red Blue Black
| valign="top" |
''' What is your favorite color? ''' Red Blue Black
|-
| valign="top" |
'' 2.Possible answers ''<nowiki>: </nowiki>

Red Blue Black !other
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Other:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Other:
|-
| valign="top" |
'' 3.Possible answers:''

Red Blue Black !other=Another color:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Another color:
| valign="top" |
''' What is your favorite color? ''' Red Blue Black Another color:
|-
| valign="top" |
| valign="top" | Questionnaire View
| valign="top" | ''''' Text data export '''''
|-
| valign="top" |
'' 4.Possible answers: ''

red::the color of blood blue::the color of the sky black::opposite of white
| valign="top" |
''' What is your favorite color? ''' the color of blood the color of the sky opposite of white
| valign="top" |
'' The "values" red, blue and black will be exported to the columns instead of standard 1, 2 and 3 numbers. See [[Viewing_Questionnaire_responses#Download_in_text_format|Download in text format]]. ''
|-
| valign="top" |
'' 5.Possible answers:''

0=Never 1=Once a year 3=Once a month 5=Once a week 7=Once a day
| valign="top" |
''' How often do you practise a sport? '''Never Once a year Once a month Once a week Once a day
| valign="top" |
{{New features}}
|}

You may enter <tt>“!other”</tt> on a line to create an '''''optional''''' ''fill in the blank'' option. An <tt><nowiki>!other</nowiki></tt> box defaults to using the prompt ''Other:'', (or the equivalent translation for ''Other'' in the current language being used). You may change this default prompt by using the format: <tt>“!other=''prompt text”''</tt> as shown in Example #3 above.

'''Notes'''

# At the moment the length of the ''fill in the blank'' input text box is set to 25 characters and is not customizable through the online interface.
# It does not make sense to provide more than one <tt><nowiki>!other</nowiki></tt> ''fill in the blank'' option for a Radio Buttons question.
# If a respondent checks a ''fill in the blank'' option '''radio button''' and leaves the text field empty, ''a warning message will be displayed'' (upon navigating to the next page or upon submitting the questionnaire).
# If a respondent has checked a ''fill in the blank'' option '''radio button''' and has filled in the text field, and later on changes his mind and clicks a different radio button in the same question, the ''fill in the blank'' text field previously entered will be automatically emptied.
# Example #4 shows a possible "hidden" option, for exporting - in responses - named values as data instead of standard numbers. If you never export your data for studying it in stats packages you won't need this option.
# If you plan to use the ''''"Personality Test"'''' feature in your questionnaire, the number preceding each choice will be used to calculate the "score" of the section that includes this question. See https://docs.moodle.org/27/en/mod/questionnaire/personality_test#Questions

=== Rate (scale 1..5) ===
==== Example: ====
{{New features}}
The Rate question now features extra "not yet answered" radio buttons. This is especially useful in Rate questions with a long list of choices.
[[File:03-12-2013 15-23-57.jpg]]

In case the respondent forgets to check some radio buttons, upon moving to next page or submitting, the error message will be completed with highlighting of the "not yet answered" radio buttons.

[[File:03-12-2013 15-26-58.jpg]]

==== Question editing interface: ====

[[Image:05-08-2013 14-26-37.jpg]]

==== Number of scale items ====
''' Nb of scale items '''is the ''number of items'' to be used in your rate scale. You would normally use a value of 3 to 5. Default value: '''5'''.

==== Type of rate scale ====
* ''' Normal ''' (default value)
* ''' N/A columns ''' : Choose this if you want an '''N/A''' column to be added to the right of your Rate scale items columns.
* ''' No duplicate choices'''<nowiki>: Choose this if you want </nowiki>''to prevent duplicate choices in each degree '''column'''''.
** This is useful if you want the respondent to rank a number of items on a 1 to n scale and to force each rank to be unique. Example: order items A, B and C in order of preference will accept: ''A1, B3 and C2'' or ''A3, B2 and C1'', but ''it will not be possible'' for the respondent to enter: ''A1, B1, C2'' or ''A1, B2, C2,'' etc.
** Used in conjunction with [[#anchor_one|named degrees]], this '''No duplicate choices''' option can also be useful if you want the respondent to match items with named degrees, e.g. the colors ''red, blue, yellow'' with a set of physiological responses: ''excitement, tranquillity, concentration'' where '''one''' color can only match '''one''' physiological response.
* '''Osgood'''<nowiki>: Choose this to create a question of the </nowiki>[http://en.wikipedia.org/wiki/Semantic_differential Osgood's semantic differential] type. This parameter must be used in conjunction with [[#anchor_one|named degrees]].

====Possible answers====
Examples.

{| style="width: 100%" border="1" cellpadding="5"
! style="width: 50%" scope="col" valign="top" | Editing Mode
! style="width: 50%" scope="col" valign="top" | Questionnaire View
|-
| valign="top" |
''' Ex. 1 Rate''' (single line) Possible answers -> '''Enter a blank space or a short "label".''' '''Settings: ''' ''' Nb of scale items ''' = 5 (5 columns numbered 1...5);'''''Type of rate scale''''' = ''Normal'' (N/A column not needed here). 
| valign="top" |
[[Image:05-08-2013_13-53-43.jpg]]
|-
| valign="top" |
''' Ex. 2 Rate ''' (several lines) Possible answers.

Blackboard Desire2Learn Moodle Sakai WebCT

''' Settings: '' Nb of scale items ''''' = 4 (4 columns numbered 1...4) ''''' Type of rate scale ''''' = '' N/A column ''
| valign="top" |
[[Image:05-08-2013 13-50-05.jpg]]
|-
| valign="top" |
''' Ex. 2a Rate ("ordering") '''

This option makes it impossible to click more than one radio button per column; it is thus equivalent to an "ordering" question type.

''' Settings: ''' ''''' Nb of scale items ''''' = 3 (3 columns numbered 1...3) ''''' Type of rate scale''''' = ''No duplicate choices''
| valign="top" |
[[Image:05-08-2013 13-59-31.jpg]]
|-
| valign="top" |
''' Ex. 3 Rate ''with named degrees '' ''' Possible answers.

4=Very easy to use 
3=Easy to use 
2=Somewhat difficult to use 
1=Difficult to use 
Formatting Your Course 
Laying out Your Course 
Number of Clicks to Access Needed Content 
Adding Content 
Ability to Add/Change Themes/Appearance 
Overall Navigation of Moodle 

''' Settings: ''' ''''' Nb of scale items ''''' = 4 (4 named columns) ''''' Type of rate scale ''''' = '' Normal '' (N/A column not needed here)
| valign="top" |
[[Image:05-08-2013 14-04-00.jpg|800px|thumb|left]]
|-
| valign="top" |
''' Ex. 3b Rate ''with named degrees '' ''' Possible answers.

4=Very easy to use 
3=Easy to use 
2=Somewhat difficult to use 
1=Difficult to use 
formatting::Formatting Your Course 
layout::Laying out Your Course 
clicks::Number of Clicks to Access Needed Content 
addcontent::Adding Content 
appearance::Ability to Add/Change Themes/Appearance 
navigation::Overall Navigation of Moodle 

| valign="top" |
If the choice options text is fairly long, you may use shorter "labels" immediately followed by two colons (::).
The labels "formatting", "layout", "clicks" etc. will be saved to the columns headings in the Download as text format operation, instead of the longer labels which will be displayed to the questionnaire respondent.

'''Please note''' that in former versions of Questionnaire the separator between "short label" and "options text" used to be the equal sign (=). In Questionnaire 2.5 and later, please use two colons (::) as a separator.
|-
| valign="top" |
''' Ex. 4 [http://en.wikipedia.org/wiki/Semantic_differential Osgood's Semantic differential] '''' ''' Possible answers.

1=-- 2=- 3=± 4=+ 5=++ weak|strong cold|warm cowardly|brave

''' Settings: ''' ''''' Nb of scale items ''''' = 5 (5 named columns) ''''' Type of rate scale ''''' = ''Osgood''

''' Note.- ''' To separate the pairs of words you must use a pipe character '''<nowiki>|</nowiki>'''
| valign="top" |
[[Image:05-08-2013 14-06-54.jpg]]
|}

'''Notes.-''' '''named degrees'''

For this question type you have two display options. The default option displays the [http://en.wikipedia.org/wiki/Likert_scale Likert] scale degrees as numbers (1...5). If you prefer to have named degrees instead of numbers, you'll have to enter those names in the '''''Possible answers''''' list (see '''''Example 3 ''''' above). On each line of "possible answers" enter the degree number, ''immediately followed'' by the equal sign '''<nowiki>=</nowiki>''' ''immediately followed'' by the name you want to give to that degree.

{{New features}}

If you plan to use the "Personality Test" feature in your questionnaire, the number preceding each named degree will be used to calculate the "score" of the section that includes this question. See https://docs.moodle.org/27/en/mod/questionnaire/personality_test#Questions_2.

If ''the number of named degrees'' in the possible answers list ''is different from the number determined by the value you entered'' in the '''Nb of scale items''' field, this will be automatically adjusted when you save the question. If you decide to use named degrees for your Likert scale, it is recommended (but not obligatory) to start your list of possible answers with the named degrees, and then to enter the various ''items'' to be scaled.

Example #3b shows a possible "hidden" option, for exporting - in responses - shorter label instead of the longer text values. If you never export your data for studying it in stats packages you won't need this option. Please note that the example is provided here for the '''Rate ''with named degrees''''' question sub-type but it works for all Rate question sub-types except Osgood which requires short left and right options anyway.

===Text Box===

For the Text Box question type, enter the Input Box length and the Maximum text length of text to be entered by respondent.

Default values are 20 characters for the Input Box width and 25 characters for the maximum length of text entered.

===Yes/No===

==Manage questions==

In the '''Manage questions''' section of the Edit Questions page, you can conduct a number of operations on a Questionnaire's questions. Normally you should never add questions or delete questions in a questionnaire that is live in a moodle course, and which some students may have already responded to.

You can Move a question to a different position in the Questionnaire. If your questionnaire contains some "conditional branching" questions, you may not be able to move some of the parent or child questions to some positions which would ruin the branching.

You can Edit a question, but again, be extra careful when editing questions once students have started to complete a questionnaire.

If you try to Delete a child or parent question (in a Conditional branching questionnaire), you will be warned of the possible consequences of those deletions.

By clicking on the Green or Red dots, you can switch the "Response required" status of questions.

Please note that the numbers in front of each question in this interface are ''not'' the question numbers that will be displayed when answering the questionnaire. Here, these numbers indicate the question's position, and even non-real questions such as Labels and Page Breaks have a position number.

----
[[Category:Teacher]]

[[es:Editando preguntas de un cuestionario]]

Setting up a questionnaire

2014-01-23T10:21:17Z

Rezeau: /* Public questionnaire roll out to multiple courses */

{{Questionnaire}}

After you have created a questionnaire you can define extra settings in the '''Advanced settings''' link/tab.

==Content options==
===Questionnaire Type===
There are three types of questionnaires:

# ''' Private ''' - belongs to the course it is defined in only. This is the standard Moodle module concept. You create a questionnaire and its questions for the course it is defined in. Editing teachers of that course can change the questionnaire and all teachers can review the results.
# ''' Template ''' - can be copied and edited. This type of questionnaire cannot be used directly, but its content can be copied into a new questionnaire and edited.
# ''' Public ''' - can be shared among courses. If a questionnaire has already been created (in another course on the same Moodle site) with the "public" setting, then you may use that "public" questionnaire in your own course(s). The number of settings available to such questionnaires is limited and you cannot edit its questions nor view the responses. '''''Example'''''.- If a public questionnaire has been created in course A, it can be "used" in courses B, C, ... All the responses from courses A, B, C, ... are collected in the public questionnaire created in course A (the original course where it was created) and are viewable there by the person (admin or teacher) who originally created it.
====Public questionnaire roll out to multiple courses====

It is possible to create a Public questionnaire whose aliases can be placed in several courses. The student responses will only be visible in the course where the original Public questionnaire has been created. There are mainly 2 applications of this setup.

case 1.- An admin may want to see course evaluations by students without the course teachers seeing those evaluations.

case 2.- A teacher teaching several courses may want to "consolidate" the results of several questionnaires (in his various courses) into one unique Public questionnaire.

Here's how you do it (for case1)
<ol>
<li>Create a course that will simply be a shell for any public questionnaires. Give it whatever title you like, e.g. PubQuestCourse. You can hide the course entirely. </li>
<li>Create your questionnaire in this course. Call it e.g. "Public questionnaire01" On the "Advanced settings" page, select '''Public''' for the questionnaire type.</li>
<li>Add questions in this public questionnaire.</li>
<li>Navigate to the course where you want to place an alias of that Public questionnaire.</li>
<li>Add an activity or resource: Questionnaire. Edit all the various settings. Name it e.g. Questionnaire01. For Response options|Type, we suggest you select Respond once.
<li> 
[[File:10-10-2013 09-55-37.jpg]]
 
In the Content options section, in the radio buttons list, under Use public, the title of the public questionnaire you created in the other course (PubQuestCourse) will appear (e.g. Public questionnaire01): check its radio button. Then finish editing (click the Save and return to course button).</li>
Note.- For options 4-6 above, an admin may ask individual teachers to create those questionnaires based on a public questionnaire in their own courses, giving them detailed instructions on how to proceed. Unfortunately at the moment there is no way to automatically deploy a public questionnaire to other courses, it has to be done "by hand".
<li>Student responses will appear in the original questionnaire (e.g. "Public questionnaire01" in course PubQuestCourse), but will not be visible at all in the "local" questionnaire (alias). Teachers will not be able to respond to it or view their students' responses.</li>
</ol>
'''IMPORTANT''' Please note that when you delete a Public questionnaire, you also delete the links to its "dependent" questionnaires in the other courses on your moodle site. If a Public questionnaire is no longer used, the normal procedure is to go to all the other courses that "use" that Public questionnaire and delete them first.

====Template questionnaire used in multiple courses====

When the responses to your questionnaire should remain accessible in the course in which it resides, but the questionnaire itself will follow a standard format with the same questions, use a template-type of questionnaire. So instead of re-creating the questions for each questionnaire, you can apply the template questionnaire to each one you create.

Here's how you do it:
<ol>
<li>Create a course that will simply be a shell for any template questionnaires. Give it whatever title you like e.g. TempQuestCourse. You can hide the course entirely. </li>
<li>Create your questionnaire in this course. On the "Advanced settings" page, select '''Template''' for the questionnaire type.</li>
<li>Add questions in this template questionnaire.</li>
<li>Navigate to the course where you want to place an alias of that Template questionnaire.</li>
<li>Add an activity or resource: Questionnaire. Edit all the various settings. Name it e.g. Questionnaire02.</li>
<li> 
[[File:10-10-2013 10-07-55.jpg]]
 
In the Content options section, in the radio buttons list, under Copy existing, the title of the Template questionnaire you created in the other course (TempQuestCourse) will appear (e.g. Template questionnaire01): check its radio button. Then finish editing (click the Save and return to course button).</li>
</ol>

If you don't want your teachers to view or alter questionnaire responses, just define this in the Define Roles settings for Questionnaires. In Define Roles, you can limit teachers from being able to delete responses from the questionnaire, or be able to submit their own questionnaires or view responses.

===Title/Sub-title===

Title of the questionnaire, which will appear at the top of every page. By default Title is set to the questionnaire Name, but you can edit it as you like.

===Additional Info===

Text to be displayed at the top of the first page of the questionnaire. (i.e. instructions, background info, etc.)

==Submission options==

===Confirmation URL/page===

Heading (in bold) and body text for the "Confirmation" page displayed after a user completes this questionnaire. (URL, if present, takes precedence over confirmation text.) If you leave this field empty, a default message will be displayed upon questionnaire completion (''Thank you for completing this Questionnaire'').
===Email===
Sends a copy of each submission to the specified address or addresses.
You can provide more than one address by separating them with commas.
Leave blank for no email backup.

[[Category:Teacher]]

Import questions

2014-01-09T22:01:00Z

Rezeau: /* Lesson module process */

{{Managing questions}}
Moodle has a number of different formats that can be used to import questions into [[Question bank]] categories and as [[Adding a question page|lesson question pages]]. These include some proprietary quiz software formats, as well as text files and Moodle formats.

==Importing questions from an existing file==
It is possible to import questions from a file on your network/computer or from a file that has been saved or uploaded into your course files. The underlying [[Import_questions#Character_encoding|character encoding]] of this file is important.

Note: Moodle XML format is the recommended import question type format as it enables the maximum amount of question data (such as question feedback) to be imported.

=== Question bank import process ===
The question bank allows you a great deal of flexibility when importing questions. To import questions into Moodle's [[Question bank]], use the Questions link in the course administration and select the import tab. In most versions of Moodle it is also possible to get to this screen (produced by ../question/import.php) while editing an existing quiz.

[[Image:Questions import 197.png|thumb|center|Import question formats from the import tab]].

*Select import tab
*Select the question type to import
*General: pick the category, determine if the context and category information that maybe contained in a GIFT or XML file should be used.
*Select what should happen if there are no grades or an error is detected in the import process.
*Determine the file to import
**Import from file upload. Use the browse function to import a file from your computer. Use the "Upload this file" button to import the questions.
**Import from file already in course files. A popup window will take you to the course files start page. Use the "Import from this file" button.

[[Image:Question bank import file gen import 1.png|thumb|center|General and import file parameters sections]]

===Lesson module process===
The question types that can be imported from the Quiz questions bank into a lesson are the following:
Matching, Multichoice, Numerical, Short answer, True/false.

The Description and Cloze questions can '''not''' be imported from Quiz questions bank into a lesson
[[Image:Lesson Import question types.png|thumb|center|Lesson screen asking which file type will be imported]]

[[Lesson module|Lesson]] can only import from a file located on the teachers computer.
*In edit, using the expanded view
*Select the position where questions should be inserted into the lesson
*Click on the Import question link between the pages.
*Select the file type
*Use the browse function to find the file on your computer
*Import the selected file.

==Question import formats==

=== [[GIFT]] ===
Moodle 'proprietary' text format for import and export. Reasonably comprehensive.

=== [[Moodle XML format|Moodle XML]] ===
Moodle 'proprietary' xml format for import and export. Very comprehensive.

====How do you create XML files to enable import of images?====
Discussion: http://moodle.org/mod/forum/discuss.php?d=181211
=====OPTION 1=====
Check out http://www.slideshare.net/tjuly/adding-images-to-moodle-quiz-and-import-via-xml

This describes a use of a text to XML conversion process using http://vletools.com/questions/quiz

Please add any further comments here:

=====OPTION 2=====

=== [[Aiken]] ===
This format is an easy way of writing multiple-choice questions for import.

=== Blackboard ===
It's possible to import both .dat files containing just questions text or zip archives containing questions and associated medias (images, sounds, ...).

If your questions contains images they are imported too.

Also both Blackboard POOL and QTI files are supported.

Questions produced with TestGen and Examview softwares and saved as Blackboard files are imported.

If the zip archives contains several resources files all questions from all files are imported. "Undeployed" Blackboard quiz are also supported.

Follow these steps to import questions:

1. Create a quiz with questions in Examview Test Generator v. 6.2.1 or another question generator able to save questions as Blackboard files like TestGen.

2. Export the quiz to Blackboard 6.0-7.0 format.

3. From the ''Settings'' tab for your course choose ''Question bank'' and then ''Import''. Make sure you use the Blackboard format.

'''NOTE:''' Some tutorials on the web explain that you need to edit files to re-link images. '''This is no more needed'''. Images are imported without any editing.

==== Importing questions in different categories ====

If you check the "Get category from file" option during import, the category name for each resource file will be extracted for the resource file and created if necessary.

If "Get category from file" is unchecked, all questions will be imported in the current category.

==== Other alternative method to import Blackboard questions files ====
There is an alternative to the Blackboard format to import questions saved as Blackboard files.
[http://www.nashcc.edu/moodlexmlbuilder MoodleXMLBuilder] discussed below in [https://docs.moodle.org/23/en/Import_questions#See_also See Also] can also be used to convert ExamView exports to Moodle XML.
Images are supported and included within the Moodle XML when using [http://www.nashcc.edu/moodlexmlbuilder MoodleXMLBuilder].

If you decide to use MoodleXMLBuilder to convert your Blackboard zip file to a Moodle XML file, rather than use the recommended method to directly import your zip file using the Blackboard format (see above), here is how to do it:

1. Create a quiz with questions in Examview Test Generator v. 6.2.1 or another question generator able to save questions as Blackboard files like TestGen.

2. Export the quiz to Blackboard 6.0-7.0 format

3. Use the aforementioned [http://www.nashcc.edu/moodlexmlbuilder MoodleXMLBuilder] to convert from '''ExamView Export to Blackboard 6.0-7.0''' into the XML format that Moodle accepts.

4. From the ''Settings'' tab for your course choose ''Question bank'' and then ''Import''. Make sure you use the Moodle XML format. You may also need to set ''Stop on error'' to ''No''.

FYI To install MoodleXMLBuilder you may need to be logged into an administrator account or select "Run as administrator" from the right-click menu. You'll also need java and you will need to run the MoodleXMLBuilder.exe application from its install directory (the installer doesn't seem to create a Start menu entry). For Windows 7 it was C:\Program Files (x86)\MoodleXMLBuilder\MoodleXMLBuilder.exe.

=== Course Test Manager ===
This format enables you to import questions from the Course Test Manager from Course Technology.

=== [[Embedded Answers (Cloze) question type|Embedded Answers (Cloze)]] ===
This format is a multiple question, multiple answer question with embedded answers. They can be a bit tricky to develop, but they are a unique way of asking questions.

=== Examview ===
ExamView 4 supported an XML export format that Moodle can import.

Follow these steps to import questions from ExamView 4.0.8

1. Create a new test using ExamView

2. After selecting the types of questions and how many of each Click on File - Export – Change Save As Type to ExamView XML

3. After creating the export of your ExamView test login to your Moodle site

4. Go to the course you wish to add the quiz to and Turn Editing On

5. Scroll down to the topic or week you wish to add a Quiz Click add an activity – highlight quiz, Enter a name and introduction for the quiz and any other applicable information.

6. Click save and display

7. Editing quiz - click Edit then Import, click the radio button next to ExamView

8. Browse to the location you saved the file highlight and click open, then click the upload this file button.

9. Review the questions imported, click continue, click on Quiz, select all and click add to quiz

10. Save Changes, click on the preview tab view the test and the quiz is ready.

If you are using a newer version of ExamView, you should export your questions from Examview choosing the Blackboard format:

1. In ExamView choose one of the two Blackboard export options, either Blackboard option can be imported into Moodle, however it is recommended to choose the Blackboard 7.1+ option

2. Save the zip archive ExamView creates

3. Import this zip file in Moodle using "Blackboard V6+" format. see the above paragraph about the Blackboard V6+ import format for more informations.

===[[Hot Potatoes]]===
A freeware program that can export questions into Moodle.

----

'''Note 1'''.- All types of Hot Potatoes question types can be imported into Moodle, but ''JCross'' and ''JMix'' questions will be changed to Short Answer questions.

*Can be imported into the ''Quiz questions'' bank:
**Cloze questions (''JCloze'');
**Match questions (''JMatch'');
**Multiple Choice questions (''JQuiz'')
**Short Answer questions (''JQuiz'', ''JCross'' and ''JMix'')

*Can be imported into Moodle's ''Lesson'' module:
**Match questions (''JMatch'');
**Multiple Choice questions (''JQuiz'')

'''Note 2'''.- For Hot Potatoes' Multiple Choice question type (''JQuiz''), the ''Multiple-choice'' ''Short answer'' and ''Multi-select'' question-type will imported as they are. ''Hybrid'' questions will be imported as ''MultiChoice'' questions, i.e. they will not start as Short Answer questions and then change to Multiple Choice questions after several wrong responses.

===Learnwise===
This format can import multiple choice questions saved in Learnwise's XML format.

===[[Missing word question format|Missing word]]===
This format is only used for multiple choice questions and short answer questions, similar to GIFT.

=== [[WebCT format]] ===
This format supports importing multiple choice and short answers questions from WebCT's text format.

'''Caution:''' Keep in mind that WebCT allows more than one "blank" per short answer question; whereas, Moodle will only accommodate one blank per question. Questions that used multiple short answers in a question will not convert successfully.

=== [[Word table format]] ===
This format supports importing all question types (except calculated) from structured tables in Microsoft Word files.
Creating, editing and managing large numbers of questions is much easier in an external Word file than maintaining them one at a time inside Moodle.

The contributed plugin is not a standand part of Moodle, but is available in the Moodle Plugins Directory at [http://moodle.org/plugins/view.php?plugin=qformat_wordtable Moodle2Word Word table import/export].

==Importing from other programs==
=== Diploma 6 ===
Diploma 6 also supports an XML export format that Moodle can import. If you are using a newer version of Diploma, here are the steps to export from Diploma and import to Moodle. The steps are the same as those for Blackboard(see above).
*Export from Diploma with the Blackboard LS 6.0 – 6.2 format.
*Import the .zip file using the Blackboard format. The images are imported at the same time.

===Old formats===
*AON -This format is the same as the missing word format, except it creates matching questions from the multiple choice questions. Please note that from Moodle 1.8 it will no longer be part of the standard Moodle.

== Character encoding ==

It is important that the imported file is encoded in the [http://en.wikipedia.org/wiki/UTF-8 UTF-8] standard.

If this is not adhered to you may get import errors and/or strange characters in the imported materials. If the file is not UTF-8, an external tool must be used to change the encoding. Note that if only basic 'latin' characters are used, then the coding issue can generally be ignored. Be particularly careful when creating questions using Microsoft Word. For reasons best known to themselves, Microsoft used their own encoding for some characters (incompatible with UTF-8) and this is likely to break the import.

:''Note:''If you are having problems with the first question (or category modifier) in the file being misinterpreted (this particularly applies to GIFT format) it might be your editor adding a "Byte-Order-Mark" character at the beginning of the file. This is particularly common in Windows programs (e.g. Notepad) and is another good reason to steer clear of Microsoft products for text editing (as apposed to word processing). There are plenty of free or low cost text editors available for download. The BOM is neither recommended or required as UTF8 does not have [http://en.wikipedia.org/wiki/Byte-order_mark byte order issues].

==Match grades==

Imported grades must '''exactly''' match one of the fixed list of valid grades, as follows:

100, 90, 80, 75, 70, 66.666, 60, 50, 40, 33.333, 30, 25, 20, 16.666, 14.2857, 12.5, 11.111, 10, 5, 0

negative values of the above list are also permitted.

There are two settings for this switch. They affect how the import routine treats values that do not exactly match one of the values in the above list

* Error if grade not listed - If a question contains any grades not found in the list an error is displayed and that question will not be imported.
* Nearest grade if not listed - If a grade is found that does not match a value in the list, the grade is changed to the closest matching value in the list

Note: some custom import formats write directly to the database and may bypass this check.

==Tips and tricks==

*''TIP:'' It may be easier and faster to type many questions into a '''single text file''', than to create a series of Quiz or Lesson question pages. Some teachers report that once they master creating questions in one of the formats to import, they do not have to wait for their Moodle site screen to refresh and the process of selecting the next question type to create.
*''TIP:'' Want to use questions from your quiz in a '''Lesson'''? Export the question category in say a GIFT format, then use a text editor to delete questions, or perhaps use a search and replace function to change names or places.

== See also ==
* [http://vletools.com Moodle XML Converter] Convert your questions online into Moodle XML format. Allows to create questions from existing textfiles that should to be preformatted in a simple way. Supports TeX formulas, HTML and image embedded questions. Also can generate *.txt file from Moodle XML in case you need to export your questions in textfile.
* [http://www.nashcc.edu/moodlexmlbuilder MoodleXMLBuilder] converts commonly-used test generator output into Moodle XML. MoodleXMLBuilder currently supports converting tests and question banks created in Blackboard, ExamView, TestGen, and EZTest. Images are fully supported within all question fields where images are allowed within the Moodle quiz module.
* The help button link next to the import file button gives a lot of detail about each format in a popup window.
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=51316 escaping problem in gift import?] forum discussion
* [[Converting files to UTF-8]]
* [[Import and export FAQ]]
* [http://moodle.org/mod/forum/user.php?id=726938&course=5 Eoin Campbell is working on a XSLT based import/export module for Word] - stay tuned!
*[http://www.moodle2word.net website for converting Moodle Questions into tables in a Microsoft Word file, and vice versa].
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=202101 GIFT import - default grade] forum discussion

[[de:Fragen importieren]]
[[es:Importar preguntas]]
[[eu:Galderak_inportatu]]
[[fr:Importer des questions]]
[[ja:問題のインポート]]

Questionnaire Personality test

2014-01-05T12:19:47Z

Rezeau: /* Chart display */

Questionnaire Personality test

2014-01-02T10:53:53Z

Rezeau: /* Feedback options */

{{Questionnaire}}
{{New features}}
==Overview==

===Definition===
A personality test is a tool that attempts to measure a person's social interaction skills and patterns of behavior. (US legal definition).

In the Moodle Questionnaire add-on, the "personality test" feature enables a questionnaire creator to attribute different "values" to the answers to certain types of questions. Those values can be added into scores - globally or in several "sections" - and relevant feedback messages based on those scores can be displayed to the respondent.

Given the particular nature of the "personality test" feature, great care should be exercised when using it in questionnaires.

===Organization===
The following question types can be used with the "personality test" feature: ''Radio buttons'', ''Dropdown Box'', ''Rate'' and ''Yes/No''. In order for the answers to those questions to be "scored", they ''must'' have a '''question name''', must be '''required''' and each of their choices must have a '''value'''. For the ''Yes/No'' question, the default values are 1 for a Yes answer and 0 for a No.

===Settings===
See the examples below.

==Global Feedback example==

Adapted from [http://www.personalitytest.net/funtest/hrdept.htm www.personalitytest.net]

===Questions===
*Create Q1 as a ''Radio Buttons'' (or Dropdown Box) question type
**'''Question Name''': ''feel your best''
**'''Response Required''': ''Yes''. We are giving question Q1 a '''name''' and setting it as '''Required''' because we plan to use it in the Personality test feedback.
**'''Question Text''': When do you feel your best?
**'''Possible answers''':
***2=In the morning
***4=During the afternoon and early evening
***6=Late at night
Each possible answer choice begins with a value ''immediately followed'' by the equal sign (=) ''immediately followed'' by the choice words(*). The values attributed to the various choices must be carefully considered in order to obtain a coherent "score" when they are added up in the feedback score calculation. Here we are using the values as given in the "personality fun test" of our example.

(*) '''No space''' before nor after the equal sign (=).

Continue to create all 10 questions in the sample questionnaire.

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select the first option available, i.e. Global Feedback.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.
Now click the '''Save settings and edit Feedback Sections''' button.
====Editing Questionnaire Feedback Sections====
On this page is displayed the full list of the questions available for the Feedback report. Since we have selected the Global feedback option, all those questions have been default-set in Section 1, the only section available here. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
Normally, you have nothing to change on that page. However you might want to remove one or several questions from the list by clicking the 0 radio button instead of the (Section) 1 button.
Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Global Feedback heading=====
* This begins with a list of the names of all the questions that are used in this Global Feedback section.
* The ''Label'' text box should be kept as short as possible. It will be displayed in the Feedback report and - when the Chart feature is avaiblable in a later version of Questionnaire - will be used in the Charts.
* In the ''Heading'' field you may type a brief heading text. You may use 2 variables in this heading, $scorepercent and $oppositescorepercent. One example is: "You scored $scorepercent in this questionnaire."
=====Global Feedback messages=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, still taken from our sample Personality "Fun" test.
*Feedback Score boundary
**100%
**Feedback : Others see you as someone they should "handle with care" You're seen as vain, self-centered, and who is extremely dominant. Others may admire you, wishing they could be more like you, but don't always trust you, hesitating to become too deeply involved with you.

*Feedback Score boundary
**94%
**Feedback : Others see you as an exciting, highly volatile, rather impulsive personality; a natural leader, who's quick to make decisions, though not always the right ones. [etc.]

*Feedback Score boundary
**85%
etc.

This starts with 3 default boundaries and associated messages, but you may add more boundaries if needed.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 12-21-49.jpg]]

# This table shows the global score for respondent plus, if any, the average global score for all participants. If the questionnaire is set to "separate groups", this box may show the average global score for the group that the actual respondent belongs to.
# In the first box of the Feedback Report we see the Heading text, which may include the value of the $scorepercent variable.
# In the second box we see the "personalized" feedback message, relevant to the Feedback score boundaries that the actual respondent's score sits in.

On the View all Responses page, the Feedback report heading will be displayed, together with the average Global score for All participants. If the questionnaire is set to "visible" or "separate groups", the average global score for the current group will be displayed.

[[File:03-12-2013 13-42-07.jpg]]

==Several sections Feedback example==
A simplistic "health habits" questionnaire.
===Questions===
*Create Q1 as a ''Rate'' question type
**'''Question Name''': ''sports''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you practise these sports?
**'''Possible answers''':
***0=never
***1=once a month
***2=every week
***3=every day
***cycling
***running
***swimming
***walking

*Create Q2 as a ''yes/no'' question type
**'''Question Name''': ''fruit and vegetables''
**'''Response Required''': ''Yes''.
**'''Question Text''': Do you regularly eat fresh fruit and vegetables?

*Create Q3 as a ''Radio buttons'' question type
**'''Question Name''': ''smoking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you smoke?
**'''Possible answers''':
***3=never
***2=less than one packet per month
***1=one packet per week
***0=one packet per day

*Create Q4 as a ''Radio buttons'' question type
**'''Question Name''': ''drinking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you drink alcohol?
**'''Possible answers''':
***3=never
***2=less than one glass per month
***1=one glass per week
***0=one glass per day

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select 2 Feedback sections.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.

[[File:03-12-2013 14-23-55.jpg]]

Now click the '''Save settings and edit Feedback Sections''' button.

====Editing Questionnaire Feedback Sections====

On this page is displayed the full list of the questions available for the Feedback report. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
By default, the questions are not set into any Feedback Section (all radio buttons are set at 0). You now have to set each question into one of the 2 Sections you decided to display in your questionnaire's Feedback Report. At this stage, those 2 Feedback Sections have not yet been named, so you really have to be careful and make a mental note of "which is which". Suppose you want Section 1 to be related to your respondents' practise of sport, you would put question 1 into section 1 (click radio button 1 for that question). Now suppose you want your second section to be related to "healthy attitude" towards food, drinking and smoking; click all the remaining radio buttons "2" for questions 2, 3 and 4.

Suppose you get it wrong and you mistakenly put all of your questions in Section 1. Upon clicking on the "Save" button, this error message would be displayed:
''You must select at least ONE question per section!
Section(s) not selected: 2''

Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Feedback heading for section 1/2=====
You will now get a screen very similar to the one you get for Global Feedback messages (as in our previous example). But you will get several screens, one per section.

* Questions in this section:
** sports
* Label: Physical activity
* Heading: Your "physical activity" score is $scorepercent.
=====Feedback messages for section 1/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You must be very fit. Congratulations!

*Feedback Score boundary
**66%
**Feedback: Your physical activity is only average. Come on!

*Feedback Score boundary
**33%
**Feedback: You seem to be a real couch potato. Make an effort!

When finished, click the '''Next section (2/2)''' button.

=====Feedback heading for section 2/2=====
* Questions in this section:
** fruit and vegetables
** smoking
** drinking
* Label: Healthy habits
* Heading: Your "healthy habits" score is $scorepercent.

=====Feedback messages for section 2/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You seem to have quite healthy habits. Continue!

*Feedback Score boundary
**66%
**Feedback: You seem to have not very healthy habits. Make an effort to cut down on drinking and smoking.

*Feedback Score boundary
**33%
**Feedback: You seem to have not terribly healthy habits. You must make a serious effort.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 14-53-07.jpg]]

This report is similar to the Global Feedback report in our previous example, except that now the score is separated into 2 sections.

==Bipolar results==
Some "personality tests" aim at detecting a bipolar characteristic in respondents' character. For example, whether an individual's profile is rather visual or auditory, global or analytic, extrovert or introvert etc. See Julian Rotter's theory of [http://en.wikipedia.org/wiki/Julian_Rotter#Locus_of_control Locus of Control].

In such cases, you can enter the section labels as a set of 2 opposed (bipolar) concepts, separated by a pipe character.

[[File:03-12-2013 14-58-51.jpg]]

In a questionnaire based on the Locus of Control theory, this "bipolar" heading will give the following kind of report:

[[File:03-12-2013 15-13-09.jpg]]

==Chart display==
'''Important Note'''.- This feature is currently in Beta stage and only available from the github repository (Questionnaire version 2.6.3).
===Site settings===
Upon installing or updating the Questionnaire plugin, its "site settings" page is displayed. On that ''Site administration ► Plugins ► Activity modules ► Questionnaire'' page, an admin can choose to enable the Chart feature site-wide. The default is ''No'' (do not enable). The Questionnaire Chart feature currently uses the [http://www.rgraph.net/ RGraph] libraries, which are licensed under the MIT type of open source license.

===Chart types===
Navigate to the ''Advanced settings'' page and click the ''Feedback options'' button.

You can choose to display or not the table of scores in the Feedback report.

The Chart type drop down list that is available is dependent on the number of feedback sections in your questionnaire.

* Global Feedback (i.e. one section only): Bipolar bars or Vertical Progress bar.
* 2 Sections: Bipolar bars or Horizontal bars or Rose.
* More than 2 sections: Bipolar bars or Horizontal bars or Radar or Rose.

Your choice of Chart type depends on the type of questions in your questionnaire. It's up to you to find out the most suitable Chart type. The Bipolar bars type is only suited when your feedback sections include Bipolar_results (see above).

The selected Chart will be displayed on the All Responses page. It will be constructed with all participants' results or, if the questionnaire is set to Visible Groups, with the results of the currently selected group.

On an Individual Responses page, the current user's current results Chart will be displayed, and also the All participants (or current group) results Chart.

Some samples illustrating the complete Chart types that can be used are displayed below.

Vertical Progress bar

[[File:02-01-2014 11-44-28.jpg]]

Bipolar bars

[[File:02-01-2014 11-40-05.jpg]]

Horizontal bars

[[File:02-01-2014 11-42-27.jpg]]

Radar

[[File:02-01-2014 11-37-47.jpg]]

Rose

[[File:02-01-2014 11-38-58.jpg]]

Questionnaire Personality test

2014-01-02T10:53:07Z

Rezeau: /* Feedback options */

{{Questionnaire}}
{{New features}}
==Overview==

===Definition===
A personality test is a tool that attempts to measure a person's social interaction skills and patterns of behavior. (US legal definition).

In the Moodle Questionnaire add-on, the "personality test" feature enables a questionnaire creator to attribute different "values" to the answers to certain types of questions. Those values can be added into scores - globally or in several "sections" - and relevant feedback messages based on those scores can be displayed to the respondent.

Given the particular nature of the "personality test" feature, great care should be exercised when using it in questionnaires.

===Organization===
The following question types can be used with the "personality test" feature: ''Radio buttons'', ''Dropdown Box'', ''Rate'' and ''Yes/No''. In order for the answers to those questions to be "scored", they ''must'' have a '''question name''', must be '''required''' and each of their choices must have a '''value'''. For the ''Yes/No'' question, the default values are 1 for a Yes answer and 0 for a No.

===Settings===
See the examples below.

==Global Feedback example==

Adapted from [http://www.personalitytest.net/funtest/hrdept.htm www.personalitytest.net]

===Questions===
*Create Q1 as a ''Radio Buttons'' (or Dropdown Box) question type
**'''Question Name''': ''feel your best''
**'''Response Required''': ''Yes''. We are giving question Q1 a '''name''' and setting it as '''Required''' because we plan to use it in the Personality test feedback.
**'''Question Text''': When do you feel your best?
**'''Possible answers''':
***2=In the morning
***4=During the afternoon and early evening
***6=Late at night
Each possible answer choice begins with a value ''immediately followed'' by the equal sign (=) ''immediately followed'' by the choice words(*). The values attributed to the various choices must be carefully considered in order to obtain a coherent "score" when they are added up in the feedback score calculation. Here we are using the values as given in the "personality fun test" of our example.

(*) '''No space''' before nor after the equal sign (=).

Continue to create all 10 questions in the sample questionnaire.

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select the first option available, i.e. Global Feedback.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.
Now click the '''Save settings and edit Feedback Sections''' button.
====Editing Questionnaire Feedback Sections====
On this page is displayed the full list of the questions available for the Feedback report. Since we have selected the Global feedback option, all those questions have been default-set in Section 1, the only section available here. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
Normally, you have nothing to change on that page. However you might want to remove one or several questions from the list by clicking the 0 radio button instead of the (Section) 1 button.
Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Global Feedback heading=====
* This begins with a list of the names of all the questions that are used in this Global Feedback section.
* The ''Label'' text box should be kept as short as possible. It will be displayed in the Feedback report and - when the Chart feature is avaiblable in a later version of Questionnaire - will be used in the Charts.
* In the ''Heading'' field you may type a brief heading text. You may use 2 variables in this heading, $scorepercent and $oppositescorepercent. One example is: "You scored $scorepercent in this questionnaire."
=====Global Feedback messages=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, still taken from our sample Personality "Fun" test.
*Feedback Score boundary
**100%
**Feedback : Others see you as someone they should "handle with care" You're seen as vain, self-centered, and who is extremely dominant. Others may admire you, wishing they could be more like you, but don't always trust you, hesitating to become too deeply involved with you.

*Feedback Score boundary
**94%
**Feedback : Others see you as an exciting, highly volatile, rather impulsive personality; a natural leader, who's quick to make decisions, though not always the right ones. [etc.]

*Feedback Score boundary
**85%
etc.

This starts with 3 default boundaries and associated messages, but you may add more boundaries if needed.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 12-21-49.jpg]]

# This table shows the global score for respondent plus, if any, the average global score for all participants. If the questionnaire is set to "separate groups", this box may show the average global score for the group that the actual respondent belongs to.
# In the first box of the Feedback Report we see the Heading text, which may include the value of the $scorepercent variable.
# In the second box we see the "personalized" feedback message, relevant to the Feedback score boundaries that the actual respondent's score sits in.

On the View all Responses page, the Feedback report heading will be displayed, together with the average Global score for All participants. If the questionnaire is set to "visible" or "separate groups", the average global score for the current group will be displayed.

[[File:03-12-2013 13-42-07.jpg]]

==Several sections Feedback example==
A simplistic "health habits" questionnaire.
===Questions===
*Create Q1 as a ''Rate'' question type
**'''Question Name''': ''sports''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you practise these sports?
**'''Possible answers''':
***0=never
***1=once a month
***2=every week
***3=every day
***cycling
***running
***swimming
***walking

*Create Q2 as a ''yes/no'' question type
**'''Question Name''': ''fruit and vegetables''
**'''Response Required''': ''Yes''.
**'''Question Text''': Do you regularly eat fresh fruit and vegetables?

*Create Q3 as a ''Radio buttons'' question type
**'''Question Name''': ''smoking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you smoke?
**'''Possible answers''':
***3=never
***2=less than one packet per month
***1=one packet per week
***0=one packet per day

*Create Q4 as a ''Radio buttons'' question type
**'''Question Name''': ''drinking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you drink alcohol?
**'''Possible answers''':
***3=never
***2=less than one glass per month
***1=one glass per week
***0=one glass per day

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select 2 Feedback sections.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.

[[File:03-12-2013 14-23-55.jpg]]

Now click the '''Save settings and edit Feedback Sections''' button.

====Editing Questionnaire Feedback Sections====

On this page is displayed the full list of the questions available for the Feedback report. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
By default, the questions are not set into any Feedback Section (all radio buttons are set at 0). You now have to set each question into one of the 2 Sections you decided to display in your questionnaire's Feedback Report. At this stage, those 2 Feedback Sections have not yet been named, so you really have to be careful and make a mental note of "which is which". Suppose you want Section 1 to be related to your respondents' practise of sport, you would put question 1 into section 1 (click radio button 1 for that question). Now suppose you want your second section to be related to "healthy attitude" towards food, drinking and smoking; click all the remaining radio buttons "2" for questions 2, 3 and 4.

Suppose you get it wrong and you mistakenly put all of your questions in Section 1. Upon clicking on the "Save" button, this error message would be displayed:
''You must select at least ONE question per section!
Section(s) not selected: 2''

Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Feedback heading for section 1/2=====
You will now get a screen very similar to the one you get for Global Feedback messages (as in our previous example). But you will get several screens, one per section.

* Questions in this section:
** sports
* Label: Physical activity
* Heading: Your "physical activity" score is $scorepercent.
=====Feedback messages for section 1/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You must be very fit. Congratulations!

*Feedback Score boundary
**66%
**Feedback: Your physical activity is only average. Come on!

*Feedback Score boundary
**33%
**Feedback: You seem to be a real couch potato. Make an effort!

When finished, click the '''Next section (2/2)''' button.

=====Feedback heading for section 2/2=====
* Questions in this section:
** fruit and vegetables
** smoking
** drinking
* Label: Healthy habits
* Heading: Your "healthy habits" score is $scorepercent.

=====Feedback messages for section 2/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You seem to have quite healthy habits. Continue!

*Feedback Score boundary
**66%
**Feedback: You seem to have not very healthy habits. Make an effort to cut down on drinking and smoking.

*Feedback Score boundary
**33%
**Feedback: You seem to have not terribly healthy habits. You must make a serious effort.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 14-53-07.jpg]]

This report is similar to the Global Feedback report in our previous example, except that now the score is separated into 2 sections.

==Bipolar results==
Some "personality tests" aim at detecting a bipolar characteristic in respondents' character. For example, whether an individual's profile is rather visual or auditory, global or analytic, extrovert or introvert etc. See Julian Rotter's theory of [http://en.wikipedia.org/wiki/Julian_Rotter#Locus_of_control Locus of Control].

In such cases, you can enter the section labels as a set of 2 opposed (bipolar) concepts, separated by a pipe character.

[[File:03-12-2013 14-58-51.jpg]]

In a questionnaire based on the Locus of Control theory, this "bipolar" heading will give the following kind of report:

[[File:03-12-2013 15-13-09.jpg]]

==Chart display==
'''Important Note'''.- This feature is currently in Beta stage and only available from the github repository (Questionnaire version 2.6.3).
===Site settings===
Upon installing or updating the Questionnaire plugin, its "site settings" page is displayed. On that ''Site administration ► Plugins ► Activity modules ► Questionnaire'' page, an admin can choose to enable the Chart feature site-wide. The default is ''No'' (do not enable). The Questionnaire Chart feature currently uses the [http://www.rgraph.net/ RGraph] libraries, which are licensed under the MIT type of open source license.

===Feedback options===
Navigate to the ''Advanced settings'' page and click the ''Feedback options'' button.

You can choose to display or not the table of scores in the Feedback report.

The Chart type drop down list that is available is dependent on the number of feedback sections in your questionnaire.

* Global Feedback (i.e. one section only): Bipolar bars or Vertical Progress bar.
* 2 Sections: Bipolar bars or Horizontal bars or Rose.
* More than 2 sections: Bipolar bars or Horizontal bars or Radar or Rose.

Your choice of Chart type depends on the type of questions in your questionnaire. It's up to you to find out the most suitable Chart type. The Bipolar bars type is only suited when your feedback sections include Bipolar_results (see above).

The selected Chart will be displayed on the All Responses page. It will be constructed with all participants' results or, if the questionnaire is set to Visible Groups, with the results of the currently selected group.

On an Individual Responses page, the current user's current results Chart will be displayed, and also the All participants (or current group) results Chart.

Some samples illustrating the complete Chart types that can be used are displayed below.

Vertical Progress bar

[[File:02-01-2014 11-44-28.jpg]]

Bipolar bars

[[File:02-01-2014 11-40-05.jpg]]

Horizontal bars

[[File:02-01-2014 11-42-27.jpg]]

Radar

[[File:02-01-2014 11-37-47.jpg]]

Rose

[[File:02-01-2014 11-38-58.jpg]]

File:02-01-2014 11-38-58.jpg

2014-01-02T10:52:21Z

Rezeau:

File:02-01-2014 11-37-47.jpg

2014-01-02T10:51:41Z

Rezeau:

File:02-01-2014 11-42-27.jpg

2014-01-02T10:51:04Z

Rezeau:

File:02-01-2014 11-40-05.jpg

2014-01-02T10:49:56Z

Rezeau:

File:02-01-2014 11-44-28.jpg

2014-01-02T10:46:50Z

Rezeau: