Перейти к содержимому

Шаблоны процессов

Описание

Шаблоны процессов позволяют сохранять готовые фрагменты логики и повторно использовать их в других проектах.

Шаблон — это:

  • готовый кусок процесса (функция или группа блоков)
  • оформленный по стандарту
  • пригодный для повторного использования

Шаблоны помогают:

  • ускорить разработку
  • избежать дублирования логики
  • внедрять единые подходы (например, обработку ошибок или retry)
  • формировать библиотеку готовых решений

Когда использовать шаблоны

Рекомендуется использовать шаблоны, если:

  • вы повторяете одну и ту же логику в разных процессах
  • есть типовой сценарий (например: retry, работа с API, логирование)
  • нужно стандартизировать подход внутри команды
  • вы хотите собрать библиотеку переиспользуемых блоков

Открытие панели шаблонов

Панель «Шаблоны процессов» доступна из рабочей области.

Панель: Шаблоны процессов

В панели можно:

  • искать шаблоны по названию
  • фильтровать по категориям
  • просматривать описание и структуру
  • добавлять шаблон в проект
Панель: Шаблоны процессов

Добавление шаблона в процесс

Чтобы использовать шаблон:

  1. Откройте панель шаблонов
  2. Найдите нужный шаблон
  3. Нажмите «Добавить в проект»
  4. Разместите шаблон в алгоритме процесса

После добавления шаблона в процесс можно:

  • изменять под конкретную задачу
  • дополнять логикой
  • использовать как основу для новых решений

Создание шаблона

Шаблон создаётся на основе уже реализованной логики.

  1. Требуется выбрать блок (функцию или группу)
  2. Открыть контекстное меню блока
  3. Нажать «Создать шаблон»
  4. Заполнить описание шаблона
  5. Сохранить шаблон
Создание шаблона

Локальные шаблоны

Пользовательские шаблоны сохраняются локально в папке пользователя и в панели шаблонов отмечаются пометкой «Локальный».

Локальные шаблоны

Рекомендации по созданию шаблонов

Хороший шаблон — это не просто код, а переиспользуемое решение.

Рекомендуется:

  • делать шаблон независимым от конкретного процесса
  • использовать понятные имена параметров
  • избегать жёстких зависимостей
  • добавлять README с описанием
  • придерживаться единого контракта результата (для блоков функций)

Стандарт шаблонов

Каждый шаблон должен содержать описание (README) со структурой:

  • Название
  • Назначение
  • Входные параметры (для блоков функций)
  • Структура
  • Возвращаемое значение (для блоков функций)
  • Когда использовать
  • Ограничения

Это позволяет:

  • быстро понять, как использовать шаблон
  • снизить порог входа для других разработчиков
  • упростить поддержку

Возвращаемое значение (execution_result)

Шаблоны-функции рекомендуется строить с единым форматом результата:

{
"status": "success | error",
"message": "string",
"data": {},
"error_description": "string"
}