Apakah yang Dilakukan Halaman Ini?
Halaman ini menerima satu fail JSON dan menukarnya kepada fail Excel (XLSX). Proses penukaran dilakukan secara automatik: struktur hierarki JSON diratakan menjadi jadual rata. Kunci objek menjadi tajuk lajur, tatasusunan objek menjadi baris, dan kunci bersarang dikembangkan dengan nama laluan bertitik (dot‑path). Anda boleh melihat pratonton hasil serta memuat turun fail spreadsheet yang telah siap.
Input yang diperlukan ialah satu fail JSON pada satu masa. JSON tersebut mestilah “berbentuk jadual” – iaitu sama ada tatasusunan objek (array of objects) atau tatasusunan tatasusunan (array of arrays). Output yang dihasilkan ialah fail XLSX. Selain daripada pratonton, alat ini juga memaparkan bilangan baris dan lajur dalam jadual yang ditukar, serta saiz fail output.
Mengapa Perataan Diperlukan?
JSON adalah berjenis dan boleh bersarang. Ia boleh mengandungi objek, tatasusunan, nombor, boolean, dan null. Sebaliknya, spreadsheet rata tidak boleh mewakili hierarki tersebut secara langsung. Apabila anda menukar JSON kepada Excel, peraturan perataan (flattening) perlu digunakan – lajur dinamakan dengan laluan bertitik (contohnya address.city). Ini berbeza dengan penukaran daripada CSV atau Excel, yang sumbernya sudah pun rata.
Format sasaran, XLSX, adalah buku kerja XML yang dizip. Ia boleh menyimpan jenis data seperti nombor dan boolean secara natif – tidak seperti CSV yang menukarkan semuanya kepada teks. Namun begitu, alat ini tidak mengekalkan sebarang formula atau gaya sel; ia hanya menulis data statik yang kelihatan daripada sumber JSON.
Bagaimana Data JSON Dipetakan ke dalam Excel?
Apabila menukar JSON kepada jadual, alat ini menganggap tatasusunan objek sebagai baris. Setiap objek menjadi satu baris, manakala kunci objek menjadi tajuk lajur. Kunci objek bersarang diratakan dengan laluan bertitik. Contohnya, JSON seperti:
[
{ "nama": "Ali", "alamat": { "bandar": "Kuala Lumpur", "poskod": 50400 } },
{ "nama": "Sara", "alamat": { "bandar": "Penang", "poskod": 10000 } }
]
akan menghasilkan lajur nama, alamat.bandar, dan alamat.poskod.
Tatasusunan tatasusunan (array of arrays) pula dikekalkan sebagai baris jadual secara terus. Contohnya, [["A", 1], ["B", 2]] akan menghasilkan dua baris dengan dua lajur.
Hanya satu lembaran kerja (worksheet) dihasilkan, dinamakan Sheet1. Tiada berbilang helaian, formula, atau format dari JSON dibawa masuk. Data yang ditulis adalah data statik semata-mata.
Jenis Data dan Cara Ia Dikendalikan
Format XLSX boleh menyimpan nombor, boolean, rentetan, dan tarikh secara natif. Alat ini mengambil kesempatan daripada keupayaan tersebut. Nombor integer dan perpuluhan dikekalkan sebagai nombor. Nilai true dan false dikekalkan sebagai boolean. Nilai null akan diisi sebagai sel kosong dalam Excel. Rentetan tetap sebagai rentetan.
Ini adalah perbezaan utama berbanding CSV, yang menukarkan segala-galanya kepada teks. Contohnya, nombor 1000 dalam JSON akan menjadi nombor 1000 dalam Excel, bukan rentetan "1000". Ini memudahkan pengiraan dan analisis data seterusnya.
Walau bagaimanapun, formula tidak dihitung atau dikekalkan. Jika JSON mengandungi rentetan seperti =SUM(A1:A10), ia akan dianggap sebagai rentetan biasa, bukan formula. Tiada pemformatan sel seperti warna, sempadan, atau fon yang dipindahkan.
Had dan Sempadan Penggunaan
Alat ini beroperasi sepenuhnya di penyemak imbas (pelanggan). Tiada fail dimuat naik ke pelayan. Ini memastikan privasi data – maklumat anda tidak meninggalkan peranti anda.
Beberapa had telah ditetapkan. Mesej ralat yang mungkin muncul termasuk:
- “Pilih fail CSV, JSON atau XLSX.” (Choose a CSV, JSON or XLSX file.)
- “Fail ini terlalu besar. Guna fail di bawah ‹maks›.” (This file is too large. Use a file under ‹max›.)
- “JSON ini tidak sah atau tidak berbentuk jadual.” (This JSON is invalid or not table‑shaped.)
- “Fail ini tiada baris jadual.” (This file has no table rows.)
- “Jadual ini mempunyai lebih daripada ‹maks› baris.” (This table has more than ‹max› rows.)
- “Jadual ini mempunyai lebih daripada ‹maks› lajur.” (This table has more than ‹max› columns.)
- “Penukaran dibatalkan.” (Conversion cancelled.)
- “Penukaran ini mengambil masa terlalu lama. Cuba fail yang lebih kecil.” (This conversion is taking too long. Try a smaller file.)
Had saiz fail ialah 8 MB; fail yang lebih besar akan ditolak. Jadual dihadkan kepada 10,000 baris dan 200 lajur. Penukaran yang mengambil masa lebih daripada kira-kira 12 saat akan dihentikan. Alat ini tidak mengira formula dan tidak mengekalkan format daripada input Excel (yang tidak relevan untuk input JSON).
Proses Klien untuk Privasi Data
Semua pengiraan penukaran berlaku dalam penyemak imbas anda. Fail JSON dibaca oleh JavaScript pada peranti anda, diproses, dan fail XLSX dihasilkan secara setempat. Tiada data dihantar ke pelayan luar. Ini penting untuk data sensitif seperti rekod kakitangan, data kewangan, atau maklumat peribadi yang mungkin terkandung dalam fail JSON.
Proses ini bermula apabila anda memuat naik fail. Alat akan menyemak jenis fail, saiz, dan kesahihan struktur JSON. Jika JSON sah dan berbentuk jadual, perataan dijalankan. Kemudian pratonton dipaparkan, dan butang muat turun diaktifkan. Fail XLSX yang dihasilkan boleh disimpan terus ke komputer anda.
Sekiranya berlaku ralat, mesej jelas dipaparkan. Contohnya, jika JSON tidak berbentuk jadual – seperti objek tunggal atau tatasusunan dengan elemen bercampur – alat akan memaklumkan bahawa “JSON ini tidak sah atau tidak berbentuk jadual.” Jika tiada baris langsung, ralat “Fail ini tiada baris jadual” akan muncul.
Soalan Lazim (FAQ)
S1: Bolehkah saya menukar fail JSON yang mempunyai objek bersarang bertingkat dalam?
Ya. Alat ini akan meratakan semua peringkat bersarang menggunakan laluan bertitik. Contohnya, data.pengguna.alamat.jalan akan menjadi satu tajuk lajur. Walau bagaimanapun, jika terdapat tatasusunan di dalam objek, perataan mungkin menghasilkan banyak baris atau lajur yang tidak teratur. Untuk data sangat kompleks, anda mungkin perlu memproses JSON terlebih dahulu.
S2: Apakah yang berlaku jika JSON saya mempunyai nilai null?
Nilai null akan diisi sebagai sel kosong dalam Excel. Ini bermakna sel tersebut tidak mengandungi sebarang nilai. Jika anda memerlukan tempat letak khas, ubah suai JSON anda dahulu (contohnya, gantikan null dengan rentetan "Tiada data").
S3: Bolehkah saya menukar lebih daripada satu fail JSON pada satu masa?
Tidak. Halaman ini hanya menerima satu fail pada satu masa. Jika anda mempunyai berbilang fail JSON, anda perlu menukarnya satu per satu.
S4: Adakah data saya selamat?
Ya. Semua pemprosesan berlaku dalam penyemak imbas anda. Tiada data dimuat naik ke pelayan. Fail anda tidak meninggalkan peranti anda. Ini memastikan privasi sepenuhnya.
S5: Apakah perbezaan antara menukar JSON ke Excel berbanding JSON ke CSV?
Format XLSX boleh menyimpan nombor, boolean, dan tarikh secara natif, manakala CSV mengubah semuanya kepada teks. XLSX juga menyokong berbilang helaian dan formula (walaupun alat ini tidak mengekalkan formula) serta pemformatan. CSV lebih mudah tetapi kurang kaya dari segi jenis data. Untuk analisis data yang memerlukan jenis data tepat, XLSX adalah pilihan lebih baik.
S6: Mengapa saya mendapat ralat “JSON ini tidak sah atau tidak berbentuk jadual”?
Ini bermakna struktur JSON yang dimuat naik bukan tatasusunan objek atau tatasusunan tatasusunan. Contohnya, jika JSON ialah objek tunggal {"nama": "Ali"} atau tatasusunan dengan elemen bercampur seperti [1, "teks"], ia tidak boleh dijadikan jadual. Pastikan JSON anda berbentuk senarai objek atau senarai senarai, dan setiap objek mempunyai struktur kunci yang sama atau konsisten.