Шаблоны миссий

Шаблоны миссий — это предустановленные алгоритмы (workflow), которые определяют логику поведения роботов и оборудования. Использование шаблонов позволяет автоматизировать повторяющиеся задачи, такие как паллетирование, перемещение грузов или взаимодействие с внешними устройствами.

1. Список шаблонов

Доступ к управлению осуществляется через меню Управление > Шаблоны миссий. В этом разделе представлен реестр всех доступных сценариев.

Основные поля таблицы:

ID и Имя: Уникальный номер и понятное название шаблона (например, «Запаллетировать», «MoveTo2»).
Встроенный: Указывает, является ли шаблон базовым системным компонентом.
Описание: Краткое описание шаблона или способ его применения.
Публичный: Статус видимости шаблона для различных групп пользователей.
Статус: Текущее состояние. Метка «Активный» подтверждает, что шаблон готов к использованию.

Доступные действия с шаблоном (меню «…»):

Деактивировать: Временное отключение шаблона без его удаления.
Редактировать: Изменение настроек, параметров JSON или описания шаблона.
Дублировать: Создание копии шаблона для быстрой настройки схожего процесса.
Удалить шаблон: Полное удаление сценария из системы.

2. Создание шаблона

Для инициации процесса создания нового сценария нажмите кнопку «+ Добавить шаблон», расположенную в верхнем правом углу экрана управления шаблонами. Процесс разделен на два этапа: настройку параметров и проектирование логики.

В открывшемся модальном окне необходимо задать базовые настройки:

Название шаблона: Укажите краткое, но понятное имя, которое будет отображаться в списке миссий (например, «Перемещение_Зона_А»).
Описание: Поле для подробного комментария о назначении шаблона (используется для внутренней документации команды).
Статусы:
- Активный: Установите галочку, чтобы шаблон стал доступен для исполнения сразу после сохранения.
- Публичный: Отметьте, если шаблон должен быть виден другим пользователям системы.
Схема параметров (JSON): В этом блоке прописываются переменные, которые система запросит у оператора при ручном запуске миссии через виджет MissionStarter.

{% hint style=“info” %} Пример: Вы можете определить параметр target_location с типом string, чтобы при каждом запуске указывать новую точку назначения. {% endhint %}

3. Редактирование параметров шаблона (JSON Schema)

При создании или редактировании шаблона открывается модальное окно, где настраиваются базовые свойства:

Название и Описание: Идентификация назначения миссии.
Флаги «Активный» и «Публичный»: Управление доступом.
Схема параметров (JSON): Здесь определяется структура данных, которые оператор должен будет ввести при запуске миссии (например, длительность задержки delay или текст сообщения msg). Это обеспечивает гибкость шаблона без изменения его основной логики.

4. Визуальный редактор Workflow

Система оснащена мощным графическим редактором для проектирования цепочек действий методом Drag-and-Drop. Чтобы открыть редактор - кликните на шаблон один раз.

Рабочая область канвы

Блоки (Ноды): Представляют собой конкретные действия (Start, Set Vars, Sleep, Прочитать регистр) или логические операторы (IF, Error). Подробнее о имеющихся в системе блоках (нодах) описано в статье.
Связи: Линии, определяющие последовательность выполнения и ветвление логики в зависимости от условий (успех/ошибка).
Инструменты навигации: В левом нижнем углу доступны кнопки масштабирования и центрирования схемы. В верхнем левом — кнопки сохранения, отмены и повтора действий.

Библиотека действий

Для добавления нового шага в сценарий используется панель «Добавить действие», где инструменты сгруппированы по категориям:

Системные: Базовые операции управления процессом.
AGV роботы: Команды для мобильных роботов (перемещение, захват).
Логические: Операторы условий и циклов.
Modbus устройства: Взаимодействие с внешними контроллерами и датчиками.
Карта и Объекты данных: Работа с координатами, точками и записями в БД.

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

Построение Workflow

После первичного сохранения шаблона вы переходите в визуальный редактор (канву).

Размещение стартового узла: Каждая миссия начинается с обязательного блока Start.
Добавление действий: Используйте правую панель «Добавить действие». Раскройте нужную категорию (например, «AGV роботы») и перетащите функциональный блок на рабочее поле.
Связывание узлов: * Нажмите на выходной маркер одного блока и протяните линию к входному маркеру следующего.
- Для логических блоков (например, IF) предусмотрите две ветки: успешное выполнение и обработку исключения (ветка Error).
Настройка узлов: Кликните по добавленному блоку на канве, чтобы задать его специфические свойства (коды точек на карте, время ожидания в блоке Sleep и т.д.).
Сохранение: Нажмите иконку «Сохранить» (дискета) в левом верхнем углу редактора, чтобы применить изменения.

Полезные инструменты редактора

История изменений: Кнопки «Отменить» и «Повторить» позволяют быстро откатывать правки в логике workflow.

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

Удаление лишнего: Выделите ненужный блок или связь и нажмите Del на клавиатуре или воспользуйтесь контекстным меню.
Навигация и управление масштабом. При работе со сложными и разветвленными схемами (например, как в шаблоне «Запаллетировать»), используйте блок кнопок в левом нижнем углу редактора для точной настройки отображения:
- Кнопка «+» (Увеличить): Приближает рабочую область. Используется для детальной настройки параметров конкретного узла или проверки точности соединений между блоками.
- Кнопка «–» (Уменьшить): Отдаляет камеру, позволяя увидеть структуру всего workflow целиком. Полезно для оценки общей логики процесса и поиска неразорванных связей.
- Кнопка «По размеру экрана» (Квадрат в рамке): Автоматически масштабирует и центрирует схему так, чтобы все созданные узлы полностью поместились в видимой области редактора.
- Кнопка «Заблокировать/Разблокировать» (Замок): Позволяет зафиксировать элементы на канве, предотвращая их случайное перемещение при просмотре схемы.

5. Дублировать

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

6. Деактивировать шаблон

Временно отключить шаблона без его удаления из системы можно по кнопке “Деактивировать” в контекстном меню шаблона:

7. Удалить шаблон

Полное удаление сценария из системы можно по кнопке “Удалить шаблон” в контекстном меню шаблона:

В открывшемся окне подтвердите удаление.