- 21 Jun 2022
- 2 minutes to read
Managing course completion uploads
- Updated on 21 Jun 2022
- 2 minutes to read
In Totara you can upload course completions using a CSV file.
An example file is shown below:
You can alternatively upload CSV files via a directory on the server (see Using a directory on the server).
CSV grade format
Select the grade format used in the CSV file:
- Real: Grade as points
- Percentage: Grade as a percentage
Take an example of a course with three activities, so the maximum grade for the course is 300, and upload a course completion CSV file with a grade of 60. The system reports the grade as follows, depending on how the grade column is handled in a report:
- Real: 60 points or 20.0%
- Percentage: 180 points or 60.0%
Note that both current learning and previous completions in the Record of Learning page display a grade as percentage.
Override current course completions
When uploading a course completion CSV file, the system looks up an existing completion record and compares its completion date against the incoming completion date.
Before existing completiondate
After existing completiondate
Identical to existing completiondate
No previous completions
In Totara 16
If more recent
Using a directory on the server
If you'd like users to be able import completion data form a file already uploaded to the server. They can follow the link Alternatively upload CSV files via a directory on the server at the bottom of the Upload Completion Records page. The user will need to know the full path to the file to be imported. Be aware that this file will be deleted after import.
In order to use this functionality, you will need to add a value for $CFG->completionimportdir to the config.php file. This should be set to the beginning of the path to the uploaded files. The path that the user enters in the form must begin with this value. Be aware that the user would also be able to enter the path to any file that begins with the value given in the config setting and that file would subsequently be deleted.
Reset report data
From time to time it may be useful to clean up the course and certification upload logs, especially if you are having problems with uploading new records. You can clean up your records by going to Courses > Upload Completion Records > Reset Report data from the Administration block. Use the check boxes to select Reset course report data and/or Reset certification report data.
You can also set up a scheduled task for clearing out the course/certification report data by going to Quick-access menu > Server > Scheduled tasks.
Resetting completion records
Once a record of prior completion has been uploaded for a user they will need to have this record archived before they can attempt the course again, just as with any completion record. You can find more information about this on the Course completion archive page.
© Copyright 2023 Totara Learning Solutions. All rights reserved. Some content originally obtained via GPLv3 license and continues to be available under GPLv3. All other content is the sole copyright of Totara Learning Solutions.