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 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

sample_enrol.csv

Retour à l'index du composant - Retour au catalogue