Элемент управления "Канбан"

Свойства

Выбирать первую настройку при загрузке

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

Настройка данных

Основное свойство, которое задается через специальную форму и содержит в себе список всех настроек.

Настройка данных
Рисунок 1. Настройка данных
Форма настройки данных состоит из двух частей:

  1. Список настроек — позволяет добавлять, удалять и менять местами настройки. Это те настройки, между которыми пользователь может переключаться в выпадающем списке в шапке канбан-доски.

  2. Свойства выбранной настройки — весь набор свойств, которые отображаются справа от списка настроек. Эти свойства задаются индивидуально для каждой настройки из списка.

    Данные свойства можно разбить на три группы:

    1. Общая настройка.

      Имя набора настроек

      Название, которое отображается в списке настроек в левой части формы, а также в выпадающем списке в шапке канбан-доски.

      Использовать плагин

      Флаг, который определяет, будет ли использоваться плагин для данной настройки. Если флаг активен, то будет доступно поле под ввод имени плагина.

      Операция редактирования

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

      Операция редактирования

      Возможность Drag & Drop. Если канбан расположен внутри разметки карточки, то есть возможность выбрать операцию редактирования, которая определит, имеет ли пользователь возможность перемещать карточки между столбцами в данной настройке. Если выбранная операция недоступна, то при попытке переместить карточку она будет возвращаться обратно в исходный столбец. Если канбан расположен в отдельной локации, то данную доступность можно определить плагином.

      Тип или виды карточек

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

      Поисковый запрос

      Позволяет выбрать заранее созданный поисковый запрос для дополнительной фильтрации карточек на канбан-доске. Из результатов поискового запроса будут взяты только те карточки, которые соответствуют свойству "Тип или виды карточек".

      Изменяемое поле карточки

      Поле, которое будет изменяться в карточке при перемещении её между столбцами канбан-доски. Также, исходя из значения этого поля, карточки будут распределяться по столбцам, то есть, если значение поля карточки не совпадает ни с одним из значений столбцов в данной настройке, то такая карточка будет отброшена. Стоит учитывать, что если выбрано поле древовидной\табличной секции, то будет браться значение из первой строки такой секции, т.е. каждая карточка на канбан-доске может отображаться только в единственном экземпляре.

      Поле сортировки

      Выбор поля карточки, по которому будет происходить сортировка внутри каждого столбца. Стоит учитывать, что если выбрано поле древовидной\табличной секции, то будет браться значение из первой строки такой секции. Если выбрано поле с типом refCardId, то сортировка будет происходить по дайджесту карточек. Если выбрано поле с типом refId и указано, на что оно ссылается, то сортировка будет происходить по отображаемому значению объекта, ссылка на который указана.

      Сортировать по убыванию

      Флаг, который определяет направление сортировки.

      Поле с цветом

      Поле, в котором хранится значение цвета, например: rgba (91, 192, 3, 1). Стоит учитывать, что если выбрано поле древовидной\табличной секции, то будет браться значение из первой строки такой секции. Цвет применяется к окантовке контейнера карточки.

      Поле со значением цвета

      Поле, в котором хранится пояснение к цвету карточки, которое будет отображено в легенде напротив соответствующего цвета. Стоит учитывать, что если выбрано поле древовидной\табличной секции, то будет браться значение из первой строки такой секции. Если выбрано поле с типом refCardId, то напротив цвета будет выведен дайджест карточки, на которую указана ссылка. Если выбрано поле с типом refId и указано, на что оно ссылается, то напротив цвета в легенде будет выведено отображаемое значение объекта, ссылка на который указана в поле.

      Использовать предопределенный набор столбцов

      Флаг, который определяет, будет ли использоваться предопределенный набор столбцов. Если он активен, то на форме появляется выпадающий список, из которого можно выбрать предопределенный набор. На данный момент доступен только один: Неделя.

      Использовать предопределенный набор столбцов
      Рисунок 2. Использовать предопределенный набор столбцов

      Если выбран данный предопределенный набор столбцов, то столбцами канбан-доски будут даты текущей недели (без времени, т.е. изменяемое поле должно быть Date либо DateTime, но со временем 0:00:00, чтобы карточки попадали в настройку).

    2. Настройка столбцов.

      Имеется возможность создать список столбцов и для каждого заполнить свойства:
      *Заголовок столбца

      Значение, которое будет отображаться в шапке столбца на канбан-доске, а также в списке столбцов в текущей форме настроек.

      Устанавливать заголовок столбца исходя из значения поля

      Флаг, который определяет, что заголовок столбца на канбан-доске будет определяться исходя из значения в свойстве столбца Значение поля. При активном флагше значение из свойства *Заголовок столбца будет игнорироваться на шапке столбца канбан-доски. Так, например, если в свойстве Значение поля указан идентификатор, а в свойстве Изменяемое поле карточки выбрано поле refId, у которого указано, на что оно ссылается, то заголовком будет отображаемое значение объекта, идентификатор которого указан в свойстве столбца Значение поля. Если в Изменяемое поле карточки выбрано поле с типом refCardId, то заголовком будет дайджест.

      Значение поля

      Фактическое значение, которое будет устанавливаться в поле карточки при перемещении между столбцами. Если в столбцах указываются сотрудники, значением должен быть идентификатор.
      Значение столбца должно быть таким, чтобы его можно было привести к типу поля, которое выбрано в свойстве Изменяемое поле карточки. Если в одном из столбцов указано значение, которое не удается привести к значению изменяемого поля, то такой столбец будет исключен из канбан-доски и при выборе данной настройки будет выдано предупреждение:

      Предупреждение о скрытых столбцах
      Рисунок 3. Предупреждение о скрытых столбцах
      Цвет столбца

      Выбор цвета для столбца. Цвет столбца влияет на цвет шапки столбца, а также на цвет границ контейнеров карточек в данном столбце. При выборе белого будет использоваться цвет столбца по умолчанию. Если для карточки есть свое значение цвета (из свойства Поле с цветом, либо задано плагином), для границ контейнера карточки будет использоваться этот цвет, иначе будет использоваться цвет столбца, в котором находится карточка. Если цвет столбца не задан (в цвете столбца выбран белый), будет использоваться цвет по умолчанию.

      Отображать кнопку создания карточки

      Флаг определяет, будет ли в данном столбце доступна кнопка для быстрого создания карточки. Подробнее см. раздел "Создание карточек на канбан-доске".

    3. Настройка показателей.

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

      Свойства показателей в форме настройки данных:
      *Имя показателя

      Значение, которое отображается на кнопке, отвечающей за разворачивание и сворачивание процентах строк, относящихся к данному показателю.

      Цвет показателя

      Цвет, который определяет цвет кнопки показателя, а также цвет процентных полос.

      Поле подсчёта

      Поле карточки, по которому идет подсчёт. Если поле подсчета имеет тип refCardId, над процентной полосой будет указан дайджест карточки. Если тип поля подсчёта refId и указано, на что оно ссылается, над процентной полосой будет отображаемое имя соответствующего объекта. Если указано поле из табличной\древовидной секции, показателя будет комбинация значений указанного поля из каждой строки, разделенные точкой с запятой.

      Например, если выбрано поле Сотрудник табличной секции Исполнители, то результат показателя для одного из столбцов будет следующим:

      Вид столбца секции
      Рисунок 4. Вид столбца табличной секции

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

      Если выбрано поле плоской секции, уникальные значения отображаются обычным образом. Например, показатель по полю Состояние плоской секции Системные свойства:

      Вид столбца плоской секции
      Рисунок 5. Вид столбца плоской секции

      То есть, в столбце всего 4 карточки, три из которых в состоянии Начато, одна в состоянии В работе.

      Подсчёт показателей происходит по фактическому значению поля (например, в двух показателях сверху сравниваются идентификаторы), а не по отображаемому над процентной полосой.

      Агрегатные функции

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

      • Сумма — по умолчанию работает только для числовых полей

      • Среднее арифметическое — по умолчанию работает только для числовых полей

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

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

      Собственные агрегатные функции можно создать в плагине, после чего обработать в клиентском расширении их подсчет в событии calculateIndicatorAggregateFunction.

      Стоит учитывать, что расчёт агрегатных функций, как и процентных строк, происходит на клиентской стороне. Дополнительные метаданные для показателей можно передавать через плагин и затем использовать их в обработчике события.
      Максимальное и минимальное значения
      Рисунок 6. Максимальное и минимальное значения

Дополнительные css классы

Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.

Видимость

Настройка видимости. Элемент управления отображается в карточке, когда флаг установлен. Элемент управления и любое его содержимое не отображаются, когда флаг снят.

Адаптивный

Отключен

Когда флаг установлен, отключается возможность изменить значения элемента управления. Работает совместно со свойством Операция редактирования. Редактирование будет запрещено, если одно из свойств запрещает редактирование.

Адаптивный