JSON‑taulukon muuntaminen Exceliksi: miten hierarkkinen data litteroidaan soluiksi
Tämä sivu tekee yhden asian: se ottaa vastaan JSON‑tiedoston ja tuottaa XLSX‑tiedoston eli Excel‑työkirjan. Muunnos ei ole triviaali, koska JSON on luonnostaan hierarkkinen ja tyypitetty, kun taas laskentataulukko on kaksiulotteinen ruudukko. Siksi työkalu pakkaa sisäkkäiset rakenteet litteäksi taulukoksi käyttämällä pisteviivaa (dot‑path) osoittamaan alkuperäistä polkua.
Työkalun keskeinen ero verrattuna CSV‑ tai Excel‑lähteistä tehtyihin muunnoksiin on se, että JSON vaatii nimenomaisen litistysvaiheen. CSV ja Excel ovat jo valmiiksi litteitä, joten niissä ei tarvitse päättää, miten sisäkkäiset kentät käännetään sarakeotsikoiksi. Tässä muunnoksessa jokainen avainpolku tulee näkyviin otsikkoriville, ja eri tietotyypit — numerot, totuusarvot, null — siirtyvät sellaisinaan XLSX‑soluihin.
Kaikki käsittely tapahtuu selaimessa. Yhtään tiedostoa ei lähetetä palvelimelle, joten data pysyy omalla koneella. Tämä on olennainen yksityisyysnäkökohta, varsinkin jos JSON sisältää henkilötietoja tai liikesalaisuuksia.
Miten JSON litistetään taulukoksi
JSON on kieliriippumaton tiedonsiirtomuoto, joka perustuu avain–arvo‑pareihin (oliot), järjestettyihin listoihin (taulukot) ja primitiivityyppeihin (merkkijonot, numerot, totuusarvot, null). Kun tällainen rakenne muunnetaan laskentataulukoksi, jokainen rivi vastaa yhtä oliota, ja jokainen sarake vastaa yhtä avainta. Jos arvo on itse olio, sen kentät nostetaan pääolion tasolle pisteviivalla.
Esimerkki: jos JSON sisältää olion {"osoite": {"kaupunki": "Helsinki", "postinumero": "00100"}}, se muuttuu kahdeksi sarakkeeksi: osoite.kaupunki ja osoite.postinumero. Toisella rivillä voi olla osoite.kaupunki: "Turku" ja osoite.postinumero: "20100". Tämä litistys tekee hierarkkisesta datasta suoraviivaisesti taulukkomuotoista.
Työkalu osaa käsitellä kaksi rakennetyyppiä:
| JSON‑rakenne | Miten käsitellään |
|---|---|
Oliotaulukko [{...}, {...}] |
Jokainen olio muodostaa yhden rivin, ja olioiden avaimet määrittävät sarakkeet. |
Taulukoiden taulukko [[...], [...]] |
Jokainen sisempi taulukko on yksi rivi, ja sen alkioista tulee sarakkeet. |
Jos JSON on pelkkä olio (ei taulukko), se muunnetaan yksiriviseksi taulukoksi. Jos tiedosto ei ole kelvollinen JSON, työkalu palauttaa virheen: "This JSON is invalid or not table‑shaped.".
Tietotyypit: numerot, totuusarvot ja null
XLSX‑tiedosto on sisäisesti zipattujen XML‑tiedostojen kokoelma, ja se voi tallentaa datatyyppejä solutasolla. Tämä on merkittävä etu CSV:hen verrattuna, sillä CSV ei tunne tietotyyppejä — kaikki tallennetaan merkkijonona, mikä aiheuttaa ongelmia numeroille, päivämäärille ja totuusarvoille.
Tässä tilanteessa:
- Numerot (kokonaisluvut ja liukuluvut) tallennetaan XLSX‑soluihin numeerisina. Tämä tarkoittaa, että laskutoimitukset ja summa‑funktiot toimivat heti ilman muunnosta.
- Totuusarvot (true/false) tallennetaan Excelin oikeina totuusarvosoluina. Ne eivät muutu merkkijonoiksi, joten esimerkiksi
=LASKE.JOS()toimii odotetusti. - null‑arvot tallennetaan tyhjinä soluina. Tämä on tavallinen ja looginen vastine, koska tyhjä solu tarkoittaa tietokannan merkinnöissä usein "ei tietoa".
- Merkkijonot pysyvät merkkijonoina.
Yksi huomionarvoinen asia: JSONissa voi olla sama avain eri tietotyypeillä eri riveillä (esim. "hinta": 100 rivillä 1 ja "hinta": "ei myynnissä" rivillä 2). Taulukkomuodossa tämä on validia, mutta Excel saattaa kohdella rivejä eri tavoin. Työkalu ei yritä pakottaa tyyppiä — se kirjoittaa solun siinä muodossa, jossa tieto JSONissa on.
XLSX‑tiedoston rakenne ja rajoitukset
XLSX on virallinen Office Open XML -formaatti, jota Microsoft Excel, LibreOffice Calc ja Google Sheets tukevat. Tiedosto on zip‑paketti, joka sisältää:
xl/workbook.xml: määrittelee työkirjan ja sen työarkit.xl/worksheets/sheet1.xml: sisältää varsinaisen datan, solujen viitteet, tietotyypit ja mahdolliset kaavat.xl/styles.xml: määrittelee solujen muotoilun (fontit, reunukset, taustavärit)._rels/.rels: tiedostojen väliset suhteet.
Tämä työkalu tuottaa vain yhden työarkin (Sheet1). Se ei kopioi mitään muotoilua JSONista — ei värejä, fontteja, eikä solujen yhdistämisiä. Se ei myöskään laske kaavoja eikä tallenna makroja. Tämä on tietoinen rajoitus: työkalu on suunniteltu datan siirtämiseen, ei visuaaliseen muotoiluun.
Työkalulla on käytännön rajat, jotta käsittely pysyy sujuvana selaimessa:
- Tiedoston koko enintään 8 Mt.
- Enintään 10 000 riviä.
- Enintään 200 saraketta.
Nämä mainitaan virheilmoituksissa:
- "This file is too large. Use a file under ‹max›."
- "This table has more than ‹max› rows."
- "This table has more than ‹max› columns."
Yleisimmät virhetilanteet ja niiden syyt
Työkalu antaa selkeät virheilmoitukset, jotka kertovat tarkalleen, mikä meni pieleen. Tässä ovat kaikki mahdolliset virheet ja niiden merkitys:
| Virheviesti | Syy |
|---|---|
| "Choose a CSV, JSON or XLSX file." | Valittu tiedosto ei ole tuetuissa formaateissa (vain JSON otetaan tässä vastaan). |
| "This file is too large. Use a file under ‹max›." | Tiedoston koko ylittää sallitun maksimin (8 Mt). |
| "This JSON is invalid or not table‑shaped." | JSON on joko syntaksiltaan virheellinen tai se ei ole olio‑ tai taulukkotaulukko. |
| "This file has no table rows." | JSON on tyhjä taulukko `` tai olio on tyhjä {}. |
| "This table has more than ‹max› rows." | Taulukossa on liikaa rivejä (yli 10 000). |
| "This table has more than ‹max› columns." | Taulukossa on liikaa sarakkeita (yli 200). |
| "Conversion cancelled." | Käyttäjä on keskeyttänyt muunnoksen. |
| "This conversion is taking too long. Try a smaller file." | Selaimen JavaScript‑suoritusaika on ylitetty (yli 12 sekuntia). |
Yleisin virhe on "This JSON is invalid or not table‑shaped.". Jos JSON on {"nimi": "Matti", "ika": 30}, se on olio, mutta ei taulukko. Oikea muoto olisi [{"nimi": "Matti", "ika": 30}]. Myös syvästi sisäkkäiset oliot, jotka eivät ole yhdenmukaisia, voivat aiheuttaa yllätyksiä — esimerkiksi jos yhdessä oliossa on "osoite": {"kaupunki": "Hki"} ja toisessa "osoite": "Ei osoitetta", työkalu luo sarakkeen osoite ja sarakkeen osoite.kaupunki. Tämä on tekninen ratkaisu, mutta saattaa johtaa harhaan, jos käyttäjä odottaa täysin symmetristä taulukkoa.
Kenelle tämä työkalu on tarkoitettu
Tavallisin käyttäjä on henkilö, jolla on JSON‑dataa esimerkiksi REST‑rajapinnasta, järjestelmän konfiguraatiosta tai IoT‑laitteesta ja joka haluaa tarkastella sitä taulukkolaskentaohjelmassa. Toinen tyypillinen käyttäjä on data‑analyytikko, joka tarvitsee pikaisen “silmäyksen” JSON‑tiedostosta ilman, että kirjoittaa Python‑skriptiä pelkkää litistystä varten.
Kolmas ryhmä on tiimityöntekijät, jotka saavat JSON‑tiedostoja kehittäjiltä mutta käyttävät itse Exceliä. Heille tämä on suorin reitti saada data laskentataulukkoon ilman, että heidän tarvitsee oppia JSON‑rakenteita syvällisesti.
Lisäksi henkilöt, jotka välttävät CSV:tä sen tyyppimuunnosongelmien vuoksi, hyötyvät XLSX‑tuotoksesta. Jos tiedosto sisältää esimerkiksi tuotenumeroita, joissa on etunollia ("00123"), CSV saattaa muuttaa ne luvuksi 123, kun taas XLSX säilyttää merkkijonon.
Usein kysytyt kysymykset (FAQ)
Voinko muuntaa JSONin, jossa on useita sisäkkäisiä taulukoita?
Yksi sisäinen taulukko kerrallaan. Jos JSON on {"tuotteet": [{"nimi": "kirja"}, {"nimi": "kynä"}]}, taulukko tuotteet litistetään omiksi riveikseen, mutta avain tuotteet itsessään korvataan polulla tuotteet.nimi. Syvä taulukoiden taulukko (esim. ``) toimii suoraan rivi‑sarakemuodossa.
Mitä tapahtuu, jos JSON sisältää eri avaimia eri riveillä?
Kaikki uniikit avaimet (myös litistyksen jälkeen) tulevat sarakeotsikoiksi. Jos rivillä 1 on nimi ja ika, ja rivillä 2 on nimi ja osoite, taulukkoon tulee kolme saraketta: nimi, ika, osoite. Puuttuvat solut jäävät tyhjiksi.
Miten tiedoston koko vaikuttaa käytettävyyteen? Työkalu käsittelee tiedoston selaimessa, joten suuret tiedostot (yli 8 Mt) voivat pidentää käsittelyaikaa tai kaataa välilehden. Virheilmoitus "This conversion is taking too long. Try a smaller file." tulee, jos suoritusaika ylittää rajan (noin 12 sekuntia).
Voinko muuntaa JSONin, joka on yksi iso olio ilman taulukkorakennetta?
Kyllä. Yksi olio muunnetaan yksiriviseksi taulukoksi: sen avaimista tulee sarakkeet. Sen kääriminen hakasulkeisiin ([{...}]) antaa saman tuloksen.
Säilyykö JSONin kellonaika- ja päivämäärät? JSONissa ei ole omaa päivämäärätyyppiä. Ne ovat yleensä merkkijonoja (ISO 8601 -muodossa) tai aikaleimoja (lukuina). Työkalu tallentaa ne sellaisinaan — merkkijonoina tai numeroina. Jos haluat Excelin päivämäärämuodon, sinun täytyy muuntaa ne manuaalisesti Excelissä.
Onko tulos avattavissa Google Sheetsissa? Kyllä. XLSX on standardiformaatti, ja Google Sheets avaa sen ilman ongelmia. Kaikki tiedot, tietotyypit ja tyhjyysarvot säilyvät.