Dasar-Dasar Komputasi

JSON dan Schema: Membaca Data Terstruktur dengan Teliti

Pahami JSON dan JSON Schema melalui tipe data, properti wajib, nilai kosong, serta contoh pemeriksaan yang membantu mencegah salah tafsir.

Sebuah berkas data dapat terlihat rapi dan tetap menimbulkan salah paham. Angka jumlah barang disimpan sebagai teks, nama bidang berubah sedikit, atau nilai kosong dibaca sebagai nol. Ketika data itu berpindah ke aplikasi lain, masalahnya baru terlihat pada perhitungan atau tampilan. Menemukan tanda kurung yang hilang hanyalah salah satu bagian pemeriksaan.

JSON menyediakan bentuk pertukaran data yang umum dipakai aplikasi. JSON Schema menambahkan cara menyatakan aturan yang dapat diperiksa terhadap data tersebut. Keduanya perlu dibedakan: parser memeriksa apakah teks dapat dibaca sebagai JSON, sedangkan validator schema memeriksa apakah struktur dan nilainya memenuhi aturan yang dipilih. Data yang melewati keduanya pun masih dapat salah secara isi.

Tulisan ini menggunakan contoh rekaan inventaris bahan untuk sebuah kegiatan belajar. Setiap catatan memuat kode barang, jumlah, satuan, dan informasi lokasi. Tidak ada data pelanggan atau sistem produksi yang perlu digunakan. Dengan contoh kecil, Anda dapat melihat perbedaan sintaks, tipe, kelengkapan, dan makna tanpa mencoba memperbaiki ribuan catatan sekaligus. Seluruh aturan contoh merupakan pilihan untuk skenario tersebut, bukan standar wajib bagi semua aplikasi inventaris.

Baca struktur sebelum memperhatikan nilainya

JSON mengenal objek, array, string, angka, boolean, dan null. Objek menghubungkan nama anggota dengan nilai; array menyusun nilai dalam urutan. RFC 8259 mendefinisikan bentuk dasar pertukaran ini. Mulailah dengan mengenali apakah bagian terluar data merupakan satu objek atau daftar, karena cara membaca langkah berikutnya bergantung pada bentuk tersebut.

Dalam contoh inventaris, satu barang dapat digambarkan sebagai objek, sedangkan beberapa barang ditempatkan dalam array. Jika aplikasi mengharapkan daftar tetapi menerima satu objek, teksnya mungkin tetap JSON yang sah. Masalahnya berada pada kesesuaian bentuk dengan kebutuhan penerima, bukan pada ada tidaknya tanda kurung penutup. Menyebut jenis masalah secara tepat membantu memilih alat pemeriksaan yang sesuai.

Saat pertama menerima berkas, jangan langsung merapikan seluruh isi. Simpan salinan asli, catat sumbernya, dan lihat satu bagian kecil yang mewakili bentuk data. Jika isinya sensitif, gunakan alat lokal yang diizinkan. Memasukkan seluruh berkas ke situs pemformat sembarang dapat memindahkan data ke pihak lain sebelum Anda memahami isinya. Pemformatan membantu membaca, tetapi tidak menggantikan pemeriksaan izin penggunaan data.

Bedakan JSON yang sah dari struktur yang diharapkan

Parser dapat menolak koma yang menggantung, tanda kutip yang keliru, atau bentuk nilai yang tidak termasuk JSON. Kesalahan seperti ini perlu diselesaikan sebelum validasi schema bermakna. Namun, perbaikan sintaks seharusnya tidak dilakukan dengan menebak isi yang hilang. Jika jumlah barang kosong akibat pemotongan berkas, menambahkan angka sembarang hanya membuat kerusakan tampak rapi.

Pada contoh rekaan, pengirim mungkin memberi catatan dengan bidang nama_barang sedangkan penerima mengharapkan nama. Kedua nama sah sebagai nama anggota objek. Parser tidak mempunyai pengetahuan tentang perjanjian kedua aplikasi. Karena itu, pesan “JSON valid” dari alat pemformat tidak cukup untuk menyimpulkan data siap diimpor. Anda masih perlu mengetahui aturan yang hendak dipenuhi.

