Tiontaire JSON go CSV

Cad a dhéanann an leathanach seo?

Ligeann an uirlis seo duit comhad JSON a uaslódáil (nó a tharraingt isteach sa fhuinneog) agus é a thiontú go comhad CSV. Roghnaíonn tú an deighilteoir a bheidh sa CSV: camóg (comma), leathstad (semicolon) nó cluaisín (tab). Taispeántar réamhamharc den tábla roimh an íoslódáil, agus feicfidh tú líon na rónta agus líon na gcolún atá sa toradh. Chomh maith leis sin, taispeántar méid an chomhaid aschuir. Tarlaíonn an phróiseáil ar fad i do bhrabhsálaí féin – ní sheoltar aon sonraí chuig freastalaí.

Chun tús a chur, níl le déanamh ach comhad JSON a roghnú (foirmeacha inghlactha: CSV, JSON, XLSX – ach ní bhaineann ach JSON leis seo in áit). Ansin roghnaigh an deighilteoir atá uait don CSV. Nuair a bheidh an tiontú críochnaithe, is féidir leat an comhad a íoslódáil. Déantar an tiontú láithreach, gan fanacht.

Cad a dhéanann an leathanach seo difriúil?

Is é an príomh-dhifríocht idir an leathanach seo agus tiontuithe eile (COSÚL le CSV-go-Excel nó Excel-go-JSON) gur cothromú (flatten) a dhéanann sé ar fhormáid ordlathach, chlóscríofa ina tábla cothrom gan chló. Smaoinigh ar JSON: tacaíonn sé le réada, le heagair, le huimhreacha, le booleans, agus le null, agus is féidir iad seo go léir a neadú laistigh dá chéile. Ar an taobh eile, níl aon chló ag CSV – gach rud ina theaghrán – agus níl aon neadú ná bileoga ann. Cailltear an fhaisnéis faoi chineál sonraí, an struchtúr neadaithe, aon bhileoga breise (ní bhíonn siad ann i JSON ar aon nós) agus aon fhormáidiú.

Chun réada neadaithe JSON a léiriú i dtábla cothrom, úsáideann an uirlis nodaireacht cosán le ponc (dot‑path notation). Mar shampla, má tá réad JSON mar seo:

{
  "ainm": "Séan",
  "seoladh": {
    "cathair": "Baile Átha Cliath",
    "poist": "D02"
  }
}

tiontófar é go colún darb ainm seoladh.cathair agus colún eile seoladh.poist. Déantar eagair réada go rónta sa tábla; déantar eagair eagair a choinneáil mar rónta freisin (gan aon eochracha réada). Toisc go n-úsáideann CSV deighilteoirí, caithfear camóga agus briseadh líne atá leabaithe i luachanna a chur in athfhriotail – láimhseálann an uirlis é seo go huathoibríoch. Mar sin féin, cailltear nialais tosaigh in uimhreacha.

Caithfidh tú cinneadh a dhéanamh roimh ré ar conas ba mhaith leat réimsí neadaithe a léiriú – úsáideann an uirlis cosáin le ponc de réir réamhshocraithe.

Conas a oibríonn an tiontú ó JSON go CSV?

Ní mór don JSON a bheith i bhfoirm tábla-chruthach – is é sin, eagar amháin de réada, nó eagar d’eagair. Mura bhfuil an JSON bailí nó nach bhfuil sé tábla-chruthach, taispeántar an earráid: “This JSON is invalid or not table‑shaped.”

Tá dhá chás ann:

• Eagar réada – déantar gach réad ina ró (sraith), déantar eochracha na réada ina gcolúin. Má tá réad neadaithe laistigh de réad eile, leathnaítear é le nodaireacht chosáin (cosán le ponc). Mar shampla, ligimis go bhfuil eagar mar seo:

[
  {"ainm": "Máire", "scór": 90},
  {"ainm": "Pádraig", "scór": 85}
]

Tiocfaidh sé seo amach mar CSV le dhá cholún (ainm, scór) agus dhá sheanró.

Ach má tá réad neadaithe ann:

[
  {"ainm": "Máire", "teagmháil": {"rphost": "maire@example.com", "guthán": "012345"}}
]

