Konvertitur minn JSON għal CSV

X’jagħmel din il-paġna

Din il-paġna onlajn tippermetti li ttella’ fajl JSON (jew ittih b’drag and drop) u tikkonvertih f’fajl CSV. Tista’ tagħżel id-delimitatur għall-output — koma (comma), punt u virgola (semicolon) jew tab. Wara l-konverżjoni, ikollok preview tat-tabella, tara n-numru ta’ ringieli u kolonni, u tista’ tniżżel il-fajl lest. Kollox isseħħ fil-browser tiegħek: l-ebda data ma tintbagħat fuq server.

Dak li jagħmel din il-paġna differenti minn għodod oħra bħal CSV‑to-Excel jew Excel‑to‑JSON huwa li din il-konverżjoni tieħu format ġerarkiku u b’tipi ta’ data u tċattah (flatten) f’tabella ċatta u mingħajr tipi. JSON jappoġġa oġġetti, arrays, numri, booleani u null, kollha f’strutturi mbejta. CSV, min-naħa l-oħra, m’għandu l-ebda tip, l-ebda bejta, u l-ebda folja separata. Il-konverżjoni titlef l-informazzjoni tat-tip, l-istruttura mbejta, u kwalunkwe formattjar. Biex wieħed jirrappreżenta oġġetti JSON imbejta f’CSV ċatt, il-paġna tuża notazzjoni dot‑path (eż. address.city). Arrays ta’ oġġetti jsiru ringieli fit-tabella; arrays ta’ arrays jibqgħu ringieli. Minħabba li CSV juża delimitaturi, komas inkorporati u tmiem ta’ linja fi ħdan valuri jridu jiġu kkwotati — l-għodda tagħmel dan awtomatikament, iżda jista’ jkun li ż-żerijiet ta’ quddiem f’numri jintilfu. Inti trid tiddeċiedi kif ir-rappreżentazzjoni tal-kampijiet imbejta trid tkun qabel il-konverżjoni (l-għodda tuża dot‑paths b’mod awtomatiku).

Id-differenzi strutturali: JSON vs CSV

JSON huwa format ierarkiku u tipat. Kull valur jista’ jkun numru, stringa, boolean, null, oġġett jew array. CSV, min-naħa l-oħra, huwa format ċatt: kull ċellola fiha stringa biss. Meta tikkonverti minn JSON għal CSV, titlef l-informazzjoni dwar jekk valur kienx numru jew boolean. Pereżempju, "count": 42 isir 42 bħala stringa fil-CSV, mhux numru. "active": true isir true bħala stringa. null isir stringa vojta jew null skont kif jittieħed (il-paġna tikkonvertih f’stringa vojta). Din it-telfa hija inevitabbli; CSV sempliċement ma jappoġġax tipi.

Barra minn hekk, JSON jista’ jkollu strutturi fondi b’oġġetti fi ħdan oġġetti. Il-CSV ma jistax jirrappreżenta dan direttament. L-għodda tuża dot‑path notation biex “tċattar” l-oġġett. Jekk il-JSON tiegħek ikun:

{
  "isem": "Marija",
  "indirizz": {
    "triq": "Triq il-Kbira",
    "belt": "Valletta"
  }
}

Dan isir tabella b’kolonni isem, indirizz.triq, indirizz.belt. Jekk ikollok array ta’ oġġetti bħal dawn, kull oġġett isir ringiela waħda. Jekk l-array ikun fih arrays aktar milli oġġetti (eż. [, ]), kull array ta’ ġewwa jsir ringiela, u l-elementi jsiru kolonni mingħajr ismijiet ta’ kampijiet.

Huwa importanti li l-JSON ikun “table‑shaped”, jiġifieri array wieħed ta’ oġġetti (jew arrays). Jekk il-JSON ma jkunx validu jew ma jkollux din il-forma, il-paġna turi l-iżball: “This JSON is invalid or not table‑shaped.” Għalhekk, qabel ma tuża l-għodda, iċċekkja li l-JSON tiegħek għandu struttura konsistenti.

Kif jaħdem it-tċattar (flattening) b’dot‑path

