Überprüfen Sie die Quelltabelle
Beginnen Sie mit einer CSV-Tabelle, deren Kopfzeile „id,name,active“ lautet und deren zwei Zeilen „001,Ada,true“ und „002,Bo,false“ lauten. Das eingebettete CSV-zu-JSON-Tool wandelt jede Datenzeile in ein durch den Header verschlüsseltes Objekt um. Das ist nützlich, um die Struktur zu erkennen, aber gehen Sie nicht davon aus, dass dadurch entschieden wurde, was die Felder bedeuten. Ein Bezeichner wie 001 sollte oft Text bleiben; Wenn man es in die Zahl 1 zwingt, gehen die führenden Nullen verloren. Das Wort „true“ kann ein boolescher Wert in einem Zielschema oder der vom Benutzer eingegebene Literaltext sein. Notieren Sie sich diese Feldtypen vor dem Import.
Überprüfen Sie die CSV-Grammatik vor der Eingabe
CSV-Felder können Kommas, Anführungszeichen und Zeilenumbrüche enthalten, wenn sie entsprechend dem verwendeten Dialekt in Anführungszeichen gesetzt werden. Eine naive Trennung bei jedem Komma kann die Spalten verschieben und dazu führen, dass eine gültige Adresse oder ein gültiger Titel wie zwei Felder aussieht. RFC 4180 beschreibt ein gängiges Format, aber echte Exporte unterscheiden sich in Bezug auf Trennzeichen, Anführungszeichenbehandlung, Header-Präsenz und Zeichenkodierung. Wenn eine Tabelle Semikolons oder Tabulatoren verwendet, wählen oder transformieren Sie dieses Format bewusst, anstatt es einem Nur-Komma-Parser zuzuführen. Überprüfen Sie, ob jede Zeile die erwartete Anzahl an Feldern aufweist und dass die Headernamen eindeutig sind.
- CSV-Kopfzeile und zwei Datensätze
- JSON-Array mit zwei Objekten
- API: id, active und leere Zellen prüfen
Wählen Sie die Empfangsform
Ein JSON-Array hält die beiden Zeilenobjekte zusammen und eignet sich für eine kleine Batch-Anfrage. JSON Lines platziert einen vollständigen JSON-Wert in jeder Zeile und eignet sich für einen Stream oder ein System, das Datensätze unabhängig verarbeitet. Eine URL-Abfragezeichenfolge besteht normalerweise aus einer Reihe kurzer Parameter und nicht aus einem Transportmittel für beliebige Tabellenkalkulationstabellen. Die Ziel-API entscheidet, welche Form gültig ist. Das JSON-Array-to-Lines-Tool ändert den Rahmen, ohne ein Schema zu erfinden, und bei der Rückkonvertierung sollten die beiden Objekte erhalten bleiben, wenn jede Zeile gültiges JSON ist.
Fehlende und spezielle Werte auflösen
Eine leere CSV-Zelle kann eine leere Zeichenfolge, einen unbekannten Wert oder keinen Wert bedeuten; Diese sind nicht in jeder API gleichwertig. Eine leere aktive Zelle sollte nicht automatisch zu „falsch“ werden. Zahlen mit einem Dezimalkomma, Datumsangaben ohne Zeitzone und Bezeichner mit führenden Nullen müssen vor dem Import explizit behandelt werden. Verwenden Sie eine Testzeile, die ein Komma in einem Namen in Anführungszeichen, eine leere Zelle und ein Nicht-ASCII-Zeichen enthält, um zu sehen, was der Konverter beibehält. Überprüfen Sie die dokumentierten erforderlichen Felder der API und lehnen Sie Zeilen ab, die nicht originalgetreu dargestellt werden können, anstatt stillschweigend zu raten.
Bestätigen Sie die Hin- und Rückfahrt und das Ziel
Überprüfen Sie nach der Konvertierung den JSON auf zwei Objekte, drei erwartete Schlüssel und Werte mit den vorgesehenen Typen. Konvertieren Sie eine Kopie zurück in CSV, um Änderungen im Angebot oder in der Feldreihenfolge zu erkennen. Eine optisch ähnliche Tabelle garantiert nicht identische Quellbytes. Senden Sie nur einen kleinen Teststapel an eine tatsächliche API, wenn deren Schema und Autorisierung bereit sind. Die MultiVerto-Tools werden in Ihrem Browser ausgeführt und helfen bei der Prüfung der Darstellung, sie können jedoch keinen Remote-API-Vertrag überprüfen oder einen Import autorisieren. Behalten Sie den ursprünglichen Export und eine schriftliche Zuordnung von jeder Spalte zu jedem Zielfeld für eine spätere Prüfung.