Подписки на события (интерфейс UI4)
Функция доступна с версии 1.26.3
Описание этого раздела для прежнего интерфейса (UI2) см. в статье Подписки на события.
Механизм подписки на события позволяет гибко настраивать получение уведомлений, связанных с роботами, проектами, заданиями и машинами.
Старый механизм подписок сохранен для обратной совместимости. В дальнейшем планируется постепенный переход на новый механизм.
Основные возможности
- Гибкая настройка фильтров — можно подписаться на события, связанные только с конкретными проектами, машинами, заданиями или роботами.
- Выбор событий — поддерживается подписка как на отдельные системные или оркестраторные события, так и на их комбинации.
- Мультиязычность — язык уведомлений (русский или английский) настраивается централизованно через конфигурацию сервисов.
- Управление активностью — подписку можно временно отключить без удаления.
Типы событий
Системные события
| Событие | Описание |
|---|---|
| Агент не доступен | Агент робота перестал отвечать |
| Очередь ожидания проектов растет | Увеличивается количество проектов в очереди |
| Срок действия лицензии истекает | Приближается дата окончания лицензии |
Оркестраторные события
В новом механизме подписок доступны для выбора оркестраторные события. Полный перечень событий с кодами и описаниями приведен в Приложении 3 – События Оркестратора.
Ниже перечислены основные события, наиболее часто используемые для настройки подписок:
| Событие | Описание |
|---|---|
| Агент доступен / не доступен | Изменение статуса подключения агента |
| Задание создано / изменено / удалено / завершено | Операции с заданиями |
| Запуск робота / Ошибка запуска робота | События запуска роботов |
| Ошибка выполнения робота | Ошибка в процессе выполнения |
| Успешное завершение выполнения проекта | Проект выполнен без ошибок |
| Проект создан / изменен / удален | Операции с проектами |
| Робот создан / изменен / удален | Операции с роботами |
| Лицензия истекает | Приближается дата окончания лицензии |
Фильтрация по сущностям
При создании подписки можно уточнить, к каким сущностям она будет применяться, выбрав один или несколько фильтров:
- Проект — уведомления только для выбранных проектов;
- Машина — уведомления только для выбранных машин;
- Задание — уведомления только для выбранных заданий.
Принцип работы фильтров
Подписка сработает, если хотя бы одна сущность из выбранного списка участвует в событии, на которое оформлена подписка.
Настройка языка уведомлений
Язык уведомлений определяется настройками служб States и Notifications. В файлах конфигурации appsettings.json необходимо установить параметр Culture:
| Язык | Значение параметра |
|---|---|
| Русский | "ru-RU" |
| Английский | "en-US" |
Важно: Значение Culture должно быть одинаковым в обеих службах — States
и Notifications.
Создание подписки
Подписки создаются и редактируются в разделе Настройки → Администрирование → вкладка Подписки.
-
Откройте Настройки → Администрирование → Подписки и нажмите Добавить подписку.
-
В открывшейся форме заполните поля:
- Наименование — обязательное поле;
- Тенант — подставляется автоматически (тенант по умолчанию);
- Описание — необязательное;
- Email — обязательное, адрес для получения уведомлений;
- Подписка активна — переключатель активности подписки;
- Системные события и Оркестраторные события — выбор событий (мультивыбор);
- Фильтр по сущностям — становится доступен при выбранных оркестраторных событиях (кнопка Добавить фильтр).
-
Нажмите Сохранить.
Подробные правила проверки полей и права доступа описаны в статье Подписки на события (интерфейс UI4).
Пункт Настройки → Администрирование → Уведомления в новом интерфейсе открывает не подписки, а очередь исходящих email — см. Уведомления — очередь email.