{{ :blocks:logo-apl.png?nolink |}} ==== 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 ''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 ou ''shortname'' 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. --------------- [[:Tool:Sync|Retour à l'index du composant]] - [[:start|Retour au catalogue]]