Převodník JSON na Excel

Jak nástroj JSON to Excel funguje

Nástroj přijme jediný JSON soubor a převede jej do formátu XLSX (Excel). Samotný převod není triviální, protože JSON je typovaný a hierarchický – může obsahovat vnořené objekty, pole, čísla, booleany a hodnoty null. Plochá tabulka naproti tomu žádnou takovou hierarchii přímo nepodporuje. Proto musí dojít k algoritmickému zploštění (flattening) struktury.

Konverze probíhá výhradně v prohlížeči. Žádný soubor není odeslán na server. To má význam pro práci s citlivými daty – API klíče, konfigurační soubory nebo exporty z interních systémů zůstávají na lokálním počítači.

Vstupem musí být JSON, který je „tabulkový“ – tedy pole objektů (každý objekt je jeden řádek) nebo pole polí (každé pole je jeden řádek). Jednotlivý objekt je také přijatelný – převede se na tabulku s jedním řádkem.

Výstupem je soubor XLSX. Nástroj zobrazí náhled tabulky (prvních 8 řádků a 8 sloupců), počet řádků a sloupců a velikost výsledného souboru před stažením.

Zplošťování vnořených JSON struktur

Hlavní rozdíl oproti nástrojům, které převádějí CSV nebo již existující Excel do jiného formátu, spočívá ve způsobu práce s hierarchií. JSON umožňuje libovolné vnoření objektů do objektů a polí do polí. Plochý tabulkový procesor s tím neumí pracovat – každá buňka obsahuje jednu skalární hodnotu, nikoli celý podobjekt.

Algoritmus nástroje proto postupuje takto:

• Pro každou dvojici klíč–hodnota, pokud je hodnota primitivní (řetězec, číslo, boolean, null), zapíše tuto hodnotu do buňky patřící k cestě klíče.
• Pokud je hodnota jiný objekt, algoritmus rekurzivně pokračuje a rozšiřuje cestu klíče o každý podklíč.
• Pokud je hodnota pole primitivních hodnot, stane se z ní jedna buňka obsahující JSON reprezentaci tohoto pole – např. `` jako řetězec.
• Pokud objektu chybí klíč, který se objevuje v jiných objektech, chybějící buňka zůstane prázdná. Hodnoty null se také stanou prázdnými buňkami.
• Vnořené klíče se vyjádří pomocí tečkové notace. Například objekt {"address": {"city": "Praha", "zip": "11000"}} vytvoří dva sloupce: address.city a address.zip.
• Pokud je pole objektů uvnitř objektu, není toto pole rozbaleno do samostatných řádků. Místo toho je celé pole převedeno na JSON řetězec a umístěno do jedné buňky.

Příklad:

Vstupní JSON:

[
  {
    "id": 1,
    "name": "Jan Novák",
    "address": {
      "city": "Brno",
      "street": "Hlavní 5"
    },
    "tags": ["admin", "editor"],
    "active": true
  },
  {
    "id": 2,
    "name": "Eva Svobodová",
    "address": {
      "city": "Ostrava",
      "street": "Nádražní 12"
    },
    "tags": ["viewer"],
    "active": false
  }
]

Výstupní tabulka bude mít sloupce: id, name, address.city, address.street, tags, active.

• Hodnota true se převede jako logická hodnota TRUE do buňky.
• Hodnota false se převede jako FALSE.
• Pole tags se stane jedinou buňkou obsahující JSON reprezentaci pole, např. ["admin","editor"] jako řetězec.

Datové typy v JSON versus XLSX

JSON pracuje s několika primitivními typy: string, number, boolean, null. Dále obsahuje struktury object a array. XLSX (formát Office Open XML) ukládá buňky s typy, například číslo (number), řetězec (string), logická hodnota (boolean) nebo prázdná buňka. CSV naproti tomu převádí vše na text – číslo 100 se v CSV uloží jako "100" a při opětovném načtení do Excelu se často interpretuje jako text, nikoli číslo.

Nástroj JSON to Excel provádí mapování typů:

Důsledky pro praxi:

