Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Grader report.

Grader report: Difference between revisions

From MoodleDocs
(edit intro give location of report)
(→‎See also: Adding MoodleBites YouTube video link)
 
(26 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Grades}}The grader report page is the main teacher view of the new gradebook in Moodle 1.9. For versions prior to 1.9, look [[Grades_pre-1.9 | here]].
{{Grades}}
All the grades for each student in a course can be found in the course gradebook, or 'Grader report' in ''Administration > Course administration > Grades''. For an introduction to the gradebook, see the HQ screencast: [https://www.youtube.com/watch?v=XLxALUCbBgI Where is the Gradebook?]


The report can be seen in [[Course administration block|Course administration]]>Grades.
The grader report collects [[Grade_items|items]] that have been graded from the various parts of Moodle that are assessed, and allows you to view and change them as well as sort them out into [[Grade_categories|categories]] and calculate totals in various ways. When you add an assessed item in a Moodle course, the gradebook automatically creates space for the grades it will produce and also adds the grades themselves as they are generated, either by the system or by you.


=Basics=
The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).
The gradebook collects [[Grade_items|items]] that have been graded from the various parts of Moodle that are assessed, and allows you to view and change them as well as sort them out into [[Grade_categories|categories]] and calculate totals in various ways. When you add an assessed item in a Moodle course, the gradebook automatically creates space for the grades it will produce and also adds the grades themselves as they are generated, either by the system or by you.


The [[Grades|grades]] displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).
Note that various default options for the gradebook are set at system level by the administrator in  and can be marked as being overridable by you, or fixed. This means that the options will not always be set up the same way for every user when they see the grader report for the first time.


Note that various default options for the gradebook are set at system level by the administrator and can be marked as being overridable by you, or fixed. This means that the options will not always be set up the same way for every user when they see the grader report for the first time.
==Hiding settings globally==


=Display=
New settings hide parts of the user interface:
==Layout==
[[Image:gradebook_normal_mode.png|right|thumb|Grader report in non-editing mode]]
Along the top are several rows: first the course, then the category, then the actual column (e.g. an essay or a category total). When you start off, every essay, quiz etc is in the '''uncategorised''' category, which is named after the course by default, but can be changed if needed.


You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.
*''Site administration>Grades>General settings'':  'Show minimum grade' . If this setting is disabled, the minimum grade will default to zero and cannot be edited.
*''Site administration>Grades>Grade category settings'': 'Allow category grades to be manually overridden'. If this setting is disabled, users cannot override category grades.


There are three ways that the categories can be displayed


* Grades only - without the category totals column
===Scrolling through the gradebook===
* Collapsed - Category total column only
 
* Full view - grades and the aggregates (the totals column for the category)  
The gradebook allows for smooth and stable scrolling horizontally and vertically through grades. It uses the whole window, making it accessible on all platforms.( Note: horizontal scrolling is at the bottom of the browser window, and there is no horizontal scrollbar at the top.)
 
{|
| [[File:scrolling28a.png|thumb|500px|Scrolling in all directions]]
| [[File:wholewindow.png|thumb|500px|Using the whole window]]
|}
 
[[File:newgradereporta.png|thumb|600px|center]]
 
==Display==


Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category. + goes to grades only view, o goes to full view and - goes to collapsed view.
Along the top of the grader report are several rows: first the course, then the category, then the columns for each graded activity (for example: Assignment, Quiz, Lesson). Any activities settings which were left "uncategorised" will appear in the general category which is named after the course by default (any category name can be changed).


===Other layout options===
[[Image:gradereportcategories.png|center|thumb|600px]]
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->Grader report.


*You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.
You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.


==Highlighting rows and columns==
There are three ways that the categories can be displayed:
When your gradebook starts to grow, it can be hard to keep track of which student and which assignment a cell refers to. Highlighting solves that.
* Clicking on empty space in the cell that contains the students name will toggle the highlighting of that entire row
* Clicking on empty space in the cell at the top of each column will toggle highlighting of the entire column
(Note: this requires Javascript to be enabled in your browser.)
==Sorting by columns==


