Mengesahkan fungsi
Digunakan pada:
Aplikasi kanvas Apl berpandukan model
Fungsi Validate menyemak sama ada nilai lajur tunggal atau rekod penuh sah untuk sumber data.
Penerangan
Sebelum pengguna menghantar perubahan data, anda boleh memberikan maklum balas segera pada pengesahan penghantaran, menghasilkan pengalaman pengguna yang lebih baik.
Sumber data boleh menyediakan maklumat tentang apa yang membentuk nilai sah dalam rekod. Maklumat boleh termasuk banyak kekangan, seperti contoh ini:
- sama ada lajur memerlukan nilai
- panjang rentetan teks yang boleh
- tinggi dan rendah nombor yang boleh
- tarikh terawal dan terlambat yang boleh
Fungsi Validate menggunakan maklumat ini untuk menentukan sama ada nilai adalah sah dan mengembalikan message ralat yang sesuai jika tidak. Anda boleh menggunakan fungsi DataSourceInfo untuk melihat maklumat yang sama untuk Validate pengguna.
Sumber data menyediakan maklumat pengesahan yang berbeza, termasuk tidak menyediakan langsung maklumat. Validate hanya boleh mengesahkan nilai berasaskan pada maklumat ini. Walaupun Tentusah tidak menemui masalah, menggunakan perubahan data mungkin tetap gagal. Anda boleh menggunakan fungsi Errors untuk mendapatkan maklumat tentang kegagalan.
Jika Sahkan menemui masalah, fungsi mengembalikan message ralat yang boleh anda tunjukkan kepada pengguna aplikasi. Jika semula nilai adalah sah, Validate mengembalikan blank. Apabila anda bekerja dengan pengumpulan yang tiada maklumat pengesahan, nilai selalu sah.
Sintaks
Sahkan( DataSource, Column, Value )
- DataSource – Diperlukan. Sumber data untuk disahkan bersama.
- Lajur – Diperlukan. Lajur untuk disahkan.
- Nilai – Diperlukan. Nilai untuk lajur yang dipilih untuk disahkan.
Sahkan( DataSource, OriginalRecord, Updates )
- DataSource – Diperlukan. Sumber data untuk disahkan bersama.
- OriginalRecord - Diperlukan. Rekod yang kemas kini perlu dikemas kini.
- Kemas kini - Diperlukan. Perubahan untuk digunakan ke rekod asal.
Contoh
Contohnya, nilai dalam lajur Peratusan untuk sumber data Skor mesti antara 0 dan 100, terangkum. Jika data melalui pengesahan, fungsi mengembalikan kosong. Jika tidak, fungsi mengembalikan message ralat.
Sahkan dengan lajur tunggal
| Formula | Penerangan | Hasil |
|---|---|---|
| Sahkan( Skor, Peratusan, 10 ) | Semak sama ada 10 adalah nilai sah untuk lajur Peratusan dalam sumber data Skor. | kosong |
| Sahkan( Skor, Peratusan, 120 ) | Semak sama ada 120 adalah nilai sah untuk lajur Peratusan dalam sumber data Skor. | "Nilai mesti antara 0 dan 100." |
Sahkan dengan rekod lengkap
| Formula | Penerangan | Hasil |
|---|---|---|
| Validate( Scores, EditRecord, Gallery.Updates ) | Semak sama ada nilai dalam semua lajur adalah sah untuk sumber data Skor. Dalam contoh ini, nilai dalam lajur Peratusan ialah 10. | kosong |
| Validate( Scores, EditRecord, Gallery.Updates ) | Semak sama ada nilai dalam semua lajur adalah sah untuk sumber data Skor. Dalam contoh ini, nilai dalam lajur Peratusan ialah 120. | "Nilai mesti antara 0 dan 100." |