Konverter JSON ke CSV

Strategi pengurutan kolom

• Dari rekaman pertama: kolom-kolom sesuai dengan kunci objek JSON pertama. Prosesnya cepat dan deterministik, namun melewatkan kunci yang hanya muncul pada rekaman berikutnya.
• Gabungan semua kunci: memindai setiap rekaman dan mengumpulkan seluruh kunci. Prosesnya lebih lambat pada dataset yang sangat besar, namun menghasilkan daftar kolom yang lengkap.
• Urutan khusus: masukkan daftar nama kolom yang dipisahkan koma. Semua elemen lainnya ditambahkan di akhir sesuai urutan kemunculannya.

Tanda kutip dan escape

Mengikuti RFC 4180:

• Bidang yang mengandung koma, baris baru, atau tanda kutip ganda harus dibungkus dengan tanda kutip ganda.
• Tanda kutip ganda di dalam bidang yang dikutip di-escape dengan cara menggandakannya: misalnya, He said "Hi" menjadi "He said ""Hi""".
• Baris baru di dalam bidang yang dikutip diperbolehkan, tetapi tidak semua perangkat impor mendukungnya; aktifkan opsi “escape baris baru” jika Anda memerlukan kompatibilitas maksimal.

Pelestarian tipe data

CSV berupa teks; semua elemennya adalah string. Petunjuk tipe untuk kolom numerik, nilai boolean, atau tanggal bergantung pada cara pihak penerima mengurai data tersebut. Berikut beberapa tips:

• Nol di depan (007) dipertahankan sebagai string di file CSV, tetapi Excel secara diam-diam mengonversinya menjadi angka. Beri awalan =""007"" (terlihat tidak rapi, namun berfungsi) atau impor sebagai teks di Excel.
• Bilangan bulat besar yang melebihi 2^53 kehilangan presisi di Excel; simpan sebagai string dalam format JSON.
• Tanggal ISO (2026-04-18T10:22:00Z) hanya bertahan setelah proses impor-ekspor Excel jika kolomnya diformat sebagai teks saat diimpor.
• Nilai boolean diubah menjadi string true atau false. Jika sistem hilir menuntut format 1/0, lakukan pemetaan terlebih dahulu sebelum ekspor.

BOM dan Excel

Excel di Windows memerlukan BOM berformat UTF-8 (0xEF 0xBB 0xBF) di awal file; jika tidak, byte UTF-8 akan ditafsirkan sebagai Latin-1 dan mengubah karakter yang bukan ASCII menjadi data yang tidak terbaca. Mac Numbers serta Google Sheets mampu menangani kedua format tersebut.

Kesalahan Umum

• Mengirimkan objek alih-alih array. Alat ini memerlukan [{...}, {...}], bukan {...}. Sebelumnya, lakukan unwrap terlebih dahulu.
• Kunci yang berbeda pada setiap rekaman. Gunakan strategi “gabungan semua kunci” untuk mencegah kolom hilang.
• Nilai sentinel untuk null. Beberapa alur pemrosesan menganggap sel kosong sebagai null, sedangkan yang lain menganggapnya sebagai string "". Pilih satu konvensi dan patuhi secara konsisten di seluruh proyek.
• Lokal yang tidak sesuai. Mengekspor dengan , lalu membukanya di Excel versi Eropa yang mengharapkan ; dapat membuat kolom menyusut. Sesuaikan pemisah dengan lokal tujuan.