Pretvornik iz JSON v CSV

Namen in delovanje orodja

Orodje za pretvorbo JSON v CSV omogoča, da datoteko JSON naložite (ali povlečete in spustite) ter jo pretvorite v datoteko CSV. Uporabnik izbere ločilo – vejico, podpičje ali tabulator –, si ogleda predogled tabele in nato prenese pretvorjeno datoteko. Vsa obdelava poteka v brskalniku; nič od vaših podatkov se ne naloži na strežnik. To je temeljna lastnost, ki orodje loči od spletnih storitev, ki podatke pošiljajo v oblak.

Postopek je preprost: izberete datoteko JSON, izberete izhodno ločilo in kliknete gumb za pretvorbo. Orodje takoj prikaže predogled s številom vrstic in stolpcev ter velikostjo izhodne datoteke. Nato lahko datoteko CSV prenesete.

Ključna razlika med JSON in CSV: sploščenje hierarhičnih podatkov

Glavna posebnost tega orodja je smer pretvorbe – iz JSON (hierarhični, tipiziran format) v CSV (ravna, netipizirana tabela). JSON podpira objekte, polja, števila, logične vrednosti in null v gnezdenih strukturah. CSV nima tipov, nima gnezdenja in nima listov. Pri pretvorbi se zato izgubijo vsi podatki o tipih, gnezdena struktura, več listov (ki jih JSON nima) in oblikovanje.

Da bi gnezdene objekte JSON predstavili v ravni CSV-tabeli, orodje uporabi sploščenje imen ključev s pomočjo poti s pikami (dot‑path notation). Na primer: če imate objekt { "oseba": { "ime": "Ana", "naslov": { "mesto": "Ljubljana" } } }, bodo stolpci v CSV-ju postali oseba.ime in oseba.naslov.mesto. Vsak gnezden ključ dobi polno pot od korena do vrednosti, ločeno s piko.

Polja objektov postanejo vrstice tabele; notranja polja polj (array of arrays) se ohranijo kot vrstice, kjer vsak element notranjega polja postane stolpec. Orodje ne poskuša rekurzivno sploščiti notranjih polj, če ta niso objekti.

Vhodni in izhodni podatki

Vhod: ena datoteka JSON (orodje sprejema tudi CSV in XLSX, a za to stran je relevanten le JSON). Uporabnik lahko izbere tudi izhodno ločilo:

• Vejica (,)
• Podpičje (;)
• Tabulator (\t)

Izhod: datoteka CSV z izbranim ločilom. Orodje prikaže predogled tabele, število vrstic, število stolpcev in velikost izhodne datoteke.

Vse vrednosti iz JSON se v CSV pretvorijo v nize. Števila, logične vrednosti in null postanejo nizi. To pomeni, da se lahko izgubijo vodeče ničle pri številkah (npr. "001" postane 1, ker CSV nima nabora za ohranjanje ničel). Če vaši podatki vsebujejo vodeče ničle, jih je treba pred pretvorbo v JSON obdržati kot nize (v narekovajih), sicer jih bo orodje obravnavalo kot število.

Pravila, omejitve in robni primeri

Orodje pretvarja le vidne vrednosti; formul ali kode ne izračunava. Za uspešno pretvorbo mora biti JSON tabelarične oblike – bodisi eno polje objektov bodisi polje polj. Če JSON ni veljaven ali ni tabelaričen, se prikaže napaka: »This JSON is invalid or not table‑shaped.«

Polje objektov: vsak objekt postane vrstica, ključi objektov postanejo stolpci, gnezdeni ključi se sploščijo s potmi s pikami.

Polje polj: vsako notranje polje postane vrstica, elementi postanejo stolpci (brez imen ključev).

Pomembna omejitev: orodje ne ohranja tipov JSON – vse vrednosti v CSV so nizi. Pri pretvorbi se gnezdena struktura izgubi; preživi le sploščena predstavitev s potmi s pikami.

Pravila za citiranje v CSV se uporabijo samodejno. To pomeni, da se vrednosti, ki vsebujejo ločilo (vejico, podpičje, tabulator), prelome vrstic ali narekovaje, zaprejo v dvojne narekovaje. Notranji narekovaji se podvojijo.

Omejitve velikosti in števila vrstic/stolpcev:

• Če je datoteka prevelika, se prikaže napaka: »This file is too large. Use a file under ‹max›.«
• Če ima tabela več kot dovoljeno število vrstic, se prikaže: »This table has more than ‹max› rows.«
• Če ima tabela več kot dovoljeno število stolpcev, se prikaže: »This table has more than ‹max› columns.«

