Prevodník JSON na CSV

Čo tento nástroj robí a ako funguje

Na stránke json-to-cvs vyberiete súbor vo formáte JSON (alebo ho pretiahnete myšou) a nástroj ho prevedie na CSV. Rozhodujete sa pre oddeľovač – čiarku, bodkočiarku, alebo tabulátor – podľa toho, aký formát CSV požadujete. Po konverzii si môžete výslednú tabuľku prezrieť v náhľade (prvých 8 riadkov a 8 stĺpcov), skontrolovať počet riadkov a stĺpcov a potom hotový súbor stiahnuť.

Všetko spracovanie prebieha priamo vo vašom prehliadači. Na žiadny server sa neodošle ani jeden bajt. To znamená, že ak pracujete s citlivými údajmi (napríklad s osobnými údajmi, finančnými záznamami alebo internými API odpoveďami), nemusíte sa obávať, že by dáta opustili váš počítač. Nástroj načíta súbor, spracuje ho a vygeneruje výstup lokálne.

Prečo je konverzia JSON → CSV náročnejšia, než sa zdá

Na prvý pohľad vyzerá prevod medzi dvoma textovými formátmi jednoducho. Opak je pravdou. JSON je hierarchický a typovaný formát. Dokáže reprezentovať vnorené objekty, polia, čísla, boolovské hodnoty, reťazce aj null. CSV je naopak plochá, neotypovaná tabuľka. Neexistujú v ňom vnorené štruktúry, žiadne typy údajov, žiadne listy (hárky) a žiadne vzorce.

Pri konverzii JSON → CSV sa nevyhnutne strácajú všetky informácie o typoch: čísla, boolovské hodnoty a null sa menia na reťazce. Ak má JSON vnorený objekt, musíte ho nejako „sploštiť“ do stĺpcov. Bežným riešením je zápis s bodkovou notáciou – napríklad address.city vznikne z objektu address s kľúčom city. Polia objektov sa stávajú riadkami tabuľky, pričom každý objekt v poli vytvorí jeden riadok. Polia polí sa takisto mapujú na riadky – prvky poľa sa stanú stĺpcami, ale bez názvov kľúčov.

Typický omyl začiatočníkov: očakávajú, že sa zachová pôvodná štruktúra JSON-u. Nie je to možné. CSV nemá mechanizmus na reprezentáciu vnorenia – všetky údaje sú v jednom riadku oddelené oddeľovačom. Preto je kľúčové pred konverziou pochopiť, ako sa majú vnorené polia reprezentovať. Tento nástroj používa štandardnú bodkovú notáciu, ale ak potrebujete inú stratégiu (napríklad zlúčenie vnorených hodnôt do jedného stĺpca so zátvorkami), musíte JSON najprv transformovať sami.

Ako nástroj spracúva vnorené štruktúry

JSON musí byť „tabuľkovo tvarovaný“ – teda musí ísť o pole objektov alebo pole polí. Ak nahráte JSON, ktorý je len jeden objekt, alebo obsahuje hlboko vnorené štruktúry bez konzistentných kľúčov, nástroj zobrazí chybu: „Tento JSON je neplatný alebo nie je tabuľkovo tvarovaný.“

Príklad 1 – pole objektov:

[
  {"name": "Ján", "address": {"city": "Bratislava", "street": "Hlavná"}},
  {"name": "Eva", "address": {"city": "Košice", "street": "Mlynská"}}
]

Po konverzii vzniknú stĺpce name, address.city, address.street. Každý objekt v poli je jeden riadok.

Príklad 2 – pole polí:

[
  ["Ján", "Bratislava"],
  ["Eva", "Košice"]
]

Výstupné CSV bude mať dva riadky a dva stĺpce – žiadne názvy stĺpcov (keďže vstupné polia nemajú kľúče). Prvý riadok bude Ján,Bratislava, druhý Eva,Košice.

