Skip to Content
Руководство администратораОбъекты данных

Объекты данных

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

Объект данных — это именованный JSON-документ, который можно читать и изменять из workflow действиями «Прочитать объект данных» и «Записать объект данных», а также через внешние интеграции. В отличие от входных параметров шаблона, значение сохраняется между запусками миссий: его можно править в настройках, не пересобирая workflow.

Путь: «Настройки» → «Объекты данных».

Типичные применения

  • Общие настройки склада. Один объект с зонами, порогами и признаками включения, который используют несколько шаблонов. Например: {"receiving_point":"STATION_05","priority_threshold":8,"notify":true}. Оператор меняет точку приёмки в объекте данных, а не в каждом шаблоне.
  • Состояние ячеек и буферов. Workflow читает занятость ячейки перед постановкой груза и записывает новый статус после выгрузки: {"cell":"A-12","occupied":true,"pallet_id":"PL-1042"}.
  • Счётчики и накопленный результат. Миссия по расписанию читает текущее значение, увеличивает его и записывает обратно: число обработанных паллет за смену, последний обработанный заказ, время последнего успешного цикла.
  • Справочник соответствий. Таблица соответствий, которой нет в других реестрах WCS: код точки → зона, тип груза → шаблон устройства, внешний код заказа → внутренний идентификатор.
  • Данные для интеграций. HTTP Request, NATS или MQTT берут полезную нагрузку из объекта либо записывают в него ответ внешней системы, чтобы следующие шаги миссии работали с уже сохранённым JSON.

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

Реестр объектов

В таблице «Управление объектами данных» отображаются ID, «Название», «Описание», «Создано» и «Действия». Код объекта задаётся в форме, но отдельной колонкой в таблице не отображается.

В меню строки доступны «Редактировать» и «Удалить», а при праве только на просмотр — «Открыть детали». Общие правила поиска и работы с меню строки приведены в статье «Работа с таблицами».

Добавление объекта

  1. Нажмите «Добавить объект данных».
  1. Заполните «Название», «Код» и «Описание».

Название — понятное пользователю название объекта данных, например «Настройки зоны приёмки». Может быть на русском и позже изменено.

Код — стабильный технический ключ для workflow и интеграций, например receiving_zone_settings. Без пробелов. Не меняйте его после того, как на объект уже ссылаются шаблоны.

Описание — необязательный комментарий, зачем объект нужен и кто его использует.

  1. В поле «Данные (JSON)» укажите значение объекта.
  2. При необходимости добавьте схему данных
  3. При необходимости добавьте UI-схему.
  4. Нажмите «Сохранить».

Объект данных

В поле «Данные (JSON)» укажите само содержимое объекта: то, что читает и записывает workflow. Это JSON-объект с полями, которые будут использоваться в миссиях и интеграциях. Рекомендации:

  • храните один объект ({ ... }), а не массив и не одно число;
  • имена полей делайте стабильными, как код объекта: receiving_point, а не «Точка приёмки»;
  • кладите только то, что реально читают шаблоны; служебные комментарии лучше в «Описание».

Схема данных

Команда «Добавить схему данных (JSON-Sсhemа)» открывает редактор JSON Schema. Схема определяет допустимые поля, типы, обязательность и ограничения данных.

Схема определяет правила для этих данных: типы, обязательность, диапазоны, запрет лишних полей. Используйте её, если структура объекта должна проверяться при вводе или изменении. Нужна, если объект будут менять операторы или внешние системы. Для простого неизменяемого JSON схему можно не добавлять. Рекомендации:

  • type: "object" и properties по полям из «Данные (JSON)»;
  • обязательные поля перечислите в required;
  • additionalProperties: false, если лишние ключи недопустимы;
  • текущие данные должны проходить схему: не задавайте minimum: 1, если в JSON уже 0.

UI-схема

Команда «Добавить UI-Схему (JSON-UI-Schemа)» добавляет настройки представления формы. UI-схема управляет расположением и видом полей, но не заменяет проверку данных по JSON Schema.

как поля показать в форме: порядок, подсказки, чекбокс, многострочный ввод. На проверку значений не влияет и не заменяет JSON Schema. Имеет смысл только вместе со схемой данных, если объект редактируют как форму, а не сырой JSON. Рекомендации:

  • ui:order совпадает с порядком полей в схеме;
  • ui:help и ui:placeholder — для оператора, не для workflow;
  • виджеты должны соответствовать типу: checkbox для boolean, textarea для длинного текста, updown для числа.

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

Чтобы изменить объект, в меню «Действия» выберите «Редактировать», внесите изменения и нажмите «Сохранить».

Чтобы удалить объект, в меню «Действия» выберите «Удалить». Перед удалением проверьте шаблоны миссий и внешние интеграции, которые обращаются к коду объекта. После подтверждения запись будет удалена, и такие обращения начнут завершаться ошибкой.

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