Экспорт и импорт workflow в Staqflow: перенос без пересборки
Рабочий процесс нужно перенести из тестовой среды в рабочую, развернуть у нового клиента или запустить на собственном сервере. Повторная сборка узлов создаёт риск потерять настройки. Экспорт и импорт workflow в Staqflow позволяют перенести схему одним JSON-файлом, сохранив параметры и связи.
Файл переносит схему, а подключения остаются в пространстве
Экспорт создаёт файл *.workflow.json с названием, настройками, узлами и связями. В него входят часовой пояс, язык, повторы, заметки, обработка ошибок и выражения, включая $vars.ключ. На узлах сохраняются только ссылки и имена подключений.
Токены, пароли, API-ключи и OAuth-данные из хранилища учётных данных не выгружаются. Не переносятся значения переменных, история запусков, участники и их права. Новый процесс создаётся выключенным, чтобы импорт не запустил рабочие действия раньше проверки.
Экспортируется текущее состояние холста
Откройте workflow и выберите «Экспорт в файл» в меню редактора. Браузер скачает JSON с именем процесса. В файл попадают и ещё не сохранённые правки: так можно передать вариант схемы, не заменяя рабочую версию.
Формат содержит идентификатор staqflow.workflow и номер версии. Они позволяют отличить workflow от произвольного JSON. Если файл создан более новой версией платформы, импорт требует обновления приложения вместо загрузки с потерей данных.
Импорт создаёт новый процесс или заменяет открытый
В списке workflow выберите «Импорт из файла» и загрузите документ. Откроется редактор новой схемы. Она ещё не сохранена: сначала проверьте узлы и подключения, затем сохраните процесс.
Можно импортировать файл в открытый редактор. Перед заменой Staqflow показывает сводку. Текущие узлы и связи будут заменены, но идентификатор процесса и его пространство останутся прежними. Изменения применяются после сохранения; до этого от них можно отказаться.
У импортированных узлов новые идентификаторы, поэтому копия не конфликтует с исходной схемой даже в том же пространстве. Некорректный JSON, неподходящий формат, слишком новая версия и отсутствие узлов препятствуют импорту.
Подключения проверяются в целевом пространстве
Если указанное подключение существует в доступном пространстве, оно подставляется. Ссылки на чужие подключения удаляются. В сводке видно, какие имена найдены, какие нужно выбрать заново и какие узлы неизвестны текущей установке. Неизвестный узел может появиться на холсте, но не будет выполняться.
Для переноса между облаком и on-premise нужны совместимые версии платформы и каталога интеграций. В новом пространстве следует создать переменные с теми же ключами: в файле остаются выражения, а значения берутся из целевой среды. Так api_url может указывать на тестовый или рабочий сервер без изменения схемы.
Перед передачей файла проверяют параметры узлов
Защита учётных данных не очищает произвольный текст. Если токен вручную вставлен в заголовок HTTP-запроса, он является параметром узла и попадёт в экспорт. Ключи нужно хранить в учётных данных, общие настройки — в переменных. Закреплённые тестовые данные с информацией клиентов перед внешней передачей следует удалить.
После импорта процесс включают только после теста
- Выберите подключения на узлах, где они не подставились.
- Создайте необходимые переменные с совпадающими ключами.
- Проверьте триггер, новый адрес вебхука, расписание и часовой пояс.
- Выберите workflow обработки ошибок из целевого пространства, если он используется.
- Сохраните схему, выполните тестовый запуск и проверьте результаты шагов.
- Включите новый процесс.
Способ переноса зависит от задачи
Для копии в том же пространстве удобнее «Дублировать». Для другой среды, резервной копии или хранения схемы в Git — экспорт файлом. Если нужен похожий процесс по описанию, ИИ-клиент через MCP может прочитать существующую схему и создать новую в доступном пространстве. Файл предпочтительнее, когда требуется точная копия или передача без доступа к исходной среде.
Частые вопросы
Запустится ли workflow сразу после импорта?
Новый процесс создаётся выключенным и требует сохранения, тестирования и включения.
Переносятся ли значения переменных?
Нет. В схеме остаются ссылки $vars, а значения нужно создать в целевом пространстве.
Можно ли хранить файл в репозитории?
Да, формат читаемого JSON подходит для хранения версий. Перед этим проверьте, что в параметрах и тестовых данных нет секретов.
Связанные материалы
- Переменные в Staqflow: общие настройки workflow через $vars
- Пространства Staqflow: автоматизация для команд и клиентов
- STAQ.WorkflowAI: визуальный конструктор и ИИ для процессов
Подробнее о возможностях автоматизации — на сайте Staqflow.