Všimnite si dôležitý detail: pri poliach polí sa nestráca len typová informácia, ale aj akákoľvek sémantika hlavičiek. Ak potrebujete hlavičky, musíte JSON previesť na pole objektov ešte pred konverziou.

Ak JSON obsahuje pole primitívnych hodnôt (napríklad ["jablko", "hruška", "slivka"]), nie je považovaný za tabuľkovo tvarovaný – nástroj ho odmietne. Rovnako tak odmietne JSON, ktorý je jeden objekt s vnorenými poľami – musí to byť pole na najvyššej úrovni.

Oddeľovač, typy údajov a automatické citovanie

Pri výstupe si vyberáte oddeľovač: čiarka (,), bodkočiarka (;) alebo tabulátor (\t). Každý má svoje opodstatnenie:

• Čiarka je štandard v anglicky hovoriacich krajinách.
• Bodkočiarka sa používa v mnohých európskych jazykoch, kde čiarka slúži ako desatinná oddeľovač.
• Tabulátor je vhodný, keď dáta obsahujú veľa čiarok alebo bodkočiarok – minimalizuje riziko konfliktov.

CSV nemá natívny typový systém. Všetky hodnoty sa ukladajú ako reťazce. Číslo 42 sa v CSV zapíše ako 42 (reťazec), boolovská hodnota true ako true, null ako prázdny reťazec. Tento prevod je jednosmerný – pri spätnom importe do Excelu už nerozoznáte, či pôvodná hodnota bolo číslo alebo text.

Kritické miesto: vedúce nuly v číslach sa pri konverzii strácajú. Hodnota "007" (reťazec) by sa v JSON dala reprezentovať ako reťazec "007" – v CSV zostane 007. Ale ak je v JSON uložená ako číslo 7, CSV bude obsahovať 7. Stratu vedúcich núl nemožno obísť, pretože CSV nepozná formátovanie čísel.

Automatické citovanie hodnôt v CSV je nevyhnutné, ak hodnota obsahuje oddeľovač, úvodzovky alebo znak nového riadka. Nástroj to robí sám:

• Ak hodnota obsahuje oddeľovač (napr. čiarku), obalí ju do úvodzoviek.
• Ak obsahuje úvodzovky, zdvojí ich (podľa pravidiel RFC 4180).
• Ak obsahuje zalomenie riadka, zostane v úvodzovkách – no pri importe do niektorých nástrojov (napr. staršie verzie Excelu) môže dôjsť k chybe.

Obmedzenia, ktoré musíte poznať

Hoci spracovanie prebieha lokálne a je rýchle, existujú tvrdé hranice:

• Veľkosť súboru: Ak nahraný súbor presiahne maximálnu povolenú veľkosť, nástroj zobrazí chybu: „Tento súbor je príliš veľký. Použite súbor menší ako ‹max›.“ Presná hodnota ‹max› je 8 MB.
• Počet riadkov: Tabuľka s viac ako 10 000 riadkami vyvolá chybu: „Táto tabuľka má viac ako ‹max› riadkov.“
• Počet stĺpcov: Podobne pre stĺpce: „Táto tabuľka má viac ako ‹max› stĺpcov.“ Stĺpce vznikajú z kľúčov objektov po sploštení – ak máte 50 vnorených polí, môže vzniknúť stovky stĺpcov.
• Formát súboru: Výber súboru je obmedzený na JSON, CSV a XLSX. Ak sa pokúsite nahrať niečo iné, zobrazí sa „Vyberte súbor typu CSV, JSON alebo XLSX.“
• Prázdny vstup: Ak nenahráte žiadny súbor, nástroj vráti „Najprv vyberte jeden súbor.“
• Neplatný JSON: Pri chybe parsovania sa zobrazí „Tento JSON je neplatný alebo nie je tabuľkovo tvarovaný.“
• Časový limit: Pri veľmi veľkých súboroch, kde spracovanie trvá príliš dlho, nástroj zobrazí „Táto konverzia trvá príliš dlho. Skúste menší súbor.“
• Zrušenie konverzie: Ak používateľ konverziu zruší, zobrazí sa „Konverzia zrušená.“
• Neočakávaná chyba: V prípade, že konverzia zlyhá z iného dôvodu, nástroj napíše „Nepodarilo sa previesť tento súbor.“

