Функция за валидиране

Отнася се за: Приложения за платно Приложения, управлявани от модел

Функцията Validate проверява дали стойността на една колона или на пълен запис е валидна за източник на данни.

Описание

Преди даден потребител изпрати промяна на данните, можете да предоставите незабавна обратна връзка относно валидността на това изпращане, което води до по-добро потребителско изживяване.

Източниците на данни могат да предоставят информация за това какво представлява валидни стойности в даден запис. Тази информация може да включва много ограничения, като тези примери:

• дали колоната изисква стойност
• колко дълъг може да бъде низ от текст
• колко високо и ниско може да бъде числото
• колко ранна и закъсняла може да бъде една среща

Функцията Validate използва тази информация, за да определи дали стойността е валидна и за да върне подходящо съобщение за грешка, ако не. Можете да използвате DataSourceInfo функция за преглед на същата информация, която Validate използва.

Източниците на данни се различават по това колко информация за валидиране предоставят, включително не предоставят такава изобщо. Validate може да проверява стойности само въз основа на тази информация. Дори ако Validate не намери проблем, прилагането на промяната на данните все още може да се провали. Можете да използвате Errors функция за получаване на информация за повредата.

Ако Validate открива проблем, функцията връща съобщение за грешка, което можете да покажете на потребителя на приложението. Ако всички стойности са валидни, Validate връща blank. Когато работите с колекция, която няма информация за валидиране, стойностите са винаги валидни.

Синтаксис

Валидиране(Източник на данни,Колона,Стойност )

• Източник на данни – Задължително. Източникът на данни за потвърждаване.
• Колона – Задължително. Колоната за валидиране.
• Стойност – Задължително. Стойността за избраната колона за валидиране.

Валидиране ( Източник на данни, Оригинален запис, Актуализации )

• Източник на данни – Задължително. Източникът на данни за потвърждаване.
• Оригинален запис - Изисква се. Записът, към който трябва да бъдат потвърдени актуализациите.
• Актуализации - Задължително. Промените, които се прилагат към оригиналния запис.

Примери

За тези примери стойностите в Процент колоната на Оценки източник на данни трябва да бъде между 0 и 100, включително. Ако данните преминат валидиране, функцията се връща празно. В противен случай функцията връща съобщение за грешка.

Проверете с една колона

Формула	Описание	Резултат
Валидиране ( Резултати, Процент, 10 )	Проверява дали 10 е валидна стойност за Процент в колоната в Оценки източник на данни.	интервал
Валидиране ( Резултати, Процент, 120 )	Проверява дали 120 е валидна стойност за Процент в колоната в Оценки източник на данни.	„Стойностите трябва да са между 0 и 100.”

Валидирайте с пълен запис

Формула	Описание	Резултат
Validate( Резултати, EditRecord, Gallery.Updates )	Проверява дали стойностите във всички колони са валидни за Оценки източник на данни. В този пример стойността в Процент колоната е 10.	интервал
Validate( Резултати, EditRecord, Gallery.Updates )	Проверява дали стойностите във всички колони са валидни за Оценки източник на данни. В този пример стойността в Процент колоната е 120.	„Стойностите трябва да са между 0 и 100.”