Tuliskan tiga pertanyaan secara terpisah: apakah teks dapat dibaca, apakah bentuknya sesuai aturan, dan apakah nilainya benar untuk kegiatan tersebut. Pemisahan ini membantu saat bekerja bersama orang lain. Pengirim dapat memperbaiki sintaks, pengelola schema menjelaskan aturan, dan pemilik informasi memastikan jumlah serta lokasi benar. Satu orang tidak perlu menebak seluruh lapisan hanya karena berkas sudah berhasil dibuka di editor.

Periksa tipe, pengenal, dan nilai kosong

Jumlah 12 dan teks “12” dapat ditampilkan dengan bentuk yang hampir sama. Namun, keduanya membawa tipe berbeda. Pilihan itu berpengaruh ketika aplikasi menghitung, mengurutkan, atau menggabungkan data. Jangan mengubah semua string yang berisi angka menjadi bilangan. Kode barang dengan nol di depan atau nomor identitas dapat membutuhkan perlakuan sebagai teks.

Untuk inventaris rekaan, kode “0012” menunjukkan identitas barang, sedangkan jumlah 12 menunjukkan banyaknya unit. Menghilangkan nol di depan kode dapat membuat pencocokan gagal. Di sisi lain, menyimpan jumlah sebagai string dapat memerlukan langkah konversi tambahan sebelum penjumlahan. Aturannya harus mengikuti makna bidang, bukan sekadar bentuk karakter yang tampak seperti angka.

Buat daftar bidang sebelum menulis schema. Untuk setiap bidang, jelaskan apakah nilainya dihitung, digunakan sebagai label, atau dipakai sebagai pengenal. Kegiatan ini terlihat sederhana tetapi mengurangi perselisihan ketika dua aplikasi menafsirkan nilai dengan cara berbeda. Jika data berasal dari spreadsheet, pelajari juga kebiasaan perubahan format pada saat ekspor. Berkas yang berhasil dibuka belum membuktikan bahwa pengenal dan jumlah tetap mempunyai makna yang sama.

Nilai kosong mempunyai beberapa kemungkinan makna

Bidang yang tidak ada, bidang bernilai null, dan string kosong bukan keadaan yang identik. Pada contoh lokasi barang, ketidakhadiran bidang mungkin berarti informasi belum diberikan. Null dapat dipakai bila perjanjian data menyatakan lokasi belum ditentukan. String kosong mungkin merupakan masukan yang belum diisi. Arti tersebut tidak datang otomatis dari JSON; aplikasi perlu menyepakatinya.

Jangan memakai nol sebagai pengganti semua keadaan kosong. Jumlah nol dapat berarti barang benar-benar habis, sedangkan jumlah yang belum diketahui membutuhkan perlakuan berbeda. Jika keduanya dicampur, laporan stok dapat menganggap bahan tidak tersedia padahal catatannya hanya belum lengkap. Schema dapat membantu membatasi bentuk nilai, tetapi keputusan mengenai arti tetap memerlukan pemilik proses.

Tulis contoh untuk setiap keadaan yang dibolehkan. Misalnya, lokasi boleh tidak ada pada draf, tetapi wajib terisi sebelum catatan digunakan untuk pembagian barang. Aturan draf dan aturan siap digunakan dapat berbeda. Dengan menyatakan tahap data secara jelas, Anda tidak perlu melonggarkan semua pemeriksaan hanya agar catatan yang belum selesai dapat disimpan. Perbedaan tahap itu juga memudahkan pembuatan pesan kesalahan yang dapat dipahami.

Ilustrasi AI: bentuk geometris biru menempati bingkai, dengan satu slot heksagonal kuning dan kartu bertitik
Ilustrasi AI: kolom wajib, tipe, dan nilai opsional perlu dibedakan dalam kontrak data

Schema merupakan perjanjian yang dinyatakan secara eksplisit

JSON Schema menjelaskan aturan terhadap instance data. Dokumen schema sendiri ditulis dalam JSON, tetapi perannya berbeda dari catatan inventaris yang diperiksa. Referensi tipe JSON Schema menunjukkan penggunaan tipe dan kata kunci yang relevan. Menetapkan tipe objek di awal membantu menghindari anggapan bahwa kata kunci untuk objek otomatis menolak semua bentuk nilai lain.

