Grade export: Difference between revisions

From MoodleDocs
(→‎Export setting page: more edit instructions)
 
(37 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{Grades}}
{{Grades}}Grades can be exported to Excel spreadsheet, OpenDocument spreadsheet, plain text file or XML file, or published via a URL.
Grades can be exported in several formats. In the course administration block, select grades. In the course grade window, change the view pull down menu to the best export format.  This will bring up an export setting page.


==Export setting page==
''Grade export is NOT intended for students.''
[[Image:Grade export.png|thumb|center|Moodle Version 1.x Export settings page: Open Office spreadsheet format]]
 
# Confirm the export format - Excel spreadsheet, OpenDocument spreadsheet, plain text file or XML file - using the view drop down menu, it can be changed on the settings page
==How to export grades==
#If the course uses groups, select whether to export grades for all participants or for a particular group via the drop down menu at the top of the page
[[Image:gradexportupdated.png|thumb|Grade export]]
# Each format may have slightly different settings. There are 3 sections of settings.
To export grades from the gradebook:
## Options - Grade type, decimal point, lines displayed in preview and feedback export
# Choose an export format from the gradebook dropdown menu or in the Administration block under ''Gradebook setup > Export''.
## Publishing - settings who can see the data without logging into the Moodlesite.
# Set options as required.
## Grade items to be included - a long list of options. Note that ID numbers are required for all activities for XML file export. An ID number field can be found in the common module settings for each activity
# If the course uses groups, select whether to export grades for all participants or for a particular group.
# Click the submit button
# Select the grade items to be included. Note that ID numbers are required for all activities for XML file export. An ID number field can be found in the common module settings for each activity.
# Preview the data
# Click the ''Download'' button.
# Click the download button.
 
# Save or open the file
==XML file export==
 
To export grades to XML file, you need to ensure that:
* Users have ID numbers (an optional field in the user profile)
* Activities have ID numbers (an optional field in the common module settings)
 
==Export new or updated grades only==
 
To export only new or updated grades you need to enable '''XML File''' in ''Site administration > Grades > General settings > Primary grade export methods (gradeexport)''.
 
After this setting has been enabled, the XML File option will then set and use a "last exported" field for every grade. The result will export the records with the <state> tag being identified as new or regraded.
 
This means the report will track the last exported date. If you export and then try again, it will not show any results because there are no new or updated grades since the last export.


==Default grade export settings==
==Default grade export settings==


The grade export display type and grade export decimal points site-wide defaults may be set by an administrator in ''Administration > Grades > [[General grade settings|Grade settings]]''.
The grade export display type and grade export decimal points site-wide defaults may be set by an administrator in ''Site administration > Grades > [[General grade settings|General settings]]''.
 
==User profile fields export==
 
An administrator can specify user profile fields and custom profile fields to be included in the grade export in ''Site administration > Grades > General settings''.


==Grade publishing==
==Grade publishing==
[[Image:Grade publishing settings.png|thumb|left|Grade publishing settings]]
[[File:grade publishing options.png|thumb|Grade publishing options]]
Grade publishing is a way of importing and exporting grades via a URL without being logged in to Moodle. Grade publishing is intended for administrators only, due to the security implications.
Grade publishing is a way of importing and exporting grades via a URL without being logged in to Moodle. Grade publishing is intended for administrators only, due to the security implications.


Grade publishing is disabled by default. It can be enabled by an administrator by checking the gradepublishing box in ''Administration > Grades > [[General grade settings|Grade settings]]''. Users with grade publishing capabilities (normally administrators only) are then provided with grade export publishing settings.
Grade publishing is disabled by default. It can be enabled by an administrator by checking the gradepublishing box in ''Administration > Site administration > Grades > [[General grade settings|General settings]]''. Users with grade publishing capabilities (normally managers only) will then be able to access the grade publishing options.
 
To publish grades from the gradebook:
# Follow the first four steps above for 'How to export grades'.
# In the grade publishing options, choose 'Create a new user key' or select a key generated previously.
# Click the export button. A download URL will then be displayed.
 
==Grade export capabilities==
 
