Différences

Ci-dessous, les différences entre deux révisions de la page.

--- toolsynccoursecreate [2015/10/12 15:37] – admin
+++ toolsynccoursecreate [2025/12/10 16:16] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 11: / Ligne 11: @@
 |    cost	| String(10) |
 |    format	| String('social','topics','weeks', ...) |
-|    fullname	| String(254) |
+|    **fullname* **	| String(254) |
 |    groupmode	| 0=NOGROUPS,1=SEPARATEGROUPS,2=VISIBLEGROUPS |
 |    groupmodeforce	| 0=FALSE,1=TRUE |
@@ Ligne 20: / Ligne 20: @@
 |    maxbytes	| Integer(Site Max) |
 |    newsitems	| Integer(10) |
-|    shortname	| String(15) |
+|    **shortname* **	| String(15) |
 |    showgrades	| 0=FALSE,1=TRUE |
 |    showreports	| 0=FALSE,1=TRUE |
@@ Ligne 36: / Ligne 36: @@
 |    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.
-  * sinon ()
+  * 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.
 [[ToolSync|Revenir à l'index de l'outil]]