Beddelaha CSV to JSON

Waxa boggan ku sameyn karo

Boggani waa qalab loogu talagalay in CSV (Comma‑Separated Values) loo rogo JSON (JavaScript Object Notation). Haddii aad haysato fayl CSV – oo ah shax si toos ah loogu qoray, mid kasta oo saf ah oo ay kala soocaan comma, semicolon, ama tab – waxaad u baahan tahay inaad u beddesho JSON, inta badan qaab urur shay ah (array of objects) halkaasoo saf kasta uu noqdo shay, tiir kastana uu noqdo furaha (key). Qalabku wuxuu kaa caawinayaa inaad xulato faylka, doorato "JSON" sida qaabka soosaarka, sheegto delimiter‑ka saxda ah (CSV‑gu hadduu isticmaalayo wax ka duwan comma), ka dibna aad eegto horudhaca (preview) oo aad soo dejiso JSON‑ga dhammaaday.

Habka shaqeeya waa mid dhanka browser‑ka ku shaqeeya, oo faylka laguma soo geliyo server‑ka. Tani waxay ka dhigan tahay in xogtaada qarsoon (sida liisaska iibka, cinwaannada, xogta shaqaalaha) aysan u baahnayn inay ka gudubto kumbuyuutarkaaga. Qalabku wuxuu u shaqeeyaa sida isbeddel toos ah oo gudaha ku dhaca – isagoo bilaabaya faylka CSV oo ku dhameynaya JSON qaab dhismeed leh.

---

Maxaa boggan ka duwaya kuwa kale?

Qalabkani wuxuu leeyahay sifooyin gaar ah oo ka duwan qalabka kale ee isbeddelka qaababka. Waa kuwan:

1. Nooca xogta waa lagu qasbayaa, ma aha mid toos ah

CSV waxay kaydisaa wax walba oo qoraal ah (string). Tusaale ahaan, qiimaha 1,500 oo CSV ah waa qoraal "1500" ma aha tiro (number). JSON waxa uu taageeraa tirooyin, boolean (run/been), null, iyo qaabab qoto dheer. Laakiin qalabkani kama beddelayo tirooyinka ama taariikhaha. Qiimaha "00123" wuxuu ku sii jiraa JSON sida "00123", maaha 123. Tani waxay muhiim u tahay kuwa haya xogta sida boosta lambarrada hore loo haysto (postcodes) ama badeecada koodhadhka (product codes) oo eberka hore lumi karo haddii si toos ah loo tiro ahaan u qaato.

2. Ma jiro qaab qoto dheer (nesting)

CSV waa shax fidsan (flat table). Saf kasta oo CSV ah wuxuu u dhigmaa hal shay oo JSON ah, tiir kastana waa furaha. Ma sameyn kartid shay gudaha shay (object within object) ama shax sare. Tusaale ahaan, haddii aad haysato xogta "magaca qofka iyo cinwaankiisa oo qaybsan", CSV ma siin karo JSON qaabka:

{
  "magaca": "Cali",
  "cinwaan": { "magaalo": "Muqdisho", "guri": 12 }
}

Waxaa lagugu xaddidayaa in cinwaanku noqdo hal qoraal sida "Muqdisho, 12". Haddii aad u baahan tahay qaabka qoto dheer, waa inaad samaysataa tiirar kala duwan (magaalo, guri) oo kadibna aad ku rogto JSON ka dib.

3. Delimiter‑ka waa in la sheegaa

CSV waxay isticmaali kartaa comma, semicolon, ama tab. Qalabkani wuxuu kaa su’aalaa delimiter‑ka saxda ah. Kuma qasbana inaad doorato haddii faylkaagu yahay JSON ama XLSX, laakiin CSV‑gu wuxuu u baahan yahay. Haddii aad khalad u sheegto delimiter‑ka (tusaale ahaan, faylkaagu wuxuu isticmaalaa semicolon laakiin aad doorato comma), qalabku ma karin doono inuu si sax ah u akhriyo xogta.

4. Comma iyo line breaks ku dhex jira waa dhib badan yihiin

CSV waxay leedahay qawaaniin ka hadlaya sida loo xafido qiimayaasha ay ku jiraan comma ama line break gudaha (quoting rules). Laakiin qawaaniintan looma raaco si isku mid ah. Tusaale: haddii qiime uu ka kooban yahay "Muqdisho, Soomaaliya" oo aan la xigin (quotes), comma‑ka dhexdiisa wuxuu u qaybin doonaa laba tiir. Sidoo kale, line break gudaha xigashada (quoted field) waa dhib. Qalabkani wuxuu isku dayaa inuu u akhriyo si sax ah, laakiin faylalka khaldan ayaa keeni kara "This CSV could not be parsed."

