Pretvornik JSON v CSV

Kaj je to orodje?

API-ji in podatkovne baze običajno vrnejo podatke kot JSON, vendar preglednice, Excel, Google Sheets in večina orodij za uvoz podatkov pričakujejo CSV. To orodje premosti to razliko: prilepi polje JSON objektov (kot je odgovor API-ja) in zgradilo bo CSV z enim stolpcem na vsak edinstven ključ in eno vrstico na vsak objekt.

Pretvorba obravnava podrobnosti, ki pokvarijo preproste pristope: vrednosti z vejicami ali narekovaji so pravilno ubežane, manjkajoča polja postanejo prazne celice namesto povzročanja napake pri pretvorbi, gnezdeni objekti ali polja znotraj polja pa so serializirani kot JSON niz v tej celici namesto da bi bili tiho izpuščeni.

Izhod sledi pravilom navajanja iz RFC 4180, de facto standarda za CSV: vsako polje, ki vsebuje vejico, dvojni narekovaj ali prelom vrstice, je zavito v dvojne narekovaje, narekovaji znotraj polja pa so podvojeni. To je tisto, kar ohranja vrednost, kot je New York, NY, v enem stolpcu namesto tihe razdelitve v dva.

Zakaj ga uporabiti?

• Samodejno zaznavanje glav — seznam stolpcev je zgrajen iz unije ključev čez vse objekte, tako da neusklajeni zapisi ne pokvarijo izhoda.
• Pravilno CSV ubežanje — vrednosti z vejicami, narekovaji ali prelomi vrstic so pravilno navedene, tako da se datoteka pravilno odpre v Excelu ali Google Sheets.
• Obravnava gnezdene podatke — objekt ali polje znotraj polja je serializirano v besedilo JSON namesto da povzroči napako.
• Kopiraj v odložišče ali prenesi kot datoteko .csv neposredno.
• 100 % odjemalsko — tvoji podatki (odgovori API-ja, izvoženi zapisi) se nikoli nikamor ne naložijo.

Kako ga uporabljati

1. Prilepi JSON polje objektov, npr. [{"name":"Alice","age":30},{"name":"Bob","age":25}].
2. Klikni "Pretvori v CSV".
3. Preglej izhod — kopiraj ga ali klikni "Prenesi CSV", da shraniš datoteko.
4. Odpri preneseno datoteko v Excelu, Google Sheets ali katerem koli orodju za preglednice.

Primer

Vnos

[{"name":"Alice","age":30},{"name":"Bob","city":"NYC"}]

Rezultat

name,age,city
Alice,30,
Bob,,NYC

Opazi, kako oba "city" in "age" postaneta stolpca, čeprav noben posamezen objekt nima obeh — manjkajoče vrednosti so preprosto puščene prazne.

Praktični nasveti

• Pretvorba odgovora API-ja za poročilo v preglednici: prilepi JSON polje neposredno iz zavihka Network brskalnika ali orodja za testiranje API-jev, pretvori in prenesi — brez potrebnega vmesnega skripta.
• Delo z neusklajenimi zapisi (npr. neobvezna polja iz izvoza obrazca): samodejno zaznavanje glav pomeni, da ti ni treba ročno usklajevati shem vnaprej.
• Če je tvoj JSON en velik objekt z gnezdenim poljem znotraj (npr. {"users": [...]}), pred lepljenjem sem izvleci samo del polja (delec [...]).

Zakaj sta vrstni red in popolnost stolpcev pomembna

Subtilna, a pogosta CSV napaka se zgodi, kadar so podatki izvoženi tako, da so glave napisane ročno vnaprej v upanju, da se bo vsaka vrstica ujemala: če ima vrstica 50 od 1000 dodatno polje, ki ga nobena prejšnja vrstica ni imela, preprost pisalnik CSV vrstico za vrstico to polje bodisi tiho izpusti bodisi zamakne vse naslednje stolpce iz poravnave. To orodje se izogne tej napaki tako, da najprej pregleda vsak objekt v polju, da zgradi popolno, pravilno vrstico glav, preden zapiše en sam vrstico izhoda — tako da polje, ki se pojavi samo enkrat, na čisto zadnjem objektu, še vedno dobi svoj lastni stolpec, vrednost vsake druge vrstice zanj pa je pravilno prikazana kot prazna, namesto da bi pokvarila strukturo vrstice.

Pogosta vprašanja