MoodleDocs - User contributions [en]

Adding/editing a questionnaire

2013-10-28T09:52:32Z

Rezeau: /* Response viewing */ Moved "Never" view ALL responses from Response options setting to Permissions

{{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===

You can specify who 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.'''

{{New features}}
Note.- If you want the questionnaire respondents to NEVER be able to view ALL responses, use the ''Roles and capabilities system'' to decide which course participants will be allowed to view ALL responses. Go to the Questionnaire 'Permissions' settings and Override the Student role by setting 'Read response summaries, subject to open times (mod/questionnaire:readallresponses)' from ''Inherit (Allow)'' to ''Prevent'' or ''Prohibit''. As for all other Roles and capabilities settings, you can set that permission at site level, course level or activity level.

In Questionnaire 2.5, this option has been moved from Response options setting to Permissions.

===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===
{{New features}}
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]]

Setting up a questionnaire

2013-10-16T11:55:51Z

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 a questionnaire 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]]

Setting up a questionnaire

2013-10-16T11:51:55Z

Rezeau:

{{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 a questionnaire 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>

====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]]

Viewing Questionnaire responses

2013-10-16T11:48:28Z

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]]

{{New features}}
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.
* ''Members of: All groups'' includes responses from people who belong to any group.
* And ''People not in a group'' is self-explanatory.;

'''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]]
{{New features}}
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 ==
{{New features}}

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]]

[[Category:Teacher]]

File:16-10-2013 13-45-08.jpg

2013-10-16T11:47:36Z

Rezeau:

Setting up a questionnaire

2013-10-10T08:47:23Z

Rezeau: /* Questionnaire Type */

{{Questionnaire}}

If you are creating a new survey or editing an existing template you will be able to define the overall settings via the '''Advanced settings''' 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 questionnaire content 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 a questionnaire 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>

====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:10-10-2013 10-07-55.jpg

2013-10-10T08:44:57Z

Rezeau:

Setting up a questionnaire

2013-10-10T08:03:52Z

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

{{Questionnaire}}

If you are creating a new survey or editing an existing template you will be able to define the overall settings via the '''Advanced settings''' 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 questionnaire content 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 a questionnaire 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>

====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. You can hide the course entirely. </li>
<li>Create your questionnaire in this course. Be sure to select '''Template''' for the questionnaire type.</li>
<li>Build all of the questionnaire questions in this template questionnaire.</li>
<li>Navigate to the course where you want to place the questionnaire for respondents.</li>
<li>Select the option to add a questionnaire. Complete the creation screen. For Type, select whichever option you like. For Respondent Eligibility, select Students only. Then select the template questionnaire you created in the other course. '''For Questionnaire type, select Private.''' </li>
<li>After you save your changes, the same screen will appear. Note that the questionnaire type now says "Private" and the selected template questionnaire is shown below.</li>
<li>Test it out! Student responses will appear in the local questionnaire instead of in the template questionnaire you created outside of the course. </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:10-10-2013 09-55-37.jpg

2013-10-10T08:00:26Z

Rezeau:

Setting up a questionnaire

2013-10-10T07:43:22Z

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

{{Questionnaire}}

If you are creating a new survey or editing an existing template you will be able to define the overall settings via the '''Advanced settings''' 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 questionnaire content 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 a questionnaire 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>Build all of the questionnaire 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>In the Content options section, in the radio butons 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>

====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. You can hide the course entirely. </li>
<li>Create your questionnaire in this course. Be sure to select '''Template''' for the questionnaire type.</li>
<li>Build all of the questionnaire questions in this template questionnaire.</li>
<li>Navigate to the course where you want to place the questionnaire for respondents.</li>
<li>Select the option to add a questionnaire. Complete the creation screen. For Type, select whichever option you like. For Respondent Eligibility, select Students only. Then select the template questionnaire you created in the other course. '''For Questionnaire type, select Private.''' </li>
<li>After you save your changes, the same screen will appear. Note that the questionnaire type now says "Private" and the selected template questionnaire is shown below.</li>
<li>Test it out! Student responses will appear in the local questionnaire instead of in the template questionnaire you created outside of the course. </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]]

