Convertir JSON en CSV

Le format JSON est idéal pour les applications web, mais le CSV reste le roi pour l'analyse de données dans Excel ou Google Sheets. Convertir vos fichiers JSON en CSV permet de rendre vos données accessibles à tous et faciles à manipuler.

Le JSON (JavaScript Object Notation) est une structure hiérarchique complexe. Le CSV (Comma Separated Values) est une structure plate en colonnes. Cette conversion "aplatit" les données pour qu'elles puissent être ouvertes comme un tableau classique.

Pourquoi un JSON imbriqué ne rentre pas tel quel dans un CSV

La difficulté de cette conversion n'est pas technique, elle est structurelle : les deux formats ne décrivent pas la même chose. Le JSON est un arbre. Un objet peut contenir d'autres objets, eux-mêmes contenant des tableaux, sur autant de niveaux que nécessaire. Le CSV est un tableau à deux dimensions : des lignes, des colonnes, et rien d'autre. Il n'a aucun moyen d'exprimer qu'une cellule contient elle-même une structure. Convertir revient donc à aplatir, et il existe deux stratégies, qui ne donnent pas le même résultat. La première déplie les objets imbriqués en colonnes, avec un nom composé. Un objet contenant une adresse avec une ville et un code postal devient deux colonnes, « adresse.ville » et « adresse.code_postal ». La notation par points est la convention la plus répandue. Cette stratégie conserve une ligne par enregistrement, ce qui est ce qu'on veut la plupart du temps. La seconde traite les tableaux. Si un enregistrement contient une liste de trois commandes, faut-il produire trois colonnes numérotées, ou trois lignes répétant les autres champs ? La première option garde une ligne par client mais impose un nombre maximal de commandes. La seconde produit un tableau exploitable en tableur croisé dynamique, au prix de la duplication des données. Il n'y a pas de bonne réponse dans l'absolu : cela dépend de ce que vous ferez du fichier. Pour une analyse dans un tableur, la duplication en lignes est presque toujours plus pratique. Pour un import dans un outil qui attend un enregistrement par ligne, les colonnes numérotées s'imposent. Un point à vérifier avant de lancer la conversion : tous les objets de votre tableau JSON n'ont pas forcément les mêmes clés. Un convertisseur correct doit parcourir l'ensemble des enregistrements pour construire la liste complète des colonnes, et laisser vides celles qui manquent, plutôt que de se fier au premier objet rencontré.

Les champs qui contiennent des virgules, des guillemets ou des retours à la ligne

C'est la première cause de CSV cassés, et elle passe souvent inaperçue jusqu'à ce que le fichier soit ouvert par quelqu'un d'autre. Le CSV sépare ses colonnes par un caractère. Dès qu'une valeur contient elle-même ce caractère, la ligne se décale et toutes les colonnes suivantes glissent d'un cran. Une adresse comme « 12 rue des Lilas, Paris » suffit à casser un fichier séparé par des virgules. La règle, fixée par la RFC 4180, est simple : tout champ contenant le séparateur, un guillemet ou un retour à la ligne doit être entouré de guillemets doubles. Et si le champ contient lui-même un guillemet, celui-ci doit être doublé. Une valeur comme le mot « test » entre guillemets s'écrit donc, dans le fichier, avec deux guillemets de chaque côté du mot et des guillemets doublés autour. Le cas du retour à la ligne surprend le plus. Un champ de commentaire multiligne reste parfaitement valide en CSV à condition d'être entouré de guillemets : le format autorise qu'un enregistrement s'étende sur plusieurs lignes physiques du fichier. Beaucoup de scripts maison lisent le CSV ligne par ligne et se cassent précisément là-dessus. La conséquence pratique : ne fabriquez jamais un CSV en concaténant des chaînes avec des virgules. Utilisez un outil qui applique les règles d'échappement, sans quoi le fichier sera correct sur vos données de test et faux dès la première apostrophe ou la première adresse.

Excel et le CSV : le séparateur, l'encodage, et pourquoi vos accents deviennent des symboles

Un CSV parfaitement valide peut s'afficher n'importe comment dans Excel. Ce n'est pas un défaut du fichier, c'est une question de conventions locales, et la France cumule les deux pièges. Le premier est le séparateur. Excel n'utilise pas la virgule sur une installation française, mais le point-virgule. La raison est mécanique : en notation française, la virgule est le séparateur décimal. Un fichier contenant un prix de 12,50 euros et séparé par des virgules serait ininterprétable. Excel suit donc le séparateur de liste défini par les paramètres régionaux de Windows. Résultat : un CSV séparé par des virgules, standard partout ailleurs, s'ouvre dans Excel français avec toutes les données tassées dans la première colonne. Le fichier n'est pas cassé, il est simplement lu avec la mauvaise convention. Les solutions sont de produire un fichier séparé par des points-virgules, ou de passer par l'assistant d'importation de données plutôt que par un double-clic. Le second piège est l'encodage. Les accents s'affichent correctement dans un éditeur de texte, puis deviennent des suites de symboles dans Excel. La cause est qu'Excel ne détecte pas l'UTF-8 tout seul dans un fichier portant l'extension csv : il suppose l'encodage historique du système. Un « é » encodé en UTF-8 occupe deux octets, relus séparément comme deux caractères. Le contournement consiste à placer en tête de fichier une marque d'ordre des octets, le BOM. Ces trois octets invisibles signalent à Excel que le contenu est en UTF-8, et les accents s'affichent alors correctement. C'est une bizarrerie propre à Excel — la plupart des autres outils s'en passent très bien, et certains l'affichent même comme des caractères parasites en début de première cellule. Si vous produisez un CSV destiné à des collègues sous Excel en France, la combinaison qui fonctionne est donc : séparateur point-virgule et UTF-8 avec BOM. Si le fichier part vers un système informatique, c'est l'inverse qu'il faut : virgule et UTF-8 sans BOM.

• Notre outil gère les objets imbriqués en les transformant en chaînes JSON
• Vous pouvez choisir le séparateur (virgule ou point-virgule) pour une compatibilité Excel FR

Questions supplémentaires