Excel í JSON breytir

Upphleðsla Excel-skjals og útkoma sem JSON

Þú velur eða dregur XLSX-skrá yfir á svæðið og færð til baka JSON-skrá sem inniheldur gögn úr fyrsta vinnublaðinu sem skipulagða töflu. Umbreytingin keyrir eingöngu í vafranum þínum — ekkert er hlaðið upp á neinn miðlara. Hér er nákvæmlega það sem gerist.

Hvað gerir þessa síðu frábrugðna

Að umbreyta XLSX í JSON er ekki það sama og að umbreyta í CSV. XLSX-skrá er þjöppuð XML-verkvöflun sem getur borið mörg blöð, frumugerðir (texta, tölur, dagsetningar, boolsk gildi), formúlur og ríka sniðmátun. JSON er aftur á móti skrifað, hreiðranlegt snið — það styður hluti, fylki, tölur, boolsk gildi og null.

Þetta þýðir að þegar þú umbreytir úr XLSX í JSON varðveitast töluleg og boolsk frumugildi sem skrifuð JSON-gildi (frekar en að vera þvinguð innan gæsalappa). Sniðmátun frumna, formúlur (sem eru ekki reiknaðar) og öll gögn umfram fyrsta vinnublaðið eru hent. Ólíkt CSV, sem flatar hverja röð í óbrotna textalínu, getur JSON táknað töflulega byggingu sem fylki af hlutum og heldur dálkaheitum sem lykla. Hins vegar er upprunataflan flöt — það er engin stigveldi í XLSX-töflu sjálfri — svo hreiðruð JSON-virkni verður ekki til sjálfkrafa.

Flest verkfæri á netinu þvinga allt í strengi. Þetta verkfæri notar raunveruleg gildi: tala 42 í Excel verður talan 42 í JSON, ekki strengurinn "42". Boolsk gildi eins og SATT í Excel verður true í JSON. Dagsetningar, sem Excel geymir sem raðtölur, verða að ISO 8601 strengjum í JSON (sjá nánar hér að neðan). Þetta er lykilmunurinn fyrir forritara sem þurfa gögn með réttum gerðum.

Innri virkni XLSX-skrár og hvernig hún er lesin

XLSX-skrá er í raun ZIP-safn sem inniheldur XML-skrár. Inni í því er:

• xl/workbook.xml — lýsir vinnublöðum, nöfnum þeirra og uppbyggingu.
• xl/worksheets/sheet1.xml — inniheldur raunveruleg gögn fyrir fyrsta vinnublaðið.
• xl/sharedStrings.xml — texti sem er endurnýttur milli frumna (t.d. dálkaheitin).
• xl/styles.xml — sniðmátun (leturgerð, litir, brúnir) og frumugerðir.

Vafrinn opnar ZIP-safnið og les sheet1.xml. Fyrir hverja frumu er kóðinn:

1. Sækir gildið úr XML-gögnunum (t.d. <v>42</v>).
2. Athugar frumugerðina úr styles.xml (t.d. tala, strengur, dagsetning).
3. Notar rétta JSON-gerð: tala fyrir tölur, true/false fyrir boolsk gildi, streng fyrir texta, ISO 8601 streng fyrir dagsetningar.

Formúlur eru lesnar sem síðast vistað gildi — ekki endurreiknaðar. Þannig að ef þú hefur frumu með formúlunni =A1+B1 og vistað gildi er 15, þá færðu 15 í JSON, ekki formúluna sjálfa.

Fyrsta vinnublaðið: hvað tapast og af hverju

Verkfærið les aðeins fyrsta vinnublaðið í XLSX-skránni. Þetta er algengasta atburðarásin: flest Excel-skjöl innihalda aðal gögnin á fyrsta blaðinu. Ef þú þarft gögn úr öðrum blöðum verður þú að afrita þau á fyrsta blað eða umbreyta hverju blaði fyrir sig.

Hvað tapast:

• Sniðmátun: allt sem lítur vel út í Excel — litir, leturgerðir, brúnir, bakgrunnslitir — er hent. JSON snýst um gögn, ekki útlit.
• Sameinaðar frumur: ef frumur eru sameinaðar, les verkfærið aðeins gildið í efri vinstri frumunni. Aðrar sameinaðar frumur verða að tómum strengjum.
• Formúlur: eins og fyrr segir, aðeins niðurstöður (vistað gildi) eru varðveittar.
• Faldir dálkar eða raðir: þau eru lesin, en falla inn í JSON-gögnin. Ef þú vilt ekki falin gögn, þarftu að sýna þau fyrst og taka þau svo út handvirkt.
• Fleytimyndir, töflur og línurit: þau eru ekki gagnabærar — aðeins frumugildi teljast.

Vörpun frumugerða: frá Excel til JSON

Excel hefur þrjár megingerðir sem skipta máli fyrir JSON-vörpun:

Hvað með dagsetningar? Excel geymir dagsetningar sem raðtölur (t.d. 45144 fyrir 15. ágúst 2023). Umbreytirinn skrifar þær sem ISO 8601 streng í UTC, eins og "2023-08-15T00:00:00.000Z". Ef þig vantar annað snið, verður þú að vinna JSON-gögnin eftir á.

