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

Описание

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

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

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

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

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

Синтаксис

Validate(источник_данных, столбец, значение)

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

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

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

Validate(источник_данных, исходная_запись, обновления)

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

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

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

Примеры

В этих примерах значения в столбце 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) Проверяет, является ли 10 допустимым значением для столбца Percentage в источнике данных Scores. пусто
Validate(Scores, EditRecord, Gallery.Updates) Проверяет, является ли 120 допустимым значением для столбца Percentage в источнике данных Scores. "Значения должны быть в диапазоне от 0 до 100".