ValidationController

Назначение компонента

ValidationController – инструмент для построения проверок перед сохранением.

ValidationController срабатывает только в момент сохранения (по кнопке SaveButton на Form.

Настройка компонента

Настройка ValidationController включает в себя настройку следующих разделов:

• ЕСЛИ – условия.
• Уведомить – реакция системы на выполнение всех условий из ЕСЛИ.

Рассмотрим настройку каждого раздела:

ЕСЛИ

Этот раздел задает условия(проверки), при выполнении которых будет выполняться раздел Уведомить.

Условие задается:

• ссылкой на объект (на который мы накладываем наше условие):
• проверка.

Есть возможность создавать группы условий, объединенных логическими операциями “И”, “ИЛИ”.

Уведомить

Этот раздел задает реакцию системы, в случае если условия из раздела ЕСЛИ выполнились:

Есть два типа уведомлений:

• **SYSTEM **– стандартное уведомление, с заданным текстом;

  

• **CUSTOM **– уведомление, которое будет выведено в заданный компонент. Для примера, будем использовать вывод уведомления в компонент TextArea. Такой вывод происходит в два этапа:

• • действие до – предварительные действия.
    В нашем примере, компонент TextArea, в который будет выведено уведомление, необходимо предварительно очистить (присвоить пустое значение):
    

  • действие _–****_ действия, непосредственно связанные с выводом.
    Осуществим вывод в TextArea:
    

Пример настройки

Задача: На странице имеются два поля (ComboBox) и кнопка сохранения. Необходимо проверить на заполненность этих полей при сохранении.

1. Добавляем все необходимые компоненты на страницу:

   

   Замечание

   Обратите внимание, поля расположены в Form.

   ValidationController расположен в Form.

2. Настраиваем компонент Form (см. Настройка Grid), компоненты ComboBox, SaveButton.

3. Настраиваем ValidationController:
   1. Создаем Условие (ЕСЛИ), нажатием на кнопку . Условия в этом примере связаны логической операцией ИЛИ, т.к. необходимо проверить оба поля на пустоту (если поставим И - будет выдаваться сообщение только если оба поля будут пустыми).
   2. К Условию привязываем объект для валидации - PersistingComboBox_country (необходимо проверять ComboBox, содержащий страны, на пустоту):

      

   3. Задаем проверку на пустоту (Если значение ComboBox пусто):
      
   4. Тоже самое для второго ComboBox, содержащего города:
      
   5. Задаем реакцию на выполненные условия (Уведомить):
      из выпадающего списка выбираем SYSTEM - вывод простого системного сообщения:
      
   6. Зададим сообщение: