Imports CSV

Route de l’application : /admin/imports

À quoi sert cet écran

Mettre un établissement en donnée en quelques heures plutôt qu’en quelques semaines. C’est le point d’entrée du parcours d’import : « Importez votre référentiel depuis des fichiers CSV, avec mapping assisté et rapport d’erreurs. »

C’est aussi le point d’entrée des exports, au même format — un export se ré-importe tel quel.

Le parcours se lit en trois pages, dans cet ordre :

1. cette page — choisir un type, déposer un fichier, suivre l’état des imports ;
2. Assistant d'import — mapper, vérifier, importer, corriger ;
3. Import global — le cas particulier du classeur Excel, qui enchaîne tous les types d’un coup.

Qui y a accès

Permission requise : Gérer le référentiel referential.manage .

La portent Administrateur, Gestionnaire de patrimoine — plus, le cas échéant, les rôles personnalisés de votre établissement qui la contiennent.

Sans cette permission, l'entrée n'existe pas dans le menu. Elle n'y figure ni grisée ni cadenassée : la navigation est filtrée sur les droits résolus, pas désactivée. Une section absente n'est donc pas une panne — et au tout premier affichage, le menu peut être plus court une fraction de seconde, le temps que les permissions arrivent.

Une permission peut être limitée à certains campus ou formations. Dans ce cas l'écran s'ouvre, mais les ressources hors périmètre en sont absentes — voir Portée.

Ce n’est pas la permission de la section Administration. L’onglet « Imports » vit sous Administration, mais l’écran demande Gérer le référentiel referential.manage et non Gérer les utilisateurs user.manage — c’est une décision assumée : mettre un établissement en donnée est un geste de gestion du référentiel.

Un gestionnaire de patrimoine peut importer, sans jamais voir le chemin pour y aller

Le menu et l’écran ne s’accordent pas ici, et c’est la seconde occurrence de ce cas dans le produit après la section Pédagogie.

• L’entrée « Administration » du menu est filtrée sur Gérer les utilisateurs user.manage — un gestionnaire de patrimoine ne la voit pas ;
• les trois écrans d’import, eux, ne demandent que Gérer le référentiel referential.manage , qu’il porte — ils s’ouvrent normalement s’il en connaît l’adresse.

Autrement dit : le rôle qui a le plus de raisons d’importer des salles est celui qui n’a aucun chemin de navigation pour y arriver.

Ce qu’il faut faire : donner le lien /admin/imports en signet, ou confier l’import à un administrateur. Rien n’est cassé — il manque une porte, pas un droit.

Ce qu’on y voit

L’écran est titré « Imports CSV ».

Le tableau des imports : « Type », « Fichier », « Statut », « Créé le », et un bouton « Ouvrir » par ligne. Un import interrompu se reprend — il n’y a rien à recommencer.

Le bouton « Nouvel import » ouvre « Choisissez le type de données et le fichier CSV (UTF-8 ou Windows-1252, séparateur virgule ou point-virgule, 10 Mo max). »

La section « Exports CSV » : « Exportez les mêmes référentiels au format d’import (aller-retour possible). »

Les types de données

Type	Ce qu’il alimente
« Salles (+ équipements) »	le parc, avec le rattachement au bâtiment, le type et les équipements
« Enseignants »	l’annuaire, avec les matières enseignées
« Formations / groupes / sous-groupes »	toute la structure pédagogique d’un coup
« Étudiants »	la liste et les affectations aux sous-groupes
« Matières »	le catalogue, avec ses exigences de salle
« Cours à placer »	les cours, leur cible, leur durée, leur récurrence
« Disponibilités enseignants »	les plages déclarées

Un huitième type, les bâtiments, amorce le patrimoine : il crée campus et bâtiments, et évite d’avoir à saisir quoi que ce soit à la main avant d’importer les salles.

L’ordre compte : chaque type référence les précédents. Salles avant cours, matières avant cours, formations avant étudiants. Le classeur Excel de Import global applique cet ordre tout seul.

Ce qu’un import ne fera jamais

• Il ne devine pas. Une référence introuvable rejette la ligne ; elle n’est jamais créée à la volée — sauf pour le type « Formations / groupes / sous-groupes », dont c’est précisément l’objet.
• Il ne duplique pas. Chaque type a une clé naturelle — le code d’une salle, la référence externe d’un étudiant. Ré-importer le même fichier met à jour.
• Il n’écrase pas sans prévenir. Rien ne s’écrit avant une vérification réussie, et une seule ligne rejetée suffit à bloquer l’import — voir Assistant d'import.

Ce qu’on peut y faire

Action	Permission	Où c’est expliqué
Déposer un fichier CSV	Gérer le référentiel referential.manage	guide de l’administrateur
Suivre l’état des imports	Gérer le référentiel referential.manage	cette page
Reprendre un import interrompu	Gérer le référentiel referential.manage	Assistant d'import
Exporter un référentiel	Gérer le référentiel referential.manage	cette page
Importer un classeur complet	Gérer le référentiel referential.manage	Import global

Chaque exécution d’import est auditée, avec ses compteurs — jamais ligne par ligne. Voir Journal d'audit.

États particuliers

Les sept états d’un import se lisent dans la colonne « Statut » :

Statut	Ce qu’il veut dire
« Fichier reçu »	le fichier est déposé, rien n’est encore mappé
« Mapping défini »	les colonnes sont associées, la vérification reste à lancer
« Vérification… »	le contrôle ligne à ligne est en cours ; rien n’est écrit
« Vérifié »	le rapport est disponible : c’est le moment de lire les rejets
« Import… »	l’écriture est en cours
« Terminé »	l’import a abouti ; le fichier déposé est supprimé
« Échec »	l’import s’est arrêté sur une erreur

Ce que vous voyez	Ce que ça veut dire
« Chargement… »	vos permissions ou la liste arrivent
« Aucun import pour le moment. »	état initial : c’est le tout premier écran d’une mise en service
« Le téléversement a échoué : … »	fichier trop gros, format non reconnu, ou encodage illisible
« L’export a échoué. Réessayez. »	l’export n’a pas abouti
Un import resté à « Vérifié »	il attend une décision humaine ; il ne se poursuivra pas tout seul
Un import resté à « Fichier reçu »	le mapping n’a jamais été validé
Vous êtes renvoyé à l’accueil	vous n’avez pas Gérer le référentiel referential.manage

Sur les limites du fichier : 10 Mo et 50 000 lignes au maximum, encodage UTF-8 ou Windows-1252, séparateur virgule ou point-virgule — les deux sont détectés automatiquement. Un fichier hors de ces bornes est refusé au dépôt, avant tout traitement.

Sur un import en cours : la progression se rafraîchit toute seule tant que l’import tourne. Quitter l’écran ne l’interrompt pas — le travail se fait côté serveur, et l’état se retrouve dans la liste.

Sur le temps réel : hors import en cours, cette liste ne se met pas à jour toute seule.

Sur le hors-périmètre : la portée d’un rôle ne filtre pas cet écran. Un import porte sur tout l’établissement, quel que soit le périmètre de celui qui le lance.

Écrans liés

• Assistant d'import — l’étape suivante : mapper, vérifier, importer.
• Import global — tout importer d’un seul classeur.
• Parc de salles et Patrimoine — ce que l’import alimente côté patrimoine.
• Structure pédagogique — ce qu’il alimente côté pédagogie.
• Journal d'audit — la trace de chaque exécution.
• Les 7 premiers jours — où l’import prend sa place dans la mise en service.