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

Чтобы использовать системные события в своих задачах, вам необходимо: 

1. Создайте запись в реестре событий.
2. Определите серверный скрипт для системного события, создав запись в таблице Скрипты действий для событий (sys_event_script_action).
3. Определите правило отправки уведомлений.
4. Вы можете комбинировать перечисленные выше параметры, чтобы ваша запись реестра событий могла совместно запускать действия и отправлять уведомления.

Структура событий

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

Чтобы создать событие, используйте методы серверного API ss.eventQueue или ss.eventQueueScheduled. В результате создания добавятся записи в таблице События (sys_event).

Поля формы Событие

Связанные списки записи события содержат следующие записи:

• Список всех связанных записей из таблицы Реестра событий (sys_event_register).
• Список всех скриптов из таблицы Скрипты действий для событий (sys_event_script_action), которые ссылаются на текущую запись.

Реестр событий

Чтобы создать запись реестра, выполните следующие шаги:

1. Перейдите в Системные события → Реестр событий.
2. Нажмите Создать и заполните поля.
3. Нажмите Сохранить или Сохранить и выйти.

Поля формы Реестр событий

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

• Список всех скриптов из таблицы Скрипты действий для событий (sys_event_script_action) ссылается на текущую запись.
• Список всех связанных Правил уведомлений активированных текущей записью реестра событий. 

Скрипты действий для событий

Чтобы создать скрипт действия для события, выполните следующие шаги:

1. Перейдите в Системные события → Скрипты событий.
2. Нажмите Создать и заполните поля.
3. Нажмите Сохранить или Сохранить и выйти.

Поля формы Скрипты действий для событий

const currentRecord = new SimpleRecord(event.table_id.name);
currentRecord.get(event.instance);
if (String(currentRecord.state) !== event.param_1) {
    currentRecord.state = event.param_1;
    currentRecord.update();
}

(function executeEventScript(event) {
  const lastComment = new SimpleRecord('sys_activity_feed_item');
  lastComment.addQuery('table_id', '156950677111866258'); // itsm_incident
  lastComment.addQuery('record_id', event.instance);
  lastComment.addQuery('type_id.name', '!=', 'history');
  lastComment.orderByDesc('sys_created_at');
  lastComment.setLimit(1);
  lastComment.query();
  event.param_5 = lastComment.next();
})(event);