Importer des utilisateurs

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 :

- chaque ligne du fichier contient un enregistrement ;
- les données de chaque enregistrement sont séparées par une virgule ;
- le premier enregistrement contient le nom des champs qui composent les enregistrements.

  > Champs requis : ces champs doivent être mentionnés dans le premier enregistrement et définis pour tous les utilisateurs

  > username, password, firstname, lastname, email

  > Champs par défaut : ces champs sont optionnels - s'ils ne sont pas inclus, leurs valeurs seront les mêmes que celles de l'administrateur principal du site

  > institution, department, city, country, lang, auth, timezone

  > Champs optionnels : tous ces champs sont optionnels. Les noms de cours utilisés (course1, course2, etc.) sont les « Noms abrégés » des cours. Si un ou des noms de cours sont mentionnés, l'utilisateur sera inscrit comme étudiant à ce ou ces cours. Les noms des groupes doivent correspondre au cours dans lesquels ils sont définis, dans l'exemple ci-dessous, le groupe1 est défini dans le cours1, etc.

  > idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, course1, course2, course3, course4, course5, groupe1, groupe2, groupe3, groupe4, groupe5

- les virgules faisant partie des données doivent être remplacées par le code &#44. Le script d'importation transformera automatiquement ce code en virgule ;
- utilisez 1 pour oui/vrai et 0 pour non/faux dans les champs Oui/Non ou Vrai/Faux.
- si un utilisateur existe déjà dans la base de données de Moodle, le script inscrira l'utilisateur dans les cours indiqués, mais ne modifiera pas ses données. Il retournera en outre le numéro de cet utilisateur.

Voici un exemple d'un fichier valide :

username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, groupe1
lebidon, topsecret, Jules, Lebidon, jlebidon@undomaine.ch, fr, 3663737, 1, Astro101, Groupe A
marieuntel, ultrasecret, Marie, Untel, marieu@someplace.ca, fr_ca, 6736733, 0, Crypt202, Groupe C