Функция Validate

Применимо к: Приложениям Canvas Приложениям, управляемым моделями

Функция Validate проверяет, являются ли значения одного столбца или всей записи допустимыми для источника данных.

Описание

Вы можете настроить мгновенную проверку пользовательских изменений перед их отправкой, чтобы оптимизировать работу пользователей с данными.

Источники данных могут содержать информацию о том, какие значения в записях считаются допустимыми. Эти сведения могут включать различные ограничения, например:

• требуется ли значение в определенном столбце;
• максимальная допустимая длина для текстовой строки;
• максимальное и минимальное значения для числа;
• нижняя и верхняя границы диапазона для даты.

Функция Validate использует эту информацию, чтобы определить, является ли значение допустимым, и в противном случае возвращает соответствующее сообщение об ошибке. Для просмотра информации, которую использует функция Validate, можно воспользоваться функцией DataSourceInfo.

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

Если функция Validate обнаруживает проблему, она возвращает сообщение об ошибке, которое можно продемонстрировать пользователю приложения. Если все значения допустимы, Validate возвращает пустое значение. При работе с коллекцией, в которой нет информации о проверке, значения всегда считаются действительными.

Синтаксис

Проверить( DataSource, Столбец, Значение< а10>)

• Источник данных – обязателен. Источник данных, с которым необходимо сверить значение.
• Столбец – Обязательно. Столбец, который необходимо проверить.
• Значение – Обязательно. Значение в выбранном столбце, которое необходимо проверить.

Проверить( Источник данных, Исходная запись, Обновления )

• Источник данных – обязателен. Источник данных, с которым необходимо сверить значение.
• OriginalRecord - Обязательно. Запись, обновления которой необходимо проверить.
• Обновления - Требуются. Изменения, которые требуется применить к исходной записи.

Примеры

В этих примерах значения в столбце Percentage (Процент) источника данных Scores (Показатели) должны находиться в диапазоне от 0 до 100 включительно. Если данные проходят проверку, функция возвращает пустое значение. В противном случае она возвращает сообщение об ошибке.

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

Проверка всей записи