Takmarkanir og villuboð

Verkfærið hefur nokkrar takmarkanir. Þessar takmarkanir snúast um skráarstærð og stærð gagna:

• Skráarstærð: skráarstærð er takmörkuð við 8 MB. Ef XLSX-skráin er stærri en 8 MB birtist villuboðin: „Þessi skrá er of stór. Notaðu skrá undir ‹max›.“
• Fjöldi raða: taflan getur mest innihaldið 10.000 raðir.
• Fjöldi dálka: taflan getur mest innihaldið 200 dálka.

Aðrar villuboð:

Hvað gerist eftir umbreytingu

Eftir að umbreytingu lýkur færðu:

• JSON-skrá til niðurhals: venjulega nefnd output.json.
• Forsýn af gögnunum: fyrstu 8 raðirnar og 8 dálkarnir birtast á skjánum.
• Fjölda raða og dálka: til dæmis „12 raðir, 5 dálkar“.
• Skráarstærð JSON-úttaksins: til dæmis „2.3 KB“.

Forsýnin gerir þér kleift að athuga hvort umbreytingin hafi tekist rétt áður en þú hleður niður. Ef gögnin líta ekki rétt út (t.d. vantar dálka, óvænt gildi), skaltu athuga Excel-skránna og tryggja að fyrsta vinnublaðið innihaldi það sem þú þarft.

Hvernig vafrinn vinnur gögnin staðbundið

Öll vinna fer fram í vafranum þínum. Þegar þú velur XLSX-skrá:

1. Vafrinn les skrána.
2. XML-skrárnar eru þáttaðar.
3. Fyrsta vinnublaðið er lesið og gögnum safnað saman.
4. Gögnunum er breytt í JSON-format.
5. JSON-strengurinn er gerður aðgengilegur til niðurhals.

Engin gögn fara upp á miðlara. Þetta er lykilatriði fyrir næði: þú getur umbreytt viðkvæmum gögnum (t.d. fjárhagsupplýsingum, persónuupplýsingum) án þess að þau fari í gegnum netið.

Algeng mistök og hvernig á að forðast þau

• Hausar sem spanna margar raðir: ef taflan þín er með sameinaða hausa (t.d. tvær raðir með titlum), les verkfærið aðeins fyrstu röðina sem hausa. Þú gætir endað með skrýtna lykla. Betra er að hafa eina röð af hausum.
• Tóm raðir: tómar raðir eru felldar niður.
• Falinn dálkar: ef þú hefur falið dálka, birtast þeir samt í JSON. Athugaðu þetta fyrirfram.
• Formúlur sem skila villum: villugildi verða að strengjum í JSON. Þetta gæti ruglað gögnin þín. Gakktu úr skugga um að allar formúlur skili réttum gildum fyrir umbreytingu.

Hverjir nota þetta og af hverju

• Vefþróunaraðili sem fær vörugögn í Excel og þarf þau sem JSON fyrir API eða framendaforrit.
• Gagnafræðingur sem vill umbreyta ársfjórðungsskýrslu (XLSX) í vélrænt lesanlegt JSON-snið fyrir frekari vinnslu.
• Teymi sem vinnur með utanaðkomandi aðilum sem kjósa JSON fram yfir Excel og þurfa einstaka umbreytingu án þess að setja upp hugbúnað.
• Persónuverndarsinnar sem vilja umbreyta XLSX-skjölum í JSON án þess að hlaða þeim upp í skýjaþjónustu.

Algengar spurningar

Af hverju verða dagsetningar að tölum í JSON? Excel geymir dagsetningar sem raðtölur (fjölda daga frá 1. janúar 1900). Umbreytirinn skrifar þær sem ISO 8601 streng í UTC, eins og "2023-08-15T00:00:00.000Z". Ef þig vantar annað snið, verður þú að vinna JSON-gögnin eftir á.

Get ég fengið gögn úr fleiri en einu vinnublaði? Nei, aðeins fyrsta vinnublaðið er lesið. Til að fá gögn úr öðrum blöðum verður þú að afrita þau á fyrsta blað eða nota annað verkfæri sem styður mörg blöð.

Hvað gerist ef Excel-skráin er með formúlu? Verkfærið les aðeins síðast vistað gildi formúlunnar, ekki formúluna sjálfa. Ef þú hefur ekki vistað skrána eftir að formúlur voru reiknaðar, gæti gildið verið rangt eða vantað.

Hvernig virkar þetta í vafranum? Erum við ekki að hlaða upp gögnum? Nei, öll vinnsla fer fram staðbundið í vafranum. Skráin er lesin beint úr tækinu þínu. Ekkert er sent á miðlara — öryggið er í raun fullkomið fyrir þetta verkfæri.

Hvað með tómar frumur? Tómar frumur verða að tómum strengjum í JSON.

Er hægt að breyta sniði JSON-úttaksins? Nei, verkfærið skilar alltaf fylki af hlutum (array of objects) með dálkaheitum sem lykla. Ef þú þarft annað snið (t.d. fylki af fylkjum), verður þú að vinna gögnin eftir umbreytingu.