Comment convertir du JSON en CSV

À quoi sert la conversion JSON vers CSV ?

Cet outil transforme un texte JSON en texte CSV, pratique pour préparer des données à ouvrir ou à traiter dans un tableur. Il accepte un objet JSON unique ou un tableau non vide qui commence par un objet. Le séparateur peut rester une virgule ou être remplacé par un autre caractère, selon le format attendu par votre logiciel.

Procédure

1. Préparez le contenu JSON sous forme de texte. Vérifiez qu’il n’est pas vide et qu’il respecte la syntaxe JSON, notamment les guillemets et les séparateurs entre les propriétés.

2. Collez ce texte dans la zone d’entrée prévue par l’outil. Un objet au niveau supérieur est traité comme un seul enregistrement. Pour plusieurs enregistrements, utilisez un tableau non vide dont le premier élément est un objet.

3. Choisissez le séparateur CSV si nécessaire. Sans valeur fournie, la virgule est utilisée. Si vous saisissez plusieurs caractères, seul le premier est retenu ; une valeur vide revient également à la virgule. Pour un résultat destiné à un tableur configuré en français, le point-virgule peut donc être un choix adapté.

4. Lancez la conversion, puis examinez le texte CSV produit. La première ligne réunit les noms de champs distincts rencontrés dans les enregistrements, en conservant leur ordre de première apparition. Chaque enregistrement traité produit ensuite une ligne. Lorsqu’un champ manque dans un enregistrement, sa cellule reste vide.

Comprendre le résultat et ses limites

L’en-tête décrit les champs rencontrés pendant le traitement. Il ne s’agit pas d’une liste de colonnes imposée à l’avance : les noms distincts sont ajoutés dans l’ordre de leur première rencontre. Les lignes qui suivent correspondent aux enregistrements traités, et les valeurs écrites dans le CSV sont converties en texte.

Pour un tableau JSON, contrôlez donc sa structure avant la conversion. La validation initiale exige un tableau non vide commençant par un objet. Les éléments suivants ne sont pas vérifiés séparément comme objets ; un élément scalaire, nul ou tableau peut provoquer l’échec du traitement au moment de la conversion. De même, un tableau vide, une valeur JSON de niveau supérieur qui n’est ni objet ni tableau, ou un JSON mal formé ne produit pas une conversion valide.

Exemple pratique

Vous devez transformer un objet JSON contenant le nom et l’âge d’une personne en texte CSV séparé par des points-virgules.

Saisissez le JSON {"nom":"Léa","age":31}, choisissez ; comme séparateur et lancez la conversion.

Le résultat comporte une ligne d’en-tête nom;age, suivie d’une ligne Léa;31.

Limites

• La conversion ne couvre pas les tableaux vides, les valeurs JSON de niveau supérieur qui ne sont ni objets ni tableaux, ni les tableaux dont le premier élément n’est pas un objet. Les valeurs écrites dans les cellules sont converties en texte ; aucun aplatissement de structures imbriquées en colonnes distinctes n’est établi.

Erreurs fréquentes

• Cause : le tableau commence par un objet, mais un élément suivant est une valeur simple, null ou un autre tableau. Correction : vérifiez chaque élément du tableau et conservez uniquement des enregistrements objets avant de relancer la conversion.

Questions fréquentes

Un tableau JSON peut-il être converti en CSV ?

Oui, si le tableau n’est pas vide et que son premier élément est un objet. Les éléments suivants doivent aussi être vérifiés, car une valeur simple, null ou un tableau peut faire échouer le traitement.

Quel séparateur CSV est utilisé ?

Le séparateur par défaut est la virgule. Si vous fournissez plusieurs caractères, seul le premier est utilisé ; une valeur vide rétablit la virgule.

Que devient un champ absent d’un enregistrement ?

La cellule correspondante est laissée vide lorsque l’enregistrement ne possède pas un champ présent dans l’en-tête.