Validate işlevi
Şunlar için geçerlidir: Tuval uygulamaları Model yönetimli uygulamalar
Validate işlevi tek bir sütunun veya bir kaydın tamamının değerinin bir veri kaynağı için geçerli olup olmadığını kontrol eder.
Açıklama
Bir kullanıcı tarafından veri değişikliği gönderilmeden önce ilgili gönderinin geçerli olup olmadığıyla ilgili anlık geri bildirim sağlayarak daha iyi bir kullanıcı deneyimi oluşturabilirsiniz.
Veri kaynakları bir kayıtta geçerli değer olarak kabul edilen veriler hakkında bilgi sağlayabilir. Bu bilgiler aşağıdaki örnekte olduğu gibi birçok kısıtlama içerebilir:
- bir sütun için değer gerekip gerekmediği
- bir metin dizesinin ne kadar uzun olabileceği
- sayıların alt ve üst sınırları
- tarihlerin başlangıç ve bitiş dönemleri
Validate işlevi bu bilgileri kullanarak bir değerin geçerli olup olmadığını belirler ve geçerli olmaması halinde uygun bir hata iletisi döndürür. DataSourceInfo işlevini kullanarak Validate tarafından kullanılan bilgilerin aynısını görüntüleyebilirsiniz.
Veri kaynakları, sağladıkları bilgi miktarı açısından değişiklik gösterir. Hiç veri sağlamayan veri kaynakları da mevcuttur. Doğrulama , yalnızca bu bilgilere dayalı olarak değerleri doğrulayabilir. Validate bir sorun algılamasa da veri değişikliğinin uygulanması hata oluşturabilir. Errors işlevini kullanarak hatayla ilgili bilgi alabilirsiniz.
Validate işlevi bir sorun algılarsa uygulamanın kullanıcılarına gösterebileceğiniz bir hata iletisi döndürür. Tüm değerler geçerliyse Validate işlevi blank değer döndürür. Doğrulama bilgisine sahip olmayan bir koleksiyonla çalıştığınızda değerler her zaman geçerlidir.
Sözdizimi
Validate(DataSource,Column,Value )
- DataSource – Gerekli. Doğrulama yapılacak veri kaynağı.
- Sütun – Gerekli. Doğrulanacak sütun.
- Değer – Gerekli. Seçilen sütunun doğrulanması için gerekli değer.
Doğrula(DataSource,OriginalRecord,Updates )
- DataSource – Gerekli. Doğrulama yapılacak veri kaynağı.
- OriginalRecord - Gerekli. Güncelleştirmelerin doğrulanacağı kayıt.
- Güncellemeler - Gerekli. Özgün kayda uygulanacak değişiklikler.
Örnekler
Bu örnekler için Puanlar veri kaynağının Yüzde sütunundaki değerlerin 0 ile 100 arasında (ikisi de dahil) olması gerekir. Veriler doğrulamadan geçerse işlev boş değer döndürür. Geçemezse işlev bir hata iletisi döndürür.
Tek bir sütunla doğrulama
Formül | Açıklama | Sonuç |
---|---|---|
Validate( Puanlar, Yüzde, 10 ) | 10 değerinin Puanlar veri kaynağındaki Yüzde sütunu için geçerli bir değer olup olmadığını kontrol eder. | boş |
Validate( Puanlar, Yüzde, 120 ) | 120 değerinin Puanlar veri kaynağındaki Yüzde sütunu için geçerli bir değer olup olmadığını kontrol eder. | "Değerler 0 ile 100 arasında olmalıdır." |
Tam bir kayıtla doğrulama
Formül | Açıklama | Sonuç |
---|---|---|
Validate( Puanlar, EditRecord, Gallery.Updates ) | Tüm sütunlardaki verilerin Puanlar veri kaynağı için geçerli olup olmadığını denetler. Bu örnekte, Yüzde sütununda 10 değeri bulunmaktadır. | boş |
Validate( Puanlar, EditRecord, Gallery.Updates ) | Tüm sütunlardaki verilerin Puanlar veri kaynağı için geçerli olup olmadığını denetler. Bu örnekte, Yüzde sütununda 120 değeri bulunmaktadır. | "Değerler 0 ile 100 arasında olmalıdır." |