You can sort by any column.  Click the [[Image:Move.gif]] symbol near the top of a column to sort by that column.  This will change the symbol to a single downarrow.  Clicking again will sort lowest-to-highest, changing the symbol to an uparrow.  The arrows will toggle between these two states until you click on a different column.
* Grades only - without the category totals column
* Aggregates - Category total column only
* Full view - grades and the aggregates (the totals column for the category)


The student name columns do not have the [[Image:Move.gif]] symbol. Clicking on either the first or last name will cause the report to sort.
Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category;


*Examples
{| style="width:75%; border="0" align="center"
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]]
|-
|}


==Highlighting scores that are either adequate or unacceptable in red and green==
[[Image:grades3iconsa.png|thumb|500px|center]]


Turn editing on and click on the edit icon in the controls cell at the top of the column. You can then (maybe need to click 'show advanced') see the option to enter a 'grade to pass'. Once set, any grades falling above this will be highlighted in green and any below will be highlighted in red.
===Sorting by columns===


Note that the highlighting will not show if the Grader report is viewed in the editing mode.
You can sort by any column.  Click the [[Image:iconsort.png]] symbol near the top of a column to sort by that column (1 below).  This will change the symbol to a single down arrow.  Clicking again will sort lowest-to-highest, changing the symbol to an up arrow.  The arrows will toggle between these two states until you click on a different column.


==Categorising the grades==
You can also access the [[Single view]] by clicking the pencil icon next to the arrows (2 below).
The 'Choose an action...' drop down on the upper left will let you switch to other views
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc.  


Each category will then have its own '''Category total''' column.
[[File:iconsgrades.png]]


==Horizontal scrollbar==
You can sort the students by clicking the arrow (1 below), access individual [[User report| user reports]] by clicking the icon (2 below) and similar to the grade items you can access [[Single view]] by clicking the pencil icon (3 below)
[[Image:Gradebook horizontal scrollbar.png|thumb|Grader report with horizontal scrollbar]]
In Moodle 1.9.5 onwards, administrators may enable a static students column (in ''Administration > Grades > Report settings > [[Gradebook report settings|Grader report]]'') for teachers to scroll grades in the grader report using a horizontal scrollbar. (Note that this feature is not available for IE6 users or for users who have have the screenreader setting in their profile set to Yes.)


==Mouse-over tooltips==
[[File:studentsort.png]]


In Moodle 1.9.5 onwards, each grade cell in the table has a tooltip indicating the user and grade item to which the grade belongs.
===Searching and filtering the gradebook===
If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.


=Editing=
It is also possible to search students by first name and last name:
[[Image:gradebook_edit_mode.png|right|thumb|Grader report in editing mode]]
Note: Editing anything in the gradebook refers to editing the grades '''only''' and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook. The "Turn editing on" button functions separately from the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities.  Roles such as 'non-editing teacher' may only have one or the other.


==Altering the grades==
[[File:gradebooksearch.png]]
You can click "Turn editing on"  at the top right to show an edit icon next to each grade. Clicking on the icon will bring up the editing screen for that grade which will allow you to set the grade, its written feedback and a number of other attributes.


Alternatively, you can click on "[[Grade_preferences|My report preferences]]"' and choose "Quick grading" and "Quick feedback" to make the report appear with editable boxes containing each grade, so you can change many at once.  This capability can be a real time saver, but make sure to save at reasonable intervals lest a pageful of changes be lost.  You can lose unsaved changes by bringing up a new page in the browser, such as a Moodle manual page.  If you want a manual page or the like, be sure to bring it up in a new tab.
==Editing==


Quick feedback is switched off by default, but you can easily switch it on or off using the "Show Quick Feedback" link above the grader report, when editing is on. Alternatively you can switch it on and off in the page "[[Grade_preferences|My report preferences]]".
Note: Editing anything in the gradebook refers to editing the grades '''only''' and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook. The "Turn editing on" button functions separately from the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities.  Roles such as 'non-editing teacher' may only have one or the other.


