Assistant d'import
Vérifié contre le produit le .
Route de l’application : /admin/imports/$jobId — cette page décrit tous les assistants
d’import, pas un en particulier.
À quoi sert cet écran
Section intitulée « À quoi sert cet écran »Conduire un fichier du dépôt jusqu’à l’écriture, en s’arrêtant avant d’abîmer quoi que ce soit. C’est l’écran où l’on associe les colonnes, où l’on vérifie sans rien écrire, et où l’on décide quoi faire des lignes que le produit refuse.
Sa règle de fond tient en une phrase : rien ne s’écrit tant qu’une vérification n’a pas réussi, et une seule ligne rejetée suffit à tout bloquer.
Qui y a accès
Section intitulée « Qui y a accès »Permission requise : .
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.
Comme les deux autres écrans d’import, il ne demande pas la permission de la section Administration — le détail, et la conséquence pour un gestionnaire de patrimoine, sont sur Imports CSV.
Ce qu’on y voit
Section intitulée « Ce qu’on y voit »L’écran est titré « Assistant d’import », avec le rappel du fichier — « salles-2026.csv — encodage utf-8, séparateur « ; » » — et « Retour aux imports ».
Quatre étapes, matérialisées en tête : « Fichier », « Mapping », « Vérification », « Import ». L’assistant est reprenable : on peut le quitter et y revenir à l’étape où on l’a laissé.
« Mapping des colonnes »
Section intitulée « « Mapping des colonnes » »« Associez chaque champ cible à une colonne de votre fichier. Les suggestions sont pré-remplies ; le mapping est mémorisé pour la prochaine fois. »
Un tableau à trois colonnes : « Champ cible », « Colonne source », « Aperçu ». Les champs obligatoires portent la mention « requis » ; une colonne qu’on ne veut pas utiliser reste sur « — non mappé — ».
Les suggestions sont calculées par ressemblance entre vos en-têtes et les noms attendus. Quand un mapping a déjà été validé pour ce type, l’assistant le reprend et le signale : « Mapping repris de votre dernier import de ce type. »
« Valider le mapping » enregistre. Changer le mapping d’un import déjà vérifié le ramène à l’étape de vérification : l’ancien rapport ne correspond plus.
« Lancer la vérification (dry-run) »
Section intitulée « « Lancer la vérification (dry-run) » »C’est l’étape qui donne sa valeur à l’écran. Le produit relit chaque ligne, résout chaque référence, et ne écrit rien.
Le rapport annonce « 480 lignes valides sur 500 », puis :
- « Aucune erreur détectée : toutes les lignes peuvent être importées. » — le cas favorable ;
- ou « Lignes rejetées (20) », avec un tableau : « Ligne », « Champ », « Raison », « Valeur », « Suggestion ».
La colonne « Suggestion » est la plus utile : quand une référence introuvable ressemble à une référence existante, le produit propose la bonne. C’est ce qui transforme une correction d’une heure en correction de cinq minutes.
« Importer N lignes »
Section intitulée « « Importer N lignes » »L’écriture, avec sa « Progression : 62 % », puis « Import terminé » et son bilan : « 412 créés · 68 mis à jour · 20 rejetés ».
Les lignes rejetées : ce que vous pouvez en faire
Section intitulée « Les lignes rejetées : ce que vous pouvez en faire »C’est le point décisif, et le comportement est restrictif par défaut.
S’il reste une seule ligne rejetée, l’import est refusé. Il faut choisir :
| Option | Ce qui se passe |
|---|---|
| Corriger le fichier et recommencer | le chemin recommandé : on repart d’un dépôt propre |
| Corriger le référentiel puis « Relancer la vérification » | quand le problème est une référence manquante — créer le type de salle, puis revérifier |
| Cocher « Importer uniquement les lignes valides (les lignes rejetées seront ignorées) » | l’import passe, les lignes rejetées sont perdues — elles ne sont ni écrites, ni mises de côté |
La troisième option est un choix explicite, jamais un défaut. C’est ce qui garantit qu’un fichier approximatif ne peut pas entrer à moitié sans que personne ne l’ait décidé.
Les raisons de rejet les plus fréquentes
Section intitulée « Les raisons de rejet les plus fréquentes »| Message | Ce qu’il faut corriger |
|---|---|
| « Le champ « Code » est obligatoire et la cellule est vide. » | la cellule, ou le mapping si vous avez visé la mauvaise colonne |
| « La référence indiquée dans « Type de salle » est introuvable dans le référentiel. » | créez la référence, ou corrigez l’orthographe — regardez la suggestion |
| « Cette clé « Référence externe » apparaît plusieurs fois dans le fichier. » | un doublon dans votre fichier, pas dans le référentiel |
| « La cible est ambiguë : précisez un seul groupe OU sous-groupe existant. » | deux groupes portent le même nom dans deux formations : le produit refuse plutôt que de deviner |
| « La ligne n’a pas le même nombre de colonnes que l’en-tête. » | un point-virgule ou une virgule de trop, souvent dans un champ libre |
| « « Capacité » doit être un nombre entier valide. » | une valeur non numérique, un espace, une unité |
Ce qu’on peut y faire
Section intitulée « Ce qu’on peut y faire »| Action | Permission | Où c’est expliqué |
|---|---|---|
| Associer les colonnes | guide de l’administrateur | |
| Lancer la vérification | cette page | |
| Corriger le référentiel et revérifier | Nomenclatures | |
| Lancer l’import | cette page | |
| Accepter un import partiel | cette page |
États particuliers
Section intitulée « États particuliers »| Ce que vous voyez | Ce que ça veut dire |
|---|---|
| « Import introuvable. » | l’identifiant de l’adresse ne correspond à rien — lien périmé |
| « Vérification en cours… » | le contrôle tourne ; aucune écriture n’a lieu |
| « Aucune erreur détectée : toutes les lignes peuvent être importées. » | le chemin favorable |
| « Lignes rejetées (20) » | l’import est bloqué jusqu’à correction ou acceptation explicite |
| « Rapport tronqué : seules les 1 000 premières erreurs sont affichées. » | il y en a davantage ; corrigez la cause la plus fréquente et relancez plutôt que de dérouler |
| « Import en cours… » avec sa progression | l’écriture est en route ; quitter l’écran ne l’interrompt pas |
| « Import terminé » | avec son bilan créés / mis à jour / rejetés |
| « L’import a échoué. » | l’écriture s’est arrêtée sur une erreur ; il n’y a pas de reprise automatique |
| « Impossible de démarrer : … » | l’import a été refusé avant de commencer — vérification manquante, ou lignes rejetées sans acceptation explicite |
| « Enregistrement impossible : … » | le mapping n’a pas pu être validé |
| Le mapping revient à l’étape précédente | vous l’avez modifié après une vérification : elle ne vaut plus |
| Vous êtes renvoyé à l’accueil | vous n’avez pas |
Sur un import partiellement appliqué : il n’existe que si vous l’avez explicitement demandé. Dans ce cas, les lignes valides sont écrites et les autres sont ignorées, définitivement — il n’y a pas de fichier de rejets à récupérer ensuite. Notez-les depuis le rapport avant de lancer l’import.
Sur un import échoué en cours d’écriture : les lignes déjà écrites le restent. Le bilan n’apparaît pas, mais le référentiel a bougé. Relancer l’import après correction mettra à jour ce qui est déjà passé — à condition que la clé naturelle soit renseignée.
Sur le fichier déposé : il est supprimé dès l’import réussi. Gardez votre exemplaire ; on ne peut pas le retélécharger depuis le produit.
Sur le temps réel : l’écran se rafraîchit tout seul pendant une vérification et pendant un import. Le reste du temps, non.
Sur le hors-périmètre : la portée d’un rôle ne filtre pas cet écran.
Écrans liés
Section intitulée « Écrans liés »- Imports CSV — l’étape précédente, et la liste des imports.
- Import global — le même assistant, enchaîné sur tous les onglets d’un classeur.
- Nomenclatures — où créer les références qu’un import ne trouve pas.
- Parc de salles et Structure pédagogique — le résultat, une fois l’import passé.
- Journal d'audit — l’entrée laissée par chaque exécution.