|
|---|
Вид карточки канбана, состав ее дополнительных и системных параметров можно настроить с помощью шаблона задач в соответствии со следующими шагами:
1. Создание шаблона задач
В режиме администрирования перейдите к странице Шаблоны задач в разделе МП. Нажмите кнопку Создать.
В открывшемся окне задайте параметры:
•Контекст — Cell
•Тип — dynamic
•Категория — Категория, для которой создается шаблон
Имя шаблона, язык и описание могут иметь любое значение.
Создание шаблона задач
2. Настройка шаблона
Стандартне тело динамического шаблона — это JSON трехуровневой структуры: sections -> blocks -> elements.
Шаблон канбана описывается в блоке Sections — он содержит только один элемент, соответствующий карточке канбана. В блоке задаются параметры blocks и settings.
Секция Blocks
В Blocks задаются блоки внутри карточки канбана:
•header и footer — Блоки с предопределенным видом, который можно конфигурировать внутри массива elements.
•body — Динамический блок, в котором можно отображать значения ДП или системных полей задачи. ДП выводятся в карточке, только если в них есть значение.
Разделение карточки на блоки
Каждый блок содержит параметры:
• alias — Определяет тип блока (header, body, footer).
• elements — Описывает элементы внутри блока.
Элементы для блоков с типом header и footer:
Элемент с источником данных из системного параметра
Элемент с источником данных из ДП
Описание параметров блоков:
Параметр |
Описание |
|
|---|---|---|
type |
Тип источника данных |
|
mainParam |
Системный параметр |
|
extparam |
ДП |
|
dataKey |
Для ДП ("type":"extparam") в dataKey указывается ID ДП. Для системных параметров задачи ("type":"mainParam") dataKey может принимать следующие значения: |
|
taskText |
Текст задачи |
|
taskId |
Номер задачи |
|
priority |
Приоритет |
|
state |
Статус |
|
dueDate |
Срок |
|
performers |
Исполнители |
|
owner |
Заказчик |
|
alias (для header) |
Статическое поле в карточке канбана, которое необоходимо отобразить. Возможные значения:  alias в header |
|
title |
Заголовок — текст задачи |
|
headerCounter |
Индикатор с количеством задач. В секции можно задать параметры: •color — Цвет счетчика. Возможные значения: oprimary. oaccent. oinfo. osuccess. owarning. ofav. odanger. oerror. odefault. oblackWhite. •emphasis — Акцент счетчика. Возможные значения: oaccent. ocontainer. |
|
subtitle |
Подзаголовок, вторая строка |
|
mainTag |
Главный тег. В секции можно задать параметр: •color — Цвет счетчика. Возможные значения: oprimary. oaccent. oinfo. osuccess. owarning. ofav. odanger. oerror. odefault. oblackWhite. |
|
tags |
Теги задачи. Приходят в viewTags задачи. Для другого источника данных пока не работает |
|
headerDate |
Дата заголовка. Выполняет функцию отображения срока |
|
cover |
Обложка карточки канбана. В секции settings для данного alias можно задать параметры: •showEmptyCover — Показать пустую обложку. Обязательный параметр, должно быть указано true. •ratioWH — Соотношение сторон изображения. Доступные значения: o16:9. o1:1. |
|
alias (для footer) |
Возможные значения:  alias в footer |
|
avatar |
Аватар карточки задачи. В dataKey необходимо передать ID ДП с типом "Файл", в котором хранится аватар. |
|
priority |
Приоритет. Для отображения можно передать dataKey: priority, либо для кастомного поля в settings передать поле valueMapper (см. пример) |
|
users |
Пользователи. Например, исполнители задачи или значение в ДП "Выбор пользователей". Для отображения в параметр viewMode элемента необходимо передать значение table. |
|
cardIdentifier |
Текстовое или числовое значение. В settings можно передать поле prefix, который добавит перфикс к значению. |
|
totalSubtasks |
Общее количество подзадач. Может использоваться для отображения значения из ДП с типом Число — в таком случае alias остается без изменений, в параметре type должно быть задано значение extparam, а в dataKey указан ID нужного ДП. |
|
activeSubtasks |
Число активных подзадач. Может использоваться для отображения значения из ДП с типом Число — в таком случае alias остается без изменений, в параметре type должно быть задано значение extparam, а в dataKey указан ID нужного ДП. |
|
viewMode |
Параметр вида. Для отображения пользователей необходимо передать значение table, для остальных типов данных можно не передавать. |
|
settings |
Является параметром, который необходимо описать для определенных полей. Например, если мы хотим чтобы перед номером задачи в footer отображатся символ #, то в settings элемента нужно передать параметр prefix со значением префикса (в нашем случае #). Ниже будут описаны возможные settings для каждого элемента. |
|
Элементы для блока с типом body
Элемент с источником данных из системного параметра
Элемент с источником данных из ДП
Описание параметров блоков:
Параметр |
Описание |
|
|---|---|---|
type |
Тип источника данных |
|
mainParam |
Системный параметр |
|
extparam |
ДП |
|
name |
Название поля. Если значение не задано, по умолчанию будет отображаться в зависимости от типа источника данных: название ДП или название системного поля. |
|
dataKey |
Для ДП ("type":"extparam") в dataKey указывается ID ДП. Для системных параметров задачи ("type":"mainParam") dataKey может принимать следующие значения: |
|
taskText |
Текст задачи |
|
taskId |
Номер задачи |
|
priority |
Приоритет |
|
state |
Статус |
|
dueDate |
Срок |
|
performers |
Исполнители |
|
owner |
Заказчик |
|
viewMode |
Параметр вида. В отличие от header и footer, для блока body viewMode является обязательным параметром. Возможные значения: |
|
normal |
Названия параметров отображаются строкой выше значений |
|
compact |
Названия параметров отображаются слева от их значений. Является значением по умолчанию, если не передать другой viewMode.  |
|
valueOnly |
Параметры отображаются без названий  |
|
none |
Параметры в карточке не отображаются  |
|
table |
Используется для отображения пользователей. В settings можно передать "showUserStatus": true чтобы отобразить статус пользователя "как в ленте" |
|
icon |
Вместо названия параметра отображается иконка слева. Необходимо передать icon в settings элемента.  |
|
iconSet |
Вместо значений ДП с типом "Выбор нескольких задач из категории" (Multilookup) передавать иконки задач. Опционально иконки могут быть окрашены в соответствии с цветом выбранных в ДП задач, для этого необходимо передать showColor в settings элемента. |
|
tags |
Значения ДП "Lookup" и "Выбор нескольких задач из категории" (Multilookup) в виде тегов. Опционально в карточке можно отображать иконки задач-значений ДП с соответствующим цветом, для этого необходимо передать showIcon и showColor в settings элемента.  |
|
settings |
Параметр, который необходимо описать для определенных полей. |
|
icon |
При viewMode: icon задается иконка из списка иконок. Список доступных иконок можно найти по адресу: https://Адрес_1Формы/spa/content-icons |
|
truncate |
Обрезка текстовых значений полей и заголовков. Возможные значения: true (обрезать, текст при достижении максимально доступного значения обрезается троеточием) / false (не обрезать, текст отображается полностью с переносом на следующую строку). По умолчанию true. |
|
showUserStatus |
Отображение статуса пользователей в viewMode: table для полей с выбором пользователей. Возможные значения: true (отображать) / false (не отображать). По умолчанию false. |
|
showIcon |
Признак отображения иконки задачи, выбранной в ДП, при viewMode: tags |
|
showColor |
Признак отображения цвета задачи, выбранной в ДП, при viewMode: tags |
|
Секция Settings
В Settings содержатся настройки карточки канбана. Из параметров доступны leftBorder , groupings и aggregations.
leftBorder отвечает за левую обводку карточки.
Пример карточки с заданным leftBorder
groupings позволяет задать список доступных группировок. Элементы в groupings имеют схожий вид с элементами в sections. Для указания группировки по умолчанию, которая будет отображаться для пользователей при переходе в Канбан, в "settings" параметр "isDefault" должен принимать значение "true".
Группировка в канбане
Если не указывать группировку, в выпадающем списке по умолчанию отображаются системные параметры: Исполнители, Заказчик, Срок, Дата создания, Дата изменения.
aggregations позволяет включить отображение суммы, среднего, максимального и минимального значения по значениям ДП с типом "Число" и "Деньги".
Параметр |
Описание |
|
|---|---|---|
column |
ID ДП в формате ExtParam{ExtParamID} "column": "ExtParam12872" |
|
name |
Имя ДП |
|
postfix |
Текст, который добавляется после вычисленного значения |
|
separator |
Символ-разделитель, который используется между агрегациями |
|
operation |
sum |
Сумма |
avg |
Среднее значение |
|
max |
Максимальное значение |
|
min |
Минимальное значение |
|
Сохраните созданный шаблон.
Фильтрация по параметру
Канбан может быть построен не только по основному маршруту, но и по значениям параметра с типом Lookup поле. Любой из настроенных в категории параметров выбирается в меню Статус. Задать порядок колонок в канбане можно с помощью настройки определенного Lookup поля Колонка сортировки. Если настройка для параметра не задана, то по умолчанию колонки выводятся по алфавиту.
Вид отображения канбана по Lookup полю
3. Настройка шаблонизации в категории
В настройках категории во вкладке Вид перейдите к настройкам шаблонизации.
Шаблонизация в настройках вида категории
Выберите в списке созданный шаблон. Задайте для него следующие настройки:
•В колонке Клиент выберите значение all.
•Активируйте опцию В кратком отображении.
•Активируйте опцию Активность правила.
Параметры шаблона в категории
Пример настроенного шаблона