Kedy tento nástroj použiť a kedy radšej nie

Použite ho, keď:

• Máte JSON z API odpovede (napríklad REST API vráti pole objektov) a potrebujete ho vložiť do Excelu alebo Google Sheets.
• Pracujete s citlivými údajmi a nemôžete ich nahrať na externý server.
• Potrebujete CSV s iným ako štandardným oddeľovačom (napr. bodkočiarka pre slovenskú lokalizáciu).
• Rýchlo prototypujete dátový pipeline a chcete jednorazovú konverziu bez inštalácie nástroja.

Nepoužite ho, keď:

• Potrebujete zachovať typy údajov (čísla, boolovské hodnoty, null) – CSV ich všetky zmení na reťazce.
• JSON obsahuje vnorené objekty hlbšie ako 2–3 úrovne a potrebujete špecifickú stratégie sploštenia (napr. viacero riadkov pre jedno vnorené pole). Tento nástroj používa len bodkovú notáciu.
• Potrebujete viacero listov (hárkov) – JSON nemá koncept listov, preto výstupný CSV bude vždy jeden list.
• Pracujete s JSON súbormi, ktoré nie sú tabuľkovo tvarované (napr. jeden objekt s vnorenými poľami). Museli by ste JSON najprv manuálne transformovať.
• Potrebujete, aby sa vedúce nuly v číslach zachovali – musíte ich v JSON reprezentovať ako reťazce, inak sa stratia.

FAQ

Otázka: Môžem konvertovať JSON, ktorý obsahuje pole objektov, kde niektoré objekty majú rôzne kľúče? Odpoveď: Nástroj očakáva konzistentnú štruktúru. Ak majú objekty rôzne kľúče, stĺpce sa vytvoria zo všetkých kľúčov, ktoré sa vyskytnú v ktoromkoľvek objekte. Chýbajúce hodnoty sa vyplnia prázdnymi bunkami. To môže viesť k veľkému počtu stĺpcov, ak sú kľúče veľmi rôznorodé.

Otázka: Prečo sa v CSV stratili vedúce nuly z čísel, ktoré som mal v JSON? Odpoveď: V JSON sú čísla bez vedúcich núlt – 007 je v JSON číslo 7. Ak potrebujete vedúce nuly zachovať, musíte hodnotu v JSON reprezentovať ako reťazec, napríklad "007". Potom sa v CSV zapíše ako 007 (reťazec).

Otázka: Ako sa spracúva null v JSON? Odpoveď: Hodnota null sa v CSV zapíše ako prázdny reťazec. Ak potrebujete v CSV explicitnú reprezentáciu (napríklad NULL), musíte JSON pred konverziou transformovať.

Otázka: Môžem konvertovať JSON, ktorý obsahuje pole vnorených polí? Odpoveď: Áno, ak ide o pole polí (array of arrays). Každé vnútorné pole sa stane riadkom, prvky poľa sa stanú stĺpcami bez názvov. Ak chcete hlavičky, musíte použiť pole objektov.

Otázka: Je možné konvertovať XLSX súbor na CSV pomocou tohto nástroja? Odpoveď: Táto stránka konvertuje JSON na CSV. Ak chcete konvertovať XLSX na CSV, použite špecializovaný nástroj na konverziu tabuliek.

Otázka: Ako zistím, koľko riadkov a stĺpcov bude mať výstupné CSV? Odpoveď: Nástroj po konverzii zobrazí počet riadkov a stĺpcov v náhľade. Ak presahujú povolené limity (10 000 riadkov alebo 200 stĺpcov), konverzia sa nevykoná a zobrazí sa príslušná chyba.