Справочник событий уведомлений

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

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

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

  • Задание начато,

  • Задание завершено,

  • Задание на приёмке,

  • Задание на доработке.

Родительское событие "Задание (общее уведомление)" работать не будет.
Справочник событий уведомлений
Рисунок 1. Справочник событий уведомлений
Справочник представлен в виде таблицы со следующими полями:
Идентификатор

Уникальный идентификатор, используемый при программном создании события.

Название

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

Описание

Развёрнутое описание события.

Тип карточки

Идентификатор типа карточки.

Вид карточки

Идентификатор вида карточки.

Состояние карточки

Идентификатор состояния карточки.

Создание нового события

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

Чтобы добавить новое событие уведомлений:

  1. Откройте справочник событий и добавьте новую строку в таблицу кнопкой Плюс.

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

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

  4. В поле Описание (опционально) укажите описание события, любую дополнительную информацию.

  5. В поле Тип карточки укажите идентификатор типа карточки, для которого создаётся событие. Событие в справочнике не может использоваться для разных типов карточек.

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

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

  7. В поле Состояние карточки (опционально) укажите идентификатор состояния, в котором применимо данное событие. Если указан пустой идентификатор, событие совместимо с карточками во всех доступных состояниях.

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

  8. Сохраните событие нажатием кнопки Сохранить.

Примеры настройки событий для неопределённых вызовов

Пример 1

Поскольку процесс Базовые объекты обращается к Сервису уведомлений при переходе задания в состояние На приёмке, можно создать уникальное событие Задание перешло на приёмку:

  1. В поле Название укажите: "Задание перешло на приёмку".

  2. В поле Тип карточки укажите ID типа Задание.

  3. В поле Вид карточки укажите ID вида задания[1], для которого применимо событие.

  4. В поле Состояние карточки укажите ID состояния На приёмке требуемого вида.

Пример 2

Дополнительно можно создать событие, которое будет совместимо со всеми карточками выбранного типа независимо от состояния (или вида и состояния).

Для этого:

  1. В поле Тип карточки укажите ID типа.

  2. В поле Вид укажите ID вида.

  3. В поле Состояние укажите пустой идентификатор (или укажите пустой идентификатор в полях Вид и Состояние).

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

Пример 3

Дополнительно можно создать "пустое" событие, которое будет использоваться для исключения рассылки в конкретном случае. Например, чтобы рассылка не выполнялась при возврате задания на доработку:

  1. Зарегистрируйте в справочнике событие из "Примера 2" и привяжите его к карточке рассылки.

  2. Зарегистрируйте новое событие Отказ в приёмке:

    1. В поле Вид карточки укажите вид задания.

    2. В поле Состояние карточки укажите ID состояния На доработке выбранного вида.

  3. Не привязывайте новое событие к карточке рассылки. В этом случае при переходе задания указанного вида на доработку из справочника будет выбрано событие Отказ в приёмке, а при переводе на приёмку — общее событие из "Примера 2".

1. ID вида необходим для дополнительного фильтра по состоянию