Note: You are currently viewing documentation for Moodle 3.3. Up-to-date documentation for the latest stable version of Moodle is probably available here: Grade items.

Grade items: Difference between revisions

From MoodleDocs
(removing outdated info)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Managing grades}}
{{Managing grades}}
{{Improve}}
A grade item is a unit (typically an activity) where course participants are assessed through a grade or mark.
A grade item is a unit (typically an activity) where course participants are assessed through a grade or mark.
As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and [[Grade_export|exports]].
As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and [[Grade_export|exports]].
Line 12: Line 11:
#The [[Grade_categories|grade category]]
#The [[Grade_categories|grade category]]
#The [[Grades|grade]]
#The [[Grades|grade]]


Grade items are represented by columns in the [[Grader_report | grader report]].
Grade items are represented by columns in the [[Grader_report | grader report]].
Line 19: Line 17:


== Activity-based grade items ==
== Activity-based grade items ==
[[Image:Edit grade item.png|right|thumb|Editing a grade item]]
[[Image:editingradeitem.png|right|thumb|Editing a grade item]]
Modules that include a form of grading use the [[Development:Grades#API_for_communication_with_modules.2Fblocks|Gradebook API]] to generate a matching grade item, and to communicate their grades to the gradebook. The generated grade item can later be edited from within the gradebook interface (Course -> Grades -> Edit Categories and items -> Edit (hand icon) grade item), as seen in the screenshot to the right, but several of its settings will be 'frozen', only changeable from the activity module's interface. These are listed and explained below in the manual grade items section.
A number of activities such as [[Assignment]], [[Workshop]], [[Lesson]], [[Quiz]] and others  communicate their grades to the gradebook. The generated grade item can later be changed directly from Course administration>Grades, but this will then freeze it in the activity itself; so, a teacher who has edited an assignment grade in the gradebook will not be able to change it from the assignment, unless they unlock it in the gradebook.


Here is a list of the settings that can be edited for an activity-based grade item:
Here is a list of the settings that can be edited for an activity-based grade item:


*'''Item name''' The name given to this item, for example the assignment name
*'''Item info''': General information about the grade item. Optional.
*'''Item info''': General information about the grade item. Optional.
*'''Grade to pass''': Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook.  
*'''Grade to pass''': Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook. (The Grade to pass may also be specified from activity set up pages.)
*'''Grade display type''': See the [[Grade_item_settings#Grade_display_type | Grade display type doc]]
*'''Grade type''': There are 4 grade types:
#None - No grading possible
#Value - A numerical value with a maximum and minimum
#Scale - An item in a list - see [[Scales]]
#Text - Feedback only
Only value and scale grade types may be aggregated. The grade type for an activity-based grade item is set on the activity settings page.
 
*'''Overall decimal points''': This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places.  
*'''Overall decimal points''': This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places.  
*'''Multiplicator''': Factor by which all grades for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100.  
*'''Multiplicator''': Factor by which all grade for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100.  
*'''Offset''': Number that will be added to every grade for this grade item, after the Multiplicator is applied. (Can be a negative number.)
*'''Offset''': Number that will be added to every grade for this grade item, '''after''' the Multiplicator is applied. (Can be a negative number.)
*'''Hidden''': Whether this grade item should be hidden from students.
*'''Hidden''': Whether this grade item should be hidden from students.
*'''Hidden until''': An optional date after which the grade item will no longer be hidden (i.e. a grades release date)
*'''Hidden until''': An optional date after which the grade item will no longer be hidden (i.e. a grades release date)
Line 35: Line 40:
*'''Locked after''': A date after which the locking will be effective, usually after the grades release date.
*'''Locked after''': A date after which the locking will be effective, usually after the grades release date.


== Grade outcome items ==
== Outcome items ==
[[Image:grade_outcome_item.png|right|thumb|Editing a grade outcome item]]
 
An outcome item is in most respects the same thing as a grade item. The main difference between the two is that the purpose of a outcome item is to rate students on a particular outcome/competency/goal, whereas grade items are used for grading students, usually with the intention of aggregating the results as a measure of the student's performance in the course activities.
 
An outcome item is always linked with an outcome, which itself is linked to a [[Scales|scale]]. The scale may represent a quantitative measure, its values being arranged from lowest to highest; or it may represent a qualitative measure, in which the order of the scale values is irrelevant. The first type can be aggregated, but the second type shouldn't (we wouldn't want to fail a student because her favourite colour is "blue"!).
 
An outcome item may optionally be linked to an activity. This activity may or may not appear in the gradebook (for example, a wiki is usually not graded, so does not appear). Linking an outcome item with an activity creates a grade item with the icon of the linked activity, but there is no other way to see which activity it is linked with. For this reason, it is a good idea to include the activity name in the name of the outcome item (e.g. Wiki 1: Participation).
 
These can either be generated by the creation of a new activity module (by selecting [[Outcomes]] in the module creation form), or manually created like manual grade items. A grade outcome item uses a course outcome as its grading type, so such an outcome must be made available at the course level before a grade outcome item can be manually created.
These can either be generated by the creation of a new activity module (by selecting [[Outcomes]] in the module creation form), or manually created like manual grade items. A grade outcome item uses a course outcome as its grading type, so such an outcome must be made available at the course level before a grade outcome item can be manually created.
Grade outcome items can optionally be linked with an activity module. This is done automatically when a grade outcome item is generated by the creation of an activity module in which outcomes were selected. In this scenario, a grade category is also created and named after the activity module, and the grade item and grade outcome items are created as children of that category.


The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:
The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:
Line 47: Line 56:


== Manual grade items ==
== Manual grade items ==
[[Image:manual_item.png|right|thumb|Editing a manual grade item]]
[[File:editingmanualgrades.png|right|thumb|Editing a manual grade item]]
These grade items are created manually through the "Edit Categories and Items" page. The "Add grade item" button is clicked, and the form appears. Several options are available here which are normally automatically filled out by the activity module creating an activity-based grade item:
These grade items are created manually from ''Course administration > Gradebook setup''. The "Add grade item" button is clicked, and the form appears. Several options are available here;


*'''Item name''': The display name of your grade item
*'''Item name''': The display name of your grade item
Line 57: Line 66:
*'''Minimum grade''': The minimum grade that can be given (for scales: 0)
*'''Minimum grade''': The minimum grade that can be given (for scales: 0)


Conversely, two of the settings found in the form for activity-based grade items are absent from this form:
Manual grade items are recognised in the Grader report by their icon like a pencil:
*Multiplicator
 
*Offset
[[File:manualgradeitem2.png]]
 
Note that this icon is not clickable; to edit the manual grade item you have to click the edit icon just below it.
 
==Grade item settings==
 
===Site defaults===
 
Grade item settings, accessed from ''Administration > Grades > Grade item settings,'' are the various settings that the administrator is able to edit for the grader report used by teachers. These settings will change what items are displayed for each grade. As administrator, you would turn on or off various settings and the teacher would input the actual data.
 
[[Image:newgradeitemsettings.png|thumb|center|Grade item settings screen]]
 
===Grade display type===
 
This is the type of grade that is to be shown for each individual grade. Different school districts use different grading systems so this can be changed to suit your district.
 
* Real - Grade from minimum to maximum range indicating total points received. Default from 0-100 but may be arbitrary.
* Percentage - Grade from 0 - 100% indicating the total points received divided by maximum possible amount times 100.
* [[Grade letters|Letter]]- Grade in the form of a letter representing a range of percentages.
 
===Overall decimal points===
 
This setting is for display purposes only. Grade calculations are made with an accuracy of 5 decimal places and grade letters, if used, are assigned accordingly.
 
If rounding of grades in [[Grade calculations|grade calculations]] is required, the round(number, count) function may be used.
 
===Advanced grade item options===
You can determine here what will be displayed when a teacher clicks on the 'Show more' link.
These features can be set or viewed:


==See also==
{| style="width:75%" border="0"
*[[Grade item settings]] - for administrators
|
* Item info
* ID Number
* Grade Type
* Scale
* Minimum Grade
* Maximum Grade
||
* Grade to pass
* Offset
* Multiplicator
* Grade display type
* Overall decimal places
||
* Hidden
* Hidden until
* Locked
* Locked after
|-
|}


[[ca:grade/edit/tree/item]]
[[ca:grade/edit/tree/item]]
[[cs:Položky hodnocení]]
[[de:Bewertungsaspekte]]
[[de:Bewertungsaspekte]]
[[es:Ítems de calificación]]
[[es:Ítems de calificación]]
[[fr:Éléments de note]]
[[fr:Éléments de note]]
[[ja:評定項目]]
[[ja:評定項目]]

Latest revision as of 10:42, 10 September 2016

A grade item is a unit (typically an activity) where course participants are assessed through a grade or mark. As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and exports.

Grade items may refer to course activities (e.g. a quiz, an assignment etc.), Outcomes or manual grades.

Grade items and gradebook

The three building blocks of the Gradebook are:

  1. The grade item
  2. The grade category
  3. The grade

Grade items are represented by columns in the grader report.

Within a category, a grade summary is also a grade item itself. Summary grade items for a category can show up in reports, and can be used in the calculation of the grade for the parent category.

Activity-based grade items

Editing a grade item

A number of activities such as Assignment, Workshop, Lesson, Quiz and others communicate their grades to the gradebook. The generated grade item can later be changed directly from Course administration>Grades, but this will then freeze it in the activity itself; so, a teacher who has edited an assignment grade in the gradebook will not be able to change it from the assignment, unless they unlock it in the gradebook.

Here is a list of the settings that can be edited for an activity-based grade item:

  • Item name The name given to this item, for example the assignment name
  • Item info: General information about the grade item. Optional.
  • Grade to pass: Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook. (The Grade to pass may also be specified from activity set up pages.)
  • Grade type: There are 4 grade types:
  1. None - No grading possible
  2. Value - A numerical value with a maximum and minimum
  3. Scale - An item in a list - see Scales
  4. Text - Feedback only

Only value and scale grade types may be aggregated. The grade type for an activity-based grade item is set on the activity settings page.

  • Overall decimal points: This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places.
  • Multiplicator: Factor by which all grade for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100.
  • Offset: Number that will be added to every grade for this grade item, after the Multiplicator is applied. (Can be a negative number.)
  • Hidden: Whether this grade item should be hidden from students.
  • Hidden until: An optional date after which the grade item will no longer be hidden (i.e. a grades release date)
  • Locked: Whether or not to lock this grade item. A locked grade item doesn't accept changes to its settings or grades from its related module.
  • Locked after: A date after which the locking will be effective, usually after the grades release date.

Outcome items

An outcome item is in most respects the same thing as a grade item. The main difference between the two is that the purpose of a outcome item is to rate students on a particular outcome/competency/goal, whereas grade items are used for grading students, usually with the intention of aggregating the results as a measure of the student's performance in the course activities.

An outcome item is always linked with an outcome, which itself is linked to a scale. The scale may represent a quantitative measure, its values being arranged from lowest to highest; or it may represent a qualitative measure, in which the order of the scale values is irrelevant. The first type can be aggregated, but the second type shouldn't (we wouldn't want to fail a student because her favourite colour is "blue"!).

An outcome item may optionally be linked to an activity. This activity may or may not appear in the gradebook (for example, a wiki is usually not graded, so does not appear). Linking an outcome item with an activity creates a grade item with the icon of the linked activity, but there is no other way to see which activity it is linked with. For this reason, it is a good idea to include the activity name in the name of the outcome item (e.g. Wiki 1: Participation).

These can either be generated by the creation of a new activity module (by selecting Outcomes in the module creation form), or manually created like manual grade items. A grade outcome item uses a course outcome as its grading type, so such an outcome must be made available at the course level before a grade outcome item can be manually created.

The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:

  • Outcome: The course outcome represented by this item
  • Linked activity: The optional activity module to which this item will be linked

Manual grade items

Editing a manual grade item

These grade items are created manually from Course administration > Gradebook setup. The "Add grade item" button is clicked, and the form appears. Several options are available here;

  • Item name: The display name of your grade item
  • ID Number: An arbitrary string of characters used to refer to this grade item in Formulas. If set, it must be unique.
  • Grade type: The type of grade: None (no grading possible), Value (a numerical value), Scale (an item in a list) or Text (arbitrary text).
  • Scale: Which scale to use for grading: available only when the Scale grade type is selected.
  • Maximum grade: The maximum grade that can be given (for scales: the number of items in the scale - 1)
  • Minimum grade: The minimum grade that can be given (for scales: 0)

Manual grade items are recognised in the Grader report by their icon like a pencil:

manualgradeitem2.png

Note that this icon is not clickable; to edit the manual grade item you have to click the edit icon just below it.

Grade item settings

Site defaults

Grade item settings, accessed from Administration > Grades > Grade item settings, are the various settings that the administrator is able to edit for the grader report used by teachers. These settings will change what items are displayed for each grade. As administrator, you would turn on or off various settings and the teacher would input the actual data.

Grade item settings screen

Grade display type

This is the type of grade that is to be shown for each individual grade. Different school districts use different grading systems so this can be changed to suit your district.

  • Real - Grade from minimum to maximum range indicating total points received. Default from 0-100 but may be arbitrary.
  • Percentage - Grade from 0 - 100% indicating the total points received divided by maximum possible amount times 100.
  • Letter- Grade in the form of a letter representing a range of percentages.

Overall decimal points

This setting is for display purposes only. Grade calculations are made with an accuracy of 5 decimal places and grade letters, if used, are assigned accordingly.

If rounding of grades in grade calculations is required, the round(number, count) function may be used.

Advanced grade item options

You can determine here what will be displayed when a teacher clicks on the 'Show more' link. These features can be set or viewed:

  • Item info
  • ID Number
  • Grade Type
  • Scale
  • Minimum Grade
  • Maximum Grade
  • Grade to pass
  • Offset
  • Multiplicator
  • Grade display type
  • Overall decimal places
  • Hidden
  • Hidden until
  • Locked
  • Locked after