Excel–JSON konvertáló

Miért más ez a konvertáló?

A legtöbb online XLSX–JSON átalakító vagy CSV-szerű szöveggé lapítja az adatokat, vagy feltölti a fájlt egy szerverre. Ez az eszköz mindkét problémát egyszerre oldja meg. Az XLSX fájl valójában egy tömörített XML munkafüzet: több munkalapot, sejttípusokat (szöveg, szám, dátum, logikai), képleteket és formázást hordozhat. A JSON ezzel szemben típusos, beágyazható formátum: objektumokkal, tömbökkel, számokkal, logikai értékekkel és null-lel. A CSV minden értéket idézőjeles sztringgé kényszerít, amit utólag újra kell elemezni. Ez a konvertáló a numerikus és logikai értékeket típusosan hagyja meg: a 42 számként, az IGAZ booleanként, a null pedig null-ként jelenik meg a JSON-ban. A képletek számított eredményét ― a mentéskori látható értéket ― használja, nem magát a képletszöveget. A sejtformázás (betűtípus, szín, cellaegyesítés) elveszik, ahogy a második és további munkalapok adatai is. A feldolgozás kizárólag a böngészőben fut: a fájl sosem hagyja el a számítógépet. Ez adatvédelmi szempontból döntő, ha bizalmas kimutatásokat vagy ügyféladatokat konvertál.

Hogyan működik: teljesen a böngészőben

Az eszköz a fájlt a felhasználó gépén bontja ki. A böngésző beolvassa az XLSX-et, és közvetlenül feldolgozza a ZIP-ben található XML fájlokat. A legelső munkalapot veszi alapul, és a sorokat egy JSON tömbbe alakítja, ahol minden sor egy objektum, a kulcsok pedig az első sorban található fejlécek. Ha az első sor nem tartalmaz fejléceket, a kimenetben automatikusan generált kulcsnevek (0, 1, 2…) jelennek meg. Mivel a feldolgozás lokális, nincs szükség internetkapcsolatra a konverzióhoz ― az oldal betöltése után a fájlkezelés végig a kliensen marad. Ez az eljárás lehetővé teszi, hogy akár több ezer soros XLSX fájlokat is másodpercek alatt konvertáljon anélkül, hogy várakozni kellene a feltöltésre és a szerveroldali feldolgozásra.

Bemenetek, kimenetek és előnézet

Bemenet: egyetlen XLSX fájl, amelyet vagy fogd-és-vidd módszerrel, vagy a fájlkiválasztó gombbal lehet megadni. A formátumnak XLSX-nek kell lennie.

Kimenet: letölthető JSON fájl, amely az első munkalap adatait tartalmazza. A konvertálás után az oldalon előnézet jelenik meg: a táblázat első 8 sora és 8 oszlopa olvasható formában, valamint a sorok és oszlopok száma, illetve a kimeneti JSON fájlmérete. A sorok és oszlopok számát a konverzió pontosan meghatározza; ha a tábla üres (azaz nincs adatsor), a program hibaüzenetet ad.

Például egy ilyen Excel tábla esetén:

a JSON kimenet a következő lesz:

[
  { "Név": "Anna", "Életkor": 30, "Aktív": true },
  { "Név": "Béla", "Életkor": 25, "Aktív": false }
]

Figyeljük meg, hogy az Életkor számként, az Aktív pedig logikai értékként (true/false) jelenik meg, nem idézőjelezve.

Sejttípusok precíz leképezése JSON-ba

Az XLSX fájl minden cellája tárolja a típusát. A böngészőben futó konverter ezt a típust használja fel a JSON érték meghatározásához:

