Skip to Content
Руководство администратораТипы действий робота

Типы действий робота

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

Путь: «Настройки» → «Типы действий робота».

Реестр типов действий

В таблице отображаются:

  • ID — идентификатор записи в WCS;
  • Область — место использования действия: Instant или Node;
  • Производитель — код производителя робота;
  • Серия — серия роботов;
  • Название — понятная пользователю подпись;
  • Код — системный идентификатор команды;
  • Описание — назначение действия;
  • Обновлено — дата и время последнего изменения.

Строка поиска проверяет все поля таблицы. Фильтр «Область» показывает все записи либо только действия Instant или Node. Сортировку, ширину и видимость столбцов можно изменить стандартными средствами таблицы.

Области применения

Instant — мгновенное действие. Оно отправляется роботу отдельно от маршрута и не привязано к конкретной точке транспортного ордера. Например, так можно запросить информацию у робота или выполнить служебную команду.

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

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

{% hint style=“warning” %} В текущем интерфейсе область используется в справочнике и его фильтре, но селекторы действий не всегда отбирают записи по ней автоматически. При настройке миссии проверяйте, что для мгновенного действия выбрана запись Instant, а для точки транспортного ордера — Node. {% endhint %}

Добавление типа действия

  1. Нажмите «Добавить тип действия».
  2. Заполните обязательные поля «Название» и «Код».
  3. Выберите область Instant или Node.
  4. При необходимости укажите производителя и серию роботов.
  5. Добавьте описание, параметры по умолчанию и JSON Schema параметров.
  6. Нажмите «Сохранить».

Поля формы

ПолеНазначение
НазваниеПодпись действия в интерфейсе.
КодТочное системное имя команды, которое передаётся в миссию и интеграцию с роботом.
ОбластьОпределяет, используется действие как мгновенное (Instant) или как действие в точке транспортного ордера (Node).
ПроизводительКод производителя, для роботов которого предназначено действие. Если поле не заполнено, запись считается общей.
СерияДополнительное ограничение для конкретной серии роботов.
ОписаниеПоясняет назначение команды и условия её использования.
Параметры по умолчанию (JSON)Базовый набор параметров действия. Состав должен соответствовать контракту интеграции с роботом.
Схема параметров (JSON Schema)Описывает поля формы, их типы, обязательность и ограничения. После выбора действия WCS строит форму параметров по этой схеме.

Код должен совпадать с идентификатором действия, который поддерживает робот или его адаптер. Используйте стабильные коды без пробелов, например pick, drop или factsheetRequest. Не изменяйте код действующей записи без проверки шаблонов миссий и интеграции.

Настройка параметров

«Параметры по умолчанию (JSON)» и «Схема параметров (JSON Schema)» задаются отдельно:

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

{% hint style=“info” %} Текущий интерфейс сохраняет параметры по умолчанию вместе с типом действия, но не переносит их автоматически в поле «Параметры» при выборе действия в шаблоне миссии. Их применение может выполняться сервисом или адаптером. Если интеграция этого не делает, параметры нужно указать в миссии вручную. {% endhint %}

Пример для действия захвата паллеты:

{
  "speed": 0.5,
  "clamp": true
}

Соответствующая схема:

{
  "type": "object",
  "properties": {
    "speed": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 1
    },
    "clamp": {
      "type": "boolean"
    }
  },
  "required": [
    "clamp"
  ]
}

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

Использование в шаблонах миссий

Действия области Instant предназначены для действия workflow «Мгновенное действие». После выбора типа поле «Параметры» строится по сохранённой JSON Schema.

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

Записи справочника также можно использовать в схемах входных параметров шаблона миссии как ресурс «Тип действия робота». В таком поле сохраняется ID, код или другое выбранное свойство записи — в зависимости от настройки схемы.

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

В меню строки доступны «Редактировать» и «Удалить». Пользователь с правом только на просмотр может открыть запись без изменения.

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

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

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

Для открытия раздела нужно право просмотра ресурса «Типы действий робота». Создание, редактирование и удаление требуют соответствующих прав на этот ресурс.

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

Шаблоны устройствОбъекты данных