Note: You are currently viewing documentation for Moodle 2.7. Up-to-date documentation for the latest stable version of Moodle may be available here: Flat file.
Location: Flat file edit settings link in Site administration > Plugins > Enrolments > Manage enrol plugins
A flat file allows bulk enrolment management (enrol or unenrol) of existing users in existing courses. The file is read one time by Moodle then erased. The file is located in the moodle file structure as a text file and Cron provides the timing when it is read.
The site administrator should edit the settings for a flat file if it is enabled.
You should specify an absolute path for the upload file (eg /var/moodledata/enrolments.txt) where it can be read and modified by the webserver process. The file is automatically deleted after processing.
Make sure, you save the file (for example in a text editor) with the same encoding.
You can choose to have an email sent to notify the Administrator, Teachers and/or students when the file has been processed.
- "Unenrol user from course" When the user disappears from the external source, the enrolment is completely removed and all the roles removed. This means some user data and settings are purged from course during course unenrolment (that usually include grades, activity attempts, etc.)
- "Keep user enrolled" When the user disappears from the external source, the enrolment is kept as is, and the user is still able to enter the course and perform activities, access resources, etc. It's a "do nothing" option.
- "Disable course enrolment and remove roles" When the user disappears from the external source, the enrolment is suspended and roles assigned by enrol instance are removed. Please note that user may "disappear" from gradebook and other areas.
Flat file structure
The file should be structured with the action, role, user ID number, and course ID number. Optionally a start time and end time can be added as additional fields.
add, student, 5, CF101 add, teacher, 6, CF101 add, teacheredit, 7, CF101 del, student, 8, CF101 del, student, 17, CF101 add, student, 21, CF101, 1091115000, 1091215000
Using Moodle forum discussions: