Перейти к основному содержимому

Валидаторы

Валидаторы - набор правил, которые будут проверять содержимое атрибута при вводе в системе , и отклонять добавление данных, если они не подходят под эти правила. Для каждого из полей атрибута вы можете настроить валидаторы. Этом можно сделать, если перейти в настройки поля атрибута и спуститься в секцию "Правила валидации".

Набор валидаторов может отличаться в зависимости от типа данных.

Типы валидаторов

Каждый тип данный имеет свой набор доступных валидаторов. Ниже описаны все возможные валидаторы для всех типов данных, с которыми вы можете столкнуться.

Required filed

Это правило указывает, что данное поле обязательно должно быть заполнено. Не требует дополнительных настроек.

Trimming spaces around incoming data

Это правило указывает, что пробелы в начале и в конце строки будут удалены. Не требует дополнительных настроек.

Checking the string

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

URL verification

Это правило позволяет установить строковое значение, только если оно является ссылкой. Не требует дополнительных настроек.

Checking for a number

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

Rounding a number

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

Email Verification

Это правило проверяет, является ли значение строкой. Не требует дополнительных настроек.

Default value

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

Given list screening

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

Field mask

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

Regular expression validation

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

Регулярное выражение

Несмотря на то, что вы можете добавлять несколько валидаторов на одно поле атрибута, валидация с помощью регулярного выражения не совместима с некоторыми другими типами валидации

Comparison

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

Logical

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

Size

Это правило проверяет размер изображения. В дополнительных настройках можно настроить высоту и ширину изображения в пикселях.

Checking files

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

Пользовательские ошибки

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

Примеры

Пример валидации поля email.

В этом примере строковое значение будет добавлено:

  • Удаление возможных пробелов вначале и в конце строки
  • Проверка, что строка является email

Пример валидации поля пароля.

В этом примере строковое значение будет добавлено:

  • Проверка длины и состава строки с помощью регулярного выражения

Пример валидации поля изображения.

В этом примере строковое значение будет добавлено:

  • Проверка размерность картинки
  • Проверка вес картинки
  • Пользовательские ошибка