Beidh colúin mar ainm, teagmháil.rphost, teagmháil.guthán.

• Eagar eagair – déantar gach eagar inmheánach ina ró, agus déantar gach eilimint sa tsraith sin ina cholún. Níl aon eochracha réada ann, mar sin tugtar colúin uimhrithe de ghnáth (C1, C2, etc.).

Tá sé tábhachtach a thabhairt faoi deara nach gcoinnítear cineálacha JSON sa CSV. Déantar gach luach a thiontú go teaghrán. Ciallaíonn sé sin:

• Uimhreacha ar nós 42 nó 3.14 → teaghráin "42", "3.14"
• Booleans true → "true"
• null → "null"
• Nialais tosaigh ar nós 01234 → "1234" (cailltear an nialas tosaigh)

Ní féidir le CSV idirdhealú a dhéanamh idir uimhir agus téacs, mar sin caithfidh an t-úsáideoir a bheith aireach faoin gcaillteanas seo.

Teorainneacha agus cásanna imeall

Tá roinnt teorainneacha ag an uirlis seo, mar atá luaite sa bhileog fíricí:

• Méid comhaid – má tá an comhad rómhór, taispeántar an earráid: “This file is too large. Use a file under ‹max›.” Ní shonraítear uimhir bheacht sa bhileog fíricí, ach tá teorainn i bhfeidhm.
• Líne rónta agus colún – má tá níos mó ná ‹max› ró nó níos mó ná ‹max› colún sa tábla, gheobhaidh tú earráidí faoi seach: “This table has more than ‹max› rows.” agus “This table has more than ‹max› columns.”
• Earráidí eile – d’fhéadfadh teachtaireachtaí mar “Choose one file first.”, “Choose a CSV, JSON or XLSX file.”, “Choose a different output format.”, “Could not convert this file.”, “Conversion cancelled.”, nó “This conversion is taking too long. Try a smaller file.” a bheith le feiceáil.

Is iad na cásanna is coitianta a mbíonn fadhbanna ag daoine leo:

1. JSON neamhbhailí – má tá botún comhréire sa JSON (lúibíní ar iarraidh, camóg sa bhreis), ní oibreoidh an tiontú.
2. JSON nach bhfuil tábla-chruthach – murab éard atá ann ná eagar réada nó eagar eagair, ní féidir leis an uirlis é a láimhseáil. Mar shampla, réad aonair (ní eagar) nó réada neadaithe go domhain nach bhfuil aon phatrún sraitheanna ann.
3. Nialais tosaigh – mar a luadh, cailltear iad. Má tá uimhreacha le nialais tosaigh (cosúil le cóid phoist nó uimhreacha fóin), caithfear iad a choinneáil mar theaghráin sa JSON (idir athfhriotail) – ach fiú ansin, caillfear an nialas tosaigh sa CSV de bharr go ndéanann an uirlis gach iontráil a phróiseáil mar uimhir mura bhfuil sí in athfhriotail. Ní ráthaíonn an uirlis coimeád na nialas tosaigh.
4. Iontráil ríomhchláir nó foirmlí – ní dhéantar ach luachanna infheicthe a thiontú; ní ríomhtar aon chód ná foirmlí atá i JSON.

Mar gheall go dtarlaíonn gach rud ar an taobh cliant, níl aon riosca maidir le sonraí a sheoladh chuig freastalaí. Is buntáiste mór é seo d’úsáideoirí a bhfuil imní orthu faoi phríobháideachas.

Cé a bhaineann úsáid as an uirlis seo?

Tá an uirlis seo úsáideach do dhaoine a fhaigheann sonraí i bhformáid JSON (mar shampla, ó API nó ó chomhad sonraí de chineál éigin) agus a dteastaíonn uathu iad a ionchur in Excel, Google Sheets, nó in uirlisí allmhairí bunachar sonraí. Ós rud é go bhfuil CSV ar cheann de na formáidí is comónta le haghaidh allmhairiú táblaí, is réiteach tapaidh é.

Baineann an uirlis leas freisin as:

