Шаблоны маршрутов
=================

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

По своей структуре и функциональности
шаблон маршрута аналогичен обычному маршруту:
в нем можно настраивать этапы,
использовать различные типы действий
и управлять логикой выполнения процесса.

Шаблон маршрута является отдельной сущностью системы
и не привязан напрямую к реестру или пользовательскому действию.

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



Назначение шаблонов маршрутов
-----------------------------

Шаблоны маршрутов применяются в случаях,
когда бизнес-процесс может развиваться
по нескольким сценариям
или содержит повторяющиеся участки логики.

Использование шаблонов маршрутов позволяет:

* выносить общие части маршрута в отдельную сущность;
* переиспользовать одну и ту же логику в разных маршрутах;
* упрощать основные маршруты и делать их более наглядными;
* уменьшать дублирование настроек и этапов.

Таким образом, шаблон маршрута выступает
в роли переиспользуемого блока логики,
который может быть встроен в основной маршрут
на определенном этапе.


Создание шаблона маршрута
-------------------------

Для создания шаблона маршрута необходимо:

1. В структуре приложения выбрать папку,
   в которой будет располагаться шаблон маршрута.
2. Кликнуть правой кнопкой мыши по выбранной папке.
3. В контекстном меню выбрать:
   **Добавить → Процессы → Шаблон маршрута**.

.. figure:: /images/route_template_add.png

   Создание шаблона маршрута


После этого откроется окно создания шаблона маршрута.


Настройка основных параметров
-----------------------------

В окне создания шаблона маршрута необходимо:

1. Указать **Наименование** шаблона маршрута.
2. Задать **Код** шаблона маршрута
   либо оставить автоматически сгенерированное значение.
3. Сохранить шаблон маршрута,
   нажав на кнопку сохранения
   (иконка дискеты на панели).

После сохранения шаблон маршрута 
становится доступным его настройка и использование
в других маршрутах.


Использование шаблона маршрута
-------------------------------

Для использования шаблона маршрута
в основном бизнес-маршруте
необходимо настроить соответствующий этап.

Для этого:

1. Откройте основной маршрут бизнес-процесса.
2. Выберите этап,
   в котором должен выполняться шаблон маршрута.
3. В настройках этапа
   в разделе **Тип действия**
   выберите значение **«Запуск маршрута по шаблону»**.
4. В поле **«Шаблон маршрута»**
   выберите необходимый шаблон
   из выпадающего списка.

.. figure:: /images/route_template_select.png

   Выбор шаблона маршрута в этапе


После настройки этапа
при выполнении данного этапа основного маршрута
будет запускаться выбранный шаблон маршрута.


Логика выполнения
-----------------

При запуске шаблона маршрута:

* выполняются все этапы,
  настроенные внутри шаблона;
* шаблон маршрута работает как самостоятельный маршрут;
* после завершения шаблона
  выполнение основного маршрута
  продолжается в соответствии с его логикой.

Таким образом, шаблон маршрута
встраивается в основной маршрут
как отдельный логический блок.


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

При проектировании бизнес-процессов рекомендуется:

* использовать шаблоны маршрутов
  для повторяющихся участков логики;
* давать шаблонам понятные и однозначные названия;
* не перегружать основной маршрут
  большим количеством этапов;
* выносить сложные ветки логики
  в отдельные шаблоны маршрутов.

Корректное использование шаблонов маршрутов
упрощает сопровождение системы
и повышает читаемость бизнес-процессов.