Fungsi validasi

  • Artikel

Berlaku untuk: Aplikasi kanvas Aplikasi berdasarkan model

Fungsi Validate memeriksa apakah nilai satu kolom 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 Validate menggunakan informasi ini untuk menentukan apakah nilai valid dan menghasilkan pesan kesalahan yang sesuai jika tidak valid. Anda dapat menggunakan fungsi DataSourceInfo untuk melihat informasi yang sama yang digunakan Validate.

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

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

Sintaks

Validate( DataSource, Column, Value )

  • DataSource – wajib. Sumber data yang akan divalidasi.
  • Column – Wajib. Kolom yang akan divalidasi.
  • Value – Wajib. Nilai yang kolom yang terpilihnya akan divalidasi.

Validate( DataSource, OriginalRecord, Updates )

  • DataSource – wajib. Sumber data yang akan divalidasi.
  • OriginalRecord - Wajib. Rekaman yang pembaruannya akan divalidasi.
  • Updates - Wajib. 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.

Memvalidasi dengan satu kolom

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

Memvalidasi dengan rekaman lengkap

Rumus KETERANGAN Hasil
Validate( Scores, 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( Scores, 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."