Zkontrolujte zdrojovou tabulku
Začněte tabulkou CSV, jejíž záhlaví je id,name,active a jejíž dva řádky jsou 001,Ada,true a 002,Bo,false. Vestavěný nástroj CSV-to-JSON přemění každý datový řádek na objekt s klíčem v záhlaví. To je užitečné pro zobrazení struktury, ale nepředpokládejte, že rozhodlo, co pole znamenají. Identifikátor jako 001 by měl často zůstat text; vynucení do čísla 1 ztratí úvodní nuly. Slovo true může být logická hodnota v cílovém schématu nebo doslovný text zadaný uživatelem. Před importem si tyto typy polí zapište.
Před psaním zkontrolujte gramatiku CSV
Pole CSV mohou obsahovat čárky, uvozovky a zalomení řádků, pokud jsou uvozována podle používaného dialektu. Naivní rozdělení na každé čárce může posouvat sloupce a způsobit, že platná adresa nebo název bude vypadat jako dvě pole. RFC 4180 popisuje běžný formát, ale skutečné exporty se liší v oddělovači, zpracování citací, přítomnosti záhlaví a kódování znaků. Pokud tabulka používá středníky nebo tabulátory, vyberte nebo transformujte tento formát záměrně, místo abyste jej vložili do analyzátoru obsahujícího pouze čárky. Zkontrolujte, zda má každý řádek očekávaný počet polí a zda jsou názvy záhlaví jedinečné.
- Záhlaví CSV a dva řádky
- Pole JSON se dvěma objekty
- API: zkontrolovat id, active a prázdné buňky
Vyberte tvar příjmu
Pole JSON drží dva řádkové objekty pohromadě a je vhodné pro malý dávkový požadavek. JSON Lines umístí jednu úplnou hodnotu JSON na každý řádek a může vyhovovat streamu nebo systému, který zpracovává záznamy nezávisle. Řetězec dotazu adresy URL je obvykle sada krátkých parametrů, nikoli přenos pro libovolné tabulková data. Cílové API rozhoduje, který tvar je platný. Nástroj JSON-array-to-lines mění orámování bez vymýšlení schématu a zpětný převod by měl zachovat dva objekty, pokud je každý řádek platný JSON.
Vyřešte chybějící a speciální hodnoty
Prázdná buňka CSV může znamenat prázdný řetězec, neznámou hodnotu nebo žádnou hodnotu; ty nejsou ekvivalentní v každém API. Prázdná aktivní buňka by se neměla automaticky stát nepravdivou. Čísla s desetinnou čárkou, data zapsaná bez časového pásma a identifikátory s úvodními nulami vyžadují před importem explicitní zpracování. Použijte testovací řádek, který obsahuje čárku v názvu v uvozovkách, prázdnou buňku a znak jiný než ASCII, abyste viděli, co převaděč zachová. Zkontrolujte požadovaná pole zdokumentovaná rozhraním API a odmítněte řádky, které nelze věrně znázornit namísto tichého hádání.
Ověřte zpáteční cestu a cíl
Po převodu zkontrolujte JSON, zda neobsahuje dva objekty, tři očekávané klíče a hodnoty se zamýšlenými typy. Převeďte kopii zpět do CSV, abyste zaznamenali změny v citacích nebo pořadí polí; vizuálně podobná tabulka nezaručuje identické zdrojové bajty. Odešlete do skutečného rozhraní API pouze malou testovací dávku, jakmile bude připraveno jeho schéma a autorizace. Nástroje MultiVerto běží ve vašem prohlížeči a pomáhají zkoumat reprezentaci, ale nemohou ověřit smlouvu vzdáleného rozhraní API ani autorizovat import. Uschovejte původní export a písemné mapování z každého sloupce do každého cílového pole pro pozdější audit.
Před větším importem určete klíč, podle kterého poznáte duplicitní záznam. Dva řádky se stejným jménem nemusí být stejná osoba a číselně vypadající identifikátory mohou obsahovat významné úvodní nuly. Do zkušební dávky vložte záznam s prázdným polem, diakritikou a čárkou v citovaném textu. Pokud cílové API některý údaj odmítne, opravte mapování sloupců ještě před zpracováním celého souboru.