Добавить в очередь — документация 0.4

orch.queueAddItem · Оркестратор

Добавляет элемент (данные одной заявки, клиента, документа) в очередь оркестратора — его обработает робот

Добавляет элемент в очередь оркестратора — данные одной заявки, клиента, документа. Элемент возьмёт и обработает робот с процессом-обработчиком (orch.queueGetItem). Так одну работу делят на части: один процесс читает Excel или почту и наполняет очередь, несколько роботов параллельно её разбирают.

Действие работает в задании оркестратора и при запуске из студии, подключённой к оркестратору: тогда оно обращается к „области для отладки“, выбранной в «Оркестратор» → «Подключение…», и работает с настоящими данными этой области.

Свойства #

Свойство	Имя в файле	Значение	Обязательное	По умолчанию	Описание
Очередь	`queue`	текст	да	—	Имя очереди в оркестраторе, например «Заявки»
Данные элемента	`payload`	выражение	да	—	Объект, например { Номер: row['Номер'], ФИО: row['ФИО'] }
Ссылка	`reference`	текст	нет	—	Бизнес-ключ (номер заявки, ИНН): по нему элемент ищут в панели и отсекают дубликаты
Приоритет	`priority`	выбор из списка	нет	`normal`	Значения: `high`, `normal`, `low`.
Срок	`deadline`	текст	нет	—	Дата и время, до которых элемент нужно обработать, например 25.10.2026 18:00
Не раньше	`notBefore`	текст	нет	—	Не выдавать элемент роботу раньше этого времени

Результат #

Значение выхода сохраняется в переменную, выбранную для него в свойствах шага (раздел выходов).

Выход	Имя в файле
Id элемента	`itemId`

Как работает #

Очередь (queue) — имя очереди в панели („Заявки“).
Данные элемента (payload) — выражение-объект: row (строка Excel целиком) или { Номер: row['Номер'], ФИО: row['ФИО'] }. Обработчик получит его как item.payload.
Ссылка (reference) — бизнес-ключ: номер заявки, ИНН. По нему элемент находят в панели, и он защищает от повторной загрузки: элемент с уже известной ссылкой не добавится.
Приоритет (priority): high, normal, low — элементы с высоким приоритетом выдаются раньше.
Срок (deadline) — до когда обработать элемент, например 25.10.2026 18:00; влияет на порядок выдачи и оповещения о сроках.
Не раньше (notBefore) — не выдавать элемент роботу раньше этого времени.
Выход Id элемента — идентификатор нового элемента.

Ошибки #

Код	Причина и что делать
`QueueItemDuplicate`	Элемент с такой ссылкой уже есть в очереди — обычно это не ошибка процесса: перехватите её `control.tryCatch` и пропустите строку
`QueueNotFound`	Нет очереди с таким именем в рабочей области
`InvalidArgument`	Данные — не объект; не удалось разобрать дату срока; неверное значение для очереди
`OrchestratorUnavailable`	Процесс запущен без оркестратора (студия не подключена) или нет связи с сервером после 4 попыток (паузы 1, 2 и 4 с). Проверьте подключение студии или что агент робота на связи
`AccessDenied`	Не хватает прав в рабочей области или задание уже завершено

Пример #

{
  "type": "orch.queueAddItem",
  "props": { "queue": "Заявки", "payload": "row", "reference": "{{ row['Номер'] }}", "priority": "normal" },
  "out": { "itemId": "itemId" }
}