==The significance of altering the grades in this screen==
===Altering the grades===
If you make changes here, they're highlighted in this screen going forward.  The orange highlight represents a grade altered outside of its native assignment page.
You can click "Turn editing on"  at the top right to show an edit icon next to each grade. Clicking on the icon will bring up the editing screen for that grade which will allow you to set the grade, its written feedback and a number of other attributes.


==Calculating totals==
Alternatively, you can choose "Quick grading" and "Quick feedback" in 'My preferences' to make the report appear with editable boxes containing each grade, so you can change many at once. This capability can be a real time saver, but make sure to save at reasonable intervals lest a pageful of changes be lost.
Rather than a simple average or sum, Moodle can perform very complex calculations to produce the totals for each category and for the whole course. e.g. you want to take an average of 3 items from one category, double it, then add it to the average of another category.


You can do this using calculations. Either turn on editing, then click '''Show calculations''', or go to '''[[Grade_preferences|My report preferences]]''', choose '''show calculations''', then save and turn editing on. You will then see a small calculator icon next to each total column which, when you click on it, will take you to the page [[Edit grade calculation]] where there are instructions.
Note: If you make changes here, they are then shown highlighted to indicate grades which have been manually changed.


To choose how the grades are aggregated for the totals within categories, you can turn editing on and click on the little editing icon for the category. You can then choose to have means, medians, modes etc.  You can also leave out empty grades and choose other settings.
===Altering the grades using Single View===
There is a new way to enter grades into the grader report using the Single View tab (or listing in the dropdown) under Setup.  (This interface can also be accessed by clicking on the pencil icon at the top of the column by the item name).
The single view interface allows you to enter grades in bulk for a specific grade item or a specific user.  To change a specific grade or all grades, click on the Override checkbox by the specific grade row or use the Override All link to check every row. If you wish to override all grades with a set grade, check the Bulk Insert checkbox and enter the grade that you wish to insert.  You can select whether to fill the grade for just empty grades or for all grades from the dropdown list. 
Click on Save and you will now see in the Grader Report that all grades the specific item/user have been overridden with the grade/grades that you entered.


==Hiding columns or individual grades==
===Hiding columns or individual grades===
Turning on editing then clicking the "Show show/hide icons" link will give you the familiar show/hide eye icon next to each grade and at the top of each column. For more information, read about [[Grade_hiding|grade hiding]].
Turning on editing then clicking the "Show show/hide icons" link will give you the familiar show/hide eye icon next to each grade and at the top of each column. For more information, read about [[Grade_hiding|grade hiding]].


==Recalculating==
===Recalculating===
If you change any part of an assessment e.g. alter the maximum grade for one of the questions in a quiz, you may find that the columns do not yet reflect the change you have made. Click '''Turn editing on''' twice to force the gradebook to re-check.
If you change any part of an assessment e.g. alter the maximum grade for one of the questions in a quiz, you may find that the columns do not yet reflect the change you have made. Click '''Turn editing on''' twice to force the gradebook to re-check.


==Changing the Order of Assignments within Categories==
==Gradebook capabilities==
Assignments are listed across the top in the order they are created.  The order is not affected by the date the assignment is due, the title of the assignment or the ID number.
 
There is just one gradebook capability, [[Capabilities/gradereport/grader:view|View the grader report]], which is allowed for the default roles of manager, teacher and non-editing teacher.
 
==Extending the gradebook==


===Move an individual Grade item or Grade Category===
The Gradebook can be extended in three main ways:
On the "Edit categories and items" page of the gradebook there is a series of icons under the 'Actions' column one of which is a up/down arrow called 'move'. Click on the icon and then click on one of the empty boxes to where you want to move the item to.