---

Sida loo isticmaalo: tallaabo-tallaabo

1. Fur bogga oo raadso meesha "Choose a file" ama "Drag and drop".
2. Xulo faylkaaga CSV, JSON, ama XLSX. Haddii aadan dooran wax, ayaa kugu soo celin doonta: "Choose one file first."
3. Dooro output format – waxaad u baahan tahay inaad beddesho "JSON" (marka hore waa "JSON" sida caadiga ah).
4. Haddii faylku yahay CSV, dooro delimiter:
   • Comma (,) – waa kan ugu caansan.
   • Semicolon (;) – waxaa isticmaala dadka ku qora xogta qaybo ka mid ah Yurub, halkaasoo comma lagu isticmaalo jajabka (decimal).
   • Tab – inta badan laga soo qaado isbitaalka ama xisaabaadka.
5. Eeg horudhaca – qalabku wuxuu tusaale ka siinayaa sida JSON‑gu u ekaan doono, iyo tirada safafka iyo tiirarka.
6. Soo deji – guji badhanka "Download". Waxaad helaysaa fayl JSON oo leh.json.

Haddii faylkaagu yahay JSON ama XLSX, qalabku wuxuu u furayaa sida shax, ka dibna wuxuu u soo saaraa JSON. Laakiin boggan ujeedkiisu weyn waa CSV → JSON, sida magaca ka muuqata.

---

Fahamka CSV iyo JSON: qaab dhismeedka iyo kala duwanaanshaha

CSV – Qaab dhismeedka

CSV waa qaab qoraal fudud oo xogta loo kaydiyo shax. Safka koowaad (header) wuxuu ka kooban yahay magacyada tiirarka. Saf kasta oo xiga waa hal row oo xog ah. Magacyada tiirarka iyo qiimayaasha waxay kala soocan yihiin delimiter (comma, semicolon, tab). Tusaale:

Magac,Da'isha,Magaalo
Cali,25,Muqdisho
Xaawo,30,Hargeysa

JSON – Qaab dhismeedka

JSON waa qaab dhismeed xog ah oo adeegsada furaha iyo qiimaha (key‑value pairs). Shaxda sare waxay u rogantaa:

[
  { "Magac": "Cali", "Da'isha": "25", "Magaalo": "Muqdisho" },
  { "Magac": "Xaawo", "Da'isha": "30", "Magaalo": "Hargeysa" }
]

Fiiro: "25" waa qoraal, maaha tiro 25. Haddii aad u baahan tahay tiro, waa inaad ka dib beddeshaa JSON‑ga gacanta ama aalad kale.

Dhibaatooyinka nooca xogta

CSV ma haysto noocyo (types). Dhammaan qiimayaashu waa qoraal. Tani waa faa'iido iyo cilladba. Faa'iidada: eberka hore (sida "001") waa la keydiyaa sida uu yahay. Cilladda: haddii aad rabto in "1500" loo tiro ahaan u qaato, waa inaad qalab kale ama JavaScript function u isticmaasho si aad u beddesho Number("1500"). Qalabkani kuma sameeyo isbeddelkan toos ah.

Xiriirka CSV iyo JSON

CSV waa mid fidsan (flat). JSON wuxuu taageeraa qaabab qoto dheer. Marka CSV loo rogo JSON, waxaa laga yaabaa in lagu waayo macluumaadka qaabka (sida cinwaanka gudaha). Tani waa sababta qalabka "JSON → CSV" ay uga adag tahay, sababtoo ah waxay u baahan tahay in la fidsado (flatten) qaabka qoto dheer.

---

Cilladaha iyo qaladaadka caadiga ah

Waa kuwan cilladaha inta badan la kulmo:

• "This CSV could not be parsed." – Waxaa jira khalad ku saabsan xigashada (quoting), tiirar isku mid ah oo aan ahayn, ama delimiter khaldan. Tusaale: faylkaagu wuxuu isticmaalaa semicolon laakiin aad dooratay comma. Kaliya dooro delimiter saxda ah.
• "This file has no table rows." – Faylkaagu wuxuu leeyahay madaxa (header) laakiin ma jiraan safafka xogta. Haddii aad rabto inaad soo saarto JSON oo leh madaxa oo keliya, qalabkani ma sameyn karo.
• "This table has more than ‹max› rows." ama "This table has more than ‹max› columns." – Qalabku wuxuu leeyahay xad. Tirooyinka saxda ah (max) lama sheegin, laakiin haddii aad hesho fariinta, waa inaad yaraysaa xogta (tusaale: kala qaybi faylka).
• "This file is too large. Use a file under ‹max›." – Faylkaagu waa weyn yahay. Isku day inaad yaraysid xajmiga ama adeegsato qalab kale oo server‑ka ku shaqeeya.
• "Choose a CSV, JSON or XLSX file." – Waxaad soo gashay fayl aan ahayn noocyada la ogolyahay, sida.txt ama.pdf.
• "This conversion is taking too long. Try a smaller file." – Waxaa laga yaabaa in faylkaagu leeyahay xog badan ama qalabka browser‑kaaga uu gaabis yahay.

