Редактирование схемы автоматизации в режиме конструктора

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

Перейти в режим конструктора можно одним из следующих способов:

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

О конструкторе

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

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

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

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

  • Кнопка maximize позволяет развернуть окно конструктора на весь экран. Если окно уже развернуто, отображается кнопка minimize, которая позволяет восстановить исходный размер окна конструктора.

  • Кнопка close позволяет закрыть окно конструктора и вернуться к списку элементов экспертизы.

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

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

Информация

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

В рабочей области окна отображаются следующие поля:

  • ID — FQID схемы автоматизации. Соответствует полю id метаданных схемы автоматизации.

  • Название — название схемы автоматизации. Допустимы латинские буквы, цифры, подчеркивания. Соответствует полю name метаданных схемы автоматизации.

  • Версия — версия схемы в формате Semantic Versioning. Соответствует полю version метаданных схемы автоматизации.

  • Автор — имя и контактные данные автора схемы. Необязательное поле. Соответствует полю author метаданных схемы автоматизации.

  • Теги — теги для классификации и поиска схемы в системе. Необязательное поле. Соответствует полю tags метаданных схемы автоматизации.

  • Описание (опционально) — краткое описание назначения схемы автоматизации. Необязательное поле. Соответствует полю description метаданных схемы автоматизации.

В правом нижнем углу окна отображаются следующие кнопки:

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

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

Расчеты

На этапе Расчеты следует создать расчеты, в том числе указать их атрибуты, используемые для расчета по формулам, и непосредственно формулы.

Интерфейс окна

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

  • Кнопка Расчет (plus) позволяет создать новый расчет.

  • Кнопка Наследник (plus) позволяет создать расчет, являющийся наследником уже существующего.

  • Список расчетов, созданных в схеме.

    Если у расчета есть наследники, рядом с его строкой в списке отображается кнопка plus square, по нажатии на которую можно раскрыть список наследников. Чтобы снова свернуть список наследников, нажмите на кнопку minus square.

    Если для расчета заполнены не все обязательные атрибуты, в том числе формула, в его строке в списке отображается иконка attention red.

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

  • Кнопка plus позволяет добавить атрибут расчета.

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

  • Список атрибутов расчета, сгруппированный по типам атрибутов:

    • Поля;

    • Дочерние расчеты;

    • Глобальные переменные;

    • Скрипты.

    Чтобы раскрыть список атрибутов в группе, нажмите на кнопку chevron down справа от названия группы. Чтобы снова свернуть список атрибутов, нажмите на кнопку chevron up справа от названия группы.

В нижней части окна отображаются следующие компоненты:

  • Кнопки добавления операций в формулу расчета:

    • арифметических операций, в том числе возведения в степень и взятия остатка от деления;

    • логических операций (And, Not, Or);

    • операций сравнения, в том числе строгого равенства (===) и тернарной операции (?:);

    • функций агрегации, в том числе максимума, среднего, минимума и суммы;

    • кнопка Еще (chevron down), по нажатии на которую раскрывается список функций библиотеки JavaScript math.js, поддерживаемых в схемах автоматизации.

  • Поле ввода формулы расчета.

В правом нижнем углу окна отображаются следующие кнопки:

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

  • Назад — позволяет перейти к модальному окну этапа Информация.

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

Работа с расчетом

Доступные операции над расчетом:

Создание нового расчета

Чтобы создать новый расчет:

  1. Нажмите на кнопку Расчет (plus). Отобразится окно создания расчета.

  2. Введите ID расчета на латинице.

  3. Введите название расчета.

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

  5. Выберите из выпадающего списка сущность, для которой создается расчет.

  6. Чтобы расчет выполнялся автоматически при изменении свойств экземпляра сущности, установите переключатель Перерасчет при изменении объекта в активное положение.

  7. При необходимости введите описание расчета.

  8. При необходимости введите лимит сложности расчета.

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

    • базовая сложность выражения в формуле — 1;

    • каждый скрипт, входящий в выражение, увеличивает его сложность на 10;

    • к сложности родительского расчета прибавляется сложность всех дочерних расчетов.

    При превышении лимита сложности расчет завершится с ошибкой.

    Необязательно точно рассчитывать лимит сложности для расчета. Можно указать достаточно большое число, например, 100. Если этот предел будет превышен, возникшая ошибка укажет на то, что расчет следует оптимизировать.
  9. Нажмите на кнопку Создать. Новый расчет отобразится в списке.

  10. Переходите к добавлению атрибутов расчета.

