Inspecter la table source
Commencez par une table CSV dont l'en-tête est id,name,active et dont les deux lignes sont 001,Ada,true et 002,Bo,false. L'outil CSV vers JSON intégré transforme chaque ligne de données en un objet saisi par l'en-tête. C'est utile pour voir la structure, mais ne présumez pas que cela a décidé de la signification des champs. Un identifiant tel que 001 doit souvent rester du texte ; le forcer à entrer le chiffre 1 fait perdre les zéros non significatifs. Le mot true peut être un booléen dans un schéma de destination ou le texte littéral saisi par un utilisateur. Notez ces types de champs avant de les importer.
Vérifiez la grammaire CSV avant les types
Les champs CSV peuvent contenir des virgules, des guillemets et des sauts de ligne lorsqu'ils sont cités en fonction du dialecte utilisé. Une division naïve sur chaque virgule peut déplacer les colonnes et faire ressembler une adresse ou un titre valide à deux champs. La RFC 4180 décrit un format commun, mais les exportations réelles varient en termes de délimiteur, de gestion des guillemets, de présence d'en-tête et de codage des caractères. Si une feuille de calcul utilise des points-virgules ou des tabulations, sélectionnez ou transformez délibérément ce format au lieu de le transmettre à un analyseur de virgules uniquement. Vérifiez que chaque ligne contient le nombre de champs attendu et que les noms d'en-tête sont uniques.
- En-tête CSV et deux lignes
- Tableau JSON avec deux objets
- API : vérifier id, active et les cellules vides
Choisissez la forme de réception
Un tableau JSON contient les deux objets de ligne ensemble et est pratique pour une petite requête par lots. JSON Lines place une valeur JSON complète sur chaque ligne et peut convenir à un flux ou à un système qui traite les enregistrements de manière indépendante. Une chaîne de requête URL est généralement un ensemble de paramètres courts, et non un transport pour des tables de feuille de calcul arbitraires. L'API de destination décide quelle forme est valide. L'outil JSON-array-to-lines modifie le cadrage sans inventer de schéma, et la reconversion doit préserver les deux objets si chaque ligne est un JSON valide.
Résoudre les valeurs manquantes et spéciales
Une cellule CSV vide peut signifier une chaîne vide, une valeur inconnue ou aucune valeur ; ceux-ci ne sont pas équivalents dans toutes les API. Une cellule active vide ne doit pas automatiquement devenir fausse. Les nombres avec une virgule décimale, les dates écrites sans fuseau horaire et les identifiants avec des zéros non significatifs nécessitent un traitement explicite avant l'importation. Utilisez une ligne de test contenant une virgule dans un nom cité, une cellule vide et un caractère non-ASCII pour voir ce que le convertisseur préserve. Vérifiez les champs obligatoires documentés de l'API et rejetez les lignes qui ne peuvent pas être représentées fidèlement plutôt que de deviner silencieusement.
Valider l'aller-retour et la destination
Après la conversion, inspectez le JSON pour deux objets, trois clés et valeurs attendues avec les types prévus. Reconvertissez une copie au format CSV pour remarquer les changements dans les citations ou l'ordre des champs ; un tableau visuellement similaire ne garantit pas des octets sources identiques. Envoyez uniquement un petit lot de test à une API réelle lorsque son schéma et son autorisation sont prêts. Les outils MultiVerto s'exécutent dans votre navigateur et aident à examiner la représentation, mais ils ne peuvent pas vérifier un contrat d'API distant ni autoriser une importation. Conservez l'exportation originale et un mappage écrit de chaque colonne vers chaque champ de destination pour un audit ultérieur.