It-tċattar ta’ oġġett JSON imbejta f’ringiela CSV isir billi kull par chiave‑valur fl-ogħla livell jittieħed bħala kolonna. Jekk valur huwa oġġett ieħor, iċ-chiave tiegħu tiġi miżjuda wara punt u l-proċess jitkompla. Din hija notazzjoni komuni fl-ipproċessar tad-data. Pereżempju, oġġett bħal:

{
  "a": 1,
  "b": { "c": 2, "d": { "e": 3 } }
}

Isir kolonni: a, b.c, b.d.e. Jekk l-istruttura ma tkunx simmetrika (xi oġġetti għandhom kampijiet differenti), il-kolonni jingħaqdu skont l-ewwel oġġett; kampijiet nieqsa jimtlew b’valuri vojta.

Meta jkollok array ta’ oġġetti, kull oġġett jipproduċi ringiela. Dan ifisser li l-array innifsu m’għandux isem fil-CSV — is-sors huwa l-array kollu. Jekk l-array fih arrays ta’ arrays, il-paġna tittrattahom bħala ringieli ta’ kolonni numerati (l-ebda ismijiet ta’ kolonni).

Għal min jaħdem ma’ data API frekwenti, it-tċattar b’dot‑path huwa mod veloċi biex tinġabar data ġerarkika f’format li tista’ timporta f’Excel, Google Sheets, jew sistemi ta’ databases. Madankollu, oqgħod attent: jekk l-oġġett tiegħek ikun fond wisq (ħafna livelli), il-kolonni jsiru twal u diffiċli biex jinqraw. Ikkunsidra jekk tistax tipproċessa qabel biex tnaqqas il-fond.

Delimitaturi u l-importanza tagħhom

Id-delimitatur fil-CSV jifred il-kolonni. Is-soltu jintuża l-koma, iżda f’ħafna pajjiżi (speċjalment fl-Ewropa) il-koma tintuża bħala separatur deċimali, għalhekk il-punt u virgola jsir l-għażla standard. L-għodda tagħti tliet għażliet: koma, punt u virgola, u tab.

Jekk tniżżel fajl CSV b’delimitatur differenti minn dak li tistenna l-applikazzjoni, il-kolonni jistgħu ma jinqasmux sewwa. Pereżempju, jekk tiftaħ fajl b’delimitatur punt u virgola f’Excel li jaħseb li l-koma hija s-separatur, il-kontenut kollu jista’ jispiċċa f’kolonna waħda. Għalhekk, qabel ma timporta, iċċekkja l-issettjar tad-delimitatur fil-software tiegħek.

L-għodda tapplika regoli ta’ kwotazzjoni awtomatiċi: jekk valur fih id-delimitatur, tmiem ta’ linja, jew kwotazzjoni doppja, jitqiegħed bejn kwotazzjonijiet. Dan huwa standard RFC 4180. Jekk il-valur fih kwotazzjoni, din tiġi duplikata (eż. "It-tikketta hija ""kbira"""). M’għandekx għalfejn tinkwieta biex tagħmel dan manwalment — il-paġna tagħmlu għalik.

Regoli, limiti u każijiet speċjali

Il-paġna għandha diversi kontrolli u żbalji li għandek tkun taf bihom:

• Daqs tal-fajl: Hemm limitu massimu. Jekk il-fajl ikun akbar, tara l-messaġġ: “This file is too large. Use a file under ‹max›.” (Il-valur eżatt jiddependi mill-browser u r-riżorsi).
• Numru ta’ ringieli u kolonni: Jekk it-tabella jkollha aktar minn ċertu numru ta’ ringieli jew kolonni, il-paġna xx it “This table has more than ‹max› rows.” jew “This table has more than ‹max› columns.”
• Format tal-fajl: Trid tagħżel fajl wieħed biss, u jrid ikun CSV, JSON jew XLSX. Jekk tipprova ttella’ tip ieħor, jidher: “Choose a CSV, JSON or XLSX file.”
• Output: Trid tagħżel output differenti mill-input? Jekk il-format tal-output huwa l-istess bħall-input, il-paġna tgħidlek “Choose a different output format.”
• Konverżjoni falluta: Jekk il-konverżjoni ma tirnexxix għal raġuni mhux magħrufa, tara “Could not convert this file.” Jekk tikkanċella l-operazzjoni, jidher “Conversion cancelled.” U jekk il-proċess idum wisq, tara “This conversion is taking too long. Try a smaller file.”

