Documentation Moodle ActiveProLearn

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
<html><!-- nomoodle --></html>{{ :blocks:logo-apl.png?nolink |}}<html><!-- /nomoodle --></html>
===== Tool Sync : Format de fichier de mises à jour des inscriptions (enrolments) =====


==== Format du fichier==== 

^    Champ	^Valeur ^ Défaut ^
|   cmd	        | 'add', 'del', 'shift', 'disable', ou 'enable'| Réglage de l'outil |
|   rolename(*)	| nom court du rôle | - |
|   enrol       | String | manual |
|   cid(*)	| id ou nom court, ou le numéro d'identification du cours | selon le réglage de l'outil | 
|   uid(*)	| username, id, email, ou idnumber | selon le réglage de l'outil |
|   starttime	| timestamp unix | - |
|   endtime	| timestamp unix | - |
|   gcmd	| 'gadd', 'gaddcreate', 'greplace', 'greplacecreate' ou  'gdel' | - |
| g1 à g9       | String | - |

(*) Champs obligatoires

==== champs ====

=== cmd ===

La commande à exécuter. Si cette colonne est absente, alors la valeur par défaut mémorisée dans l'outil s'applique. Si aucune valeur par défaut n'est configurée, alors la valeur 'add' est utilisée par défaut. La commande peut prendre les valeurs : 

   * **add** : Ajoute un role
   * **del** (delete) : Supprime une inscription et le rôle
   * **shift** : Bascule l'utilisateur sur le rôle mentionné en supprimant toutes ses attributions antérieures
   * **disable** : Désactive une inscription (sans en changer ses paramètres)
   * **enable** : Active une inscription existante

=== rolename ===

Le nom court du rôle concerné (ex: student, editingteacher, etc.)

=== enrol ===

La méthode d'inscription concernée. Si cette colonne est absente du fichier, alors les opérations du fichier ne concerneront QUE les attributions de rôle, sans remettre en question les enregsitrements d'inscription. Si elle est présente, mais que la valeur de cellule est vide, alors la méthode d'inscription considérée par défaut est la méthode manuelle (manual).

=== cid ===

L'identifiant de cours. La source d'identifiant dépend de ce qui a été configuré dans le réglage de l'outil.

=== uid ===

L'identifiant de l'utilisateur. La source d'identifiant dépend de ce qui a été configuré dans le réglage de l'outil.

=== starttime / endtime ===

Les temps de début et de fin d'inscription, exprimés sous forme de [[http://www.timestamp.fr|timestamp unix]]. Ces temps de sont pris en compte QUE si la colonne 'enrol' existe.

=== gcmd ===

Commande secondaire relative aux groupes. Définit les actions à exécuter sur les groupes de cours lors du traitement de la ligne. Ce traitement peut être : 

   * **gadd** : Ajoute l'utilisateur au(x) groupe(s). Si un groupe n'existe pas, ne fait rien pour ce groupe.
   * **gaddcreate** : Idem, mais crée le(s) groupe(s) s'il n'existe(nt) pas.
   * **greplace** : Déplace l'utilisateur dans le(s) groupe(s) en supprimant toutes les affectations antérieures. Ignore les groupes non existants.
   * **greplacecreate** : Idem, mais crée les groupes non existants.
   * **gdel** : Retire l'utilisateur du(des) groupe(s).

=== g1 à g9 ===

Chaque ligne du fichier de commande peut traiter une opération sur un ensemble de 1 à 9 groupes. Le fichier CSV devra donc comprendre autant de colonnes de groupes que la commande agissant sur le plus grand nombre (par exemple, si une ligne doit modifier 5 groupes, alors le fichier aura 5 colonnes de groupe). Les cellules de groupes inutilisées doivent rester vides.

==== Fichier minimal ====

Le fichier minimal comporte 3 colonnes : rolename, uid, cid. Son effet sera d'ajouter un rôle a des inscriptions existantes (ou rôles autres) pour les utilisateurs cités dans les cours cités.

==== Exemple de fichier ====

{{:tool:sync:files:sample_enrol.csv|}}


---------------
  
<html><!-- nomoodle --></html>
[[:Tool:Sync|Retour à l'index du composant]] - [[:start|Retour au catalogue]]
<html><!-- /nomoodle --></html>