Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Системные события позволяют создавать задачи для выполнения скрипта на стороне сервера или отправки уведомления в указанный момент времени. Это наиболее распространенные варианты использования системных событий. Вы также можете использовать один регистр событий для обеих перечисленных выше задач.
Tip |
---|
Требуемая роль: admin. |
Чтобы использовать системные события в своих задачах, вам необходимо:
- Создайте запись в реестре событий.
- Определите сценарий сервера серверный скрипт для системного события, создав запись в таблице Скрипты действий для событий (sys_event_script_action).
- Определите правило отправки уведомлений.
- Вы можете комбинировать перечисленные выше параметры, чтобы ваша запись реестра событий могла совместно запускать действия и отправлять уведомления.
Структура событий
Image Modified
Создание события
Чтобы создать событие, используйте методы серверного API ss.eventQueue или ss.eventQueueScheduled. В результате создания добавятся записи в таблице События (sys_event).
Note |
---|
Вы не можете создавать, редактировать или удалять записи в таблице События (sys_event) вручную. Их могут читать только пользователи с ролью admin. |
Поля формы Событие
Поле | Описание | ||
---|---|---|---|
Наименование | Имя записи, вызываемой из таблицы Реестр событий (sys_event_register). | ||
Экземпляр | ID записи объекта. При создании события с помощью вызова методов ss.eventQueue или ss.eventQueueScheduled необходимо передать запись объекта. ID объекта будет сохранен в этом поле. Это значение можно будет вызвать в теле Скрипта действия для события (sys_event_script_action):
| ||
Таблица | Это поле содержит ссылку на таблицу, которая была передана во время создания события. Это поле заполняется автоматически. | ||
Статус | Статус события:
| ||
Длительность обработки, мс | Продолжительность обработки системного события (в миллисекундах). | ||
Пользователь | В этом поле всегда указывается пользователь системы (который также может отображаться в формах как 100000000000000000). Это пользователь, от имени которого должно выполняться событие. | ||
Процесс стартовал в | Дата и время начала выполнения системного события. Для запланированных событий, это поле заполняется значением, переданным параметром метода ss.eventQueueScheduled. Дата и время выполнения скрипта События (sys_event). | ||
Процесс завершился в | Дата и время окончания выполнения системного события. | ||
Параметр 1-5 | Строковые параметры, которые можно передать в указанную запись События (sys_event) через серверный API SimpleOne (методы ss.eventQueue и ss.eventQueueScheduled).
|
Связанные списки записи события содержат следующие записи:
- Список всех связанных записей из таблицы Реестра событий (sys_event_register).
- Список всех скриптов из таблицы Скрипты действий для событий (sys_event_script_action), которые ссылаются на текущую запись.
Реестр событий
Чтобы создать запись реестра, выполните следующие шаги:
- Перейдите в Системные события → Реестр событий.
- Нажмите Создать и заполните поля.
- Нажмите Сохранить или Сохранить и выйти.
Поля формы Реестр событий
Поле | Обязательно | Описание | ||
---|---|---|---|---|
Наименование | ДДа | Укажите название реестра событий. Оно будет отображаться в поле Наименование связанных События (sys_event), вызываемые для этого реестра, будут содержать это значение в своем поле Наименование.
| ||
Таблица | ДДа | Укажите таблицу, содержащую записи, относящиеся к событиям. Если вы собираетесь инициировать отправку электронной почты с помощью этой записи, убедитесь, что значение в поле Таблица в записи Правило уведомления такое же, как в этой записи реестра событий. | ||
Описание | ННет | Добавьте описание реестра событий. | ||
Отключить логирование скриптов | ННет | Установите флажок, чтобы отключить ведение Журнала выполнения скриптов (sys_log_script) при запуске связанного события. |
Связанные списки записи реестра событий содержат следующие записи:
- Список всех скриптов из таблицы Скрипты действий для событий (sys_event_script_action) ссылается на текущую запись.
- Список всех связанных Правил уведомлений активированных текущей записью реестра событий.
Скрипты действий для событий
Чтобы создать скрипт действия для события, выполните следующие шаги:
- Перейдите в Системные события → Скрипты событий.
- Нажмите Создать и заполните поля.
- Нажмите Сохранить или Сохранить и выйти.
Поля формы Скрипты действий для событий
Поле | Обязательно | Описание | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Активно | ННет | Установите флажок, чтобы активировать скрипт. | ||||||||||||||||||||||
Наименование | ДДа | Укажите название скрипта действия. | ||||||||||||||||||||||
Запись реестра событий | ДДа | Укажите связанный Реестр событий (sys_event_register). | ||||||||||||||||||||||
Скрипт | ДДа | Укажите скрипт, который выполняется при запуске события.
Вы также можете обновить параметры объекта события (Параметр 1-5) с помощью скрипта действий для события.
|
Table of Contents | ||||||
---|---|---|---|---|---|---|
|