Druge napake vključujejo:

• »Choose one file first.« – če ni izbrana datoteka.
• »Choose a CSV, JSON or XLSX file.« – če je izbrana napačna vrsta datoteke.
• »Choose a different output format.« – če je izbrana neveljavna oblika.
• »Could not convert this file.« – ob splošni napaki pri pretvorbi.
• »Conversion cancelled.« – če uporabnik prekine.
• »This conversion is taking too long. Try a smaller file.« – če obdelava traja predolgo.

Privatnost in obdelava v brskalniku

Vsa obdelava poteka izključno v brskalniku uporabnika – podatki se nikoli ne naložijo na strežnik. To je ključna lastnost za uporabnike, ki obdelujejo občutljive podatke, kjer je treba zagotoviti, da ne zapustijo lokalnega okolja. Ni skrbi glede shranjevanja, posredovanja ali prestrezanja podatkov. Edina komunikacija s strežnikom je prenos statičnih datotek orodja (JavaScript, HTML), sama pretvorba pa je čisto odjemalska.

Ta pristop ima tudi praktične posledice: hitrost pretvorbe je odvisna od zmogljivosti uporabnikove naprave in velikosti datoteke. Pri zelo velikih datotekah lahko brskalnik postane neodziven, kar pojasnjuje omejitev velikosti in časovno omejitev.

Kdo potrebuje to orodje in kdaj

Orodje je namenjeno vsakomur, ki ima datoteko JSON (npr. iz API‑ja) in jo želi pretvoriti v CSV za nadaljnjo obdelavo v preglednicah (Excel, Google Sheets) ali za uvoz v podatkovne baze. Pogosti primeri:

• Podatkovni analitiki, ki hitro želijo sploščiti odgovor API‑ja v obliko, primerno za poročanje.
• Razvijalci, ki potrebujejo CSV za testiranje ali uvoz v orodja, ki ne podpirajo JSON.
• Uporabniki, ki delajo z občutljivimi podatki in ne želijo uporabljati spletnih storitev, ki podatke pošiljajo na strežnik.
• Osebe, ki potrebujejo nestandardno ločilo (npr. podpičje) zaradi regionalnih nastavitev (Excel v slovenskem okolju pogosto uporablja podpičje kot ločilo).
• Hitro prototipiranje podatkovnih cevovodov, kjer je treba JSON hitro pretvoriti v CSV brez namestitve programske opreme.

Pogosta vprašanja (FAQ)

1. Zakaj so moji gnezdeni objekti postali stolpci s pikami v imenih (npr. oseba.naslov.mesto)? To je privzeta metoda sploščenja. Ker CSV ne podpira gnezdenja, orodje uporabi pot s pikami, da ohrani izvorno strukturo. Če želite drugačno predstavitev, morate JSON predhodno preoblikovati.

2. Ali se izgubijo vodeče ničle pri številkah (npr. "001" postane 1)? Da, če so v JSON zapisane kot število (brez narekovajev), jih orodje pretvori v številske nize, kar odstrani vodeče ničle. Če želite ohraniti ničle, morajo biti v JSON že zapisane kot niz (v narekovajih).

3. Kako orodje obravnava podatke, ki vsebujejo vejice ali prelome vrstic? Samodejno jih zapre v dvojne narekovaje. Notranji narekovaji se podvojijo. To je skladno s standardom RFC 4180 za CSV.

4. Ali lahko pretvorim datoteko JSON, ki ni v obliki polja objektov ali polja polj? Ne. Orodje pričakuje tabelarično strukturo. Če je JSON objekt s polji ali drugimi gnezdenimi strukturami, bo prikazana napaka: »This JSON is invalid or not table‑shaped.«

5. Zakaj je moja pretvorba prekinjena s sporočilom o preveliki datoteki? Orodje ima omejitev velikosti datoteke zaradi stabilnosti brskalnika. Če datoteka presega to mejo, jo morate razdeliti na manjše dele ali uporabiti orodje, ki podpira večje datoteke (vendar pozor na zasebnost).

6. Ali lahko pretvorim datoteko JSON z več listi (več arrayi)? JSON ne podpira več listov – ena datoteka vsebuje eno korensko strukturo. Če imate več ločenih nizov podatkov, jih morate pred pretvorbo združiti v eno tabelarično strukturo ali pretvoriti vsakega posebej.