Валидиране на функция

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

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

Описание

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

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

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

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

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

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

Синтаксис

Validate( DataSource, Column, Value )

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

Validate( DataSource, OriginalRecord, Updates )

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

Примери

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

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

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

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

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