Автоматизация

Внимание

Для доступа к разделу "Администрирование" - "Настройки автоматизации" пользователь Monq должен обладать правами Администратора пространства c соответствующим правом доступа - "Управление автоматизацией".

Основная информация

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

Пользовательские библиотеки

В создаваемых библиотеках автоматона пользователям доступно создание собственных глобальных структур и глобальных функций, которые могут быть использованы во всех сценариях текущего пространства Monq. Пользовательские глобальные структуры, также могут использоваться в смежных сервисах (например, атрибуты типов конфигурационных единиц в РСМ).

Библиотеки необходимы для категоризации и разделения функций и структур по назначению.

Для создания собственной библиотеки глобальных объектов Автоматизации перейдите к разделу Создание библиотеки.

Настройка времени хранения истории запусков сценариев

Для настройки времени хранения истории запусков сценариев, перейдите через основное меню в "Администрирование" - "Настройки автоматизации" - вкладка "Основные".

По умолчанию для всех пространств Monq установлено время хранения истории запусков сценариев - 14 дней.

Сконфигурируйте данный параметр под свои потребности.

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

⚠️ Для бессрочного хранения истории запусков сценариев необходимо обеспечить достаточное свободное пространство в хранилище СУБД ClickHouse.

Настройка времени хранения логов отладки сценариев

Для настройки времени логов отладки сценариев, перейдите через основное меню в "Администрирование" - "Настройки автоматизации" - вкладка "Основные".

По умолчанию для всех пространств Monq установлено время хранения логов отладки сценариев - 1 день.

Сконфигурируйте данный параметр под свои потребности.

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

⚠️ Для бессрочного хранения истории запусков сценариев необходимо обеспечить достаточное свободное пространство в хранилище СУБД ClickHouse.

Создание библиотеки

Чтобы создать новую библиотеку автоматона, перейдите через основное меню в "Администрирование" - "Настройки автоматизации" - вкладка "Библиотеки".

Нажмите кнопку "Создать библиотеку".

Задайте название и описание библиотеки.

⚠️ Требования к названиям библиотек:

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

После создания библиотеки, вы можете приступить к ее наполнению глобальными структурами и (или) глобальными функциями.

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

Для создания собственной глобальной структуры перейдите в раздел "Администрирование" - "Настройки автоматизации" - вкладка "Библиотеки".

Откройте необходимую библиотеку или создайте новую.

В диспетчере объектов библиотеки добавьте новую глобальную структуру, нажав "+" напротив Struct.

Задайте название структуры и ее описание.

Добавьте необходимые свойства структуры

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

Нажмите "Сохранить" для записи структуры в глобальную библиотеку.

После сохранение структура доступна для использования в качестве атрибутов типа КЕ, а также доступна для использования в сценариях автоматизации.

Управление доступными пользовательскими структурами

Администратор пространства может изменять и удалять имеющиеся в системе структуры.

Редактирование структур

⚠️ В случае, если пользователь принял решение изменить конфигурацию структуры, изменения будут применены для всех типов КЕ и сценариев, где они используются.

Удаление структур

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

Создание глобальных функций

Для создания собственной глобальной функции перейдите в раздел "Администрирование" - "Настройки автоматизации" - вкладка "Библиотеки".

Откройте необходимую библиотеку или создайте новую.

В диспетчере объектов библиотеки добавьте новую глобальную функцию, нажав "+" напротив Global functions.

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

При создании глобальной функции необходимо определить набор входящих и исходящих пинов функции в инспекторе объектов блоков InputPins и OutputPins.

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

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

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

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

Локальные переменные

Для добавления локальной переменной в глобальную функцию воспользуйтесь контекстным меню вашей функции и выберите - "Добавить локальную переменную".

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

Изменение глобальной функции

В случае, если необходимо произвести правки в сценарии глобальной функции, по завершении работ - необходимо Скомпилировать и Опубликовать функцию.

⚠️ Учтите, что при изменении глобальной функции, изменения затронут все сценарии, где данная функция использовалась.

Удаление глобальной функции

❌ Пользователь может удалить только те глобальные функции, которые не используются ни в одном сценарии.

Для удаления глобальной функции, необходимо найти свою функцию в "Диспетчере объектов" и выбрать Удалить в контекстном меню данной функции.

Удаление библиотеки

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

Для удаления библиотеки перейдите на вкладку Библиотеки и в контекстном меню, выбранной библиотеки выберите Удалить.

Экспорт/импорт библиотек

Администраторам пространства доступны функции переноса созданных структур и функций на другие стенды.

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

Импорт библиотек осуществляется путем создания новой библиотеки и заполнения поля Импорт формы создания.

При создании библиотеки через Импорт, пользователям недоступно изменение названия библиотеки. Если название библиотеки уже занято - импортировать библиотеку не получится.