Convertir XLSX en JSON

Cette conversion existe à cause d’un motif qui se répète dans toute organisation : la version de référence de quelque chose — une liste de prix, un catalogue de produits, une table de traductions, des horaires d’ouverture, un mapping de codes vers des noms — vit dans un tableur tenu par quelqu’un qui n’est pas développeur, et elle doit rejoindre un programme qui attend des données.

C’est une disposition tout à fait raisonnable. Un tableur est une bonne interface d’édition, les utilisateurs métier la connaissent déjà, et construire un petit outil d’administration pour la remplacer vaut rarement l’effort. Ce qu’il faut, c’est une conversion fiable à la frontière, et c’est précisément le travail de cette page.

Le mappage est celui qui vient naturellement. La première ligne est traitée comme l’en-tête et fournit les noms de clés ; chaque ligne suivante devient un objet ; chaque cellule devient une valeur sur cet objet. Le résultat est un tableau d’enregistrements, qui est la forme qu’un programme qui consomme attend presque toujours.

Cela vaut la peine de réfléchir à la ligne d’en-tête de manière délibérée, parce que ces cellules deviennent des noms de clés dans votre code. Courts, en minuscules, sans espace ni ponctuation — c’est ce qui rend les clés agréables à manipuler ; un en-tête qui se lit « Prix unitaire (€, HT) » produit quelque chose que personne n’a envie de taper deux fois.

Un tableur ne stocke pas les dates comme des dates. Il stocke un nombre qui compte les jours depuis une origine, et la mise en forme de la cellule est ce qui fait que 45678 ressemble à une date à l’écran. La conversion rend ce qui est réellement dans le fichier, c’est-à-dire le nombre.

Les deux façons de contourner le problème sont également délibérées. Formatez la colonne en texte dans le tableur et tapez-y des dates ISO, ce qui rend le fichier auto-descriptif et survit à toute conversion. Ou bien transformez les valeurs après la conversion, en appliquant vous-même l’arithmétique du nombre de jours. Les deux conviennent ; découvrir le problème après que les données ont atteint la production, non.

Un code postal, un code produit, un code banque ou un identifiant national stocké dans une cellule formatée comme un nombre a déjà perdu ses zéros initiaux — Excel l’a fait au moment où la valeur a été tapée ou importée, et le fichier contient un nombre.

Pareil pour les identifiants au-delà de quinze chiffres, qui perdent leurs derniers chiffres à cause de la virgule flottante dans le tableur lui-même. Aucun convertisseur ne peut restaurer l’un ou l’autre, parce que l’information n’est pas dans le fichier. La correction se fait en amont : ces colonnes doivent être formatées en texte dans le tableur, et cela vaut le coup de le dire une fois à la personne qui le tient plutôt que de réparer la sortie tous les mois.

Les formules, dont vous obtenez les résultats — ce que vous vouliez, puisqu’un programme n’a rien à faire d’une formule. La mise en forme, les couleurs, les règles conditionnelles et les largeurs de colonnes, qui ne sont pas des données. Les graphiques, les commentaires et les cellules fusionnées, qui n’ont pas d’équivalent.

Les cellules fusionnées sont celui qui mérite l’attention. Un en-tête fusionné qui couvre trois colonnes est un artifice de présentation, et il produit un objet avec une clé et deux vides — ce qui donne un enregistrement à l’allure étrange né d’une feuille parfaitement sensée. Des en-têtes à plat, une cellule par colonne, sont ce qui rend cette conversion ennuyeuse, et ennuyeux est l’objectif.

L’arrangement courant est de garder le tableur comme source éditable, convertir en JSON comme une étape, et valider le JSON en même temps que le code. Les données sont alors révisables dans une pull request, versionnées, et disponibles au moment du build sans aucune dépendance à l’exécution sur un fichier que quelqu’un pourrait déplacer.

Deux habitudes font que cela tient dans le temps. Convertissez toujours de la même manière pour qu’un diff montre de vrais changements plutôt qu’un réordonnancement. Et validez le résultat contre un schéma avant de le valider, pour qu’une colonne renommée par un collègue bien intentionné fasse échouer un test plutôt que de produire en silence des objets avec un champ manquant.

Si la destination est un import de base de données, un outil d’analyse ou un pipeline de données, le CSV est en général le meilleur intermédiaire : il se stream, tous les systèmes le lisent, et il n’impose pas de structure d’imbrication à des données qui n’en ont pas.

Le JSON trouve sa place quand les données vont dans du code applicatif — un front end, un fichier de configuration, une fixture d’API — où un tableau d’objets est ce que le langage attend et où l’analyse tient en une ligne. Choisissez en fonction de ce qui lira le fichier, pas en fonction de ce qui semble le plus moderne.

La conversion tourne dans l’onglet du navigateur sur votre propre processeur, donc rien n’est téléversé et aucun serveur ne garde de copie. Il n’y a pas de compte, pas de file et pas de quota journalier ; la limite de taille est de 100 Mo par fichier, cent fichiers par dépôt.

Ce n’est pas anecdotique ici. Les tableurs que les gens convertissent sont internes : prix, marges, listes de clients, dossiers du personnel, catalogues non publiés. Ne les envoyer nulle part est la forme la plus simple de ne pas avoir à faire confiance à qui que ce soit avec eux.