Viewing Questionnaire responses

2013-09-28T08:25:48Z

Rezeau: /* Rate question */

{{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]]

{{New features}}
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:05-08-2013 16-24-25.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.
* ''Members of: All groups'' includes responses from people who belong to any group.
* And ''People not in a group'' is self-explanatory.;

'''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]]
{{New features}}
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 ==
{{New features}}

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]]

[[Category:Teacher]]

Viewing Questionnaire responses

2013-09-28T08:21:07Z

Rezeau: /* Yes/No */

{{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]]

{{New features}}
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:05-08-2013 16-24-25.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.
* ''Members of: All groups'' includes responses from people who belong to any group.
* And ''People not in a group'' is self-explanatory.;

'''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]]
{{New features}}
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 ==
{{New features}}

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]]

[[Category:Teacher]]

Questionnaire Conditional branching

2013-09-28T08:16:40Z

Rezeau: /* Individual Responses Report */

{{Questionnaire}}
{{New features}}
==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 id 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.

Questionnaire Conditional branching

2013-09-28T08:16:02Z

Rezeau: /* Individual Responses Report */

{{Questionnaire}}
{{New features}}
==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 id 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]]

This other respondent said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

Questionnaire Conditional branching

2013-09-24T13:35:38Z

Rezeau: /* Procedure to obtain that flow */

{{Questionnaire}}
{{New features}}
==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 id 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]]

This respondent 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]]

This other respondent said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

Regular Expression Short-Answer question type

2013-08-30T13:57:07Z

Rezeau: /* Downloads */

===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-25/question/type/multianswer/questiontype.php

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

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

https://github.com/rezeau/moodle/compare/MOODLE_25_STABLE...multianswer_regexp-25
|}

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]

[[fr:question/type/regexp]]

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

Regular Expression Short-Answer question type

2013-08-30T13:54:01Z

Rezeau: /* Other answers */

===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-25/question/type/multianswer/questiontype.php

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

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

https://github.com/rezeau/moodle/compare/MOODLE_25_STABLE...multianswer_regexp-25
|}

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 latest 2.2 version (with behaviours)] from the new Plugins repository.
* IMPORTANT : for the 2.2 version, if you want the Help feature, you must also download and install the following 2 "question behaviours" from the new 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]

[[fr:question/type/regexp]]

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

Editing Questionnaire questions

2013-08-09T13:31:43Z

Rezeau: /* Questionnaires 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 feature====

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

If your questionnaire does not use the "Conditional Branching" 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====

{{New features}}

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.

{{New features}}

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

===Parent Question===
{{New features}}
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]]. ''
|}

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.

=== Rate (scale 1..5) ===
==== Example: ====

[[Image:05-08-2013 13-50-05.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.

Actually, the number preceding each named degree is only there to remind you of its position on the horizontal scale; it is not used by the programme, and you ''might'' as well use, eg. 0=Almost Never; 0=Seldom; 0=Sometimes; etc. But you ''must'' begin with ''a number'' immediately followed by ''the equal sign = ''.

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]]

Editing Questionnaire questions

2013-08-09T13:28:16Z

Rezeau: /* Parent Question */

{{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 feature====

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

If your questionnaire does not use the "Conditional Branching" 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====

{{New features}}

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]]

===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.

{{New features}}

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

===Parent Question===
{{New features}}
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]]. ''
|}

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.

=== Rate (scale 1..5) ===
==== Example: ====

[[Image:05-08-2013 13-50-05.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.

Actually, the number preceding each named degree is only there to remind you of its position on the horizontal scale; it is not used by the programme, and you ''might'' as well use, eg. 0=Almost Never; 0=Seldom; 0=Sometimes; etc. But you ''must'' begin with ''a number'' immediately followed by ''the equal sign = ''.

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]]

mod/questionnaire/conditional branching

2013-08-09T13:23:37Z

Rezeau: Redirected page to Questionnaire Conditional branching

#REDIRECT [[Questionnaire_Conditional_branching]]

Adding/editing a questionnaire

2013-08-09T13:11:55Z

