An próiseas comhshó: JSON go XLSX
Nuair a chruthaíonn tú API, nuair a íoslódálann tú cumraíocht ó chóras, nó nuair a oibríonn tú le sonraí gréasáin, is minic a thagann tú ar chomhaid JSON. Ach ceapadh JSON le haghaidh meaisíní, ní le haghaidh scarbhileog. Tá struchtúr ordlathach aige – rudaí laistigh de rudaí, eagair, uimhreacha, luachanna fíor nó bréagach, agus null. Is éard atá sa leathanach seo ná uirlis a ghlacann comhad JSON amháin agus a thiontaíonn é go comhad Excel (XLSX). Ní hamháin go n-athraíonn sé an fhormáid; déanann sé an t-ordlathas a leacú go dtí tábla cothrom. Déantar eochracha rudaí a thiontú ina gceannteidil cholún, agus déantar gach réad ina shraith. Eochracha neadaithe – mar address.city – a leathnaítear le cosán poncanna.
Oibríonn an tiontú go hiomlán sa bhrabhsálaí. Ní uaslódáiltear an comhad riamh; coinnítear na sonraí go príobháideach ar do ghléas féin. Tar éis an chomhshó, feicfidh tú réamhamharc, chomh maith le líon na sraitheanna agus na gcolún sa tábla, agus méid an chomhaid aschuir XLSX. Cliceáil le híoslódáil, agus faigheann tú leathán oibre aonair – gan foirmlí, gan stíleanna, gan ach sonraí statacha.
Cad a dhéanann an leathanach seo difriúil
Tá an chuid is mó de na huirlisí ar líne a thiontaíonn idir formáidí ag glacadh le sonraí cothroma cheana féin. Nuair a athraíonn tú CSV go Excel, tá an tábla réidh; níl le déanamh ach na colúin a aithint. Ach tá JSON difriúil. Tá sé clóscríofa agus neadaithe. Is féidir le réad a bheith ina eochair arís agus arís eile, nó d’fhéadfadh eagar de rudaí a bheith ann. Ní féidir le scarbhileog cothrom ordlathas den sórt sin a stóráil go díreach. Mar sin cuireann an uirlis seo rialachán leacaithe i bhfeidhm.
Leacú ciallaíonn go dtéann gach eochair neadaithe ar chosán poncanna. Mar shampla, má tá réad agat mar seo:
{
"ainm": "Síle",
"seoladh": {
"cathair": "Gaillimh",
"cód": "H91"
}
}
Tiontaítear é go colúin ainm, seoladh.cathair, seoladh.cód. Tá an chosán ponc seo riachtanach toisc nach dtacaíonn XLSX le neadú réada. Gan an leacú, ní bheadh aon bhealach chun an gaol idir cathair agus a réad tuismitheora a léiriú.
Difríocht eile is ea caomhnú cineálacha sonraí. Stórálann XLSX, mar fhormáid XML zipáilte, cineálacha go dúchasach: uimhreacha (integer, decimal), booleans (TRUE/FALSE), agus téacs. Ní dhéanann CSV ach gach rud a laghdú go téacs. Mar sin más mian leat uimhreacha nó luachanna fíor/bréagach a choinneáil mar atá siad, seachas iad a shlánú go téacs, is fearr an XLSX seo ná CSV.
Cé nach gcoimeádann an uirlis foirmlí ná stíleáil, coimeádann sí an cineál sonraí bunaidh ón JSON. Is tabhairt faoi deara é seo: má tá "praghas": 29.99 agat sa JSON, beidh 29.99 sa chill XLSX mar uimhir, ní mar an téacs "29.99".
Iontráil agus aschur
Iontráil: Comhad JSON amháin. Caithfidh sé a bheith ‘cruth tábla’ – is é sin, eagar de rudaí nó eagar d’eagair. Ní oibreoidh réad aonair nó eagar de luachanna scaipthe.
Aschur: Comhad XLSX (Excel). Tá leathán oibre amháin ann. Taispeánann an uirlis réamhamharc ar an leathanach gréasáin sula n-íoslódálann tú, mar aon le:
- Líon na sraitheanna
- Líon na gcolún
- Méid an chomhaid aschuir (i gcilibhirt)
Próiseáil: Oibríonn an tiontú go hiomlán sa bhrabhsálaí (JavaScript). Ní sheoltar aon sonraí chuig freastalaí. Mar sin coinnítear príobháideacht – tá sé seo úsáideach má tá sonraí íogaire sa JSON.
Na rialacha agus cásanna imeall
Tá roinnt srianta agus earráidí sonracha sa uirlis seo. Seo iad na cinn is tábhachtaí:
- Ní mór comhad amháin a roghnú. Má roghnaíonn tú níos mó ná ceann, nó mura roghnaíonn tú aon cheann, feicfidh tú an teachtaireacht: “Choose one file first.” (Roghnaigh comhad amháin ar dtús.)
- Ní mór gur comhad CSV, JSON nó XLSX é. Má roghnaíonn tú cineál eile, feicfidh tú: “Choose a CSV, JSON or XLSX file.”
- Teorainn méid: Má tá an comhad níos mó ná an t-uasmhéid a cheadaítear (ní shonraítear uimhir sa bhileog fíricí, ach tá an earráid ann), feicfidh tú: “This file is too large. Use a file under ‹max›.” (Tá an comhad seo rómhór. Úsáid comhad faoi ‹max›.)
- Ní mór an JSON a bheith ‘cruth tábla’. Mura bhfuil sé – mar shampla, má tá sé ina réad aonair nó ina eagar de naisc – feicfidh tú: “This JSON is invalid or not table‑shaped.” (Tá an JSON seo neamhbhailí nó níl sé i gcruth tábla.)
- Ní mór go mbeadh ar a laghad sraith amháin ann. Má tá an t-eagar folamh, feicfidh tú: “This file has no table rows.” (Níl aon sraitheanna tábla sa chomhad seo.)
- Teorainn líon sraitheanna agus colún: Má tá níos mó ná an t-uasmhéid (uimhir shonraithe sa chóras) sraitheanna nó colún ann, feicfidh tú earráid. Mar shampla: “This table has more than ‹max› rows.” (Tá níos mó ná ‹max› sraitheanna sa tábla seo.)
- Cealú: Má chliceálann tú cealú le linn an chomhshó, feicfidh tú: “Conversion cancelled.”
- Moill: Má tá an comhad an-mhór agus an tiontú ag glacadh an iomad ama, feicfidh tú: “This conversion is taking too long. Try a smaller file.” (Tá an tiontú seo ag glacadh an iomad ama. Bain triail as comhad níos lú.)
Conas a oibríonn an leacú go mion: Nuair a bhíonn eagar de rudaí agat, déantar gach réad ina shraith. Má tá eochair ag réad a bhfuil réad eile inti, leathnaítear í le cosán poncanna. Má tá eagar ag réad, déantar an eochair a leathnú ach coimeádtar an t-eagar mar shraith amháin – níl aon neamhneadú. Mar shampla:
[
{"ainm": "Síle", "scóir":},
{"ainm": "Seán", "scóir":}
]
Tiontaítear go colúin ainm agus scóir. Sa chill XLSX, beidh an t-eagar le feiceáil mar an téacs ``. Ní dhéanann an uirlis iarracht an t-eagar a leathnú go colúin il, toisc go mbeadh sé sin ag brath ar fhad an eagair, rud atá dothuartha.
Eagar d’eagair: Má tá eagar ina bhfuil eagair (ní rudaí), déantar gach eagar istigh ina shraith. Mar shampla:
[,]
Tiontaítear go tábla le trí cholún (colún 0, colún 1, colún 2) agus dhá shraith. Níl aon ainmneacha colún, ach uimhreacha.
Luachanna null agus folamh: Má tá eochair i réad ach go bhfuil a luach null, nó mura bhfuil an eochair ann i roinnt rudaí, líonann an uirlis an chill le folamh (ceall folamh) sa XLSX. Ní chuirtear an focal "null" isteach mar théacs.
Cé a bhaineann leas as?
- Anailísithe sonraí: Tá JSON coitianta ó APIs; is minic gur gá é a iniúchadh in Excel. In ionad script a scríobh chun an JSON a leacú, is féidir an uirlis seo a úsáid go tapa.
- Innealtóirí bogearraí: Agus iad ag obair le comhaid chumraíochta nó le freagraí API, is minic a sheolann siad JSON chuig baill foirne nach bhfuil ach Excel acu. Is féidir an comhad a thiontú agus é a sheoladh ar aghaidh.
- Daoine a oibríonn le sonraí clóscríofa: Más gá uimhreacha nó booleans a choinneáil mar atá siad (seachas iad a chailleadh i téacs CSV), is é XLSX an rogha.
- Aon duine atá ag iarraidh sonraí ordlathacha a fheiceáil i bhfoirm tábla gan script a scríobh.
Ceisteanna coitianta
C: Cén fáth a bhfaighim an earráid “This JSON is invalid or not table‑shaped”?
F: Caithfidh an JSON a bheith ina eagar de rudaí nó ina eagar d’eagair. Mura bhfuil sé sin (mar shampla, má tá sé ina réad aonair nó ina shnáithe), ní féidir é a thiontú go tábla. Déan cinnte go bhfuil do JSON timpeallaithe ag lúibíní cearnacha [] agus go bhfuil gach eilimint ina réad nó ina eagar.
C: An gcoimeádtar formáidí cille cosúil le dathanna nó cló? F: Ní choimeádtar. Scríobhann an uirlis ach na sonraí statacha. Ní thacaíonn sí le stíleáil, le foirmlí, ná le hiliomad leatháin oibre. Is tiontú glan ar an tábla amháin é.
C: Cad a tharlaíonn má tá eagar laistigh de réad, mar scóir:?
F: Déanann an uirlis an t-eagar a thiontú go téacs sa chill, mar ``. Ní chruthaíonn sí colún nua do gach uimhir. Féach an sampla thuas faoi eagair.
C: An féidir liom comhad XLSX a uaslódáil chun é a thiontú ar ais go JSON? F: Ní hea. Ní dhéanann an leathanach seo ach JSON go XLSX. Ní thacaíonn sé le tiontú droim ar ais.
C: Cén fáth nach bhfuil ach leathán oibre amháin san aschur? F: Tá an uirlis deartha chun an JSON a leacú go dtí tábla amháin. Ní chruthaíonn sé leatháin iolracha, fiú má bhí an JSON il-leibhéil. Má theastaíonn leatháin iolracha uait, beidh ort an JSON a roinnt de láimh.
C: An bhfuil teorainn le méid an chomhaid? F: Tá. Má tá an comhad rómhór, feicfidh tú an earráid “This file is too large. Use a file under ‹max›.” Ní shonraítear an uimhir uasta sa bhileog fíricí, ach braitheann sé ar acmhainn do bhrabhsálaí. Moltar comhaid faoi chúpla megabyte. Má tá an comhad an-mhór, féadfaidh an tiontú a bheith rómhall nó titim as.