Mulailah dari kebutuhan kecil yang dapat diterangkan. Sebuah catatan inventaris harus berupa objek; jumlah harus mengikuti tipe yang dipilih; kode harus berupa string. Tambahkan aturan berikutnya setelah arti setiap bidang dipahami. Schema yang panjang tanpa penjelasan sering sulit dipelihara karena orang tidak tahu aturan mana yang merupakan kebutuhan proses dan aturan mana yang tersalin dari contoh lain.

Simpan schema bersama catatan alasan perubahan. Ketika aturan lokasi menjadi wajib, tulis tahap proses yang membutuhkannya dan bagaimana catatan lama ditangani. Jangan mengganti aturan diam-diam lalu menganggap semua data sebelumnya salah sejak awal. Perjanjian data berkembang, dan pengelola perlu membuat perpindahan antarversi dapat dipahami. Riwayat keputusan ini sama pentingnya dengan dokumen schema yang akhirnya dijalankan validator.

Mendefinisikan properti belum membuatnya wajib

Kata kunci properties menetapkan aturan bagi nama properti yang disebutkan. Properti tersebut tidak otomatis wajib ada; daftar required digunakan untuk menyatakan kewajiban. Referensi objek JSON Schema menjelaskan hubungan ini. Kesalahan pemahaman pada bagian tersebut dapat membuat data kehilangan bidang penting sambil tetap lulus aturan yang sebenarnya ditulis.

Dalam skenario inventaris, mendeskripsikan kode dan jumlah saja belum tentu menolak objek yang hanya memiliki kode. Jika kedua bidang dibutuhkan untuk perhitungan, aturan kewajibannya perlu dinyatakan. Sebaliknya, menjadikan seluruh bidang wajib dapat menyulitkan penyimpanan draf atau masukan yang memang opsional. Tentukan kebutuhan berdasarkan tahap penggunaan, bukan berdasarkan keinginan agar setiap catatan terlihat penuh.

Uji aturan dengan menghapus satu bidang dari contoh yang sebelumnya lulus. Lihat apakah validator menolak dengan alasan yang sesuai. Percobaan kecil ini lebih jelas daripada mencoba banyak catatan sekaligus dan menebak mengapa sebagian gagal. Simpan pasangan contoh lulus dan contoh gagal bersama schema agar orang berikutnya memahami maksud aturan tersebut ketika menambahkan bidang atau mengubah proses impor.

Contoh rekaan satu catatan dan aturan pemeriksaannya

Objek berikut merupakan contoh rekaan barang kegiatan. Kode diperlakukan sebagai pengenal teks, sedangkan jumlah merupakan banyaknya unit. Pilihan tersebut sengaja dinyatakan agar penerima tidak menyamakan angka yang dapat dihitung dengan pengenal yang hanya tampak seperti angka.

{"kode": "A-012", "jumlah": 12}

Schema latihan berikut memakai dialek JSON Schema Draft 2020-12. Ia mengharuskan objek, dua properti bernama kode dan jumlah, tipe masing-masing, serta batas jumlah paling sedikit nol. Properti tambahan ditolak sebagai pilihan latihan; kebijakan aplikasi sebenarnya tetap perlu diputuskan sesuai kebutuhan.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "kode": {"type": "string"},
    "jumlah": {"type": "integer", "minimum": 0}
  },
  "required": ["kode", "jumlah"],
  "additionalProperties": false
}

Dua contoh negatif di bawah menguji alasan yang berbeda. Contoh pertama mempunyai jumlah berbentuk teks; contoh kedua tidak mempunyai jumlah sama sekali. Keduanya masih dapat dibaca sebagai JSON, tetapi tidak memenuhi aturan latihan tersebut. Nilai kode kosong masih diterima schema ini karena pembatasan panjang belum dinyatakan. Ini contoh mengapa isi aturan perlu benar-benar dibaca, bukan diasumsikan lebih ketat daripada yang tertulis.

{"kode": "A-012", "jumlah": "12"}
{"kode": "A-012"}

Jalankan setiap objek secara terpisah ketika mencoba validator. Dua objek berurutan di blok penjelasan terakhir bukan satu dokumen JSON tunggal. Pertahankan schema yang sama dan catat aturan yang dilanggar pada masing-masing percobaan. Dengan cara ini, Anda memperoleh pasangan contoh lulus serta contoh gagal yang dapat digunakan lagi ketika aturan diubah.

Putuskan cara menangani bidang tambahan