Rezeau: /* Respondent Type */

{{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===

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

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

# ''' Never'''. By default, only teachers of the owning course can see all questionnaire submitted 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.'''

Please use the ''Roles and capabilities system'' to decide which course participants will be allowed to view a) their own responses b) all responses.

===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===
{{New features}}
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]]

Regular Expression Short-Answer question type

2013-08-09T09:21:30Z

Rezeau: /* Inserting RegExp sub-questions in Cloze type questions */ updated to moodle 2.5 URLs on my github

===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%).

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-25/question/type/multianswer/questiontype.php

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

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

https://github.com/rezeau/moodle/compare/MOODLE_25_STABLE...multianswer_regexp-25
|}

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 latest 2.2 version (with behaviours)] from the new Plugins repository.
* IMPORTANT : for the 2.2 version, if you want the Help feature, you must also download and install the following 2 "question behaviours" from the new 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]

[[fr:question/type/regexp]]

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

Questionnaire Conditional branching

2013-08-08T21:47:29Z

Rezeau:

{{Questionnaire}}
{{New features}}
==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 id 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]]

This respondent 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]]

This other respondent said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

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

2013-08-08T21:44:16Z

Rezeau:

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

2013-08-08T21:41:29Z

Rezeau:

Questionnaire Conditional branching

2013-08-08T20:55:57Z

Rezeau: /* Previewing Questionnaire */

{{Questionnaire}}
{{New features}}
==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 id 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.

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

2013-08-08T20:46:28Z

Rezeau:

Questionnaire Conditional branching

2013-08-08T17:09:46Z

Rezeau: /* Previewing Questionnaire */

{{Questionnaire}}
{{New features}}
==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 id 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.

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

2013-08-08T17:08:45Z

Rezeau:

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

2013-08-08T17:00:08Z

Rezeau:

Questionnaire Conditional branching

2013-08-07T16:58:52Z

Rezeau: /* Previewing Questionnaire */

{{Questionnaire}}
{{New features}}
==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 mimick 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 id 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]]

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

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

2013-08-07T16:55:35Z

Rezeau:

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

2013-08-07T16:53:58Z

Rezeau:

Questionnaire Conditional branching

2013-08-07T16:42:50Z

Rezeau:

{{Questionnaire}}
{{New features}}
==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==

Questionnaire Conditional branching

2013-08-07T16:41:42Z

Rezeau: /* Operations on Conditional branching questions */

{{Questionnaire}}
{{New features}}
==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.

Questionnaire Conditional branching

2013-08-07T16:22:23Z

Rezeau: /* Delete */

File:07-08-2013 18-20-29.jpg

2013-08-07T16:21:22Z

Rezeau:

Questionnaire Conditional branching

2013-08-07T16:18:09Z

Rezeau: /* Edit */

File:07-08-2013 18-12-59.jpg

2013-08-07T16:16:10Z

Rezeau:

Questionnaire Conditional branching

2013-08-07T16:10:34Z

Rezeau: /* Move */

File:07-08-2013 18-04-16.jpg

2013-08-07T16:06:37Z

Rezeau:

Questionnaire Conditional branching

2013-08-07T15:55:50Z

Rezeau:

Questionnaire Conditional branching

2013-08-07T15:52:30Z

Rezeau: /* Procedure to obtain that flow */

File:07-08-2013 17-49-53.jpg

2013-08-07T15:51:42Z

Rezeau:

File:07-08-2013 17-39-37.jpg

2013-08-07T15:41:12Z

Rezeau:

Questionnaire Conditional branching

2013-08-07T09:22:14Z

Rezeau: /* Procedure to obtain that flow */

Questionnaire Conditional branching

2013-08-07T08:31:44Z

Rezeau: /* Procedure to obtain that flow */

Questionnaire Conditional branching

2013-08-05T22:08:27Z

Rezeau:

Questionnaire Conditional branching

2013-08-05T17:21:51Z

Rezeau:

{{New features}}
TODO: Questionnaire Conditional branching docs

Template:Questionnaire

2013-08-05T17:20:49Z

Rezeau: added conditional branching page link

<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]]
</div>
</div>