Хранилище процесса

Хранилище процесса — это JSON-объект, общий для одного запуска процесса. Через него задачи передают друг другу данные: идентификаторы, массивы для обхода в цикле, промежуточные результаты и сформированные тексты.

Запись выполняется только по правилам в конфигурации действий и элементов «Шаблон». Чтение — через Go-шаблоны {{ .store.<путь> }} в теле запроса, условиях шлюзов и других полях с поддержкой шаблонизации.

Модель данных

• Одно хранилище на запуск — у каждого экземпляра процесса своё хранилище; оно сохраняется между шагами и доступно при просмотре запуска.
• Вложенные пути — ключи задаются dot-path без ведущей точки: notification.module_name, ctx.job.id. Промежуточные объекты создаются автоматически.
• Индексы массивов — в пути можно указывать элемент массива: items[0].status, branches[2].name.
• Типы значений — в зависимости от операции в хранилище попадают строки, числа, объекты и массивы JSON. Операции «Записать строку» и «Добавить строку» всегда работают со строками; операции с суффиксом JSON сохраняют разобранную структуру.

Правила обновления хранилища

Правила настраиваются в действии: «Конфигурация» → «Обновление» → «Обновление хранилища процесса». Они выполняются после успешного завершения действия, в порядке списка. Каждое следующее правило видит изменения, внесённые предыдущими правилами того же действия.

В конфигурации задачи процесса правила отображаются в режиме только для чтения; для изменения откройте действие из боковой панели задачи.

Поля правила

Операции

Для операций Записать JSON, Добавить JSON и Слить JSON удобно использовать функцию toJSON и прямую ссылку на поле ответа, например {{ .response.items }} — платформа подставит значение без лишней сериализации.

Примеры правил

Сохранить идентификатор из ответа действия:

Записать массив для последующего цикла:

Дописать строку в лог:

Обновить только часть объекта:

Выполнить правило только на первой итерации цикла:

Удалить временный ключ после использования:

Панель «Пути хранилища»

В редакторе правил действия доступна панель Пути хранилища: она показывает ключи контекста цикла (_loop.item, _loop.index и др.).

Чтение из хранилища

В шаблонах процесса используйте:

{{ .store.<путь> }}

Для вложенных полей путь совпадает с «Целью» в правилах записи:

{{ .store.notification.module_name }}
{{ .store.items[0].id }}

Параметры запуска процесса доступны отдельным контекстом:

{{ .process.<идентификатор_параметра> }}

Подробнее о контекстах шаблонизации — в разделе «Шаблонизация».

Контекст цикла _loop

Пока выполняется тело цикла, в хранилище доступен объект _loop:

Примеры в шаблонах:

{{ .store._loop.item.name }}
{{ .store._loop.item.scan_type }}
{{ .store._loop.index }}

В условиях эксклюзивного шлюза внутри цикла:

{{ eq .store._loop.item.branch .store.current_branch_tag }}

Цикл по коллекции из хранилища

Элемент «Цикл» поддерживает два режима (поле «Режим цикла»):

1. Фиксированное число — тело выполняется заданное количество раз (1–10000). В _loop.item — номер итерации (1, 2, 3…).
2. По коллекции — при входе в цикл вычисляется Go-шаблон «Шаблон коллекции»; каждый элемент полученного JSON-массива — одна итерация.

Шаблон коллекции

Рекомендуемый вариант — путь к массиву, уже записанному в хранилище предыдущей задачей:

{{ .store.notification.engagements }}

Альтернатива — собрать массив в шаблоне:

{{ toJSON .store.modules }}

Граничные случаи:

• Пустой массив или отсутствующий ключ — 0 итераций, переход по связи «Выход из цикла»; в логе процесса появится предупреждение.
• Значение по пути не является JSON-массивом — ошибка валидации или выполнения цикла.

Сценарий: обход списка из API

1. Задача «Получить engagements» — правило Записать JSON, цель notification.engagements, источник {{ toJSON .response.engagements }}.
2. Цикл, режим По коллекции, шаблон коллекции {{ .store.notification.engagements }}.
3. Задача в теле цикла — в теле запроса использовать {{ .store._loop.item.id }}, {{ .store._loop.item.name }}.
4. Эксклюзивный шлюз в теле — условие по полю элемента, например левое значение {{ .store._loop.item.status }}, правое active.
5. Связь Выход из цикла — продолжение после обхода всех элементов.

Элемент «Шаблон»

Элемент «Шаблон» вычисляет Go-шаблон при проходе процесса и записывает строку в хранилище. JSON из результата не разбирается — в store сохраняется текст как есть.

Пример тела:

## Отчёт по {{ .store._loop.item.name }}

Статус: {{ .store._loop.item.status }}
Владелец: {{ .store._loop.item.owner }}

Последующие задачи читают результат через {{ .store.rendered_message }} или соответствующий путь.

Просмотр хранилища при выполнении

На экране визуализации запуска процесса откройте вкладку Хранилище:

• Дерево — навигация по вложенным ключам; справа — тип и значение выбранного узла.
• JSON — полное содержимое хранилища в формате JSON.

Доступны копирование значения, обновление данных и скачивание JSON запуска (кнопка на панели диалога запуска).

В боковой панели задачи на схеме запуска отображаются Правила обновления хранилища выбранного действия — удобно сверять фактическое содержимое store с конфигурацией.

Лог процесса и отладка

На панели визуализации доступны:

• вкладка Лог выполнения (в том числе в отдельном окне или снизу схемы);
• Скачать лог — текстовый лог запуска;
• сообщения о пустой коллекции цикла и пропущенных правилах хранилища.

При ошибке шаблона или невалидном JSON в правиле с операцией JSON соответствующее правило может быть пропущено (с предупреждением в логе), остальные правила того же действия продолжают выполняться.

Связанные разделы

• Обзор — элементы схемы, запуск и управление.
• Обновление хранилища в действиях — где включаются правила.
• Шаблонизация — синтаксис Go-шаблонов и контексты.