Note: You are currently viewing documentation for Moodle 2.6. Up-to-date documentation for the latest stable version of Moodle may be available here: Grade export.

Grade export: Difference between revisions

From MoodleDocs
(Reformat page, Create intro, add How to section)
 
(20 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Grades}}
{{Grades}}Grades can be exported to Excel spreadsheet, OpenDocument spreadsheet, plain text file or XML file.
Grades can be exported as a Excel spreadsheets OpenDocument spreadsheet, plain text file or XML file formats.
 
''Grade export is NOT intended for students.''


==How to export grades==
==How to export grades==
Line 10: Line 11:
# Click the submit button.
# Click the submit button.
# After previewing the data on the following page, click the download button.
# After previewing the data on the following page, 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 ''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==
 
In Moodle 2.4 onwards, 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==
Line 19: Line 38:
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 ''Settings > Site administration > Grades > [[General grade settings|General settings]]''. Users with grade publishing capabilities (normally administrators only) are then provided with grade export publishing settings.
 
To determine the URL for exporting grades, follow an export format link e.g. XML file, select a user key or 'Create a new key' to generate a new one, select other options as required, then click the Submit button. A download URL e.g. <code><nowiki>http://qa.moodle.net/grade/export/xml/dump.php?id=2&groupid=&itemids=-1&export_letters=&export_feedback=0&updatedgradesonly=0&displaytype=1&decimalpoints=2&key=ed18257297c48d15096dd49c1d09ac06</nowiki></code> will then be provided.


==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==
==Tips and tricks==
*Export grades in a spreadsheet format.  Then copy and paste that information into a 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.
*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.  
*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
 
*[http://www.youtube.com/watch?v=yZcbN_7p2zI Video showing how to export grades in Moodle 1.9]


[[ca:grade/export/xml/index]]
[[es:Exportar_calificaciones]]
[[fr:Exportation des notes]]
[[fr:Exportation des notes]]
[[ja:評定のエクスポート]]
[[de:Bewertungen exportieren]]

Latest revision as of 07:13, 7 August 2014

Grades can be exported to Excel spreadsheet, OpenDocument spreadsheet, plain text file or XML file.

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.
  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 submit button.
  6. After previewing the data on the following page, 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 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

In Moodle 2.4 onwards, 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 settings

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 Settings > Site administration > Grades > General settings. Users with grade publishing capabilities (normally administrators only) are then provided with grade export publishing settings.

To determine the URL for exporting grades, follow an export format link e.g. XML file, select a user key or 'Create a new key' to generate a new one, select other options as required, then click the Submit button. A download URL e.g. http://qa.moodle.net/grade/export/xml/dump.php?id=2&groupid=&itemids=-1&export_letters=&export_feedback=0&updatedgradesonly=0&displaytype=1&decimalpoints=2&key=ed18257297c48d15096dd49c1d09ac06 will then be provided.

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