Comment convertir un CSV en JSON avec les noms de champs

À quoi sert la conversion CSV en JSON ?

Cet outil sert à transformer un contenu CSV fourni sous forme de texte en données JSON. Il convient lorsque vous devez vérifier rapidement la structure de lignes et de colonnes, puis obtenir des enregistrements JSON plats. Par défaut, si le contenu comporte plusieurs lignes, la première est utilisée comme nom des champs et les lignes suivantes deviennent les enregistrements. Vous pouvez désactiver ce comportement lorsque la première ligne doit elle aussi être conservée comme donnée.

Convertir un contenu CSV en JSON

1. Préparez le contenu CSV sous forme de texte, avec les valeurs séparées selon la structure de votre fichier. Ne fournissez pas un classeur Excel : l’entrée attendue est du texte CSV.
2. Collez ce contenu dans la zone prévue à cet effet. Une chaîne vide est acceptée comme valeur initiale.
3. Vérifiez le réglage qui utilise la première ligne comme noms de champs. Laissez-le activé si cette ligne contient les en-têtes de vos colonnes. Désactivez-le si chaque ligne, y compris la première, doit être traitée comme une ligne de données.
4. Choisissez le niveau d’indentation numérique du JSON. Si vous ne le modifiez pas, la valeur par défaut est 2.
5. Lancez la conversion et consultez le JSON produit ainsi que le nombre d’enregistrements générés. Si le contenu est vide ou ne contient que des espaces, le résultat attendu est un tableau JSON vide et un nombre d’enregistrements égal à zéro.

Lire et vérifier le résultat

Le résultat présente les lignes converties au format JSON. Lorsque l’utilisation de la première ligne comme noms de champs est activée et que plusieurs lignes sont présentes, cette première ligne structure les enregistrements qui suivent. Lorsqu’elle est désactivée, aucune ligne n’est réservée aux noms de champs : la première ligne apparaît donc elle aussi parmi les données converties.

Le nombre d’enregistrements permet de contrôler rapidement le volume obtenu. Comparez-le au nombre de lignes de données attendu, en tenant compte du réglage choisi pour la première ligne. Une entrée vide aboutit spécifiquement à un tableau vide et à zéro enregistrement.

Si le traitement rencontre une exception, l’opération est néanmoins marquée comme réussie, mais le résultat retourné est un tableau vide, le nombre est zéro et une description de l’erreur est fournie. Dans ce cas, consultez cette description plutôt que de considérer le tableau vide comme une conversion valide.

Exemple pratique

Vous avez un contenu CSV de contacts dont la première ligne contient les noms « nom » et « courriel », et vous voulez obtenir des enregistrements JSON structurés par ces deux champs.

Collez le contenu CSV, laissez l’utilisation de la première ligne comme noms de champs activée, conservez l’indentation par défaut, puis lancez la conversion.

Le résultat attendu est un tableau JSON d’enregistrements, accompagné d’un nombre d’enregistrements correspondant aux lignes converties.

Limites

• L’entrée documentée est du texte CSV. Cette conversion ne doit pas être présentée comme l’import direct d’un classeur Excel.
• En cas d’exception, un tableau vide et zéro enregistrement peuvent être renvoyés avec une description de l’erreur, même si l’opération est indiquée comme réussie.

Erreurs fréquentes

• La première ligne disparaît du résultat parce qu’elle est interprétée comme noms de champs. Désactivez l’utilisation des en-têtes lorsque cette ligne contient des données à conserver.

Questions fréquentes

Puis-je importer directement un fichier Excel ?

Oui, si le contenu est fourni sous forme de texte CSV. L’entrée attendue n’est pas un classeur Excel ou un autre fichier téléversé.

Comment conserver la première ligne dans le JSON ?

Oui, à condition de désactiver l’utilisation de la première ligne comme noms de champs. Toutes les lignes seront alors traitées comme des données.

Que signifie un tableau JSON vide ?

Si l’entrée est vide ou composée uniquement d’espaces, le résultat est un tableau JSON vide et le nombre d’enregistrements est zéro. Une exception de traitement renvoie aussi un tableau vide et zéro, mais avec une description de l’erreur.