JSON vers CSV

Exemple

Entrée:

[
  { "id": 1, "user": { "name": "Alice", "email": "a@a.com" }, "tags": ["admin"] },
  { "id": 2, "user": { "name": "Bob",   "email": "b@b.com" }, "tags": ["user", "beta"] }
]

Sortie (aplatir imbriqué, joindre les tableaux):

id,user.name,user.email,tags
1,Alice,a@a.com,admin
2,Bob,b@b.com,"user,beta"

Choix du délimiteur

Règles de mise entre guillemets

Un champ doit être mis entre guillemets lorsqu’il contient :

• le délimiteur
• un guillemet double (qui est échappé en doublant : " -> "")
• un saut de ligne

“Toujours entre guillemets” est plus sûr pour la compatibilité entre outils ; “entre guillemets seulement si nécessaire” rend le fichier plus facile à lire manuellement.

Traitement des objets imbriqués

• Aplatir : { user: { name: "A" } } devient une colonne user.name. Les chemins profonds deviennent a.b.c.d.
• Chaîne JSON : l’objet imbriqué reste comme une valeur JSON à colonne unique : "{\"name\":\"A\"}". Utile lorsque les outils en aval peuvent le parser.
• Stringifier : joint avec un séparateur, perdant la structure.

Gestion des tableaux

• Joindre : ["a", "b"] devient "a,b" dans une seule colonne.
• Colonnes indexées : produit tags.0, tags.1, tags.2, fonctionne uniquement lorsque la longueur du tableau est cohérente.
• Premier élément seulement : prend tags[0] et ignore le reste.

Erreurs courantes

• Clés inégales entre objets. Si un objet a phone et un autre ne l’a pas, le CSV obtient une colonne phone avec des cellules vides pour les lignes manquantes. Validez toujours que l’ensemble des clés est cohérent.
• Oublier le BOM pour Excel. Excel sur Windows lit les CSV UTF-8 sans BOM comme Latin-1 et brouille les caractères accentués. L’outil propose un basculement “préfixer UTF-8 BOM” pour ce cas.
• Incorporer des sauts de ligne dans les valeurs. Légal dans le CSV RFC 4180, mais certains importateurs ont des problèmes. Si votre cible est fragile, remplacez \n par un espace ou un token \\n.
• Utiliser Excel comme format de retour. Excel convertit silencieusement 007 en 7, tronque les longs nombres et corrompt les zéros initiaux dans les ID. Pour l’intégrité des données, utilisez CSV avec un parseur approprié.