Создание расчета-наследника

Чтобы создать новый расчет-наследник:

  1. Нажмите на кнопку Наследник (plus). Отобразится окно создания расчета-наследника.

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

  3. Введите название расчета.

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

  5. Выберите из выпадающего списка сущность, для которой создается расчет.

  6. Чтобы расчет выполнялся автоматически при изменении свойств экземпляра сущности, установите переключатель Перерасчет при изменении объекта в активное положение.

  7. При необходимости введите описание расчета.

  8. При необходимости введите лимит сложности расчета.

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

    • базовая сложность выражения в формуле — 1;

    • каждый скрипт, входящий в выражение, увеличивает его сложность на 10;

    • к сложности родительского расчета прибавляется сложность всех дочерних расчетов.

    При превышении лимита сложности расчет завершится с ошибкой.

    Необязательно точно рассчитывать лимит сложности для расчета. Можно указать достаточно большое число, например, 100. Если этот предел будет превышен, возникшая ошибка укажет на то, что расчет следует оптимизировать.
  9. Нажмите на кнопку Создать. Новый расчет отобразится в списке наследников расчета, от которого он унаследован.

  10. Переходите к добавлению атрибутов расчета.

Просмотр атрибутов расчета

Чтобы просмотреть список атрибутов расчета, выберите расчет в списке. Список атрибутов расчета отобразится в правой области окна.

Изменение расчета

Чтобы изменить расчет:

  1. Выберите расчет или наведите курсор на его строку в списке.

  2. Нажмите на появившуюся кнопку edit в правой части строки. Отобразится окно настроек расчета.

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

  4. Нажмите на кнопку Сохранить. Система сохранит измененные настройки расчета.

Удаление расчета

Чтобы удалить расчет:

  1. Выберите расчет или наведите курсор на его строку в списке.

  2. Нажмите на появившуюся кнопку trash в правой части строки. Отобразится окно подтверждения удаления.

  3. Нажмите на кнопку Удалить. Удаленный расчет будет исключен из списка.

Работа с атрибутом расчета

Доступные операции над атрибутом расчета:

Добавление атрибута расчета

Чтобы добавить один или несколько атрибутов расчета:

  1. Выберите расчет.

  2. Нажмите на кнопку plus над списком атрибутов.

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

  4. Добавьте атрибуты в список:

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

      Можно осуществлять поиск атрибутов сущности по их идентификатору и наименованию.

    • При добавлении атрибутов типа Дочерние расчеты выберите из выпадающего списка дочерние расчеты — расчеты для связанных сущностей, участвующие в расчете для текущей сущности (родительском расчете).

      Можно осуществлять поиск дочерних расчетов по их наименованию.

    • При добавлении атрибутов типа Глобальные переменные выберите из выпадающего списка глобальные переменные, созданные в системе.

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

    • При добавлении атрибутов типа Скрипты в открывшемся окне установите флажки напротив тех скриптов, которые требуется добавить в качестве атрибутов расчета, и нажмите на кнопку Добавить. В списке скриптов доступны поиск и фильтрация по тегам и каталогам раздела Экспертиза.

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

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

Чтобы удалить атрибут расчета:

  1. Выберите расчет.

  2. Наведите курсор на строку атрибута расчета в списке атрибутов и нажмите на появившуюся кнопку trash в правой части строки. Отобразится окно подтверждения удаления.

  3. Нажмите на кнопку Удалить. Удаленный атрибут будет исключен из списка.

Составление формулы расчета

Расчеты могут возвращать результат следующих типов:

  • число;

  • строка;

  • дата;

  • логический;

  • элемент перечисления (Enum).

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

  1. Добавьте атрибуты расчета в поле ввода Формула расчета. Это можно сделать:

    • дважды нажав мышью на атрибут в списке атрибутов расчета;

    • наведя курсор на атрибут в списке и нажав на кнопку plus.

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

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

