Notons avant tout qu'il n'est habituellement pas nécessaire d'importer des utilisateurs pour les inscrire. Pour réduire les interventions manuelles dans la gestion du site, il est préférable d'utiliser l'une des méthodes d'authentification proposées par Moodle. Par exemple, Moodle peut se connecter à une base de données externe, ou bien les utilisateurs peuvent créer leurs propres comptes. Voyez la section Authentification dans la page d'administration de votre site.
Si vous désirez toutefois importer manuellement des comptes utilisateurs à partir d'un fichier texte, ce fichier doit être formaté de la façon suivante :
Champs requis : ces champs doivent être mentionnés dans le premier enregistrement et définis pour tous les utilisateurs
firstname, lastname
pour un ajout ouusername
pour une mise à jourChamps optionnels : tous ces champs sont optionnels. Les valeurs éventuellement précisées dans le fichier seront utilisées. Sinon, c'est la valeur par défaut pour ce champ qui sera utilisée.
institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, emailstop
Champs de profil personnalisés : optionnel, xxxxx doit être remplacé par le nom abrégé du champ personnalisé
profile_field_xxxxx
Champs spécial : utile pour modifier les noms d'utilisateurs ou supprimer des utilisateurs, voir ci-dessous
deleted, oldusername
Champs d'inscription (optionnel): Peuvent figurer ici les noms abrégés d'un ou de plusieurs cours. Dans ce cas, l'utilisateur y sera inscrit. Le champ « Type » représente le rôle à attribuer dans le cours. Il peut prendre la valeur 1 (rôle par défaut), 2 (enseignant) ou 3 (enseignant non éditeur). Alternativement, vous pouvez utiliser le champ « Role » pour indiquer directement le nom abrégé du rôle ou son id (les noms de rôle numériques ne sont pas utilisables). Vous pouvez également assigner les utilisateurs à des groupes dans les cours (group1 dans le course1, group2 in course2, etc.). De même, les groupes sont identifiés par leur nom ou leur identifiant (les noms de groupe numériques ne sont pas utilisables). Vous pouvez également définir une durée d'inscription pour chaque cours (enrolperiod1 pour course1, enrolperiod2 pour course 2, etc.).
course1, type1, role1, group1, enrolperiod1, course2, type2, role2, group2, enrolperiod2, etc.
Voici un exemple de fichier d'importation correct :
username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1, enrolperiod1
jonest, verysecret, Tom, Jones, jonest@someplace.edu, en, 3663737, 1, Intro101, Section 1, 1, 30
reznort, somesecret, Trent, Reznor, reznort@someplace.edu, en_us, 6736733, 0, Advanced202, Section 3, 3, 90
Il est possible d'utiliser des valeurs par défaut en guise de modèle de données :
%l
- sera remplacé par le nom (lastname)%f
- sera remplacé par le prénom (firstname)%u
- sera remplacé par le nom d'utilisateur (username)%%
- sera remplacé par %Entre % et la lettre qui le suit (l, f ou u) les paramètres suivants sont acceptés :
Par exemple, si le prénom est Pascal et le nom est Meunier, les modèles permettront d'obtenir les valeurs suivantes :
%l%f
= PascalMeunier%l%1f
= PascalM%-l%+f
= meunierPASCAL%-f_%-l
= pascal_meunierhttp://www.exemple.com/~%u/
= http://www.exemple.com/~pmeunier/ (si le nom d'utilisateur est pmeunier ou %-1f%-l
)Les modèles n'utilisent que les seules valeurs par défaut, et non pas celles provenant de fichiers CVS.
Afin de fiabiliser la création des noms d'utilisateurs, ceux-ci sont toujours convertis en lettres minuscules. En outre, si l'option « Autoriser les caractères spéciaux dans les noms d'utilisateur » est désactivée dans la page Règles du site, les caractères autres que les lettres, nombres les traits d'union (-) et les points (.) sont supprimés. Par exemple si le prénom est J. Pascal et le nom est Meunier, le nom d'utilisateur défini par %-f_%-l
donnera j. pascal_meunier si « Autoriser les caractères spéciaux dans les noms d'utilisateur » est activé, et j.pascalmeunier sinon.
Si le mode de création choisi est « Tout ajouter, y compris un compteur aux noms d'utilisateurs au besoin », un compteur automatique sera ajouté aux doublons générés par le modèle.
Par exemple, supposons que le fichier CSV contienne des utilisateurs du nom de Pascal Meunier, Patricia Meunier et Pierrick Meunier, sans nom d'utilisateur spécifié. Avec un modèle de nom d'utilisateur défini par %-1f%-l
avec l'ajout d'un compteur en cas de doublons, le modèle générera les noms d'utilisateurs pmeunier, pmeunier2 et pmeunier3.
Par défaut, Moodle procède à la création de nouveaux comptes utilisateurs, ignorant ainsi les enregistrements correspondant à des noms d'utilisateurs qui existent déjà. Néanmoins, si vous permettez la mise à jour des données, les comptes utilisateurs seront actualisés.
Lors de mise à jour de comptes existants, vous pouvez également modifier les noms d'utilisateurs. Réglez « Autoriser le changement des noms » sur Oui et ajoutez à votre fichier un champ nommé oldusername
.
Attention ! Des erreurs de mise à jour sur des comptes existants peuvent être très néfastes pour vos utilisateurs. Soyez très vigilant avec les options de mise à jour.
Si le champ deleted
est présent, les utilisateurs dont ce champ vaudra 1 seront supprimés. Dans ce cas, aucun autre champ n'est nécessaire, à l'exception de username
.
L'importation et la suppression de comptes peuvent être réalisés au moyen d'un seul fichier CSV. Par exemple, le fichier suivant ajoute l'utilisateur Pascal Meunier et supprime l'utilisateur reznort :
username, firstname, lastname, deleted
meunierp, Pascal, Meunier, 0
reznort, , , 1