Tool sync : Course creation file format

Introduction

Le format de fichier est désormais adapté à Moodle 2 pour cette nouvelle version.

chaque ligne du fichier contient un enregistrement. les données de chaque enregistrement sont séparées par une virgule (ou un autre caractère de séparation, la configuration de l'outil doit être vérifiée). le premier enregistrement contient le nom des champs qui composent les enregistrements, et détermine ainsi la structure de la suite du fichier.

Champ	Valeur
category	Forward?Slash-Delimited Category “Path” String (new categories are created as necessary) OR Integer Database Category ID
cost	String(10)
format	String('social','topics','weeks', …)
fullname*	String(254)
groupmode	0=NOGROUPS,1=SEPARATEGROUPS,2=VISIBLEGROUPS
groupmodeforce	0=FALSE,1=TRUE
guest	0=NO,1=YES
self	0=NO, 1=YES
idnumber	String(100)
lang	String(10) as lowercase 2 letters lang code
maxbytes	Integer(Site Max)
newsitems	Integer(10)
shortname*	String(15)
showgrades	0=FALSE,1=TRUE
showreports	0=FALSE,1=TRUE
sortorder	Integer
startdate	Timestamp
summary	Text
teacher1,2,…?_account	Search String that returns only one User Account (as used in Administration » Edit user accounts OR Integer Database User ID
teacher1,2,…?_role	String(40)
template	String
theme	String(50)
timecreated	String Date Literal
timemodified	String Date Literal
topic0 main heading?, topic1 … topic52 topic/week headings?	Text
visible	0=FALSE,1=TRUE
visibleold	0=FALSE, 1=TRUE
legacyfiles	0=FALSE, 1=TRUE

Champs obligatoires

Seuls les champs marqués en gras sont obligatoires. La construction du cours pouvant utiliser plusieurs stratégies (restauration, création par défaut), les règles sont différentes suivant le cas de figure.

En général :

si vous fournissez un template correspondant à une archive complète d'un cours, cette archive contient toutes les valeurs nécessaires à la construction du cours. Le seul champ dont vous vous préoccuperez en plus sera probablement le champ category, afin de localiser le cours généré à un endroit adéquat.

si vous ne fournissez pas de template, alors certains attributs seront utiles pour bien définir l'état du cours à créer, sinon, ce sont les valeurs “par défaut” (''Administration du site > cours > ) qui s'expriment.

Catégorie de cours

La catégorie peut être fournie comme un “chemin” séparé par des slash (“/”). Les catégories manquantes à partir de la racine seront créées autant que nécessaire. Si la catégorie est fournie comme un entier, il s'agit de l'Id de catégorie et cette catégorie DOIT exister.

Les virgules séparant les données doivent être encodées , - le script les interprétera automatiquement comme des virgules.

Pour les données booléennes, utilisez 0 pour faux et 1 pour vrai.

Utilisation de modèles ou de sauvegardes pour charger le contenu à la création

Le cours peut être créé à partir d'un modèle (template). Ce modèle désigne soit :

le nom court d'un cours de la plate-forme disposant d'une archive sauvegardée SANS LES DONNEES utilisateur.

Si le contenu du champ template ne peut être assimilé à un cours existant, alors il peut désigner un chemin physique d'accès à une archive Moodle (.mbz) compatible stockée localement sur le serveur.

Back to component index - Back to catalogue