Pokud váš JSON obsahuje čísla, například "cena": 2490.50, v XLSX bude uloženo jako číslo 2490,50 (s desetinnou tečkou, kterou Excel interpretuje podle místního nastavení). Naproti tomu CSV by uložilo "2490.50" jako text, pokud byste výslovně nepoužili jiný formát. To je zásadní výhoda XLSX pro další zpracování – vzorce, sumarizace, kontingenční tabulky.

Booleany jsou dalším případem: JSON používá true a false, což v XLSX odpovídá funkcím TRUE() a FALSE(). V CSV by se zapsaly jako "true" nebo "false" jako text, což by při importu nefungovalo jako logická hodnota.

Hodnota null se v XLSX neprojeví jako chyba ani jako text „null“. Buňka zůstane prázdná, což je v Excelu korektní reprezentace chybějící hodnoty.

Omezení ploché tabulky

Ne všechny JSON struktury lze smysluplně převést na tabulku. Nástroj pracuje pouze s prvním listem sešitu. Nevytváří více listů, nekopíruje vzorce a nezachovává formátování, protože JSON žádné neobsahuje.

Nejčastější problémy:

• Pole uvnitř objektu – pokud máte JSON, kde každý záznam obsahuje pole (např. seznam hodnocení), toto pole se do tabulky nevejde jako samostatné sloupce. Místo toho se celé pole převede na JSON řetězec a umístí do jedné buňky.
• Víceúrovňové vnoření – například tři úrovně objektů vedou k názvům sloupců typu a.b.c.d. To je sice čitelné, ale při velkém počtu úrovní vznikají velmi dlouhé názvy sloupců.
• Smíšené struktury – pokud některé objekty v poli mají jiné klíče než jiné, vznikne tabulka s mnoha sloupci, z nichž většina je pro daný řádek prázdná. Nástroj vytvoří sjednocení všech klíčů napříč všemi objekty, což může vést k velmi řídké tabulce.
• Pole polí – nástroj podporuje i vstup ve tvaru [ [1, "x"], [2, "y"] ]. V tomto případě se jednotlivé prvky vnitřních polí stanou buňkami řádků. Názvy sloupců se negenerují, první vnitřní pole je jednoduše prvním řádkem listu.

Chybové stavy a jejich význam

Nástroj definuje několik konkrétních chybových hlášení. Každé odpovídá konkrétní situaci:

V praxi je nejčastější chybou „This JSON is invalid or not table‑shaped.“ Uživatelé často nahrávají neplatný JSON (např. s čárkou na konci nebo řetězci v jednoduchých uvozovkách). Řešením je spustit soubor přes JSON validátor a opravit syntaxi.

Další častý problém je překročení limitu sloupců. Pokud máte JSON s objekty, které mají mnoho různých klíčů (např. export z netypové databáze), výsledná tabulka může mít mnoho sloupců. Pokud limit je 200 sloupců, konverze selže. V takovém případě je nutné data předzpracovat – například vybrat pouze relevantní klíče nebo strukturu rozdělit.

FAQ

Proč se názvy sloupců při zploštění oddělují tečkou?

Protože JSON objekty mohou být vnořené. Plochý sloupec tabulky potřebuje jeden název. Tečková cesta je standardní způsob reprezentace hierarchie v záhlaví.

Můžu do výsledného souboru přidat vzorce nebo formátování?

Ne. Nástroj zapisuje pouze statická data z JSON. Výstupní XLSX neobsahuje žádné vzorce, podmíněné formátování, barvy, sloučené buňky ani makra. Pokud potřebujete výsledek dále upravovat, otevřete soubor v Excelu a přidejte formátování ručně.

Co se stane, když JSON obsahuje hlouběji vnořené objekty s více úrovněmi?

Každá úroveň se přidá k názvu sloupce: a.b.c.d.

Zachová nástroj prázdné řetězce ("") nebo null jako prázdné buňky?

Ano, obě hodnoty vedou k prázdné buňce v XLSX.

Je možné převést více JSON souborů najednou?

Ne. Nástroj zpracovává vždy jeden soubor.