Grader report: Difference between revisions

Latest revision as of 15:40, 5 December 2024

All the grades for each student in a course can be found in the course gradebook, or 'Grader report', accessed from the Course navigation.

The following screencast gives a general overview of the Gradebook.

Overview of 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

Admin 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 (the minimum grade can never 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.

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

From the three dots next to a category name you can select to

show grades only
show grade totals
show grades and totals.

Collapse columns by clicking the three dots next to a grade item. Collapsed columns show with a + sign. Click the + to expand them again one at a time. From the Collapsed columns link on the right, quickly see and search how many columns are collapsed.

The three dots next to a grade item also allows you to:

switch to Single view.
change the order (ascending/descending).

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

Searching and filtering the Grader report

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.
You can search easily by starting to type the first few letters of the name of the person (or email or ID number or other user identity item) or group you wish to find.

Records per page

At the bottom of the Grader report, you can select to show 20, 100 or All students on the page.

If you change the setting, it is remembered and applied to the Grader report in all your other courses. If there are more than 5000 students, then All will show 5000, with pagination to show the rest.

Viewing and editing grades

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.

Viewing Assignment feedback

If you have a given feedback to a learner in an assignment, an asterisk icon will display. Click the three dots in that column to view the feedback in a modal window.

Altering the grades

You can click "Turn editing on" at the top right to enter grades directly in the grader report. When you are done, click 'Save changes'. From the cell actions menu (...) you can also follow the link 'Edit grade' to set the grade, its written feedback and a number of other attributes.

Note: If you enter grades directly in the grader report, they are then shown with an overridden icon (box with pencil) to indicate grades which have been manually changed.

Altering the grades using Single view

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 action to check every row. If you wish to override all grades with a set grade, select Bulk insert grades from the Actions menu 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.

Tip: You can move between grades in Single view using Ctrl+arrow keys.

Hiding columns or individual grades

Clicking the three dots next to a grade item will give you the option to hide or lock that item (along with options to edit it and view the grade analysis).

Note that visibility of quiz grades is controlled by the quiz settings (in the Review options section).

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:

Grade reports
Grade import plugins
Grade export plugins

@@ Line 2: / Line 2: @@
 All the grades for each student in a course can be found in the course gradebook, or 'Grader report', accessed from the Course navigation.
-{{MediaPlayer | url = https://youtu.be/7DuOoIenXTM | desc = Overview of the gradebook}}
+The following screencast gives a general overview of the Gradebook.
+{{MediaPlayer | url = https://youtu.be/pirrXF0py1A?si=PhoLFNwzOYDTJj1g | desc = Overview of the gradebook}}
-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.
+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.
 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).
@@ Line 13: / Line 15: @@
 ==Hiding settings globally==
-New settings hide parts of the user interface:
+Admin 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 (the minimum grade can never be edited).
@@ Line 22: / Line 24: @@
 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).
-[[Image:gradereportcategories.png|center|thumb|600px]]
+[[Image:GraderReport42.png|600px|center|thumb]]
-You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.
+From the three dots next to a category name you can select to
+*show grades only
+*show grade totals
+*show grades and totals.
-There are three ways that the categories can be displayed:
+[[File:categorydots.png|200px|center]]
-* Grades only - without the category totals column
+Collapse columns by clicking the three dots next to a grade item. Collapsed columns show with a  + sign. Click the + to expand them again one at a time.
-* Aggregates - Category total column only
+From the Collapsed columns link on the right, quickly see and search how many columns are collapsed.
-* 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;
+[[File:collapsedcolumnssearch.png|250px|center]]
+The three dots next to a grade item also allows you to:
+* switch to Single view.
+* change the order (ascending/descending).
+[[File:gradeitemthreedots.png|300px|center]]
-[[Image:grades3iconsa.png|thumb|500px|center]]
 ===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.)
+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|center|Scrolling in all directions]]
-| [[File:scrolling28a.png|thumb|500px|Scrolling in all directions]]
-| [[File:wholewindow.png|thumb|500px|Using the whole window]]
-|}
-[[File:newgradereporta.png|thumb|600px|center]]
+===Searching and filtering the Grader report===
-===Sorting by columns===
+*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.
+*You can search easily by starting to type the first few letters of the name of the person (or email or ID number or other user identity item) or group you wish to find.
-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.
+[[File:Graderreportsearch.png|thumb|400px|center]]
-You can also access the [[Single view]] by clicking the pencil icon next to the arrows (2 below).
+===Records per page===
+At the bottom of the Grader report, you can select to show 20, 100 or All students on the page.
-[[File:iconsgrades.png]]
+If you change the setting, it is remembered and applied to the Grader report in all your other courses. If there are more than 5000 students, then All will show 5000, with pagination to show the rest.
-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)
+==Viewing and editing grades==
-[[File:studentsort.png]]
+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.
-===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:
-[[File:gradebooksearch.png]]
-==Editing==
+=== Viewing Assignment feedback ===
-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.
+*If you have a given feedback to a learner in an assignment, an asterisk icon will display. Click the three dots in that column to view the feedback in a modal window.
+[[File:feedback12.png|center]]
 ===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.
+You can click "Turn editing on"  at the top right to enter grades directly in the grader report. When you are done, click 'Save changes'.  From the cell actions menu (...) you can also follow the link 'Edit grade' 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 enter grades directly in the grader report, they are then shown with an overridden icon (box with pencil) to indicate grades which have been manually changed.
-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===
+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 action to check every row.  If you wish to override all grades with a set grade, select Bulk insert grades from the Actions menu 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.
-===Altering the grades using Single View===
+Tip: You can move between grades in Single view using Ctrl+arrow keys.
-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|grade hiding]].
+Clicking the three dots next to a grade item will give you the option to hide or lock that item (along with options to edit it and view the grade analysis).
+'''Note that visibility of quiz grades is controlled by the quiz settings''' (in the Review options section).
 ===Recalculating===

Documentation