Validate fonksiyon

Şunlar için geçerlidir: Tuval uygulamaları Model temelli uygulamalar

İşlev, Validate tek bir sütunun veya tam bir kaydın değerinin bir veri kaynağı için geçerli olup olmadığını denetler.

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

İşlev, bir değerin Validate geçerli olup olmadığını belirlemek ve değilse uygun bir hata iletisi döndürmek için bu bilgileri kullanır. DataSourceInfo işlevini kullanarak aynı bilgileri Validate 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 yalnızca bu bilgilere göre değerleri doğrulayabilir. Sorun bulmasa Validate bile veri değişikliğini uygulama işlemi yine başarısız olabilir. Errors işlevini kullanarak hatayla ilgili bilgi alabilirsiniz.

Bir sorun bulursa Validate işlev, uygulamanın kullanıcısına gösterebileceğiniz bir hata iletisi döndürür. Tüm değerler geçerliyse boşValidate 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, 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.

Validate tek sütunlu

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

Validate tam bir kayıtla

Formül	Açıklama	Sonuç
Validate( Scores, 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( Scores, 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."