Import CSV
À quoi ça sert
Cette page décrit comment importer des fichiers CSV par lot pour certaines rubriques (organisations, accords, mobilités…).
Qui peut le faire
L’import nécessite un droit de création sur la rubrique concernée (pour les organisations : profil administrateur). En pratique, ce sont les administrateurs ou les référents Relations Internationales habilités (voir Profils).
Prérequis
- Fichier au format CSV (encodage UTF-8 recommandé).
- Droit de création sur la rubrique cible.
- Bouton Importer visible dans la barre d’outils de la liste concernée.
Procédure
- Ouvrez la liste de la rubrique à importer (organisations, accords Erasmus, accords hors Erasmus, mobilités étudiantes ou personnels).
- Cliquez sur Importer.
- Sélectionnez votre fichier CSV.
- Mappez les colonnes du fichier vers les champs attendus par LaBRRI (l’assistant affiche les colonnes obligatoires). Vérifiez l’aperçu : séparateur détecté, première ligne traitée comme en-têtes par défaut.
- Lancez l’import et attendez la fin du traitement.
- Vérifiez dans la liste que les enregistrements attendus sont bien présents. Les lignes rejetées par l’import ne sont pas créées : corrigez le fichier CSV et réimportez, ou complétez manuellement les fiches incomplètes.
Résultat de l’import
L’assistant affiche une notification de succès ou d’échec, sans détail ligne par ligne et sans compter les lignes rejetées. Un toast de succès peut donc apparaître même si certaines lignes ont été ignorées. Contrôlez ensuite la liste : un écart entre le nombre de lignes du fichier et les enregistrements créés ou mis à jour indique des lignes rejetées (champs obligatoires manquants, formats invalides…).
Format du fichier
Le séparateur (point-virgule ou virgule) est détecté automatiquement à l’étape de mapping — les deux formats sont en général acceptés. Par défaut, la première ligne est traitée comme ligne d’en-têtes (décochez l’option si ce n’est pas le cas). Les noms des colonnes du fichier n’ont pas besoin de correspondre aux champs LaBRRI : vous les associez manuellement à l’étape de mapping.
Types d’import disponibles
Organisations
| Colonne | Obligatoire | Description |
|---|---|---|
| idOrganisation | oui | Identifiant unique dans le fichier source (source_id de la référence externe) |
| libelle | oui | Nom de l’organisation |
| source | oui | Origine des données (MOL, MO, manuel…) |
| typeOrganisation | non | Type d’établissement (libellé du référentiel) |
| ville | non | Ville |
| pays | non | Pays (utilisé pour déduire le code pays si codePays est vide) |
| codePays | non | Code pays (ISO, 2 lettres ; prioritaire sur pays) |
| libelleFr | non | Libellé en français |
| libelleEn | non | Libellé en anglais |
Après import, contrôlez les alertes de consolidation et la qualité du référentiel (voir Gestion des organisations).
Réimport d’organisations
Un même couple source + idOrganisation met à jour la référence externe existante. Une organisation LaBRRI n’est créée que si aucune fiche n’est déjà liée à cette référence et qu’aucune organisation n’existe déjà avec le même libellé (c’est peut-être à discuter) ou le même code_ref.
Accords Erasmus et hors Erasmus
Les deux imports partagent les mêmes colonnes ; seule la liste cible diffère. Le caractère Erasmus / hors Erasmus est déduit du libellé du programme (présence de « erasmus », hors cas « hors erasmus »).
| Colonne | Obligatoire | Description |
|---|---|---|
| idAccord | oui | Identifiant unique de l’accord (numérique) |
| actif | oui | Oui / Non, ou Actif / Inactif |
| typeFlux | oui | Entrante, Sortante, Les deux, Entrants ou Sortants |
| programme | oui | Programme d’échange (créé automatiquement s’il n’existe pas encore) |
| dateDebut | oui | Date de début |
| dateFin | oui | Date de fin |
| source | oui | Plateforme source (MOL, MO…) |
| partenaire | oui | Organisation partenaire (identifiant ou libellé de la référence externe) |
| typeAccord | non | Type d’accord (libellé du référentiel) |
| typePersonne | non | Étudiants/stagiaires ou Enseignants/personnels |
| filieres | non | Filières couvertes (liste séparée par des virgules ; créées si besoin) |
| departementPartenaire | non | Département partenaire |
Effet de bord — accords
À la fin d’un import d’accords, les accords non créés ni mis à jour ce jour-là sont passés en inactif. Préparez un fichier complet avant de lancer l’import.
Mobilités étudiantes (entrantes et sortantes)
| Colonne | Obligatoire | Description |
|---|---|---|
| idMobilite | oui | Identifiant unique (numérique) |
| sortante | oui | Oui / Sortants / Sortante (sortante) ou Non / Entrants / Entrante (entrante) |
| annee | oui | Année universitaire (au moins 4 chiffres en tête, ex. 2024 ou 2024-2025) |
| typeMobilite | non | Type de mobilité (libellé du référentiel) |
| composante | non | Composante (code ou libellé) |
| filiere | non | Filière |
| programme | non | Programme |
| nationalite | non | Nationalité |
| diplome | non | Diplôme visé |
| niveau | non | Une des valeurs : L1, L2, L3, M1, M2, Doctorat, Undergraduate / Licence, Cycle court, Doctorate / Doctorat, Postgraduate / Master, Multi cycle |
| source | non | Origine des données (obligatoire si partenaire est renseigné) |
| partenaire | non | Établissement partenaire (identifiant ou libellé de la référence externe) |
| nom | non | Nom de l’étudiant |
| prenom | non | Prénom de l’étudiant |
Mobilités personnels (entrantes et sortantes)
| Colonne | Obligatoire | Description |
|---|---|---|
| idMobilite | oui | Identifiant unique (numérique) |
| sortante | oui | Oui / Sortants / Sortante (sortante) ou Non / Entrants / Entrante (entrante) |
| dateDebut | oui | Date de début du séjour |
| dateFin | oui | Date de fin du séjour |
| objet | non | Objet de la mobilité |
| typePersonnel | non | Type de personnel (libellé du référentiel) |
| nomSortant / nomAccueillant | non | Nom du personnel (selon sens : sortante → Sortant, entrante → Accueillant) |
| prenomSortant / prenomAccueillant | non | Prénom du personnel |
| composante | non | Composante (code ou libellé) |
| programme | non | Programme |
| source | non | Origine des données (obligatoire si partenaire est renseigné) |
| partenaire | non | Établissement partenaire (identifiant ou libellé de la référence externe) |
Erreurs courantes
| Problème | Piste de résolution |
|---|---|
| Import refusé (accès) | Vérifier le droit de création sur la rubrique (voir Profils) ; pour les organisations, un profil administrateur est requis |
| Colonne obligatoire manquante | Compléter le mapping dans l’assistant, ou renseigner la valeur dans le fichier |
| Ligne ignorée sans message détaillé | Contrôler les champs obligatoires, les formats acceptés et les libellés de référentiel ; la ligne est rejetée silencieusement (voir la note Résultat de l’import ci-dessus) |
| Identifiant non numérique | idAccord et idMobilite doivent être des entiers (chiffres uniquement) |
| Partenaire non rattaché | Le partenaire est résolu via une référence externe (source + identifiant ou libellé). Importer d’abord les organisations avec la même source, ou créer l’organisation et sa référence externe. Si partenaire est renseigné, source est obligatoire (accords ; mobilités si partenaire présent) |
| Réimport avec le même identifiant | Un idMobilite ou idAccord déjà présent met à jour la fiche existante |
| Accords passés inactifs après import | Comportement attendu : les accords non présents dans le fichier du jour sont désactivés — réimporter un export complet si besoin |
| Dates invalides (accords) | Formats acceptés : JJ/MM/AAAA, JJ.MM.AAAA, ou AAAA/MM (période académique → 01/09 ou 31/08) |
| Dates invalides (mobilités personnels) | Formats acceptés : JJ/MM/AAAA ou JJ.MM.AAAA |
Valeur sortante refusée |
Utiliser Oui / Non, Entrants / Sortants, Entrante / Sortante |
Valeur actif ou typeFlux refusée |
Voir les valeurs acceptées dans le tableau Accords ci-dessus |
Valeur niveau refusée |
Utiliser uniquement une des valeurs listées dans le tableau Mobilités étudiantes |
Voir aussi la FAQ pour d’autres cas fréquents.