Работа с экземплярами политик

Данный раздел описывает процесс работы с экземплярами политик автоматизации в системе. Работа осуществляется в разделе Автоматизация процессов → Политики веб-интерфейса системы.

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

О политиках

Политика — это элемент схемы автоматизации, определяющий условия запуска действий над объектами системы и сами эти действия. В интерфейсе системы можно настроить экземпляры политик — конфигурации запусков политик, различающиеся способами, параметрами и расписанием запуска.

Перед настройкой экземпляров политик необходимо описать условия и действия для этих политик в схеме автоматизации.

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

Интерфейс раздела

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

  • Кнопка Добавить позволяет добавить новый экземпляр политики.

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

Под панелью инструментов расположена область дополнительных действий. В этой области доступны следующие кнопки:

  • Добавить фильтр (plus) позволяет отфильтровать экземпляры политик по выбранным полям и значениям.

  • Сохраненные фильтры (save) позволяет создать шаблоны фильтров и выполнить поиск по ним.

В рабочей области отображается таблица имеющихся экземпляров политик. Таблица содержит следующие столбцы:

  • Наименование — название экземпляра политики.

  • Идентификатор — системный идентификатор экземпляра политики. Генерируется автоматически.

  • Статус синхронизации — статус обработки экземпляра сервисом автоматизации:

    • Успешно создана;

    • Успешно обновлена;

    • Ошибка создания;

    • Ошибка обновления;

    • Ошибка удаления.

  • Статус политики — текущий статус экземпляра политики:

    • Включена;

    • Выключена.

  • Дата создания — дата и время создания экземпляра политики.

  • Создал — идентификатор пользователя, создавшего экземпляр политики.

  • Идентификатор схемы автоматизации — идентификатор схемы автоматизации, в которой определена политика.

  • Идентификатор политики — идентификатор политики, для которой определен экземпляр.

  • Организация — организация, к которой относится экземпляр политики.

  • Тип запуска — тип запуска политики:

    • Вручную;

    • По расписанию;

    • По событиям.

  • Периодичность запуска — периодичность запуска в виде cron-выражения.

    Формат выражения cron:

    <seconds> <minutes> <hours> <day_of_month> <month> <day_of_week>

    Здесь:

    • <seconds> — секунды от 0 до 59;

    • <minutes> — минуты от 0 до 59;

    • <hours> — часы от 0 до 23;

    • <day_of_month> — числа месяца от 1 до 31;

    • <month> — номера месяцев от 1 до 12;

    • <day_of_week> — номера дней недели от 0 до 6, где 0 — воскресенье.

    Используются следующие символы:

    • * — любое допустимое значение поля;

    • ? — любое допустимое значение числа месяца или дня недели;

    • , — разделитель в списке значений;

    • - — диапазон значений;

    • / — значение шага.

    Примеры настроек cron-выражения

    • Запускать каждые 20 минут с 8 до 18 часов с понедельника по пятницу:

      0 */20 8-18 * * 1-5

    • Запускать 1 января, 1 апреля, 1 июля и 1 октября в 2:00:00:

      0 0 2 1 1,4,7,10 *

    • Запускать в 12:00:00 ежедневно:

      0 0 12 * * ?

При работе с таблицей экземпляров политик доступны следующие операции:

  • Поиск экземпляров по полям Наименование, Идентификатор, Идентификатор схемы автоматизации, Идентификатор политики.

  • Фильтрация экземпляров по полям Наименование, Идентификатор, Статус, Идентификатор схемы автоматизации, Идентификатор политики и Тип запуска.

  • Сортировка экземпляров по полям Наименование, Идентификатор, Статус, Идентификатор схемы автоматизации, Идентификатор политики и Тип запуска.

  • Настройка отображения таблицы.

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

Работа с экземпляром политики

Доступные действия над экземпляром политики:

Создание экземпляра политики

