Модули расширения системы > Пользовательские модули / Обработка событий в модулях

Обработка событий в модулях

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

Обработчик события — запускает определенное действие в системе после того, как событие произошло. Это удобно при разработке комплексных модулей. Например, обработчик может запускать бизнес-процесс, настроенный внутри модуля, при изменении элемента приложения.

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

начало внимание

Действие Передача сообщения в сервис доступно только в ELMA365 on-premises.

конец внимание

Для того, чтобы создать обработчик событий:

  1. Перейдите в Администрирование > Модули.
  2. Наведите курсор на модуль и нажмите на появившийся значок шестеренки.
  3. Перейдите на вкладку Обработка событий.
  4. Нажмите кнопку +Обработчик и задайте необходимые настройки в открывшемся окне.

events_processing-1

  • Название* — укажите название обработчика.
  • Домен события* — выберите область, события в которой будет отслеживать обработчик. Вы можете выбрать следующие домены:
    • Все события;
    • Элементы приложения;
    • Приложения;
    • Файлы;
    • Директории;
    • Модули;
    • Настройки;
    • Пользователи.

начало внимание

Домен события Файлы доступен только в ELMA365 on-premises.

конец внимание

  • Событие* — выберите событие, после которого будет запускаться обработчик. Список событий различается в зависимости от выбранного домена. Списки доступных событий для каждого домена мы привели ниже.  
  • Тип обработчика* — выберите действие, которое будет совершаться при выполнении события.
    • Запуск скриптавыполняет заданный сценарий;
    • Запуск процессазапускает бизнес-процесс, созданный в модуле на вкладке Процессы;
    • Передача сообщения в сервис — отправляет сообщение во внешний микросервис. Действие доступно только в ELMA365 on-premises.

начало внимание

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

конец внимание

  1. Нажмите кнопку Создать.
  2. В открывшемся окне выберите необходимый процесс, скрипт или микросервис.events_peocessing-2
  3. Опубликуйте разработчик.

Доступные события системы

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

Для домена Все события доступна одна опция — Все события системы.

Для домена Элементы приложений вы можете выбрать событие:

  • Добавление комментария к элементу приложений;
  • Изменение статуса элемента приложений;
  • Создание элемента приложения;
  • Удаление элемента приложения;
  • Обновление элемента приложения.

Для домена Приложения доступны следующие события:

  • Экспорт данных приложения;
  • Импорт данных приложения.

Для домена Файлы доступны события:

  • Добавление комментария к файлу;
  • Создание файла;
  • Удаление файла;
  • Изменение файла;
  • Изменение прав доступа к файлу.

Для домена Директории вы можете выбрать события:

  • Создание директории;
  • Удаление директории;
  • Изменение прав доступа к директории;
  • Изменение директории.

Для домена Модули доступны следующие события:

  • Выключение модуля;
  • Включение модуля;
  • Установка модуля;
  • Обновление модуля.

Для домена Настройки предусмотрены события:

  • Изменение дополнительных параметров.

Для домена Пользователи можно указать событие:

  • Ошибка авторизации пользователя;
  • Успешная авторизация пользователя;
  • Ошибка аутентификации пользователя;
  • Успешная аутентификация пользователя;
  • Выход пользователя из системы.

Как отменить действие обработчика

Чтобы отменить действие обработчика, на вкладке Обработка событий нажмите на три точки напротив названия, созданного обработчика. Затем выберите кнопку Отмена публикации. При этом после выполнения события действие обработчика не будет совершаться.

Кроме того, при необходимости вы можете удалить существующий обработчик событий. Для этого на вкладке Обработка событий отметьте один или несколько обработчиков в списке. Нажмите на кнопку Удалить, появившуюся в правом верхнем углу страницы.

events_processing-3

Нашли опечатку? Выделите текст, нажмите ctrl + enter и оповестите нас