Convertisseur en ligne gratuit de JSON en CSV

Une feuille de calcul, un importateur de bases de données ou un système de reporting peut nécessiter un fichier CSV tabulaire plutôt qu’un fichier JSON structuré. La conversion facilite la modification des enregistrements plats dans Excel ou LibreOffice Calc et fournit la mise en page attendue par de nombreux outils d’importation en masse.

Qu’est-ce que JSON ?

JSON (JavaScript Object Notation) est un format texte constitué d’objets, de tableaux, de paires clé-valeur, de nombres, de chaînes, de valeurs booléennes et de null. Les API Web, les applications de navigateur, les systèmes de configuration, les bases de données et les langages de programmation produisent couramment des fichiers portant l’extension .json.

JSON peut stocker des objets et des tableaux imbriqués, de sorte qu’un enregistrement peut contenir plusieurs niveaux de données associées. Cette flexibilité ne se transpose pas directement dans un tableau de feuille de calcul plat. Un fichier JSON Lines ou NDJSON, dans lequel chaque ligne constitue un objet JSON distinct, nécessite également une procédure d’importation différente de celle d’un document JSON standard.

Qu’est-ce que CSV ?

CSV (comma-separated values) représente les enregistrements tabulaires sous forme de lignes, avec un champ par colonne. La première ligne contient souvent les noms des colonnes. Un champ contenant un séparateur, un guillemet ou un saut de ligne doit être placé entre guillemets ; les guillemets situés à l’intérieur d’un champ entre guillemets sont généralement représentés par deux guillemets.

Excel, LibreOffice Calc, les importateurs de bases de données, les logiciels statistiques et les scripts de traitement des données prennent en charge le CSV. Ce format convient bien aux listes plates, au filtrage, au tri et aux importations en masse, mais il ne conserve pas nativement les objets imbriqués, les tableaux, les types de données, les formules ou la mise en forme des cellules. Les implémentations de CSV peuvent utiliser un point-virgule ou une tabulation au lieu d’une virgule : il faut donc vérifier le séparateur requis par la destination.

Comment convertir le fichier

Pour une conversion ponctuelle, utilisez gratuitement le convertisseur JSON-to-CSV de 101convert.com sans installer de logiciel :

1. Ouvrez le convertisseur et importez le fichier .json ou collez un document JSON.
2. Si des options de sélection ou d’aplatissement des champs sont disponibles, choisissez le tableau contenant les enregistrements ainsi que les champs qui doivent devenir des colonnes.
3. Lancez la conversion et téléchargez le fichier .csv obtenu.
4. Ouvrez le CSV dans LibreOffice Calc, Excel ou une autre application de feuille de calcul, puis vérifiez le séparateur, l’encodage des caractères, les en-têtes, le nombre de lignes et plusieurs valeurs représentatives.

Ne téléversez pas de données confidentielles ou réglementées, sauf si le service est approuvé pour ce type de données.

Pour des conversions répétées ou privées, les modules json et csv de la bibliothèque standard de Python évitent l’installation d’un package supplémentaire. Cet exemple attend un tableau d’objets au niveau supérieur :

import csv
import json

with open("input.json", encoding="utf-8") as source:
    records = json.load(source)

if not isinstance(records, list) or any(not isinstance(record, dict) for record in records):
    raise ValueError("Expected a top-level array of objects")

columns = list(dict.fromkeys(
    key for record in records for key in record
))

with open("output.csv", "w", newline="", encoding="utf-8-sig") as target:
    writer = csv.DictWriter(
        target, fieldnames=columns, extrasaction="ignore"
    )
    writer.writeheader()
    writer.writerows(records)

Enregistrez le code sous le nom json_to_csv.py et exécutez python json_to_csv.py. Le script conserve l’ordre dans lequel les clés apparaissent pour la première fois, écrit des cellules vides pour les clés manquantes et laisse tels quels les valeurs imbriquées qui ne conviennent pas à une conversion CSV plate. L’encodage utf-8-sig ajoute une marque d’ordre des octets UTF-8 qui aide certaines versions Windows d’Excel à détecter le texte Unicode ; utilisez utf-8 standard lorsque le système destinataire n’accepte pas de marque d’ordre des octets.

Certaines versions de Microsoft Excel peuvent importer du JSON via Data → Get Data → From File → From JSON. Dans Power Query, développez la liste ou l’enregistrement de niveau supérieur, développez les enregistrements imbriqués en colonnes, puis utilisez Close & Load ; exportez le tableau obtenu avec File → Save As et sélectionnez CSV. Si la version installée d’Excel ne possède pas ce connecteur, convertissez d’abord le fichier, puis ouvrez le CSV via sa boîte de dialogue d’importation. Dans LibreOffice Calc, utilisez File → Open pour ouvrir le CSV obtenu et sélectionnez UTF-8, le séparateur requis ainsi que le caractère de guillemet correct.

Limites de qualité et de compatibilité

Le format d’entrée le plus pratique est un tableau de niveau supérieur tel que [{"id":1,"name":"A"},{"id":2,"name":"B"}]. Un objet de niveau supérieur peut représenter un seul enregistrement, un conteneur contenant le véritable tableau d’enregistrements ou des métadonnées sans rapport. Le convertisseur doit identifier le tableau souhaité avant de produire des lignes pertinentes.

Les objets et tableaux imbriqués nécessitent une règle de traitement explicite. Ils peuvent être aplatis en colonnes telles que address.city, sérialisés en texte JSON dans un seul champ CSV entre guillemets ou ignorés. Les valeurs de tableaux peuvent être réunies sous forme de texte. Les différents convertisseurs appliquent des règles différentes : examinez donc les champs imbriqués et plusieurs lignes de sortie au lieu de vérifier uniquement les en-têtes.

Le CSV ne possède aucune distinction native fiable entre les nombres, les dates, les valeurs booléennes et les chaînes. Les logiciels de feuille de calcul peuvent convertir automatiquement les identifiants, les zéros en tête, les entiers longs ou les dates ISO. Importez les colonnes en tant que texte lorsque leur représentation d’origine doit rester inchangée et vérifiez que les valeurs vides, null et les champs manquants ont la signification requise.

Utilisez UTF-8 pour les caractères non ASCII et vérifiez si la cible attend des virgules, des points-virgules, des tabulations, des fins de ligne CRLF ou une marque d’ordre des octets. Considérez les fichiers CSV non fiables comme potentiellement dangereux dans les logiciels de feuille de calcul : les valeurs commençant par =, +, - ou @ peuvent être interprétées comme des formules. Examinez ou neutralisez ces valeurs avant d’ouvrir le fichier.