Table des matières
Tool sync : Format de fichier de création de cours (2.x et 3.x)
Introduction
- 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 donc ê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
templatecorrespondant à 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 champcategory, 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 ou
shortnamed'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.