Сигналы

С базовой информацией по сигналам можно ознакомиться в разделе Внедрение → Сигналы.
А этот раздел предназначен для изменения настроек модели сигналов.

На экране Администрирование → Настройки сигналов администратору пространства доступны 3 вкладки для управления параметрами сигналов:

1. Типы - раздел, в котором определяются состав атрибутов и схема жизненного цикла сигналов для каждого типа
2. Атрибуты - общий набор настраиваемых полей для сигналов
3. Статусы – список статусов, которые могут использоваться в схемах жизненного цикла типов сигналов

схемы ЖЦ

Каждая схема ЖЦ определяется и редактируется только внутри соответствующего типа сигнала. Вне типов сигналов схем ЖЦ быть не может.

ролевая модель

Возможность создания и редактирования модели сигналов регулируется ролевой моделью для администраторов: права зависят от назначенной пользователю роли

Типы сигналов

Общая информация

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

Управление типами сигналов выполняется на уровне пространства с последующей синхронизацией во все рабочие группы (РГ).

название типа и его ключ должны быть уникальными в рамках пространства

При попытке создания сигнала с несуществующим типом система назначает тип по умолчанию: signal.

Настройка типа сигнала осуществляется в 2 этапа:

1. Создание и настройка типа (выполняется администратором пространства)
2. Подключение типа сигнала к рабочей группе (выполняется менеджером РГ)

Создание типа сигнала

1. Перейдите на вкладку «Типы»
2. Нажмите кнопку + Создать тип
3. В открывшемся модальном окне заполните:
   • Название - должно быть уникальным в рамках пространства
   • Описание
   • Ключ - должен быть уникальным в рамках пространства, задается 1 раз при создании и больше не меняется.
     При вводе названия ключ генерируется автоматически по правилам:
     • Пробелы удаляются, строка переводится в pascal-case
     • Если сгенерированный ключ уже существует, к нему добавляется _1
     • Если ключ совпадает со служебным именем, также добавляется _1

     Ключ можно задать полностью вручную, соблюдая описанные выше правила

   • Иконку и ее цвет - по желанию
4. Нажмите кнопку Создать

Новый тип будет иметь базовую схему ЖЦ и не будет содержать добавленных атрибутов.

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

Карточка типа сигнала

Чтобы открыть карточку типа сигнала, выберите один из типов в списке.

• Основная информация - содержит название, описание, ключ и иконку.
  Все параметры (кроме ключа) можно редактировать.
• Атрибуты - содержит таблицу добавленных атрибутов с возможностью поиска по ней, а также кнопку + Добавить атрибут
  При изменении атрибутивного состава в карточках сигналов, ассоциированных с данным типом, меняется состав отображаемых полей
• Схема жизненного цикла - визуальное представление статусов сигналов и связей между ними
  • Первоначально отображается последняя опубликованная версия схемы
  • Для редактирования нужно нажать кнопку Редактировать схему.
    При переходе в режим редактирования загружается последний несохраненный черновик.
  • В режиме редактирования можно:
    • Добавлять статусы (если они еще не были добавлены и опубликованы ранее) - используется кнопка + или правая кнопка мыши
    • Создавать и удалять связи между статусами

    Статусы, которые уже были опубликованы в схеме, не могут быть удалены, но у них могут быть отключены связи (что фактически исключает их из схемы ЖЦ)

  • Для сброса всех изменений в черновике нажмите кнопку Отмена
  • Для сохранения - нажмите Сохранить изменения

Удаление типа сигнала

скоро

Опция удаления типа сигнала пока недоступна и появится в ближайших версиях

Атрибуты сигналов

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

Гибкость достигается за счет следующих возможностей:

• Настройка различных атрибутов сигналов на уровне пространства - доступна администраторам пространства с достаточными для этого правами
• Персонализация настроек сигналов на уровне РГ - менеджеры рабочих групп могут выбирать ранее определенные типы сигналов и подключать их к себе в РГ

Создание атрибута сигнала

1. Перейдите на вкладку «Атрибуты»

