JSON ke CSV

Contoh

Masukan:

[
  { "id": 1, "user": { "name": "Alice", "email": "a@a.com" }, "tags": ["admin"] },
  { "id": 2, "user": { "name": "Bob",   "email": "b@b.com" }, "tags": ["user", "beta"] }
]

Keluaran (meratakan array terstruktur dan menggabungkan array):

id,user.name,user.email,tags
1,Alice,a@a.com,admin
2,Bob,b@b.com,"user,beta"

Pemilihan pemisah

Aturan Kutipan

Sebuah bidang harus dikutip jika mengandung:

• pemisah
• tanda kutip ganda (yang diubah formatnya dengan menggandakan: " -> "")
• baris baru

Penggunaan frasa “selalu kutip” lebih aman untuk kompatibilitas antar alat; sementara penggunaan frasa “kutip hanya saat diperlukan” membuat file lebih mudah dibaca secara manual.

Pengelolaan objek terstruktur

• Ratakan: { user: { name: "A" } } berubah menjadi kolom user.name; jalur yang lebih dalam berubah menjadi a.b.c.d.
• String JSON: objek bersarang tetap berbentuk nilai JSON satu kolom: "{\"name\":\"A\"}". Sangat berguna ketika alat lanjutan dapat memprosesnya.
• Ubah ke string: menggabungkan elemen menggunakan pemisah, sehingga struktur aslinya hilang.

Pengelolaan array

• Gabungkan: ["a", "b"] berubah menjadi "a,b" dalam satu kolom.
• Kolom terindeks: menghasilkan tags.0, tags.1, tags.2, hanya berfungsi jika panjang array konsisten.
• Hanya elemen pertama: hanya mengambil tags[0] dan mengabaikan elemen lainnya.

Kesalahan Umum

• Kunci yang tidak seragam di antara objek. Jika satu objek memiliki nilai phone sedangkan objek lainnya tidak memiliki nilai tersebut, file CSV akan menampilkan kolom phone dengan sel kosong untuk baris-baris yang tidak terisi. Selalu pastikan bahwa kumpulan kunci bersifat konsisten.
• Lupa BOM untuk Excel. Excel di Windows membaca file CSV berformat UTF-8 tanpa BOM sebagai Latin-1 dan mengacaukan karakter beraksen. Alat ini menyediakan opsi “Awalan BOM UTF-8” untuk kasus tersebut.
• Menyisipkan baris baru ke dalam nilai. Diperbolehkan dalam format CSV menurut RFC 4180, namun beberapa alat impor mengalami masalah saat memprosesnya. Jika sistem tujuan Anda rentan, gantilah \n dengan spasi atau token \\n.
• Menggunakan Excel dalam format bolak-balik: Excel secara otomatis mengonversi 007 menjadi 7, memotong angka panjang, serta merusak angka nol di awal ID. Untuk menjaga integritas data, gunakan format CSV dengan parser yang sesuai.