{{ :logo-apl.png?nolink |}} ===== 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. --------------- [[:Tools:Sync|Back to component index]] - [[:start|Back to catalogue]]