• Each line of the file contains one record.
• The data of each record are separated by a comma (or another separator character, so the tool configuration must be checked).
• The first record contains the names of the fields that make up the records, and thus determines the structure of the rest of the file.

• Only the fields marked in bold are mandatory.
• As course building can use several strategies (restore, default creation), the rules differ depending on the case.

In general:

• if you provide a template corresponding to a complete course archive, this archive contains all the values needed to build the course. The only field you will probably need to care about in addition is the category field, in order to place the generated course in a suitable location.
• if you do not provide a template, then some attributes will be useful to properly define the state of the course to create, otherwise the “default” values (Site administration > courses >) apply.

• The category can be given as a “path” separated by slashes (“/”). Missing categories from the root will be created as needed.
• If the category is given as an integer, it is the category Id and this category MUST exist.
• Commas separating the data must be encoded; the script will automatically interpret them as commas.
• For boolean data, use 0 for false and 1 for true.

The course can be created from a template. This template designates either:

• the short name or shortname of a course of the platform with a saved archive WITHOUT user DATA.
• If the content of the template field cannot be matched to an existing course, then it can designate a physical access path to a compatible Moodle archive (.mbz) stored locally on the server.

Back to the component index - Back to catalogue