* [[Capabilities/gradeexport/ods:publish|Publish ODS grade export]]
* [[Capabilities/gradeexport/ods:view|Use OpenDocument grade export]]
* [[Capabilities/gradeexport/txt:publish|Publish text file grade export]]
* [[Capabilities/gradeexport/txt:view|Use text file grade export]]
* [[Capabilities/gradeexport/xls:publish|Publish XLS grade export]]
* [[Capabilities/gradeexport/xls:view|Use Excel grade export]]
* [[Capabilities/gradeexport/xml:publish|Publish XML grade export]]
* [[Capabilities/gradeexport/xml:view|Use XML grade export]]
 
==Tips and tricks==
*Export grades in a spreadsheet format.  Then copy and paste that information into another file that has  worksheet ("raw grades"). Create other worksheets which are custom reports which take their data from "raw grades". This works if graded activities are '''not''' moved around to different positions in the course. This allows you to create a standard printed report(s). For example a compact landscape report of all students and all grades for each activity, a report of just quizes, another of lessons, another of assignments. A pivot table of students by scores, generated from a report worksheet, which gets its data from the raw data.
*Mailmerge exported grades into custom documents.  For example, a document that is given to a department to file as a proof of training, with scores for every subject quiz.


==See also==
==See also==


*[http://www.youtube.com/watch?v=yZcbN_7p2zI Video showing how to exporting grades in Moodle 1.9]
*[[:dev:Gradebook export]] developer documentation
* MDL-44923 for background information about the setting 'Export new or updated grades only'


[[de:Bewertungen exportieren]]
[[es:Exportar_calificaciones]]
[[fr:Exportation des notes]]
[[fr:Exportation des notes]]
[[it:Esportare valutazioni]]
[[ja:評定のエクスポート]]

Latest revision as of 19:00, 19 March 2019

Grades can be exported to Excel spreadsheet, OpenDocument spreadsheet, plain text file or XML file, or published via a URL.

Grade export is NOT intended for students.

How to export grades

Grade export

To export grades from the gradebook:

  1. Choose an export format from the gradebook dropdown menu or in the Administration block under Gradebook setup > Export.
  2. Set options as required.
  3. If the course uses groups, select whether to export grades for all participants or for a particular group.
  4. Select the grade items to be included. Note that ID numbers are required for all activities for XML file export. An ID number field can be found in the common module settings for each activity.
  5. Click the Download button.

XML file export

To export grades to XML file, you need to ensure that:

  • Users have ID numbers (an optional field in the user profile)
  • Activities have ID numbers (an optional field in the common module settings)

Export new or updated grades only

To export only new or updated grades you need to enable XML File in Site administration > Grades > General settings > Primary grade export methods (gradeexport).

After this setting has been enabled, the XML File option will then set and use a "last exported" field for every grade. The result will export the records with the <state> tag being identified as new or regraded.

This means the report will track the last exported date. If you export and then try again, it will not show any results because there are no new or updated grades since the last export.

Default grade export settings

The grade export display type and grade export decimal points site-wide defaults may be set by an administrator in Site administration > Grades > General settings.

User profile fields export

An administrator can specify user profile fields and custom profile fields to be included in the grade export in Site administration > Grades > General settings.

Grade publishing

Grade publishing options

Grade publishing is a way of importing and exporting grades via a URL without being logged in to Moodle. Grade publishing is intended for administrators only, due to the security implications.

Grade publishing is disabled by default. It can be enabled by an administrator by checking the gradepublishing box in Administration > Site administration > Grades > General settings. Users with grade publishing capabilities (normally managers only) will then be able to access the grade publishing options.

To publish grades from the gradebook:

  1. Follow the first four steps above for 'How to export grades'.
  2. In the grade publishing options, choose 'Create a new user key' or select a key generated previously.
  3. Click the export button. A download URL will then be displayed.

Grade export capabilities

Tips and tricks

  • Export grades in a spreadsheet format. Then copy and paste that information into another file that has worksheet ("raw grades"). Create other worksheets which are custom reports which take their data from "raw grades". This works if graded activities are not moved around to different positions in the course. This allows you to create a standard printed report(s). For example a compact landscape report of all students and all grades for each activity, a report of just quizes, another of lessons, another of assignments. A pivot table of students by scores, generated from a report worksheet, which gets its data from the raw data.
  • Mailmerge exported grades into custom documents. For example, a document that is given to a department to file as a proof of training, with scores for every subject quiz.

See also