Talooyin ka hortag cilladaha

• Hubi in CSV‑gaagu uu leeyahay tiirar isku mid ah saf kasta.
• Xigashada (quotes) waa inay noqdaan laba jibaaran (double quotes) haddii qiimuhu ku jiro xigasho.
• Line break gudaha xigashada waa la ogol yahay, laakiin qalabku wuxuu u arkaa sida \n gudaha qoraalka JSON.
• Si aad u ilaaliso eberka hore, ha beddelin nooca xogta ka dib markaad soo dejiso.

---

Xadka faylka iyo miiska

Qalabkani wuxuu leeyahay xaddidaado xagga xajmiga iyo tirada safafka/tiirarka. Waa kuwan:

Tirooyinka saxda ah (sida 10,000 saf ama 500 tiir) lama sheegin, laakiin waa dhab in xadka jiro. Haddii aad hesho fariinta, kala qaybi xogtaada qaybo yaryar oo markiiba soo rog hal qayb. Tani waa caqli gal sababtoo ah browser‑kaagu wuxuu leeyahay xaddid xusuus (memory) iyo waqti.

Talo: Haddii aad shaqeynayso xog weyn (tusaale 100,000 saf), isticmaal qalabka xariiqda taliska (command line) sida csvkit ama Python script, sababtoo ah browser‑ka qaarkood way dhiman karaan.

---

Su'aalo inta badan la weydiiyo

1. Ma waxaan lumiyay eberka hore ee koodhadhka boosta? Maya, qalabkani wuxuu keydiyaa dhammaan qiimayaasha sida qoraal, marka eberka hore waa la ilaaliyaa. Tusaale: faylka CSV wuxuu leeyahay "00123", JSON‑ga soo baxa wuxuu noqonayaa "00123". Laakiin haddii aad marka dambe JSON‑ga ku shubto JavaScript ama Python oo si toos ah loogu tiro ahaan u qaato, eberka wuu lumi karaa.

2. Maxaa dhacaya haddii faylkaygu CSV uu leeyahay tiirar aan isku mid ahayn saf kasta? Qalabku wuxuu isku dayi doonaa inuu akhriyo, laakiin inta badan wuu guuldareystaa. Waxaa soo bixi doona "This CSV could not be parsed." Waa inaad hagaajisaa faylka (tusaale, ku dar madhan ama buuxi tiirarka maqan) ka hor intaadan isticmaalin.

3. Miyaan u rogi karaa JSON illaa CSV isla qalabkan? Haa, qalabkaani wuxuu leeyahay bog kale oo loogu talagalay JSON → CSV. Bogga hadda la joogo wuxuu ugu horayn u sameeyay CSV → JSON, laakiin haddii aad geliso fayl JSON, qalabku wuxuu u akhrin doonaa sidii shax (oo fidsan) oo wuxuu soo saari doonaa JSON kale. Si fiican u fiirso magaca bogga.

4. Maxaa sababa "This conversion is taking too long"? Faylkaaga ayaa laga yaabaa inuu aad u weyn yahay (tusaale, in ka badan 50,000 saf) ama browser‑kaagu wuu gaabis yahay. Isku day fayl yar oo tijaabo ah. Haddii ay tahay xog muhiim ah, isticmaal qalab desktop ama server‑ka.

5. Ma waxaan u isticmaali karaa semicolon delimiter haddii CSV‑gu yahay mid laga soo qaado Excel Soomaali? Haa, dad badan oo Soomaali ah ayaa isticmaala Excel oo leh jaantus (locale) halkaasoo comma loo isticmaalo jajabka (tusaale "1,5" = 1.5). Marka Excel‑ku wuxuu u soo dhigi karaa CSV isagoo adeegsanaya semicolon. Kaliya dooro "Semicolon" delimiter‑ka.

6. Ma xogta qarsoon waa lagu kaydiyaa server‑ka? Maya. Qalabkani wuxuu ku shaqeeyaa browser‑kaaga oo dhan, faylka laguma soo geliyo server‑ka. Waa badbaado xagga xogta qarsoon. Hadday tahay inaad u baahan tahay xaqiijin dheeri ah, fiiri caymiska (privacy policy) ee shabakada.