Periksa tabel sumber
Mulai dengan tabel CSV yang headernya adalah id,name,active dan dua barisnya adalah 001,Ada,true dan 002,Bo,false. Alat CSV-to-JSON tertanam mengubah setiap baris data menjadi objek dengan kunci dari tajuk kolom. Itu berguna untuk melihat struktur, tetapi jangan asumsikan telah memutuskan apa arti dari bidang-bidang. Identifikasi seperti 001 sering harus tetap teks; memaksanya ke dalam nomor 1 kehilangan nol depan. Kata true mungkin merupakan boolean dalam skema tujuan atau teks literal yang dimasukkan oleh pengguna. Tulis jenis medan tersebut sebelum mengimpor.
Periksa tata bahasa CSV sebelum memasukkan
Medan CSV dapat berisi koma, tanda kutip dan pembagian baris ketika dikutip menurut dialek yang digunakan. Sebuah pembagian naif pada setiap koma dapat memindahkan kolom dan membuat alamat atau judul yang valid terlihat seperti dua bidang. RFC 4180 menjelaskan format umum, tetapi ekspor nyata bervariasi dalam pemisah, pengendalian kutipan, kehadiran header dan encoding karakter. Jika spreadsheet menggunakan titik koma atau tab, pilih atau ubah format tersebut secara sengaja daripada memasukkan ke dalam parser hanya koma. Periksa bahwa setiap baris memiliki jumlah medan yang diharapkan dan bahwa nama header unik.
- Tajuk CSV + dua baris
- JSON array: dua objek bernama
- Skema API: konfirmasi id, nilai aktif dan hilang
Pilih bentuk penerima
Sebuah array JSON memegang dua baris objek bersama-sama dan mudah untuk permintaan batch kecil. JSON Lines menempatkan satu nilai JSON lengkap pada setiap baris dan dapat sesuai dengan aliran atau sistem yang memproses rekaman secara independen. Sebuah string pertanyaan URL biasanya adalah serangkaian parameter pendek, bukan sebuah transportasi untuk tabel spreadsheet arbitrer. Destinasi API memutuskan bentuk mana yang valid. Alat JSON-array-to-lines mengubah pembentukan tanpa menciptakan skema, dan konversi kembali harus mempertahankan dua objek jika setiap baris adalah valid JSON.
Selesaikan nilai yang hilang dan nilai khusus
Sel CSV kosong dapat berarti string kosong, nilai yang tidak diketahui atau tidak ada nilai; yang tidak setara dalam setiap API. Sel aktif kosong tidak harus secara otomatis menjadi salah. Nomor dengan koma desimal, tanggal yang ditulis tanpa zona waktu dan identifikator dengan nol depan memerlukan perlakuan eksplisit sebelum impor. Gunakan baris uji yang berisi koma dalam nama kutipan, sel kosong dan karakter non-ASCII untuk melihat apa yang dilestarikan oleh konverter. Periksa dokumentasi API di bidang yang diperlukan dan menolak baris yang tidak dapat diwakili dengan jujur daripada menebak dengan diam-diam.
Validasi perjalanan pulang-pergi dan tujuan
Setelah konversi, periksa JSON untuk dua objek, tiga kunci yang diharapkan dan nilai dengan jenis yang diharapkan. Konversikan salinan kembali ke CSV untuk melihat perubahan dalam kutipan atau urutan bidang; tabel yang mirip secara visual tidak menjamin byte sumber yang identik. Hanya mengirimkan tes kecil ke API saat skema dan otorisasi sudah siap. Alat MultiVerto berjalan di peramban Anda dan membantu memeriksa representasi, tetapi mereka tidak dapat memverifikasi kontrak API jauh atau memungkinkan impor. Simpan ekspor asli dan pemetaan tertulis dari setiap kolom ke setiap medan tujuan untuk audit selanjutnya.