Validate функция

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

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

Описание

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

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

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

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

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

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

Синтаксис

Validate( Източник на данни, колона, стойност )

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

Validate( DataSource, OriginalRecord, Updates )

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

Примери

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

Validate с една колона

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

Validate с пълен запис

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