Составив формулы всех необходимых расчетов, нажмите на кнопку Далее, чтобы перейти к модальному окну Обобщающие расчеты.

Обобщающие расчеты

На этапе Обобщающие расчеты следует создать обобщающие расчеты, в том числе указать расчеты, которые входят в их формулы, а также задать сами формулы.

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

Интерфейс окна

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

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

В нижней части окна отображаются следующие компоненты:

  • Кнопки добавления операций в формулу расчета:

    • арифметических операций, в том числе возведения в степень и взятия остатка от деления;

    • логических операций (And, Not, Or);

    • операций сравнения, в том числе строгого равенства (===) и тернарной операции (?:);

    • функций агрегации, в том числе максимума, среднего, минимума и суммы;

    • кнопка Еще (chevron down), по нажатии на которую раскрывается список функций библиотеки JavaScript math.js, поддерживаемых в схемах автоматизации.

  • Поле ввода формулы расчета.

В правом нижнем углу окна отображаются следующие кнопки:

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

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

  • Сохранить черновик — позволяет сохранить схему автоматизации в виде черновика без ее публикации.

  • Опубликовать версию — позволяет опубликовать новую версию схемы автоматизации.

Работа с обобщающим расчетом

Доступные операции над обобщающим расчетом:

Создание нового обобщающего расчета

Чтобы создать новый обобщающий расчет:

  1. Нажмите на кнопку Расчет (plus). Отобразится окно создания обобщающего расчета.

  2. Введите ID расчета на латинице.

  3. Введите название расчета.

  4. При необходимости введите описание расчета.

  5. Нажмите на кнопку Создать. Новый расчет отобразится в списке.

  6. Переходите к добавлению атрибутов расчета.

Просмотр атрибутов обобщающего расчета

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

Изменение обобщающего расчета

Чтобы изменить обобщающий расчет:

  1. Выберите обобщающий расчет или наведите курсор на его строку в списке.

  2. Нажмите на появившуюся кнопку edit в правой части строки. Отобразится окно настроек обобщающего расчета.

  3. Внесите изменения в требуемые поля обобщающего расчета.

  4. Нажмите на кнопку Сохранить. Система сохранит измененные настройки обобщающего расчета.

Удаление обобщающего расчета

Чтобы удалить обобщающий расчет:

  1. Выберите обобщающий расчет или наведите курсор на его строку в списке.

  2. Нажмите на появившуюся кнопку trash в правой части строки. Отобразится окно подтверждения удаления.

  3. Нажмите на кнопку Удалить. Удаленный обобщающий расчет будет исключен из списка.

Работа с атрибутом обобщающего расчета

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

Доступные операции над атрибутом обобщающего расчета:

Добавление атрибута обобщающего расчета

Чтобы добавить один или несколько атрибутов обобщающего расчета:

  1. Выберите обобщающий расчет.

  2. Нажмите на кнопку plus над списком атрибутов.

  3. Выберите из выпадающего списка расчеты, которые нужно добавить в качестве атрибутов.

    Можно осуществлять поиск расчетов по их наименованию.

Удаление атрибута обобщающего расчета

Чтобы удалить атрибут обобщающего расчета:

  1. Выберите обобщающий расчет.

  2. Наведите курсор на строку атрибута в списке и нажмите на появившуюся кнопку trash в правой части строки. Отобразится окно подтверждения удаления.

  3. Нажмите на кнопку Удалить. Удаленный атрибут будет исключен из списка.

Составление формулы обобщающего расчета

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

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

Расчеты могут возвращать результат следующих типов:

  • число;

  • строка;

  • дата;

  • логический;

  • элемент перечисления (Enum).

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

  1. Добавьте атрибуты расчета в поле ввода Формула расчета. Это можно сделать:

    • дважды нажав мышью на атрибут в списке атрибутов расчета;

    • наведя курсор на атрибут в списке и нажав на кнопку plus.

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

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

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

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

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