Проверка данных для виджетов ввода

Prev Next

Узнайте о способах проверки данных в Tulip с помощью виджетов, кнопок и триггеров.

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

Проверка данных значительно упрощает создание приложений, обеспечивая следующие преимущества:

  • Упрощение управления триггерами. Уменьшитеколичество и сложность триггеров, чтобы оптимизировать разработку и сопровождение приложений. Тратьте меньше времени на разработку приложений.
  • Создание динамических шагов. Добавьтев приложения динамическое управление с помощью функции включения/отключения кнопок, что обеспечит большую интерактивность и гибкость.
  • Упрощение обслуживания приложений: тратьтеменьше времени на проверку и изучение приложений. Копируйте и вставляйте виджеты, не беспокоясь о последствиях для триггеров.

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

Правила проверки, доступные для виджетов ввода

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

Виджет ввода Правила валидации
Флажок Не применимо
Текст Содержит, Не содержит, Начинается с, Заканчивается на, Максимальное количество символов, Минимальное количество символов, Является адресом электронной почты, Является URL-адресом (согласно информации здесь)
Многостроковый Содержит, Начинается с, Заканчивается на, Максимальное количество символов, Минимальное количество символов, Не содержит
Файл Не применимо
Число Равно, Не равно, Больше, Больше или равно, Меньше, Меньше или равно, В пределах диапазона (включительно), Вне диапазона (не включая), Точное количество десятичных знаков
Один выбор Не применимо
Многократный выбор Выбранное минимальное значение, Выбранное максимальное значение
Выбор даты «Есть», «До», «После», «В пределах диапазона (включительно)», «Вне диапазона (не включая)», «Включительно», «После»
Изображение Не применимо
Электронная подпись Не применимо

Создание правила проверки

  1. Выберите виджет ввода, для которого доступны правила проверки (см. таблицу выше).
  2. В контекстной панели нажмите значок «+ » рядом с пунктом «Правила проверки».
  3. Выберите правило, которое хотите добавить к виджету ввода.

Validation Rules side pane ex

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

Validation rules configuration ex

  1. Нажмите кнопку «+», чтобы добавить дополнительные правила.

Изменение порядка правил проверки

Порядок правил проверки соответствует порядку появления первых сообщений об ошибках в случае несоответствия введенного значения требованиям.

В приведенных ниже примерах введенные данные не соответствуют обоим правилам проверки. Однако отображаемое сообщение об ошибке относится к первому настроенному правилу.

Пример 1: «Содержитслово „Tulip“»— это первое правило, которое не прошло проверку, поэтому соответственно отображается сообщение об ошибке.

Validation Rule Order Ex1

Пример 2.Первым нарушенным правилом является«Начинаетсясо слова Hello», поэтому отображается соответствующее сообщение об ошибке.

Validation Rule Order Ex2

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

Reorder Validation Rules

Обязательность ввода данных

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

Validation rules mark required

Сообщения об ошибках проверки вводимых данных

Выпадающий список «Форматирование ошибок» в разделе «Правила проверки » боковой панели предлагает варианты отображения ошибок вводимых данных оператору при запуске приложения в Player.

Validation rules error formatting

Три варианта визуализации ошибок для оператора: 1. Показать сообщение об ошибке по правилу проверки * Поле ввода обводится красным контуром, и оператору отображается сообщение об ошибке. 2. Только обводка поля ввода * Поле ввода обводится красным контуром. 3. Скрыть ошибку * Визуальная индикация отсутствует

Динамическое включение и отключение кнопок

Определите, когда операторы могут нажимать кнопку, с помощью динамических элементов управления. Когда кнопка отключена, она отображается в приглушённых цветах, и оператор не сможет её нажать.

Enabled vs disabled buttons

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

Enabled vs disabled eSignature

Кнопки можно динамически включать или отключать, установив состояние «Включено» в разделе «Взаимодействие» боковой панели для выбранной кнопки. По умолчанию состояние «Включено» для кнопки установлено на «Да».

button side pane enabled state yes

Существует несколько способов добавить динамический контроль для определения состояния «Включено» кнопки: 1. Указать булеву переменную; 2. Проверить достоверность ввода пользователя на шаге с виджетами ввода, имеющими правила проверки; 3. Использовать опцию «Все виджеты», которая проверяет, соответствуют ли все введенные данные правилам проверки

Button side pane enabled state all widgets

  1. Используйте выражение

Используйте выражения для включения/отключения кнопок

Если вы хотите включить или отключить кнопку на основе подмножества виджетов, выберите «Использовать выражение», чтобы написать собственное условие.

Вы должны написать выражение, которое при вычислении дает булево условие (true или false). Если вы правильно составили допустимое выражение, редактор выражений укажет на это в левом нижнем углу.

**Пример 1.**В приведенном ниже примере используется операция модуля для определения, является ли значение, введенное в виджет ввода числа, чётным или нечётным. Если значение нечётное, кнопка будет включена. Если значение чётное, кнопка будет отключена.

enable-disable buttons expressions ex1(1)

Пример 2. Использованиевыражений также позволяет комбинировать несколько условий. В приведенном ниже примере для того, чтобы кнопка стала активной, значение должно быть нечётным и соответствовать условиям проверки, заданным для виджета ввода чисел.

enable-disable buttons expressions ex2(1)

Приведенное ниже значение ввода приводит к тому, что кнопка отключается. Несмотря на то что введенное значение нечетное, оно не соответствует правилам проверки виджета ввода.

enable-disable buttons expressions ex2 invalid input

При вводе значения, показанного ниже, кнопка становится активной, поскольку введенное значение является нечётным и соответствует правилам проверки, заданным для виджета ввода.

enable-disable buttons expressions ex2 valid input

Проверка данных в виджете ввода в триггерах

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

Input validation trigger ex1

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

Input validation trigger ex2


Нашли ли вы то, что искали?

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