Importanti: it-trattament huwa kollu fuq in-naħa tal-klijent. L-ebda data ma titla’ fuq server, għalhekk din l-għodda hija sikura għal data sensittiva. Iżda m’hemmx għallingħaġ ħażina ta’ dekompressjoni; il-prestazzjoni tiddependi mid-daqs tal-fajl u l-qawwa tal-kompjuter tiegħek.

Wieħed mill-iżvantaġġi komuni huwa t-telf taż-żerijiet ta’ quddiem f’numri. Pereżempju, "01234" bħala stringa f’JSON jista’ jinqara bħala numru 1234 wara l-konverżjoni, jekk l-għodda tinterpretah bħala numru. Il-paġna tikkonverti valuri f’strings; jekk il-JSON fih numru mingħajr kwotazzjoni (eż. 1234), jitfa’ fil-CSV bħala 1234, u ż-żerijiet ta’ quddiem jintilfu jekk inti stennejthom bħala stringa. Għalhekk, jekk trid iżżomm żerijiet ta’ quddiem, iċċertahom bħala strings kwotati fil-JSON.

Min għandu bżonn din l-għodda

• Żviluppaturi li jridu jikkonvertu tweġiba API f’CSV biex jimportawha f’folja ta’ kalkolu.
• Analisti tad-data li jipproċessaw data ġerarkika u jridu jċattuha għal rapporti.
• Kull min jaħdem ma’ data sensittiva u ma jridx itella’ fajls fuq server (privacy).
• Utenti f’pajjiżi fejn id-delimitatur default huwa punt u virgola (bħal fl-Italja, Franza, Ġermanja, eċċ.).
• Min irid jipprova malajr konverżjoni mingħajr ma jkollu jinstalla software.

Mistoqsijiet Frekwenti (FAQ)

1. X’jiġri jekk il-JSON tiegħi jkun fih array ta’ arrays imma l-array ta’ barra jkun fih oġġetti wkoll?
L-għodda tittratta kull element bħala ringiela. Jekk tħallat tipi, il-konverżjoni x’aktarx tfalli b’messaġġ li jgħid li l-JSON mhux table‑shaped. Żomm struttura omoġenja.

2. Nista’ nżomm it-tipi oriġinali (numru, boolean) fil-CSV?
Le. CSV jappoġġa biss strings. Kull valur isir stringa fil-fajl output. Jekk għandek bżonn iżżomm it-tip, ikkunsidra format ieħor bħal JSON.

3. Għaliex qed jintilfu ż-żerijiet ta’ quddiem f’numri?
Jekk il-JSON fih "0123" (stringa kwotata), il-paġna żżommha bħala 0123. Iżda jekk il-JSON fih 123 (numru mingħajr kwotazzjoni), il-valur jitneħħa ż-żeru. Għalhekk, jekk iż-żerijiet ta’ quddiem huma importanti, uża strings fil-JSON.

4. L-għodda tista’ tikkonverti fajls kbar?
Iva, iżda hemm limitu. Jekk il-fajl ikun kbir wisq, tara messaġġ ta’ żball. Il-prestazzjoni tiddependi fuq ir-RAM tal-browser tiegħek. Għal fajls eċċezzjonalment kbar, ikkunsidra li taqsamhom.

5. Nista’ niftaħ il-fajl CSV direttament f’Excel?
Iva, iżda oqgħod attent għad-delimitatur. Jekk użajt punt u virgola, f’Excel tista’ timporta l-fajl billi tagħżel Data > From Text/CSV u tispeċifika d-delimitatur. Jekk tiftaħ direttament, jista’ jkun li l-kolonni ma jinqasmux sewwa minħabba l-lokalità.

6. X’inhu dot‑path notation?
Hija konvenzjoni fejn kampijiet imbejta jinkitbu b’punt bejniethom, bħal indirizz.belt. Tintuża biex tirrappreżenta struttura ġerarkika f’format ċatt. Jekk l-oġġett ikun profond, il-kolonni jistgħu jsiru twal, iżda tibqa’ tista’ tagħraf is-sors.