• Úsáideoirí a dhéanann próiseáil sonraí íogair agus nach bhfuil cead acu sonraí a uaslódáil chuig freastalaí meánach.
• Ríomhchláraitheoirí a chruthaíonn píblínte sonraí go tapa agus a theastaíonn uathu JSON a thiontú go CSV díreach sa bhrabhsálaí.
• Daoine a oibríonn i dtíortha ina n-úsáidtear deighilteoirí éagsúla (leathstad in ionad camóg) agus a dteastaíonn uathu an CSV a shaincheapadh dá réir.

Mar shampla, má tá tú ag obair le sonraí praghsanna ó API agus gur mhaith leat iad a oscailt i scarbhileog, is féidir leat an comhad JSON a tharraingt isteach anseo, roghnú an deighilteoir atá uait (semicolon, mar shampla, le húsáid le huimhreacha Eorpacha), agus an CSV a íoslódáil. Tá sé tapa, slán, agus níl gá le haon bhogearraí speisialta.

Leideanna úsáideacha

• Réamhamharc – bain úsáid as an réamhamharc sula n-íoslódálann tú. Taispeánann sé líon na rónta agus na gcolún. Má tá na colúin mícheart (mar shampla, ag súil le heochracha ach feiceann colúin uimhrithe), seans nach bhfuil an JSON tábla-chruthach ar an mbealach a cheap tú.
• Deighilteoir – roghnaigh an deighilteoir a oireann do do thimpeallacht. Má tá tú ag allmhairiú go Excel i dtír ina n-úsáidtear camóg mar dheighilteoir deachúlach, b’fhéidir gur fearr leathstad nó cluaisín a roghnú le mearbhall a sheachaint.
• Struchtúr JSON – sula ndéanann tú an tiontú, is fiú an comhad JSON a iniúchadh le cinntiú go bhfuil sé ina eagar réada nó ina eagar eagair. Is féidir é seo a dhéanamh le haon eagarthóir téacs nó le huirlis ar líne a léiríonn struchtúr JSON.
• Nialais tosaigh – má tá tábhacht leo, smaoinigh ar iad a fhágáil mar theaghráin sa JSON (idir athfhriotail) agus an CSV a chur in eagar de láimh ina dhiaidh sin, nó uirlis eile a úsáid a thacaíonn le cineálacha sonraí.

Ceisteanna Coitianta

C: Cén fáth a bhfaighim “This JSON is invalid or not table‑shaped”?
F: Ní bhíonn an comhad i bhfoirm eagair réada nó eagair eagair. Seiceáil go bhfuil an JSON bailí (gan botúin lúibíní) agus go bhfuil sé ina eagar (tosaithe le ‘[’).

C: An gcaillfear mo chuid nialas tosaigh?
F: Is féidir. Má tá uimhir mar 01234 aige, tiontóidh sé go 1234 sa CSV. Ní bhfaigheann tú rabhadh sa chomhad aschuir. Más gá iad a choinneáil, úsáid teaghráin (athfhriotail) sa JSON, ach níl aon ráthaíocht.

C: An féidir liom an CSV a oscailt go díreach i Excel?
F: Is féidir, ach bí cúramach faoin deighilteoir a roghnaítear. Má roghnaíonn tú camóg agus má úsáideann Excel camóg mar dheighilteoir deachúlach (mar a tharlaíonn i roinnt tíortha, cosúil le hÉirinn), seans go mbeidh mearbhall ann. Roghnaigh deighilteoir dá réir.

C: Cé mhéad sonraí is féidir a thiontú?
F: Tá teorainn le méid an chomhaid, líon na rónta agus líon na gcolún. Nuair a sháraítear iad, taispeántar earráid shoiléir. Níl na huimhreacha beachta liostaithe, ach tá siad i bhfeidhm.

C: An ndéanann an uirlis an comhad a uaslódáil chuig freastalaí ar bith?
F: Ní dhéanann. Próiseáiltear gach rud i do bhrabhsálaí féin. Ní sheoltar aon sonraí lasmuigh de do ríomhaire.

C: Cad a tharlóidh má tá camóga nó briseadh líne i luachanna sa JSON?
F: Cuireann an uirlis athfhriotail (comharthaí athfhriotail) timpeall ar luachanna den sórt sin, mar a éilíonn caighdeán CSV. Mar sin, ní bheidh aon fhadhb agat leis an CSV a léamh i scarbhileog.