Aller au contenu
Mehdi Messaoudene

Un import Excel qui ne peut pas détruire une donnée

Mehdi Messaoudene1 min de lectureApplications desktop

Un cube, une sphère et un cylindre pastel beige, évoquant des données rangées

Le vrai risque d'un import Excel n'est pas de lire le fichier, c'est de ruiner le catalogue avec. Bio Réactifs empile trois garde-fous : un aperçu ligne par ligne avant d'écrire, une transaction unique avec des champs vides ignorés, et un instantané de la base avant chaque import.

En bref
  • Un assistant en quatre temps : choisir, mapper, prévisualiser, exécuter.
  • Une cellule vide n'écrase jamais une valeur déjà en base.
  • Un instantané de la base est pris avant chaque import : une erreur laisse la base intacte.

Où est le vrai problème ?

Lire un fichier Excel est le plus simple. Le cœur du problème est de ne pas ruiner le catalogue avec. Les classeurs fournisseurs sont incomplets, leurs colonnes changent, et une cellule vide ne veut pas dire « effacer la valeur ».

Trois garde-fous se superposent dans Bio Réactifs, l'application de bureau qui tient tout le catalogue en local.

Premier garde-fou : l'aperçu

L'assistant d'import avance en quatre temps : choisir le fichier, mapper les colonnes, prévisualiser, exécuter. L'aperçu classe chaque ligne comme nouvelle, modifiée, inchangée ou en erreur, et affiche pour les modifications un différentiel champ par champ, avant et après. Rien n'est écrit tant que vous n'avez pas validé.

Deuxième garde-fou : l'écriture

Tout l'import passe dans une seule transaction. Les écritures utilisent un UPSERT dont chaque champ est enveloppé : une cellule vide dans le fichier ne remplace jamais une valeur déjà présente.

ON CONFLICT(reference) DO UPDATE SET
  fournisseur = COALESCE(NULLIF(excluded.fournisseur, ''), produits.fournisseur),
  ...

Troisième garde-fou : la sauvegarde

Un instantané de la base est pris avant chaque import. Si une exception survient, la base reste intacte et le chemin de la sauvegarde est renvoyé à l'utilisateur.

Le mapping tolère l'à-peu-près

Les classeurs fournisseurs n'ont jamais deux fois les mêmes en-têtes : « Réf. », « reference », « REF PRODUIT ». Plutôt que d'imposer un gabarit, le mapping combine un dictionnaire de synonymes et une distance de Levenshtein, avec accents et casse normalisés. Le mapping validé est mémorisé : le deuxième import du même fournisseur est immédiat. Une seule contrainte reste dure : il faut exactement une colonne référence.

Questions fréquentes

Que se passe-t-il si une cellule du fichier est vide ?

Elle est ignorée. L'écriture utilise un UPSERT dont chaque champ est enveloppé de sorte qu'une valeur vide ne remplace jamais la valeur existante.

Peut-on rejouer le même import ?

Oui, c'est précisément ce que cette règle permet : rejouer l'import sans perdre les corrections déjà faites à la main.

This article is also available in French

Discussion

Les commentaires utilisent un compte GitHub.

Garder le contact

Les nouveaux articles du carnet de bord et les projets livrés, par email, sans excès.

Un lien de désinscription figure dans chaque envoi.