Pengirim data dapat menambahkan bidang yang belum dikenal penerima. Ada sistem yang ingin menerima penambahan tersebut, ada yang harus menolaknya karena salah ketik dapat berakibat serius. Pilihan ini perlu dinyatakan dengan sengaja. Menutup semua properti tambahan tanpa mempertimbangkan perkembangan data dapat membuat perubahan kecil pada pengirim memutus penerima yang sebenarnya tidak membutuhkan bidang baru itu.

Dalam contoh rekaan, pengirim menambahkan catatan singkat mengenai kondisi kotak. Jika penerima hanya membutuhkan kode dan jumlah, penambahan itu mungkin tidak memengaruhi perhitungan. Namun, bidang jumlh yang salah eja seharusnya tidak diam-diam dianggap pengganti jumlah. Perbedaan antara ekstensi yang sah dan kesalahan ketik memerlukan aturan nama serta kebijakan penerimaan yang jelas.

Sebelum memilih penolakan yang ketat, lihat jalur data dan tanggung jawab pengirim. Apakah semua aplikasi diperbarui bersama, atau penerima harus tetap bekerja ketika pengirim menambah informasi? Tuliskan keputusan dan contoh dampaknya. Pengujian kemudian dapat mencakup satu properti tambahan yang diperbolehkan serta satu penamaan keliru yang memang harus ditolak. Kejelasan kebijakan lebih berguna daripada memilih pengaturan paling ketat tanpa memahami konsekuensinya.

Daftar perlu diperiksa sebagai kumpulan dan sebagai anggota

Array memiliki urutan, tetapi kebutuhan aplikasi menentukan apakah urutan itu bermakna. Daftar barang untuk pembagian dapat diurutkan berdasarkan lokasi atau sekadar mengikuti waktu pencatatan. Jangan menganggap posisi pertama selalu prioritas tertinggi jika perjanjiannya tidak menyatakan demikian. Pemeriksa perlu mengetahui apakah urutan digunakan untuk keputusan atau hanya untuk tampilan.

Periksa bentuk setiap anggota sesuai aturan, lalu lihat kebutuhan kumpulan secara keseluruhan. Apakah daftar kosong dapat diterima? Apakah catatan ganda menandakan duplikasi atau dua pembagian yang berbeda? Pertanyaan tersebut tidak dapat dijawab hanya dengan memastikan semua anggota merupakan objek. Bahkan dua objek yang sama persis dapat mempunyai arti berbeda bila prosesnya mengizinkan pengulangan transaksi.

Pada contoh inventaris, pengenal barang dapat dipakai untuk mencari catatan yang merujuk benda sama. Namun, memastikan pengenal unik di seluruh kumpulan mungkin membutuhkan pemeriksaan tambahan di aplikasi. Jangan menuliskan bahwa satu kata kunci schema otomatis membuktikan semua aturan bisnis terpenuhi tanpa meninjau apa yang benar-benar diperiksa. Pisahkan validasi bentuk anggota, batas kumpulan, dan pemeriksaan hubungan antarcatatan agar hasilnya dapat diterangkan.

Batas angka harus mengikuti unit yang disepakati

Angka 5 belum menjelaskan lima apa. Lima kotak dan lima buah menghasilkan kebutuhan logistik berbeda. Jika jumlah dan satuan dipisahkan, keduanya perlu dibaca bersama. Menetapkan batas angka tanpa memastikan satuannya dapat membuat data lulus secara teknis tetapi salah ketika digunakan untuk menyiapkan bahan kegiatan.

Untuk contoh rekaan, tentukan apakah jumlah berarti barang utuh atau boleh mempunyai pecahan. Setelah itu, pilih batas yang sesuai proses. Bila nilai negatif mewakili pengembalian atau penyesuaian, jangan langsung melarangnya hanya karena inventaris terasa selalu positif. Pisahkan catatan stok saat ini dari catatan pergerakan bila maknanya berbeda, sehingga aturan tidak perlu menampung semua kebutuhan dalam satu bidang ambigu.

Uji nilai tepat di batas dan di sekitarnya. Periksa jumlah nol, angka yang sangat besar, serta nilai pecahan bila relevan. Catat perilaku aplikasi penerima ketika membaca angka, terutama bila beberapa bahasa pemrograman atau alat digunakan. Memahami makna data sebelum menghitung membantu menghindari laporan yang tampak presisi tetapi memakai satuan dan jenis angka yang tidak konsisten di antara sumber.