===Move a number of Grade items simultaneously===
===1. [https://moodle.org/plugins/browse.php?list=category&id=9 Grade reports]===
On the "Edit categories and items" page of the gradebook, under the 'Select' column tick the check boxes of the grade items you want to move. Now scroll down to the bottom of the page and find the 'Move selected items to' option list. Select the category from the list where you want to move the grade items to.
Which are the main way to view and manipulate grades
* [[LAEGrader report|LAE Grader Report]] Alternative to Grader report that scrolls vertically and horizontally without losing student columns or grade item header rows. Lot of additional enhancements.
* [https://moodle.org/plugins/view.php?plugin=gradereport_updfgrades Upload PDF Grader Report] lets you view assignment grades, comments and lateness in a report


===Other ways of moving grade items===
===2. Grade import plugins===
There is one way you can change the order of display.  Let's say you have an assignment that is in the middle someplace, but you want it on the end of the category.  Edit the assignment to '''uncategorized''' and come back to the Grader report screen.  You will see that the assignment has departed from the category and is Uncategorized.  Then edit the assignment again, returning it to its original category.  Return to the Grader Report screen.  Now the assignment should be on the end of the category.
Which allow data to be imported from external sources


If you have two or more assignments in the wrong place, repeat the process, finishing with the assignment you want to be on the extreme end.
===3. [https://moodle.org/plugins/browse.php?list=category&id=10 Grade export plugins]:===
Which allow you to export grade data for other systems
* [https://moodle.org/plugins/view.php?plugin=gradeexport_pdf PDF document] This is moodle plugin for exporting grades in PDF format. It is developed by using "Moodle PDF library"
* [https://moodle.org/plugins/view.php?plugin=gradeexport_checklist Checklist] This is a grade export plugin which will create an Excel spreadsheet containing all the checkmarks from a single checklist.


==See also==
==See also==
*[[Edit grade calculation]]
*[[Grade preferences]]
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]


Using Moodle forum discussions:
* Join the discussions about gradebook plugins in the [https://moodle.org/mod/forum/view.php?id=2122 Gradebook forum].
*[http://moodle.org/mod/forum/discuss.php?d=87844 What happens in the 1.9 gradebook when students are unenrolled from a course]
* [http://youtu.be/CMXvtFPmd0o?list=PLxcO_MFWQBDdJmqW4tD5qXJ6pPXWTP7GL Gradebook 2.8 screencast]  from Moodle HQ
*[http://moodle.org/mod/forum/discuss.php?d=125266 How to make the grader report narrower]
*[http://youtu.be/ShGv7lwMfm0 Greg Egan - Introduction to grading and the gradebook - iMoot 2013] Excellent clarification of Grader Report, Categories and Items, Scales, Aggregation (especially helpful for accurate overall grades!), Letter Grades, and Rubrics. Outcomes are not covered.
* [https://youtu.be/lWcheVbQe2E The Moodle Gradebook] MoodleBites video on YouTube


[[ca:grade/report/grader/index]]
[[de:Bewertungen]]
[[cs:Celkový přehled]]
[[es:Libro de calificaciones]]
[[es:Informe_calificador]]
[[fr:Carnet de notes]]
[[eu:Kalifikatzailearen_txostena]]
[[ja:評定表]]
[[fr:Rapport de l'évaluateur]]

Latest revision as of 20:29, 19 January 2016

All the grades for each student in a course can be found in the course gradebook, or 'Grader report' in Administration > Course administration > Grades. For an introduction to the gradebook, see the HQ screencast: Where is the Gradebook?

The grader report collects items that have been graded from the various parts of Moodle that are assessed, and allows you to view and change them as well as sort them out into categories and calculate totals in various ways. When you add an assessed item in a Moodle course, the gradebook automatically creates space for the grades it will produce and also adds the grades themselves as they are generated, either by the system or by you.

The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).

Note that various default options for the gradebook are set at system level by the administrator in and can be marked as being overridable by you, or fixed. This means that the options will not always be set up the same way for every user when they see the grader report for the first time.

Hiding settings globally

New settings hide parts of the user interface:

  • Site administration>Grades>General settings: 'Show minimum grade' . If this setting is disabled, the minimum grade will default to zero and cannot be edited.
  • Site administration>Grades>Grade category settings: 'Allow category grades to be manually overridden'. If this setting is disabled, users cannot override category grades.


Scrolling through the gradebook

The gradebook allows for smooth and stable scrolling horizontally and vertically through grades. It uses the whole window, making it accessible on all platforms.( Note: horizontal scrolling is at the bottom of the browser window, and there is no horizontal scrollbar at the top.)

Scrolling in all directions
Using the whole window
newgradereporta.png

Display

Along the top of the grader report are several rows: first the course, then the category, then the columns for each graded activity (for example: Assignment, Quiz, Lesson). Any activities settings which were left "uncategorised" will appear in the general category which is named after the course by default (any category name can be changed).

gradereportcategories.png

You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.

There are three ways that the categories can be displayed:

  • Grades only - without the category totals column
  • Aggregates - Category total column only
  • Full view - grades and the aggregates (the totals column for the category)

Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category;


grades3iconsa.png

Sorting by columns

You can sort by any column. Click the iconsort.png symbol near the top of a column to sort by that column (1 below). This will change the symbol to a single down arrow. Clicking again will sort lowest-to-highest, changing the symbol to an up arrow. The arrows will toggle between these two states until you click on a different column.

You can also access the Single view by clicking the pencil icon next to the arrows (2 below).

iconsgrades.png

You can sort the students by clicking the arrow (1 below), access individual user reports by clicking the icon (2 below) and similar to the grade items you can access Single view by clicking the pencil icon (3 below)

studentsort.png

Searching and filtering the gradebook

If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.

It is also possible to search students by first name and last name:

gradebooksearch.png

Editing

Note: Editing anything in the gradebook refers to editing the grades only and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook. The "Turn editing on" button functions separately from the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities. Roles such as 'non-editing teacher' may only have one or the other.

Altering the grades

You can click "Turn editing on" at the top right to show an edit icon next to each grade. Clicking on the icon will bring up the editing screen for that grade which will allow you to set the grade, its written feedback and a number of other attributes.

Alternatively, you can choose "Quick grading" and "Quick feedback" in 'My preferences' to make the report appear with editable boxes containing each grade, so you can change many at once. This capability can be a real time saver, but make sure to save at reasonable intervals lest a pageful of changes be lost.

Note: If you make changes here, they are then shown highlighted to indicate grades which have been manually changed.

Altering the grades using Single View

There is a new way to enter grades into the grader report using the Single View tab (or listing in the dropdown) under Setup. (This interface can also be accessed by clicking on the pencil icon at the top of the column by the item name). The single view interface allows you to enter grades in bulk for a specific grade item or a specific user. To change a specific grade or all grades, click on the Override checkbox by the specific grade row or use the Override All link to check every row. If you wish to override all grades with a set grade, check the Bulk Insert checkbox and enter the grade that you wish to insert. You can select whether to fill the grade for just empty grades or for all grades from the dropdown list. Click on Save and you will now see in the Grader Report that all grades the specific item/user have been overridden with the grade/grades that you entered.

Hiding columns or individual grades

Turning on editing then clicking the "Show show/hide icons" link will give you the familiar show/hide eye icon next to each grade and at the top of each column. For more information, read about grade hiding.

Recalculating

If you change any part of an assessment e.g. alter the maximum grade for one of the questions in a quiz, you may find that the columns do not yet reflect the change you have made. Click Turn editing on twice to force the gradebook to re-check.

Gradebook capabilities

There is just one gradebook capability, View the grader report, which is allowed for the default roles of manager, teacher and non-editing teacher.

Extending the gradebook

The Gradebook can be extended in three main ways:

1. Grade reports

Which are the main way to view and manipulate grades

  • LAE Grader Report Alternative to Grader report that scrolls vertically and horizontally without losing student columns or grade item header rows. Lot of additional enhancements.
  • Upload PDF Grader Report lets you view assignment grades, comments and lateness in a report

2. Grade import plugins

Which allow data to be imported from external sources

3. Grade export plugins:

Which allow you to export grade data for other systems

  • PDF document This is moodle plugin for exporting grades in PDF format. It is developed by using "Moodle PDF library"
  • Checklist This is a grade export plugin which will create an Excel spreadsheet containing all the checkmarks from a single checklist.

See also