Ambil perhatian
Akses ke halaman ini memerlukan kebenaran. Anda boleh cuba log masuk atau menukar direktori.
Akses ke halaman ini memerlukan kebenaran. Anda boleh cuba menukar direktori.
Terpakai kepada: Apl
kanvas Apl dipacu model
Fungsi ini Validate menyemak sama ada nilai lajur tunggal atau rekod lengkap adalah 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 ini Validate menggunakan maklumat ini untuk menentukan sama ada nilai adalah sah dan untuk mengembalikan mesej ralat yang sesuai jika tidak. Anda boleh menggunakan fungsi DataSourceInfo untuk melihat maklumat yang sama yang Validate digunakan.
Sumber data menyediakan maklumat pengesahan yang berbeza, termasuk tidak menyediakan langsung maklumat. Validate hanya boleh mengesahkan nilai berdasarkan maklumat ini. Walaupun Validate tidak menemui masalah, menggunakan perubahan data mungkin masih gagal. Anda boleh menggunakan fungsi Errors untuk mendapatkan maklumat tentang kegagalan.
Jika Validate menemui masalah, fungsi mengembalikan mesej ralat yang boleh anda tunjukkan kepada pengguna apl. Jika semua nilai adalah sah, Validate mengembalikan kosong. Apabila anda bekerja dengan pengumpulan yang tiada maklumat pengesahan, nilai selalu sah.
Sintaks
Validate( Sumber Data, Lajur, Nilai )
- Sumber Data– Diperlukan. Sumber data untuk disahkan bersama.
- Lajur – Diperlukan. Lajur untuk disahkan.
- Nilai - Diperlukan. Nilai untuk lajur yang dipilih untuk disahkan.
Validate( DataSource, OriginalRecord, Kemas Kini )
- Sumber Data– 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.
Validate dengan satu lajur
| Formula | Penerangan | Hasil |
|---|---|---|
| Validate( Markah, Peratusan, 10 ) | Semak sama ada 10 adalah nilai sah untuk lajur Peratusan dalam sumber data Skor. | Kosong |
| Validate( Markah, Peratusan, 120 ) | Semak sama ada 120 adalah nilai sah untuk lajur Peratusan dalam sumber data Skor. | "Nilai mesti antara 0 dan 100." |
Validate dengan rekod lengkap
| Formula | Penerangan | Hasil |
|---|---|---|
| Validate( Skor, EditRecord, Galeri.Kemas Kini ) | Semak sama ada nilai dalam semua lajur adalah sah untuk sumber data Skor. Dalam contoh ini, nilai dalam lajur Peratusan ialah 10. | Kosong |
| Validate( Skor, EditRecord, Galeri.Kemas Kini ) | 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." |