Skip to main content

Import d'utilisateurs par CSV

Concerne :Administrateur localSuper-administrateur

Dashboard → Administration → Import CSV (/admin/users/import). L'assistant d'import crée et met à jour les comptes d'un établissement à partir de fichiers CSV, en 4 étapes :

  1. Établissement — choisir un établissement existant (ou en créer un).
  2. Fichiers CSV — sélectionner les profils à importer et déposer un fichier par profil.
  3. Prévisualisation — validation sans création : chaque ligne est marquée Créé, Modifié, Ignoré ou Erreur.
  4. Confirmation — application effective de l'import.
Assistant d'import des utilisateurs — les 4 étapes (établissement, fichiers CSV, prévisualisation, confirmation)superadmin

Un fichier par profil

L'import attend un fichier distinct par profil. Chaque profil a son modèle, téléchargeable depuis l'assistant (ou générable en exemple) :

ProfilFichier modèle
EnseignantsCSV_Enseignants.csv
ÉlèvesCSV_Eleves.csv
ParentsCSV_Parents.csv
PersonnelsCSV_Personnels.csv
InvitésCSV_Invites.csv

Règles de format

  • Fichier .csv, séparateur point-virgule (;), encodage UTF-8.
  • Les colonnes marquées d'un astérisque (*) sont obligatoires.
  • Une colonne externalID sert d'identifiant stable pour gérer les modifications entre imports successifs (mise à jour plutôt que doublon).

Différences entre les fichiers

Chaque profil a ses propres colonnes — c'est là que les fichiers diffèrent :

Élèves — le plus simple, tout est obligatoire (la classe rattache l'élève) :

Prénom*;Nom*;Date de naissance*;Classes*

Enseignantsfonction = la discipline, puis des colonnes classe répétées :

Prénom*;Nom*;date de naissance;fonction;telephone;telephonetravail;email;adresse;cp;ville;pays;classe;classe

Parents — rattachés à leurs enfants par Nom / Prénom / Classes de l'élève, répétés jusqu'à 3 enfants :

Nom*;Prénom*;Adresse;Code postal;Ville;Pays;Courriel;Téléphone;Nom de l'élève;Prénom de l'élève;Classes de l'élève;…(×3)

Personnels — comme les enseignants, sans les classes :

Prénom*;Nom*;date de naissance;fonction;telephone;telephonetravail;email;adresse;cp;ville;pays

Invités — profil léger (classes facultatives) :

Prénom*;Nom*;Classes;date de naissance;telephone;telephonetravail;email;adresse;cp;ville;pays
Ordre d'import

Le fichier des élèves doit être chargé avant celui des parents : le rattachement parent → enfant s'appuie sur les élèves déjà importés.

Options d'import

  • Pré-supprimer les comptes absents des fichiers : les comptes d'origine CSV qui ne figurent plus dans les fichiers sont pré-supprimés (accès maintenu 90 jours).
  • L'import des classes recrée les classes / groupes absents : les partages associés et les règles de communication des classes supprimées sont réinitialisés.
Couverture e2e

dashboard-e2e/04_gestion_utilisateurs.spec.ts : accès à l'assistant d'import et prévisualisation sans validation (aucune création pendant le test).