Настройка обработчиков объекта
«Обработчики объектов» — один из ключевых инструментов автоматизации действий в системе. Он используется для вынесения типовой логики в отдельную переиспользуемую библиотеку с целью последующего подключения в настройках конкретных типов объектов или вызова через кастомные методы.
Обработчики объектов вызываются напрямую из базовых обработчиков событий (EventHandlers) и функционируют по следующему алгоритму:
- При наступлении заданного события срабатывает системный «Обработчик события».
- В случае удовлетворения настроенным условиям запускается обработчик объекта, который выполняет целевые действия:
- Для текущего объекта — логика применяется непосредственно к исходной карточке.
- Для связанного объекта — логика последовательно применяется ко всем сущностям с указанной системной ролью, находящимся в блоке связей родительского объекта.
Обработчики событий доступны для следующих бизнес-объектов системы:
| Бизнес-объект | Описание объекта | Инструкция по настройке |
|---|---|---|
Активность (Activity) |
Открыть описание | Открыть инструкцию |
Документ (simpleDocument) |
Открыть описание | Открыть инструкцию |
Договор (Contract) |
Открыть описание | Открыть инструкцию |
Закупка (productOrder) |
Открыть описание | Открыть инструкцию |
Счет (Invoice) |
Открыть описание | Открыть инструкцию |
Согласование (contractorApproval) |
Открыть описание | Открыть инструкцию |
Заявка (Request) |
Открыть описание | Открыть инструкцию |
Продажа (Opportunity) |
Открыть описание | Открыть инструкцию |
Физические лица (ContactPerson) |
Открыть описание | Открыть инструкцию |
Юридические лица (Company) |
Открыть описание | Открыть инструкцию |
Пример списка обработчиков объекта
Рисунок 1. Реестр настроенных обработчиков объектов в интерфейсе.
Пример карточки обработчика объекта
Рисунок 2. Интерфейс карточки редактирования обработчика объекта.
Основные поля и настройки обработчика событий
| Поле / Действие / Раздел | Описание и требования к заполнению |
|---|---|
| Событие | Определяет тип системного обработчика объектов. |
| Действителен с | Дата, начиная с которой обработчик становится доступным для выбора в настраиваемых типах объектов. |
| Действительно по | Дата, после которой обработчик перестанет действовать и скрывается из списков доступных конфигураций. |
| Приоритет | Порядок исполнения триггера. Если для объекта настроено несколько обработчиков, они выполняются последовательно в соответствии с приоритетом — от меньшего к большему. |
| Условия | Раздел для формирования набора логических правил, которые система анализирует в рантайме в момент фиксации события. |
| Срабатывает если | Конфигурация условий срабатывания триггера. Если вычисляемое выражение возвращает True, система запускает блок «Действия». Если False — запускается блок «Иначе». Доступны режимы:Все условия выполнились — результат равен True, если каждое заданное условие вернуло истину.Одно из условий выполнилось — результат равен True, если хотя бы одно правило из списка истинно.Другое — ручное определение сложной булевой операции (комбинации операторов AND, OR, NOT) для настроенных условий. |
| Действия | Список операций, выполняемых при результате условий True. Допускается настройка нескольких последовательных действий, которые будут выполняться по цепочке сверху вниз. |
| Иначе | Список операций, выполняемых в случае, если проверка условий вернула False. Выполняются в порядке следования от верхнего к нижнему. |
| Описание | Служебное текстовое поле для внесения подробного описания назначения и логики работы текущего обработчика. |
| Кнопка ОК | Сохраняет внесенные изменения и автоматически закрывает карточку обработчика. |
| Кнопка Сохранить | Сохраняет текущие параметры конфигурации на сервере без закрытия рабочего окна. |
| YAML | Вкладка для просмотра, копирования и сохранения YAML-конфигурации настроенного обработчика. |
| Закрыть | Закрывает карточку обработчика без сохранения внесенных изменений. |
Описание полей в таблице обработчиков объекта
Рисунок 3. Интерфейс таблицы реестра обработчиков объектов.
В основном колонки таблицы обработчиков типов дублируют ключевые поля самой карточки. Однако в табличном представлении доступны три дополнительных системных поля:
| Название поля | Описание |
|---|---|
| Действия | Поле, в котором автоматически агрегируется и визуализируется вся настроенная логическая цепочка. Пример отображения: Условие ( Срабатывает если=Другое; 1 and 2 and 3):- Условие на значение поля ( Поле=state.stateTransitionID.initialStateID; <>; Значение=Новый) - Условие на значение поля ( Поле=state.toStateID; ==; Значение=Отмена) - Текущий пользователь не оставил комментарий () то: - Показать ошибку пользователю ( Текст=В случае отмены или отклонения задачи необходимо оставить комментарий!) |
| Дата изменения | Точная дата и время последнего редактирования или пересохранения текущего обработчика. |
| Пользователь | Имя учетной записи администратора, который последним вносил изменения в обработчик. |