Skontrolujte zdrojovú tabuľku
Začnite s tabuľkou CSV, ktorej hlavička je id,name,active a ktorej dva riadky sú 001,Ada,true a 002,Bo,false. Vložený nástroj CSV-to-JSON premení každý riadok údajov na objekt s kľúčom v hlavičke. To je užitočné na zobrazenie štruktúry, ale nepredpokladajte, že to rozhodlo o tom, čo polia znamenajú. Identifikátor ako 001 by mal často zostať textom; prinútením ho do čísla 1 stráca vedúce nuly. Slovo true môže byť boolovská hodnota v cieľovej schéme alebo doslovný text, ktorý používateľ zadal. Pred importovaním si tieto typy polí zapíšte.
Pred zadávaním skontrolujte gramatiku CSV
Polia CSV môžu obsahovať čiarky, úvodzovky a zlomy riadkov, ak sú citované podľa používaného dialektu. Naivné rozdelenie každej čiarky môže posunúť stĺpce a spôsobiť, že platná adresa alebo názov budú vyzerať ako dve polia. RFC 4180 popisuje bežný formát, ale skutočné exporty sa líšia v oddeľovači, spracovaní úvodzoviek, prítomnosti hlavičky a kódovaní znakov. Ak tabuľka používa bodkočiarky alebo tabulátory, vyberte alebo transformujte tento formát zámerne, namiesto toho, aby ste ho vložili do analyzátora obsahujúceho iba čiarky. Skontrolujte, či má každý riadok očakávaný počet polí a či sú názvy hlavičiek jedinečné.
- Hlavička CSV a dva riadky
- Pole JSON s dvoma objektmi
- API: skontrolovať id, active a prázdne bunky
Vyberte prijímací tvar
Pole JSON drží dva riadkové objekty pohromade a je vhodné pre malé dávkové požiadavky. JSON Lines umiestňuje jednu úplnú hodnotu JSON na každý riadok a môže vyhovovať streamu alebo systému, ktorý spracováva záznamy nezávisle. Reťazec dopytu adresy URL je zvyčajne súbor krátkych parametrov, nie prenos pre ľubovoľné tabuľkové údaje. O tom, ktorý tvar je platný, rozhoduje cieľové API. Nástroj JSON-array-to-lines mení orámovanie bez vymýšľania schémy a spätná konverzia by mala zachovať dva objekty, ak je každý riadok platný JSON.
Vyriešte chýbajúce a špeciálne hodnoty
Prázdna bunka CSV môže znamenať prázdny reťazec, neznámu hodnotu alebo žiadnu hodnotu; nie sú ekvivalentné v každom API. Prázdna aktívna bunka by sa nemala automaticky stať falošnou. Čísla s desatinnou čiarkou, dátumy zapísané bez časového pásma a identifikátory s nulami na začiatku vyžadujú pred importom explicitné spracovanie. Ak chcete zistiť, čo konvertor zachová, použite testovací riadok, ktorý obsahuje čiarku v názve v úvodzovkách, prázdnu bunku a znak iný ako ASCII. Skontrolujte zdokumentované povinné polia rozhrania API a odmietnite riadky, ktoré nie je možné verne znázorniť namiesto tichého hádania.
Overte spiatočnú cestu a cieľ
Po konverzii skontrolujte JSON, či neobsahuje dva objekty, tri očakávané kľúče a hodnoty so zamýšľanými typmi. Skonvertujte kópiu späť na CSV, aby ste si všimli zmeny v cenovej ponuke alebo poradí polí; vizuálne podobná tabuľka nezaručuje identické zdrojové bajty. Pošlite iba malú testovaciu dávku do skutočného API, keď bude pripravená jeho schéma a autorizácia. Nástroje MultiVerto bežia vo vašom prehliadači a pomáhajú skúmať reprezentáciu, ale nedokážu overiť zmluvu o vzdialenom rozhraní API ani autorizovať import. Uchovajte pôvodný export a napísané mapovanie z každého stĺpca do každého cieľového poľa pre neskoršiu kontrolu.
Pred väčším importom určite kľúč, podľa ktorého rozpoznáte duplicitný záznam. Dva riadky s rovnakým menom nemusia byť rovnaká osoba a číselne vyzerajúce identifikátory môžu obsahovať významné úvodné nuly. Do skúšobnej dávky vložte záznam s prázdnym poľom, diakritikou a čiarkou v citovanom texte. Ak cieľové API niektorý údaj odmietne, opravte mapovanie stĺpcov ešte pred spracovaním celého súboru.