Перейти к содержанию

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

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

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

Мобильные шаблоны задаются в настройках категории: на странице категории откройте чип «Мобильные шаблоны» — он ведёт на разводящую страницу со ссылками на экраны мобильных шаблонов. Ссылка «Шаблонизация» на этой странице открывает экран шаблонов задач выбранной категории. Для одной категории может быть активно несколько шаблонов — для разных контекстов и условий. Шаблоны бывают статические и динамические; для редактирования динамического шаблона доступен 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-шаблон её категории, иначе шаблон по умолчанию (список разнородный, но учитывает специфику категорий).

Подробнее — Источники данных задач.

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

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

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

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

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

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

Подробное описание механизма и конкретные ключи — в разделе Категории — администрирование.

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