Převodník Excel na JSON

Čím se liší konverze XLSX na JSON od CSV

Převod excelového souboru do JSON není totéž co převod do CSV. Rozdíl pramení ze samotné podstaty obou formátů. CSV je textový formát, který každou hodnotu ukládá jako prostý řetězec oddělený čárkou nebo středníkem. Všechna data se tak změní na text – číslo 42 se stane řetězcem "42", boolovská hodnota TRUE se změní na text "TRUE". JSON je naproti tomu strukturovaný formát, který podporuje datové typy – čísla, boolovské hodnoty, pole, objekty a hodnotu null.

Když nástroj převede XLSX na JSON, čísla zůstanou čísly, boolovské hodnoty zůstanou TRUE nebo FALSE (v JSON jako true a false, bez uvozovek) a prázdné buňky se stanou hodnotou null. Tato vlastnost je zásadní pro programátory a datové analytiky, kteří chtějí s daty dále pracovat programově – nemusí po převodu převádět řetězce zpět na čísla nebo boolovské hodnoty.

Na rozdíl od CSV JSON také dobře zachycuje strukturu tabulky – první řádek (záhlaví) se stane klíči objektů a každý následující řádek se převede na jeden objekt. Výsledkem je pole objektů, které přesně odpovídá tabulkové struktuře. Tento výstup je přímo použitelný v JavaScriptu, API nebo databázích, které JSON nativně podporují.

Jak nástroj zpracovává typy buněk

Excelový soubor XLSX není jen prostý soubor – je to zipovaný XML soubor, který v sobě nese informace o každé buňce včetně jejího datového typu. XLSX rozlišuje několik základních typů: číslo (number), text (string), boolovská hodnota (boolean), datum (date) a prázdná buňka (empty). Formát JSON rovněž podporuje čísla, řetězce, boolovské hodnoty a null. Tato shoda umožňuje věrné mapování typů.

Datumy jsou zvláštní případ. Excel ukládá datum jako sériové číslo (např. 1. leden 1900 je 1, 1. leden 2024 je 45292). Nástroj toto číslo převede na datum a výsledek zapíše jako řetězec ve formátu ISO 8601. Pokud byste chtěli datum jako číslo, musíte si jej převést dodatečně – nástroj standardně používá textový zápis, který je univerzálně čitelný.

Pokud buňka obsahuje hodnotu, která není rozpoznatelná jako číslo ani boolovská hodnota, nástroj ji uloží jako řetězec. To se týká například textu smíchaného s čísly (např. "SKU-12345") nebo speciálních formátů čísel (např. měna zobrazená jako "1 500 Kč" – ta se převede na text, protože jde o formátovaný text, nikoli čisté číslo).

Proč se vzorce nevyhodnocují a formátování mizí

Excelové vzorce jsou součástí XLSX, ale nástroj je nevyhodnocuje. Při převodu se použije jen ta hodnota, která byla v buňce uložená v okamžiku posledního uložení souboru. Pokud máte buňku se vzorcem =A1+B1 a Excel ji uložil s výsledkem 15, do JSON půjde číslo 15. Vzorec samotný je ztracen.

Důvod je technický: XLSX sice obsahuje XML reprezentaci všech vzorců, ale jejich výpočet vyžaduje plnohodnotný Excel nebo knihovnu, která spouští výpočetní engine. Nástroj běžící v prohlížeči tuto možnost nemá – pracuje pouze s uloženými hodnotami. Pokud potřebujete aktuální výsledky vzorců, otevřete soubor nejprve v Excelu, nechte jej přepočítat a uložte. Pak teprve převeďte na JSON.

Stejně tak se ztrácí veškeré formátování – barvy buněk, fonty, orámování, sloučené buňky, podmíněné formátování. JSON je formát pro data, ne pro vizuální prezentaci. Sloučené buňky se navíc mohou chovat problematicky: nástroj je pravděpodobně přečte jako jednu buňku s hodnotou, zatímco ostatní buňky v oblasti sloučení budou prázdné. To může vést k neúplným datům. Pokud vaše tabulka obsahuje sloučené buňky, zkontrolujte výsledný JSON a případně data před konverzí upravte.

Proč jen první list a jak to obejít

Nástroj čte pouze první list (worksheet) excelového souboru. Je to záměr – specifikace nástroje je jednoduchá a přímá: nahrajete XLSX, dostanete JSON z prvního listu. Pokud máte data na více listech, musíte každý list převést zvlášť.

Jak na to? Nejjednodušší je otevřít soubor v Excelu, zkopírovat data z požadovaného listu do nového souboru a ten uložit jako XLSX. Pak tento soubor nahrajete do nástroje. Pokud potřebujete data ze všech listů, zopakujte postup pro každý list zvlášť. Výsledné JSON soubory pak můžete sloučit programově, například v Pythonu nebo JavaScriptu.

Alternativně můžete použít skript, který extrahuje data ze všech listů najednou – ale to už je nad rámec tohoto nástroje. Nástroj je určen pro rychlé jednorázové konverze, ne pro dávkové zpracování.