Чтобы создать экземпляр политики:

  1. Перейдите в раздел Автоматизация процессов → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на кнопку Добавить. Отобразится окно создания экземпляра политики.

  3. Если требуется, введите человекочитаемое наименование экземпляра политики.

  4. Введите идентификатор схемы автоматизации, в которой определена необходимая политика.

  5. Введите идентификатор политики, для которой необходимо создать экземпляр.

  6. Выберите из выпадающего списка Организация организацию, к которой относится экземпляр политики.

    Экземпляр политики работает только с объектами из своей организации.

  7. Выберите из выпадающего списка тип запуска экземпляра политики:

    • По расписанию;

    • Вручную;

    • По событиям.

  8. Если выбран тип запуска По расписанию или По событиям, укажите параметры, зависящие от типа запуска:

    • По расписанию

    • По событиям

    Задайте периодичность запуска в виде cron-выражения.

    Формат выражения cron:

    <seconds> <minutes> <hours> <day_of_month> <month> <day_of_week>

    Здесь:

    • <seconds> — секунды от 0 до 59;

    • <minutes> — минуты от 0 до 59;

    • <hours> — часы от 0 до 23;

    • <day_of_month> — числа месяца от 1 до 31;

    • <month> — номера месяцев от 1 до 12;

    • <day_of_week> — номера дней недели от 0 до 6, где 0 — воскресенье.

    Используются следующие символы:

    • * — любое допустимое значение поля;

    • ? — любое допустимое значение числа месяца или дня недели;

    • , — разделитель в списке значений;

    • - — диапазон значений;

    • / — значение шага.

    Примеры настроек cron-выражения

    • Запускать каждые 20 минут с 8 до 18 часов с понедельника по пятницу:

      0 */20 8-18 * * 1-5

    • Запускать 1 января, 1 апреля, 1 июля и 1 октября в 2:00:00:

      0 0 2 1 1,4,7,10 *

    • Запускать в 12:00:00 ежедневно:

      0 0 12 * * ?

    1. Выберите режим запуска и укажите соответствующие ему параметры:

      Режим сбора событий Описание режима Параметр режима Описание параметра

      По количеству событий

      Экземпляр политики запускается:

      • либо при возникновении указанного количества событий за временное окно после возникновения первого события;

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

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

      Количество событий

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

      Временное окно (мс)

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

      По временному окну

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

      Временное окно (мс)

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

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

    2. Добавьте в таблицу События идентификаторы событий аудита, при возникновении которых необходимо запускать экземпляр политики.

      Можно использовать символы подстановки * в идентификаторах событий:

      • * — любая последовательность символов между точками;

      • ** — любая последовательность символов до конца строки.

      Например, выражение linkage.*.evo_domain.** обозначает событие любого действия (создания, изменения, удаления) над любой связью в домене evo_domain.

      Система может добавлять идентификаторы конкретных объектов в качестве суффикса идентификатора события: например, user.create.user-12345, где user-12345 — идентификатор конкретного пользователя. В связи с этим рекомендуется добавлять ** в конце идентификаторов событий, чтобы получать события указанных типов для всех объектов системы.

  9. В поле Стратегия действий при наличии активного запуска выберите действие, которое будет выполнено, если экземпляр политики будет запущен в момент, когда предыдущий его запуск еще не завершился:

    • Отменить запуск — новый запуск экземпляра выполнен не будет, предыдущий запуск будет выполнен до конца.

    • Поставить в очередь — запустить экземпляр политики повторно по завершении текущего запуска.

    • Выполнить в случае ошибки — запустить экземпляр политики повторно, только в случае если предыдущий запуск завершился со статусом Ошибка.

  10. Добавьте в таблицу Переменные идентификаторы и значения переменных, которые будут доступны в условиях политики посредством синтаксиса {context:<variable_id>}.

  11. Выберите из выпадающего списка статус экземпляра политики:

    • Включена;

    • Выключена.

  12. Нажмите на кнопку Добавить.

Если создание экземпляра политики завершится успешно, система отобразит соответствующее уведомление, и в поле Статус синхронизации с сервисом политик карточки нового экземпляра политики отобразится значение Успешно создана.

Если во время создания произойдет ошибка, то в поле Статус синхронизации с сервисом политик карточки нового экземпляра политики отобразится значение Ошибка создания, а в поле Детали — описание этой ошибки.