2. В правом верхнем углу нажмите кнопку + Создать атрибут и заполните форму:

   

   • Название — название поля, отображаемое в таблице и карточках сигналов
   • Тип и Тип значений — задают формат данных, записываемых в поле
     Доступные варианты:

     • Поле ввода - string / double
     • Селект - string / double
     • Мультиселект - string / double
     • Чекбокс - boolean
     • Выбор пользователя - struct:UsersStructApi
     • Выбор пользователей - struct:UsersStructApi
     • Ссылка - string
   • Системное название — используется в сценариях автоматизации
   • Описание

3. Нажмите Создать

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

Обратите внимание

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

Карточка атрибута сигнала

Чтобы открыть карточку атрибута сигнала, выберите один из атрибутов в списке.

Для редактирования доступны следующие параметры:

• Название (отображаемое)
• Плэйсхолдер (для типов «Поле ввода», «Селект» и «Мультиселект»)
• Описание
• Опция «Заполнять только через API или сценарии автоматизации» - позволяет запретить заполнение поля вручную
• Набор значений (для типов «Селект», «Мультиселект» и «Выбор пользователей») - позволяет добавить набор предустановленных значений

  Системное название используется при работе с API и в сценариях автоматизации, поэтому его редактирование запрещено

Для подтверждения внесенных изменений нажмите кнопку Сохранить изменения

Удаление атрибута сигнала

1. Откройте карточку атрибута, который требуется удалить
2. Нажмите меню дополнительных действий → «Удалить»
3. Для подтверждения удаления введите системное название атрибута в форме подтверждения

Внимание

Удаление атрибута приводит к необратимому удалению всех данных, хранившихся в этом поле у всех сигналов

Статусы жизненного цикла сигнала

В жизненном цикле типа сигнала существует два базовых понятия:

1. Статус жизненного цикла
   Это статус сигнала, в который он может быть переведен.
   Каждый статус относится к одной из двух категорий статуса:
   • Open - вносит влияние в здоровье связанных КЕ
   • Closed- не вносит влияние в здоровье связанных КЕ
2. Схема жизненного цикла
   Это набор статусов сигнала и правила переходов между ними.

По умолчанию в пространстве присутствует только два системных статуса: Open и Closed и один тип сигнала: Сигнал, в котором настроена базовая схема ЖЦ.

важно

Внесение изменений в схемы и статусы ЖЦ - ответственный момент для администраторов пространства, так как это может повлиять на инцидент-менеджмент на уровне всего пространства и привести к коллапсу в работе всех рабочих групп.
В связи с этим необходимо максимально подробно проработать механики и учесть все необходимые ограничения и пути отката.

Вкладка «Статусы» содержит список всех статусов, которые могут использоваться в схемах ЖЦ разных типов сигналов.

Создание статуса сигнала

1. Перейдите на вкладку «Статусы»
2. В правом верхнем углу нажмите кнопку + Создать статус ЖЦ
3. Укажите:
   • Название (например, «В работе»)
   • Категорию статуса (Open или Closed)
   • Описание (опционально)
4. Нажмите кнопка Создать

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

Созданный статус теперь можно использовать в схемах ЖЦ типов сигналов.

Карточка статуса сигнала

Чтобы открыть карточку статуса сигнала, выберите один из статусов в списке.
На ней представлена следующая информация:

• Название
• Категория статуса
• Описание

Редактирование этих полей доступно до тех пор, пока статус не будет задействован и опубликован хотя бы в одной схеме ЖЦ типа сигналов. После такой публикации для редактирования останется доступным только поле «Описание».

Удаление статуса сигнала

1. Откройте карточку статуса.

2. В контекстном меню выберите «Удалить».

3. Подтвердите действие, введя «Системное название» статуса.

4. Откройте карточку статуса, который требуется удалить

5. Нажмите меню дополнительных действий → «Удалить»

6. Для подтверждения удаления введите системное название атрибута в форме подтверждения

планирование

Учтите, что статус ЖЦ не может быть удален, пока есть схемы ЖЦ, использующие этот его.
При этом однажды добавленный и опубликованный в схему ЖЦ статус, не может быть из нее удален (эта опция появится в будущих релизах).
Удалить весь тип целиком пока тоже нельзя.