Format yang terlihat benar belum membuktikan fakta

Sebuah nilai dapat mengikuti pola alamat surel tanpa membuktikan kotak suratnya dimiliki orang yang dimaksud. Tanggal dapat ditulis dalam format yang disepakati sambil merujuk hari kegiatan yang keliru. Validasi bentuk membantu menahan kesalahan tertentu, tetapi kebenaran faktual memerlukan pemeriksaan yang sesuai konteks dan kewenangan penggunaan data.

Pada inventaris rekaan, kode lokasi dapat mengikuti pola huruf dan angka yang benar, tetapi ruangannya sudah berganti nama. Schema yang tidak mempunyai daftar lokasi mutakhir tidak dapat mengetahui perubahan tersebut. Jika daftar rujukan tersedia, pengelola perlu menjelaskan cara memperbaruinya dan apa yang terjadi ketika lokasi baru belum masuk daftar. Jangan menyelesaikan masalah dengan mengganti nilai menjadi lokasi lain yang kebetulan lulus.

Perilaku pemeriksaan format juga perlu dibaca pada validator dan dialek schema yang dipakai. Jangan menganggap setiap alat menegakkan semua pemeriksaan dengan konfigurasi identik. Catat versi dan pilihan yang digunakan ketika hasil berbeda. Dengan begitu, percakapan mengenai “validator yang benar” dapat beralih ke pertanyaan yang lebih konkret: aturan apa yang dijalankan dan bentuk kegagalan apa yang memang hendak dideteksi.

Hindari nama anggota yang berulang

Teks JSON dengan nama anggota objek yang berulang dapat menghasilkan perilaku berbeda pada perangkat lunak penerima. RFC 8259 menyarankan nama anggota unik untuk interoperabilitas. Pada data yang dibaca manusia, dua baris jumlah dapat mudah terlewat, terlebih jika berkas panjang dan pemformat hanya menampilkan hasil setelah proses pembacaan.

Misalnya, contoh inventaris mempunyai jumlah pertama 8 dan jumlah kedua 18 di objek yang sama. Jangan memilih salah satunya berdasarkan posisi yang kebetulan dipertahankan alat Anda. Kembali ke sumber informasi dan cari alasan duplikasi. Mengubah teks hingga hanya tersisa satu nilai tanpa bukti dapat menghilangkan petunjuk mengenai kesalahan penggabungan atau proses ekspor yang bermasalah.

Simpan bentuk asli sebelum parser mengubah data menjadi struktur dalam memori. Sebagian informasi tentang pengulangan mungkin tidak lagi terlihat pada hasil pemformatan yang sudah dibaca ulang. Jika alat Anda mendukung penolakan nama berulang, pertimbangkan pengaturan itu pada tahap penerimaan sesuai kebutuhan proses. Catat hasilnya sebagai pemeriksaan tambahan, karena schema yang menerima objek hasil parsing belum tentu mengetahui seluruh bentuk teks asal yang pernah dikirim.

Buat pesan kesalahan yang membantu perbaikan

Pesan seperti “data tidak valid” memberi terlalu sedikit petunjuk. Orang yang memperbaiki memerlukan lokasi, nilai atau bentuk yang ditolak, serta aturan yang diharapkan. Untuk daftar inventaris, posisi anggota dan nama bidang membantu menemukan catatan. Namun, tampilkan informasi secukupnya agar pesan tidak membocorkan data pribadi atau isi sensitif yang tidak diperlukan.

Pisahkan pesan untuk pengguna dan rincian teknis untuk pengelola. Pengisi formulir dapat diberi arahan bahwa jumlah harus berupa bilangan bulat dalam rentang yang dibolehkan. Pengelola dapat memperoleh jalur bidang, aturan schema, dan versi validator. Kedua bentuk penjelasan melayani kebutuhan berbeda; menampilkan seluruh keluaran teknis kepada pengguna dapat membuat perbaikan justru lebih membingungkan.

Jika banyak kesalahan muncul sekaligus, prioritaskan yang paling awal memengaruhi pembacaan data. Teks yang belum dapat diparse perlu ditangani sebelum daftar kelengkapan bidang bermakna. Setelah sintaks benar, ulangi pemeriksaan struktur dan nilai. Urutan ini menghindari pekerjaan memperbaiki pesan turunan yang mungkin hilang dengan sendirinya setelah satu kesalahan bentuk awal diselesaikan secara benar.