• Szám (number): egész vagy lebegőpontos számként marad meg. A tizedesvesszőt tartalmazó számok is pontot kapnak (pl. 3,14 → 3.14).
• Logikai (boolean): IGAZ → true, HAMIS → false. A logikai értékek soha nem válnak számokká vagy szöveggé.
• Dátum: az Excel a dátumokat egy sorszámként tárolja (például 44562 a 2022. január 1-jét jelenti). A konvertáló ezt a számot ISO 8601 formátumú szöveggé alakítja (pl. "2022-01-01T00:00:00.000Z"). Ha más formátumra van szükség, azt utólag kell feldolgozni.
• Szöveg (string): közvetlenül sztringgé válik, idézőjelek között.
• Üres cella: null értékként jelenik meg a JSON-ban.
• Hibaérték: ha a cella hibaértéket tartalmaz (pl. #ÉRTÉK!), az a kimenetben szövegként jelenik meg.

A képletek esetében a program a látható (már kiszámított) értéket veszi át. Ha a képlet nincs kiszámolva (például ha a fájl csak a képletet tárolja, de az eredmény nincs elmentve), akkor az érték null lehet. Ezért fontos, hogy az XLSX fájlt előtte nyissák meg és mentsék el Excelben vagy LibreOffice-ban, hogy a számítások frissüljenek.

Korlátok, hibák és amit tudni érdemes

Az eszköz bizonyos határokat és szabályokat alkalmaz a stabil működés érdekében:

• Csak az első munkalapot dolgozza fel. Ha több munkalap adataira van szükség, azokat külön kell exportálni.
• Cellastílusok, egyesített cellák, betűtípusok, színek elvesznek. Az egyesített cellákból csak a bal felső cella értéke kerül a JSON-ba; a többi cella üres lesz.
• Fájlméret korlát: a fájl mérete legfeljebb 8 MB lehet. Ha a feltöltött fájl meghaladja ezt a méretet, a hibaüzenet: “This file is too large. Use a file under ‹max›.”
• Sor- és oszlopszám korlát: a táblázat legfeljebb 10 000 sort és 200 oszlopot tartalmazhat. Ha a táblázatban több sor vagy oszlop van, mint a megengedett maximum, a konverzió megszakad a megfelelő hibaüzenettel.
• Hibás fájl: ha az XLSX nem nyitható meg (sérült vagy nem XLSX formátum), a “This Excel file could not be opened.” üzenet jelenik meg.
• Üres munkalap: ha az első munkalap egyetlen adatsort sem tartalmaz, a program “This file has no table rows.” hibát ad.
• Egyéb hibák: “Choose a CSV, JSON or XLSX file.”, “Could not convert this file.”, “Conversion cancelled.”, “This conversion is taking too long. Try a smaller file.”

A konvertáló nem készít hierarchikus JSON-t: a táblázat lapos, ezért a kimenet egy objektumokból álló tömb. Ha beágyazott szerkezetre van szükség (pl. termékek és alkategóriák), azt utófeldolgozással kell megoldani.

Gyakori kérdések

Miért csak az első munkalapot használja?
Az XLSX fájl több lapot is tartalmazhat. Az eszköz csak az első munkalapot olvassa be. Ha másik lap adataira van szüksége, először helyezze át azt a lapot az első pozícióba az Excelben a feltöltés előtt.

Hogyan konvertálhatok dátumokat szöveggé?
A dátumok ISO 8601 formátumú szövegként jelennek meg. Ha más formátumra van szüksége, utólag kell feldolgoznia az ISO sztringet.

Elvesznek a képletek? És a cellák egyesítése?
Igen. A konverzió a cellák aktuális értékét használja, nem a képletet. Az egyesített cellák esetében csak a bal felső cella értéke marad meg; a többiben üres sztring lesz.

Biztonságos a feltöltés?
Nem történik feltöltés. A fájl a saját számítógépén marad a konverzió teljes ideje alatt. Ez a megoldás ideális érzékeny adatok esetén.

Van fájlméret-korlát?
Igen. A fájl mérete legfeljebb 8 MB lehet, és legfeljebb 10 000 sor és 200 oszlop lehet.

Miért kapok “This Excel file could not be opened.” hibát?
Valószínűleg a fájl sérült, nem XLSX formátumú (pedig a kiterjesztése az), vagy esetleg régebbi .xls fájl. Az eszköz kizárólag a modern XLSX (Office Open XML) fájlokat fogadja el. Nyissa meg a fájlt Excelben és mentse újra XLSX-ként.