#Validasi Field

Untuk memastikan akurasi, keamanan, dan konsistensi data Collection, NocoBase menyediakan fitur validasi field. Fitur ini dibagi menjadi dua bagian utama: aturan konfigurasi dan aturan validasi.

#Aturan Konfigurasi

Field sistem NocoBase mengintegrasikan aturan Joi, dengan dukungan sebagai berikut:

#Tipe String

Tipe String Joi sesuai dengan tipe field NocoBase berikut: Teks Satu Baris, Teks Multi Baris, Nomor Telepon, Email, URL, Password, UUID.

#Aturan Umum

• Panjang Minimum
• Panjang Maksimum
• Panjang
• Regular Expression
• Wajib Diisi

#Email

Lihat opsi lainnya

#URL

Lihat opsi lainnya

#UUID

Lihat opsi lainnya

#Tipe Number

Tipe Number Joi sesuai dengan tipe field NocoBase berikut: Integer, Number, Persen.

#Aturan Umum

• Lebih Besar Dari
• Lebih Kecil Dari
• Nilai Maksimum
• Nilai Minimum
• Kelipatan Bilangan Bulat

#Integer

Selain aturan umum, field integer juga mendukung validasi integer dan validasi unsafe integer.

#Number dan Persen

Selain aturan umum, field number dan persen juga mendukung validasi presisi.

#Tipe Tanggal

Tipe Date Joi sesuai dengan tipe field NocoBase berikut: Tanggal (dengan timezone), Tanggal (tanpa timezone), Hanya Tanggal, Unix Timestamp.

Aturan validasi yang didukung:

• Lebih Besar Dari
• Lebih Kecil Dari
• Nilai Maksimum
• Nilai Minimum
• Validasi Format Timestamp
• Wajib Diisi

#Field Relasi

Field relasi hanya mendukung validasi wajib diisi. Perhatikan bahwa validasi wajib diisi pada field relasi untuk sementara tidak didukung pada skenario sub form atau sub table.

#Penerapan Aturan Validasi

Setelah aturan field dikonfigurasi, aturan validasi yang sesuai akan dipicu saat menambahkan atau mengubah data.

Aturan validasi juga berlaku untuk komponen sub table dan sub form:

Perhatikan bahwa pada skenario sub form atau sub table, validasi wajib diisi pada field relasi untuk sementara tidak berlaku.

#Perbedaan dengan Validasi Field Sisi Klien

Validasi field server-side cocok untuk skenario aplikasi yang berbeda dengan validasi field sisi klien. Keduanya memiliki perbedaan signifikan dalam cara implementasi dan waktu pemicu aturan, sehingga perlu dikelola secara terpisah.

#Perbedaan Cara Konfigurasi

• Validasi Klien: Konfigurasi aturan pada form edit (seperti gambar di bawah)
• Validasi Field Server: Atur aturan field di Data Source → Konfigurasi Collection

#Perbedaan Waktu Pemicu Validasi

• Validasi Klien: Memicu validasi secara real-time saat pengguna mengisi field, dan langsung menampilkan pesan error
• Validasi Field Server: Setelah data disubmit, server melakukan validasi sebelum data masuk ke database, pesan error dikembalikan melalui respons API
• Cakupan Aplikasi: Selain berlaku saat submit form, validasi field server juga akan dipicu di workflow, import data, dan semua skenario yang melibatkan penambahan atau modifikasi data
• Pesan Error: Validasi klien mendukung pesan error custom, validasi server untuk sementara tidak mendukung pesan error custom