Запись роботом

Робот пишет в отчёт шагами категории „Оркестратор“. Каждая запись сама запоминает задание, его номер, процесс и версию, робота и элемент очереди, который задание обрабатывало, — по ним в панели видно, откуда взялась строка.

Шаги #

Свойство „Отчёт“ — ключ отчёта из панели (латиница, например payments), а не название. Ключ указан на странице отчёта.

Пример: платежи из выписки #

Процесс „Загрузка выписок“ читает выписку банка в Excel и пишет каждую строку в отчёт „Платежи“ (ключ payments, поля number, amount, paid_on, status, ключ записи — number):

1. excel.readRange читает таблицу выписки с заголовками в переменную rows.
2. orch.reportAddMany: „Отчёт“ — payments, „Записи“ — rows.map(r => ({ number: r['Номер'], amount: r['Сумма'], paid_on: r['Дата'], status: 'Новый' })), „Режим“ — upsert.
3. Позже процесс-сверщик отмечает оплату: orch.reportUpdate с „Ключ записи“ { number: 'П-0001' } и „Новые значения“ { status: 'Оплачен' }.

В режиме upsert повторный запуск того же процесса по той же выписке не создаёт дублей: строки с тем же номером обновляются. Готовый образец — samples/orchestrator/08_report_writer в репозитории (отчёт report.json и процесс main.flow.json).

Ошибки #

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

Отладка из студии #

Запуск из студии с шагами отчётов пишет настоящие записи в отчёт оркестратора, к которому подключена студия (как и шаги очередей). Для отладки используйте тестовый оркестратор или отдельную тестовую область, а лишние записи удалите на вкладке «Записи».