Skip to Content

Миссии

Раздел «Миссии» предназначен для запуска рабочих сценариев и контроля их выполнения. Здесь можно найти миссию по шаблону, статусу или времени, открыть параметры и результат, повторить запуск либо отменить выполняемую миссию.

Где доступны миссии

Миссии доступны в нескольких представлениях:

  • пункт «Миссии» в левом меню открывает отдельную страницу со всеми доступными записями;
  • инструмент «Миссии» на странице «Карта» открывает таблицу поверх карты;
  • системный виджет «Таблица миссий» размещается на дашборде. Подробнее о добавлении виджетов см. в статье «Дашборды».

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

Таблица на карте показывает выполняемые миссии и те, что завершились в последнюю минуту, а не полный архив раздела «Миссии».

Запуск миссии доступен отдельно: кнопка «Запустить миссию» на странице раздела, инструмент «Запуск миссий» на карте и одноимённый виджет на дашборде.

Таблица миссий

Состав колонок зависит от прав пользователя и настройки таблицы.

КолонкаСодержимое
IDИдентификатор миссии в формате #<номер>
ШаблонНазвание шаблона, по которому создана миссия
СтатусТекущее или итоговое состояние
НачатаДата и время начала выполнения
ЗавершенаДата и время завершения
ДлительностьИнтервал между началом и завершением в формате чч:мм:сс; для выполняемой миссии продолжает увеличиваться
РезультатJSON с результатом, если он передан workflow
ОшибкаДанные ошибки, если выполнение завершилось с ошибкой
АвторПользователь, создавший миссию; отображается при наличии права на просмотр пользователей
СозданаДата и время создания записи
ДействияДоступные операции с миссией

Если у пользователя есть доступ к шаблону, название в колонке «Шаблон» открывает его карточку. Длинные значения результата и ошибки можно открыть в отдельном окне просмотра.

Нажатие на строку выполняет действие «Открыть детали». Те же действия доступны из контекстного меню и колонки «Действия».

Статусы

СтатусЗначение
NEWМиссия создана, выполнение ещё не началось
RUNNINGМиссия выполняется
COMPLETEDВыполнение успешно завершено
FAILEDВыполнение завершилось ошибкой
CANCELLEDМиссия отменена
TERMINATEDВыполнение принудительно завершено
TIMEOUTПревышено допустимое время выполнения

Для диагностики FAILED, TERMINATED и TIMEOUT откройте детали и проверьте поля «Ошибка», «Результат» и параметры запуска.

Запуск миссии

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

  1. Нажмите кнопку
  2. В поле «Шаблоны миссий» выберите шаблон.
  3. Если шаблон содержит схему входных параметров, заполните форму «Параметры миссии».
  4. Нажмите «Запуск».

В списке отображаются только активные шаблоны, доступные текущему пользователю и поддерживающие ручной запуск. Это шаблоны с триггером API. Шаблоны Child, NATS, MQTT и Cron запускаются соответствующим способом и в списке ручного запуска не отображаются.

Форма параметров строится по JSON Schema, настроенной в шаблоне. Обязательные поля должны быть заполнены и пройти проверку перед запуском.

После успешного создания WCS показывает сообщение «Миссия успешно создана». Новая запись появляется в таблице; из сообщения можно сразу открыть её детали.

{% hint style=“warning” %} Перед запуском проверьте выбранный шаблон, карту, доступность оборудования и значения параметров. Кнопка «Запуск» создаёт рабочую миссию. {% endhint %}

Поиск и фильтры

Общие правила текстового поиска и управления условиями описаны в статье «Работа с таблицами». Для миссий доступны фильтры:

  • «Шаблон»;
  • «Статус»;
  • «Дата создания (от)» и «Дата создания (до)»;
  • «Дата начала (от)» и «Дата начала (до)»;
  • «Дата завершения (от)» и «Дата завершения (до)».

Фильтры «Шаблон» и «Статус» поддерживают выбор нескольких значений. Границы периода можно комбинировать: например, задать начало и конец интервала создания. Старый текстовый синтаксис вида :n или :s в текущем интерфейсе не используется.

Настройка таблицы

Порядок настройки столбцов приведён в статье «Работа с таблицами». Для анализа инцидентов обычно полезны ID, шаблон, статус, даты, длительность, результат и ошибка.

Детали миссии

Окно «Детали миссии» содержит:

  • ID и шаблон;
  • статус;
  • «Начало», «Завершение» и длительность;
  • автора — при наличии права;
  • параметры запуска;
  • результат;
  • ошибку;
  • дату создания.

Название шаблона является ссылкой, если пользователь имеет право его просматривать. Параметры и результат показываются как JSON и могут быть открыты полностью.

Повтор миссии

Действие «Повторить миссию» открывает окно запуска на основе исходной миссии. Оно доступно, если:

  • пользователь может просматривать шаблон и создавать миссии;
  • шаблон существует и доступен пользователю;
  • шаблон поддерживает ручной запуск.

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

Отмена миссии

Действие «Отменить миссию» доступно только для статусов NEW и RUNNING и требует права отмены миссий. После подтверждения WCS отправляет запрос на отмену.

Для завершённых, отменённых или завершившихся ошибкой миссий действие не отображается.

Текущее время и история

Если в WCS включено хранение истории и у пользователя есть соответствующие права, в верхней панели доступен переключатель «История / Текущее время».

  • «Текущее время» показывает актуальный список и оперативные обновления.
  • «История» показывает состояние миссий на выбранный момент и изменения при воспроизведении временной шкалы.

Режим истории предназначен для анализа. Перед запуском, повтором или отменой миссии вернитесь в «Текущее время», чтобы команда относилась к актуальному состоянию системы.

Подробнее о выборе момента и воспроизведении см. в статье «Навигация».

Права доступа

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

  • «Просмотр» миссий — страница, таблица и детали;
  • «Создание» миссий — запуск и повтор;
  • «Отмена» миссий — отмена записей NEW и RUNNING;
  • просмотр шаблонов миссий — названия шаблонов, выбор при запуске и переход к шаблону;
  • просмотр пользователей — колонка и поле «Автор».

Настройка прав описана в статье «Роли».