Validate işlevi

Şunlar için geçerlidir: Tuval uygulamaları Model temelli 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. Validate işlevi, değerleri yalnızca bu bilgilere dayanarak 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, Sütun, Değer )

• 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.

Validate( DataSource, OriginalRecord, Güncelleştirmeler )

• DataSource – Gerekli. Doğrulama yapılacak veri kaynağı.
• OriginalRecord: Gerekli. Güncelleştirmelerin doğrulanacağı kayıt.
• Güncelleştirmeler: 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

Tam bir kayıtla doğrulama