Skip to content

Настройка обработчиков объекта

«Обработчики объектов» — один из ключевых инструментов автоматизации действий в системе. Он используется для вынесения типовой логики в отдельную переиспользуемую библиотеку с целью последующего подключения в настройках конкретных типов объектов или вызова через кастомные методы.

Обработчики объектов вызываются напрямую из базовых обработчиков событий (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; ==; Значение=Отмена)
- Текущий пользователь не оставил комментарий ()
то:
- Показать ошибку пользователю (Текст=В случае отмены или отклонения задачи необходимо оставить комментарий!)
Дата изменения Точная дата и время последнего редактирования или пересохранения текущего обработчика.
Пользователь Имя учетной записи администратора, который последним вносил изменения в обработчик.