Просмотр экземпляра политики

Чтобы просмотреть экземпляр политики:

  1. Перейдите в раздел Автоматизация процессов → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на строку экземпляра в списке. Система отобразит в правой части экрана карточку этого экземпляра с подробной информацией о нем.

В верхней части карточки отображается название экземпляра политики. Справа от названия расположена кнопка more vertical, при нажатии на которую открывается выпадающее меню с действиями, доступными для выбранного экземпляра.

Карточка экземпляра политики содержит следующие вкладки:

Вкладка Параметры настройки

На вкладке Параметры настройки отображаются свойства и значения настроек экземпляра политики:

  • Идентификатор — системный идентификатор экземпляра политики.

  • Наименование — название экземпляра политики.

  • Идентификатор схемы автоматизации — идентификатор схемы автоматизации, в которой определена политика.

  • Идентификатор политики — идентификатор политики, для которой определен экземпляр.

  • Организация — организация, к которой относится экземпляр политики.

  • Статус — текущий статус экземпляра политики:

    • Включена;

    • Выключена.

  • Тип запуска — тип запуска политики:

    • Вручную;

    • По расписанию;

    • По событиям.

  • Периодичность запуска — периодичность запуска в виде cron-выражения, если тип запуска — По расписанию.

  • Режим сбора событий — режим запуска политики, если выбран тип запуска По событиям:

    • По количеству событий;

    • По временному окну.

  • Количество событий — количество событий аудита, которое должно возникнуть для запуска экземпляра политики, если выбраны тип запуска По событиям и режим По количеству событий.

  • Временное окно — период времени после первого события, если выбран тип запуска По событиям.

  • События — таблица идентификаторов событий, по которым запускается политика, если выбран тип запуска По событиям.

  • Стратегия действий при наличии активного запуска — действие, которое будет выполнено, если экземпляр политики будет запущен в момент, когда предыдущий его запуск еще не завершился:

    • Отменить запуск;

    • Поставить в очередь;

    • Выполнить в случае ошибки.

  • Переменные — идентификаторы и значения переменных, которые доступны в условиях политики посредством синтаксиса {context:<variable_id>}. Таблица содержит следующие столбцы:

    • Идентификатор — идентификатор переменной, который следует подставить вместо <variable_id> для обращения к ней.

    • Значение — значение переменной.

    Вы можете добавить переменные в таблицу. Для этого:

    1. Нажмите на кнопку plus square рядом с таблицей.

    2. Введите идентификатор переменной.

    3. Введите значение переменной.

    4. Нажмите на кнопку Сохранить (check). Система добавит переменную в таблицу и отобразит соответствующее уведомление.

  • Кнопка Запустить (play) позволяет запустить экземпляр политики вручную.

  • Статус синхронизации с сервисом политик — статус синхронизации экземпляра политики с сервисом автоматизации:

    • Успешно создана;

    • Успешно обновлена;

    • Ошибка создания;

    • Ошибка обновления;

    • Ошибка удаления.

  • Детали — описание ошибки синхронизации, если она произошла.

Вкладка История запусков

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

Таблица содержит следующие столбцы:

  • Время начала — дата и время начала запуска экземпляра политики.

  • Время окончания — дата и время окончания запуска экземпляра политики.

  • Статус — статус запуска экземпляра политики:

    • Запущена — экземпляр запущен, но еще не завершен. Статус будет обновлен по окончании запуска.

    • Завершена — запуск завершен, информация о запуске доступна в поле Результат.

    • Прервана — запуск прерван, информация об ошибке доступна в поле Результат.

    • Ошибка — экземпляр не удалось запустить, информация об ошибке доступна в поле Результат.

    • Не определен — не удалось получить статус и результат запуска экземпляра политики.

  • Результат — текстовое описание результата запуска политики, включая описание ошибок, если они возникли.

Чтобы просмотреть детали запуска:

  1. Нажмите на кнопку more vertical напротив запуска, информацию о котором вы хотите просмотреть.

  2. Нажмите на кнопку Открыть (open). Система откроет карточку запуска.

    Вы также можете открыть список запусков политик, где выбран нужный запуск, в новой вкладке. Для этого нажмите на кнопку Открыть в новой вкладке (open new).