Rancang contoh gagal dengan sengaja

Schema baru perlu diuji dengan data yang semestinya ditolak. Jika hanya ada satu contoh lulus, aturan yang terlalu longgar dapat terlihat berhasil. Buat salinan contoh rekaan, lalu ubah satu unsur: hilangkan bidang wajib, ubah jumlah menjadi teks, tambahkan properti salah eja, atau gunakan nilai di luar rentang. Setiap percobaan sebaiknya mempunyai alasan penolakan yang jelas.

Jangan menggabungkan semua kesalahan pada satu contoh pertama. Jika sebuah objek sekaligus kehilangan kode, mempunyai tipe jumlah salah, dan berisi daftar rusak, hasil validator sulit menjelaskan aturan mana yang benar-benar bekerja. Percobaan kecil memudahkan peninjau memahami maksud serta menemukan ketidaksesuaian antara aturan tertulis dan perilaku alat yang dijalankan.

Simpan juga contoh batas yang tetap harus diterima. Jumlah nol mungkin sah, string dengan karakter beraksen mungkin diperlukan, dan properti opsional boleh tidak ada. Tanpa contoh positif tersebut, pengetatan aturan dapat membuang data sah ketika schema dikembangkan. Keseimbangan contoh lulus dan gagal membantu mempertahankan kebutuhan proses, sekaligus mencegah perubahan yang sekadar membuat alat terlihat tegas tetapi menolak informasi yang sebenarnya dibutuhkan.

Perubahan schema perlu jalan bagi data lama

Ketika struktur berubah, tentukan hubungan antara data lama dan aturan baru. Menambahkan bidang opsional berbeda dampaknya dari mengganti nama bidang wajib. Jika kedua versi beredar bersamaan, penerima perlu mengetahui versi atau mempunyai jalur pengenalan yang dapat dipertanggungjawabkan. Menebak versi dari keberadaan satu bidang yang ambigu dapat menimbulkan kesalahan ketika data belum lengkap.

Dalam contoh rekaan, lokasi awalnya disimpan sebagai satu string lalu dipecah menjadi gedung dan ruang. Migrasi perlu menjelaskan bagaimana string lama dipetakan, apa yang dilakukan pada nilai tidak dikenal, dan bagaimana hasilnya diperiksa. Jangan mengisi gedung dengan tebakan agar semua catatan lulus schema baru. Catatan yang belum dapat dipetakan sebaiknya ditandai untuk ditinjau melalui proses yang jelas.

Sebelum migrasi, simpan sumber dan uji pemulihan sesuai prosedur pemilik data. Sesudahnya, bandingkan jumlah catatan serta contoh nilai penting. Schema membantu menilai bentuk keluaran, tetapi keberhasilan migrasi juga memerlukan pemeriksaan apakah informasi yang semula tersedia tetap terbawa. Riwayat perubahan yang dapat dibaca orang lain akan berguna ketika sebuah laporan kemudian berbeda dari hasil sebelum perpindahan struktur.

Jangan menyamakan validasi dengan izin penggunaan

Berkas yang sesuai schema dapat memuat informasi yang tidak boleh digunakan untuk tujuan tertentu. Validasi struktur tidak memberikan persetujuan pemilik data, mengatur hak akses, atau menilai apakah pengumpulan informasi diperlukan. Karena itu, langkah teknis harus berada di dalam proses penggunaan data yang sudah jelas, bukan dipakai sebagai alasan mengabaikan asal dan batas penggunaannya.

Untuk latihan, buat kode dan jumlah rekaan. Jika contoh berasal dari data nyata, samarkan atau ganti nilainya melalui prosedur yang disetujui dan periksa apakah hasilnya masih dapat mengenali seseorang. Menghapus nama saja belum tentu cukup apabila bidang lain dapat dihubungkan kembali. Pilih contoh sekecil mungkin agar kebutuhan pembelajaran terpenuhi tanpa membawa informasi yang tidak diperlukan.

Dalam aplikasi yang menerima masukan pihak luar, validasi juga bukan pengganti pengamanan lain. Data sah secara bentuk masih perlu ditangani dengan aman ketika ditampilkan, disimpan, atau dipakai dalam tindakan berikutnya. Hubungkan pembahasan ini dengan keamanan dasar sistem: pembatasan akses, pengelolaan rahasia, dan pemeriksaan keluaran melayani risiko berbeda dari schema. Menjelaskan batas alat membantu pengelola menggabungkan kontrol yang memang diperlukan.

