Шаблоны процессов
Описание
Шаблоны процессов позволяют сохранять готовые фрагменты логики и повторно использовать их в других проектах.
Шаблон — это:
- готовый кусок процесса (функция или группа блоков)
- оформленный по стандарту
- пригодный для повторного использования
Шаблоны помогают:
- ускорить разработку
- избежать дублирования логики
- внедрять единые подходы (например, обработку ошибок или retry)
- формировать библиотеку готовых решений
Когда использовать шаблоны
Рекомендуется использовать шаблоны, если:
- вы повторяете одну и ту же логику в разных процессах
- есть типовой сценарий (например: retry, работа с API, логирование)
- нужно стандартизировать подход внутри команды
- вы хотите собрать библиотеку переиспользуемых блоков
Открытие панели шаблонов
Панель «Шаблоны процессов» доступна из рабочей области.
В панели можно:
- искать шаблоны по названию
- фильтровать по категориям
- просматривать описание и структуру
- добавлять шаблон в проект
Добавление шаблона в процесс
Чтобы использовать шаблон:
- Откройте панель шаблонов
- Найдите нужный шаблон
- Нажмите «Добавить в проект»
- Разместите шаблон в алгоритме процесса
После добавления шаблона в процесс можно:
- изменять под конкретную задачу
- дополнять логикой
- использовать как основу для новых решений
Создание шаблона
Шаблон создаётся на основе уже реализованной логики.
- Требуется выбрать блок (функцию или группу)
- Открыть контекстное меню блока
- Нажать «Создать шаблон»
- Заполнить описание шаблона
- Сохранить шаблон
Локальные шаблоны
Пользовательские шаблоны сохраняются локально в папке пользователя и в панели шаблонов отмечаются пометкой «Локальный».
Рекомендации по созданию шаблонов
Хороший шаблон — это не просто код, а переиспользуемое решение.
Рекомендуется:
- делать шаблон независимым от конкретного процесса
- использовать понятные имена параметров
- избегать жёстких зависимостей
- добавлять README с описанием
- придерживаться единого контракта результата (для блоков функций)
Стандарт шаблонов
Каждый шаблон должен содержать описание (README) со структурой:
- Название
- Назначение
- Входные параметры (для блоков функций)
- Структура
- Возвращаемое значение (для блоков функций)
- Когда использовать
- Ограничения
Это позволяет:
- быстро понять, как использовать шаблон
- снизить порог входа для других разработчиков
- упростить поддержку
Возвращаемое значение (execution_result)
Шаблоны-функции рекомендуется строить с единым форматом результата:
{ "status": "success | error", "message": "string", "data": {}, "error_description": "string"}