fungsi Validate

Berlaku untuk: Aplikasi Kanvas Berbasis model aplikasi

Fungsi ini Validate memeriksa apakah nilai kolom tunggal atau rekaman lengkap valid untuk sumber data.

KETERANGAN

Sebelum pengguna mengirimkan perubahan data, Anda dapat memberikan tanggapan langsung tentang validitas pengiriman tersebut, sehingga menghasilkan pengalaman pengguna yang lebih baik.

Sumber data dapat memberikan informasi tentang apa yang merupakan nilai valid dalam rekaman. Informasi ini dapat mencakup banyak keterbatasan, seperti contoh berikut:

• apakah kolom memerlukan nilai
• seberapa panjang string teks
• seberapa tinggi dan rendah nomor
• seberapa awal dan akhir tanggal

Fungsi ini Validate menggunakan informasi ini untuk menentukan apakah nilai valid dan mengembalikan pesan kesalahan yang sesuai jika tidak. Anda dapat menggunakan fungsi DataSourceInfo untuk melihat informasi yang sama yang Validate menggunakan.

Sumber data bervariasi dalam jumlah informasi validasi yang disediakan, termasuk tidak menyediakan sama sekali. Validate hanya dapat memverifikasi nilai berdasarkan informasi ini. Bahkan jika Validate tidak menemukan masalah, menerapkan perubahan data mungkin masih gagal. Anda dapat menggunakan fungsi Errors untuk mendapatkan informasi tentang kegagalan tersebut.

Jika Validate menemukan masalah, fungsi mengembalikan pesan kesalahan yang dapat Anda tampilkan kepada pengguna aplikasi. Jika semua nilai valid, Validate mengembalikan kosong. Jika Anda bekerja dengan koleksi yang tidak memiliki informasi validasi, nilai selalu valid.

Sintaks

Validate( Sumber Data, Kolom, Nilai )

• Sumber Data– Wajib. Sumber data yang akan divalidasi.
• Kolom– Wajib. Kolom yang akan divalidasi.
• Nilai – Wajib. Nilai yang kolom yang terpilihnya akan divalidasi.

Validate( DataSource, OriginalRecord, Update )

• Sumber Data– Wajib. Sumber data yang akan divalidasi.
• OriginalRecord - Wajib. Rekaman yang pembaruannya akan divalidasi.
• Pembaruan - Diperlukan. Perubahan yang akan diterapkan ke rekaman asli.

Contoh

Untuk contoh ini, nilai dalam kolom Persentase pada sumber data Skor harus antara 0 dan 100, inklusif. Jika data meneruskan validasi, fungsi akan menghasilkan kosong. Atau, fungsi akan menghasilkan pesan kesalahan.

Validate dengan satu kolom

Rumus	KETERANGAN	Hasil
Validate( Skor, Persentase, 10 )	Memeriksa apakah 10 adalah nilai yang valid untuk kolom Persentase dalam sumber data Skor.	Kosong
Validate( Skor, Persentase, 120 )	Memeriksa apakah 120 adalah nilai yang valid untuk kolom Persentase dalam sumber data Skor.	"Nilai harus antara 0 hingga 100."

Validate dengan catatan lengkap

Rumus	KETERANGAN	Hasil
Validate( Skor, EditRecord, Gallery.Updates )	Memeriksa apakah nilai di semua kolom valid untuk sumber data Skor. Dalam contoh ini, nilai di kolom Persentase adalah 10.	Kosong
Validate( Skor, EditRecord, Gallery.Updates )	Memeriksa apakah nilai di semua kolom valid untuk sumber data Skor. Dalam contoh ini, nilai di kolom Persentase adalah 120.	"Nilai harus antara 0 hingga 100."