Catat alat dan dialek agar hasil dapat diulang

Hasil pemeriksaan lebih mudah dipahami ketika lingkungan kerjanya tercatat. Simpan nama serta versi validator, dialek schema yang digunakan, dan cara menjalankan pemeriksaan. Jangan hanya mengirim tangkapan layar tanda berhasil. Orang berikutnya mungkin memakai alat berbeda yang membaca fitur tertentu dengan cara lain, sehingga membutuhkan petunjuk untuk mereproduksi kondisi yang sama.

Gunakan contoh kecil untuk memastikan alat memang menegakkan aturan yang penting. Jika aplikasi membutuhkan jumlah sebagai bilangan bulat, jalankan satu nilai bulat yang sah dan satu nilai pecahan yang semestinya ditolak. Jika properti tambahan dilarang, coba satu nama baru. Percobaan ini menghubungkan kebutuhan proses dengan perilaku alat, sehingga Anda tidak hanya mempercayai pengaturan yang terlihat aktif pada antarmuka.

Ketika hasil dua validator berbeda, hindari mengubah data sampai keduanya menampilkan keluaran yang sama tanpa memahami alasannya. Bandingkan dialek, konfigurasi, dan fitur yang diperiksa terlebih dahulu. Perbedaan dapat menunjukkan aturan yang belum dinyatakan dengan lengkap atau dukungan alat yang tidak sesuai kebutuhan. Catatan lingkungan serta contoh reproduksi yang kecil membuat percakapan itu lebih cepat diselesaikan dan mencegah perbaikan yang sekadar menyembunyikan ketidakcocokan antara perjanjian data dan pelaksanaannya.

Akhiri pemeriksaan dengan keputusan yang dapat dilacak

Setelah semua langkah, tuliskan hasilnya menurut lapisan. Sebut apakah sintaks berhasil dibaca, schema versi mana yang digunakan, contoh aturan yang diuji, dan pemeriksaan makna yang masih diperlukan. Hindari label “data benar” apabila yang dibuktikan hanya kesesuaian struktur. Istilah yang lebih tepat memungkinkan pemakai berikutnya menilai apakah hasil sudah cukup untuk keputusan yang akan dibuat.

Pada inventaris rekaan, catatan dapat dinyatakan siap ditinjau petugas setelah kode, jumlah, satuan, dan lokasi memenuhi aturan. Petugas tetap perlu memastikan benda nyata serta penempatannya sesuai catatan. Jika ada perbedaan, simpan hubungan antara koreksi dan sumber informasi. Dengan jejak tersebut, perbaikan tidak sekadar menghasilkan berkas baru tanpa penjelasan mengenai alasan nilai berubah.

Kebiasaan ini membuat JSON Schema berguna sebagai perjanjian bersama. Orang yang membuat data mengetahui kebutuhan penerima, pengelola dapat menilai perubahan, dan pemeriksa mempunyai contoh yang dapat dijalankan ulang. Dokumen aturan akhirnya menjadi bagian dari cara bekerja yang dapat dipahami, bukan hanya berkas teknis yang dianggap benar karena sebuah alat menampilkan pesan hijau pada satu contoh.

Pertanyaan yang sering muncul

Apakah JSON yang valid otomatis sesuai kebutuhan aplikasi?

Tidak. Parser memeriksa sintaks, sedangkan schema memeriksa aturan yang dinyatakan. Kebenaran isi dan izin penggunaan masih perlu dinilai terpisah.

Apakah properties membuat bidang wajib ada?

Tidak. Properties menjelaskan aturan nama properti yang disebut. Kewajiban keberadaannya dinyatakan melalui required sesuai kebutuhan proses.

Apakah null sama dengan string kosong?

Tidak. Keduanya mempunyai tipe dan kemungkinan makna berbeda. Perjanjian data perlu menjelaskan arti nilai kosong dan bidang yang tidak ada.

Mengapa contoh yang lulus belum cukup menguji schema?

Aturan yang terlalu longgar juga dapat menerima contoh tersebut. Contoh gagal dan contoh batas membantu membuktikan aturan menolak serta menerima data yang tepat.

Tag: