# Автогенерация и привязка шаблонов

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



## Привязка шаблонов к категории

Мобильные шаблоны задаются в настройках категории: на странице категории откройте чип **«Мобильные шаблоны»** — он ведёт на разводящую страницу со ссылками на экраны мобильных шаблонов. Ссылка **«Шаблонизация»** на этой странице открывает экран шаблонов задач выбранной категории. Для одной категории может быть активно несколько шаблонов — для разных контекстов и условий. Шаблоны бывают статические и динамические; для редактирования динамического шаблона доступен JSON-редактор.

### Параметры привязки

| Параметр | Значения | Описание |
|---|---|---|
| **Тип клиента** | `mobile` / `web` / `all` | Где используется шаблон |
| **Контекст** | `NTF` / `MTF` / `Cell` | `NTF` — карточка новой задачи (форма создания); `MTF` — карточка существующей задачи; `Cell` — краткое представление в списке |
| **Активность** | вкл / выкл | Позволяет временно отключить шаблон |
| **Смарт-фильтр** | условия | Шаблон применяется при выполнении условий; иначе используется стандартный шаблон |

## Быстрая генерация шаблонов

В настройках шаблонизации категории доступны кнопки быстрой генерации шаблона по умолчанию:

- **«Генерация шаблона по умолчанию для карточки задачи»** — создаёт стандартный шаблон контекста `MTF`;
- **«Генерация шаблона по умолчанию для карточки новой задачи»** — создаёт стандартный шаблон контекста `NTF`.

Особенности:

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

Сгенерированный шаблон далее правится в редакторе (секции → блоки → элементы) или через JSON.

## Динамические шаблоны

Редактор динамического шаблона открывает окно настроек со структурой **секции → блоки → элементы**; порядок задаётся кнопками со стрелками. Кнопка **«JSON»** позволяет просматривать и редактировать шаблон в формате JSON.

## Настройки категории, влияющие на мобильное приложение

### Контексты Cell / MTF / NTF и источники данных

Шаблон контекста `Cell` определяет краткое представление задачи в списках. Его поведение связано с источниками данных задач (taskSource): в источнике параметр `cellStyle` управляет тем, какой Cell-шаблон применяется к задачам списка:

- `default` — единый шаблон по умолчанию (список однородный);
- `custom` — для каждой задачи используется Cell-шаблон её категории, иначе шаблон по умолчанию (список разнородный, но учитывает специфику категорий).

Подробнее — [Источники данных задач](https://help.1forma.ru/domains/mobile/reference/tasksources.md).

### Настройки МТФ-панели (категории чат-типа)

Для подкатегорий с чатовым типом представления в Admin SPA дополнительно отображается секция **«Настройки МТФ-панели»**:

| Поле UI | Поле БД (`dbo.Subcategories`) | Назначение |
|---|---|---|
| чекбокс `showMtfPanel` | `ShowMtfPanel` | Показывать ли МТФ-панель |
| мультиселект `mtfPanelGroupIds` | `MtfPanelGroupIds` | Группы, для которых панель отображается |

API настроек подкатегории: `GET` / `PUT /api/admin/subcat/{subcatId}/settings`.

### ДП на мобильном (наследование значений из задачи-источника)

В настройках категории есть раздел **«ДП на мобильном»** с подразделом **«Наследование значений из задачи-источника»** — механизм передачи значений дополнительных параметров в мобильном контексте.

> Подробное описание механизма и конкретные ключи — в разделе [Категории — администрирование](https://help.1forma.ru/domains/categories/admin.md).

## Связанные документы


- [Шаблоны — обзор](https://help.1forma.ru/domains/mobile/mobile-templates.md) — контексты NTF/MTF/Cell
- [Источники данных задач](https://help.1forma.ru/domains/mobile/reference/tasksources.md) — taskSource, `cellStyle`
- [Администрирование — обзор](https://help.1forma.ru/domains/mobile/admin.md) — привязка шаблонов (§ Шаблоны задач)
- [JS/CSS-вставки в карточке задачи](https://help.1forma.ru/domains/mobile/reference/template-web-widgets.md)