Функция Validate

Применимо к: приложениям на основе холста приложениям на основе модели

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

Описание

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

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

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

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

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

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

Синтаксис

Validate( DataSource, Column, Value )

  • DataSource — обязательный аргумент. Источник данных, с которым необходимо сверить значение.
  • Column — обязательный аргумент. Столбец, который необходимо проверить.
  • Value — обязательный аргумент. Значение в выбранном столбце, которое необходимо проверить.

Validate( DataSource, OriginalRecord, Updates )

  • DataSource — обязательный аргумент. Источник данных, с которым необходимо сверить значение.
  • OriginalRecord — обязательный аргумент. Запись, обновления которой необходимо проверить.
  • Updates — обязательный аргумент. Изменения, которые требуется применить к исходной записи.

Примеры

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

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

Формула Описание Результат
Validate( Scores, Percentage, 10 ) Проверяет, является ли 10 допустимым значением для столбца Percentage в источнике данных Scores. пусто
Validate( Scores, Percentage, 120 ) Проверяет, является ли 120 допустимым значением для столбца Percentage в источнике данных Scores. "Значения должны быть в диапазоне от 0 до 100".

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

Формула Описание Результат
Validate( Scores, EditRecord, Gallery.Updates ) Проверяет, допустимы ли значения во всех столбцах для источника данных Scores. В этом примере значение в столбце Percentage равно 10. пусто
Validate( Scores, EditRecord, Gallery.Updates ) Проверяет, допустимы ли значения во всех столбцах для источника данных Scores. В этом примере значение в столбце Percentage равно 120. "Значения должны быть в диапазоне от 0 до 100".