Вкладка История изменений

На вкладке История изменений отображается виджет, отображающий список событий аудита, связанных с экземпляром политики.

Вы можете ознакомиться с описанием виджета истории изменений в разделе Описания интерфейса.

Запуск экземпляра политики

Запустить экземпляр политики можно одним из следующих способов:

  • по расписанию, если выбран тип запуска По расписанию и задано cron-выражение, определяющее это расписание;

  • по событиям аудита, если выбран тип запуска По событиям и указаны идентификаторы событий, по которым запускается экземпляр политики;

  • вручную с помощью кнопки Запустить (play) на вкладке Параметры настройки карточки экземпляра политики.

    Экземпляр политики с типом запуска По расписанию или По событиям также можно запустить вручную.

При запуске экземпляра политики происходит обновление таблицы Запуски в карточке экземпляра:

  1. При запуске экземпляра политики в таблицу Запуски добавляется новая запись:

    • Время начала — дата и время запуска экземпляра политики.

    • Статус — Запущена.

  2. При завершении запуска экземпляра политики запись о нем в таблице Запуски обновляется:

    • Время окончания — дата и время окончания запуска экземпляра политики.

    • Статус — статус запуска политики: например, Завершена или Ошибка.

    • Результат — текстовое описание результата запуска политики, включая описание ошибок, если они возникли.

Изменение экземпляра политики

Чтобы изменить экземпляр политики:

  1. Перейдите в раздел Автоматизация процессов → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на строку экземпляра в списке. Система отобразит в правой части экрана карточку этого экземпляра с подробной информацией о нем.

  3. Выберите опцию Изменить в выпадающем меню кнопки действий more vertical в верхней части карточки. Отобразится окно редактирования экземпляра политики.

    При изменении экземпляра политики поля Идентификатор схемы автоматизации, Идентификатор политики и Идентификатор организации доступны только для чтения.

  4. Внесите изменения в требуемые поля экземпляра.

  5. Нажмите на кнопку Сохранить.

Если изменение экземпляра политики завершится успешно, система отобразит соответствующее уведомление, и в поле Статус синхронизации с сервисом политик карточки экземпляра политики отобразится значение Успешно обновлена.

Если во время изменения произойдет ошибка, то в поле Статус синхронизации с сервисом политик карточки экземпляра политики отобразится значение Ошибка обновления, а в поле Детали — описание этой ошибки.

Вы также можете редактировать поля экземпляра политики из его карточки. Для этого:

  1. Нажмите на строку экземпляра.

  2. Нажмите на кнопку edit для редактирования необходимого поля.

  3. Внесите изменения в поле экземпляра.

  4. Нажмите на кнопку Сохранить (check).

Синхронизация экземпляра политики с сервисом автоматизации

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

Для синхронизации выполните следующие действия:

  1. Перейдите в раздел Автоматизация процессов → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на строку экземпляра в списке. Система отобразит в правой части экрана карточку этого экземпляра с подробной информацией о нем.

  3. Выберите опцию Синхронизировать в выпадающем меню кнопки действий more vertical в верхней части карточки.

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

Удаление экземпляра политики

Чтобы удалить экземпляр политики:

  1. Перейдите в раздел Автоматизация процессов → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на строку экземпляра в списке. Система отобразит в правой части экрана карточку этого экземпляра с подробной информацией о нем.

  3. Выберите опцию Удалить в выпадающем меню кнопки действий more vertical в верхней части карточки.

Если удаление экземпляра политики завершится успешно, система отобразит соответствующее уведомление, и экземпляр будет удален из списка раздела.

Если во время удаления произойдет ошибка, то экземпляр не будет удален из списка. В поле Статус синхронизации с сервисом политик карточки экземпляра отобразится значение Ошибка удаления, а в поле Детали — описание этой ошибки.

Была ли полезна эта страница?

+7 (499) 755 55 70 sales@rvision.ru

О компании Пользовательское соглашение Политика cookies

Обратная связь