Konverze zcela offline – soukromí a rychlost

Celý převod probíhá ve vašem prohlížeči. Soubor se nikam neodesílá – žádný server, žádné cloudové úložiště. To je důležité zejména pro citlivá data, jako jsou finanční výkazy, osobní údaje nebo obchodní tajemství. Můžete si být jisti, že data neopustí váš počítač.

Technicky to funguje tak, že nástroj používá JavaScriptovou knihovnu, která čte XLSX soubor přímo v paměti prohlížeče. Knihovna rozbalí zipový archiv XLSX, přečte XML soubory uvnitř a extrahuje data. Poté je převede do JSON a zobrazí náhled. Tento proces je rychlý – obvykle trvá zlomek sekundy u běžných souborů. U velmi velkých souborů může trvat déle, a pokud překročí časový limit, zobrazí se chyba „Tento převod trvá příliš dlouho. Zkuste menší soubor.“ Vše běží offline – není třeba připojení k internetu (kromě prvního načtení stránky).

Omezení, chyby a co dělat, když něco nefunguje

Nástroj není univerzální konvertor všech excelových souborů. Stanovuje jasná omezení, která jsou uvedena v chybových hláškách:

• „Tento excelový soubor nelze otevřít.“ – Soubor je poškozený, nejde o platný XLSX (např. je to starý XLS formát), nebo má nekompatibilní strukturu. Zkuste soubor otevřít v Excelu a uložit jej znovu jako.xlsx.
• „Tento soubor neobsahuje žádné řádky tabulky.“ – První list je prázdný nebo obsahuje pouze záhlaví bez dat. Zkontrolujte, zda list skutečně obsahuje data.
• „Tento soubor je příliš velký. Použijte soubor pod ‹max›.“ – Překročili jste limit velikosti souboru. Zmenšete soubor – odstraňte nepotřebné listy, smažte prázdné řádky nebo použijte komprimaci. Přesná maximální velikost je uvedena v chybové hlášce.
• „Tato tabulka obsahuje více než ‹max› řádků.“ nebo „Tato tabulka obsahuje více než ‹max› sloupců.“ – Počet řádků nebo sloupců překročil limit. Rozdělte tabulku na menší části a převádějte je postupně.
• „Vyberte soubor CSV, JSON nebo XLSX.“ – Nástroj přijímá pouze tyto tři formáty. Jiné (např..ods,.xls,.csv) jsou odmítnuty.
• „Tento soubor nelze převést.“ – Obecná chyba, pravděpodobně neznámá struktura nebo neplatná data. Zkuste soubor otevřít a uložit znovu.
• „Převod zrušen.“ – Uživatel přerušil nahrávání nebo konverzi.
• „Tento převod trvá příliš dlouho. Zkuste menší soubor.“ – Soubor je příliš velký nebo složitý na to, aby byl zpracován v přiměřeném čase.

Při převodu také počítejte s tím, že skryté sloupce a řádky se do JSON pravděpodobně přenesou (pokud obsahují data). Pokud chcete data očistit, odstraňte nepotřebné sloupce a řádky před konverzí. Prázdné buňky se stanou null – pokud chcete mít data bez prázdných hodnot, musíte JSON dodatečně upravit.

FAQ

Otázka: Co se stane s prázdnými buňkami? Prázdná buňka se převede na null. Pokud buňka obsahuje pouze mezeru, je považována za textový řetězec s mezerou, nikoli za prázdnou. Pokud chcete mít výstup bez null, musíte jej dodatečně filtrovat.

Otázka: Můžu převést soubor s více listy najednou? Ne, nástroj převádí vždy jen první list. Ostatní listy ignoruje. Pro převod dalších listů musíte data zkopírovat do samostatných souborů a převádět je zvlášť.

Otázka: Proč se v JSON místo data zobrazí číslo? Datum v Excelu je uloženo jako sériové číslo (počet dní od 1. ledna 1900). Nástroj toto číslo převede na datum ve formátu ISO 8601. Pokud se zobrazí číslo, znamená to, že buňka nebyla rozpoznána jako datumový typ, nebo že formátování buňky není datumové. Zkontrolujte, zda má buňka v Excelu nastavený formát Datum.

Otázka: Je nástroj opravdu zdarma a bez omezení? Ano, nástroj je zcela zdarma. Jediná omezení jsou technická – maximální velikost souboru a maximální počet řádků a sloupců. Tato omezení jsou uvedena v chybových hláškách. Konverze probíhá offline, bez serveru, takže není účtován žádný poplatek.

Otázka: Můžu převést CSV nebo starý XLS soubor? Nástroj přijímá pouze soubory ve formátu XLSX (moderní Excel formát). Starší XLS soubory, CSV nebo ODS nejsou podporovány. Pokud máte starý XLS, otevřete jej v Excelu a uložte jako.xlsx. CSV soubory musíte nejprve převést do Excelu a uložit jako XLSX, nebo použít jiný nástroj určený pro CSV na JSON.