Канбан

Документ описывает канбан — визуальный режим работы с задачами в 1Форме. Канбан показывает распределение задач по статусам, позволяет менять статус перетаскиванием, фильтровать по ролям и ДП. Для администраторов (настройка) и пользователей (работа с досками). Разделы: бизнес-сценарии (канбан по маршруту, по Lookup, персональный), роли и права, представления «Канбан» и «Галерея», связи с другими доменами.

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

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

Бизнес-сценарии

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

Канбан по Lookup-полю: доска строится по значению выбранного Lookup-параметра. Порядок колонок берётся из настройки Lookup-поля «Колонка сортировки»; если сортировка не настроена, порядок алфавитный; при переносе карточки между колонками меняется значение Lookup в задаче; есть колонка «Не заполнено» для задач без значения.

Персональный канбан исполнителя: отдельный сценарий в профиле пользователя — доска задач, где пользователь является исполнителем. Колонки фиксированы: «Новое» — задачи в первоначальном статусе, «В работе» — остальные незакрытые, «Завершено» и «Отклонено» — закрытые, в зависимости от того, отмечена ли работа выполненной. Колонки закрытых задач показывают последние две недели и не более двухсот карточек. Перетаскивать карточки между колонками нельзя: колонка объединяет несколько статусов, и статус меняется переходом в карточке задачи.

Роли, права и пользовательские действия

Доступные на доске действия зависят от прав пользователя в категории: базовые операции доступны пользователям с правом работы в категории; принудительная смена статуса — пользователям с правом «Администратор задач».

С карточками на доске доступны действия: открытие полной карточки задачи по клику; быстрые действия из контекстного меню карточки; смена статуса перетаскиванием карточек; сортировка карточек внутри колонки (по сроку, приоритету, дате создания и др.); фильтрация карточек по ДП; выбор группировок и агрегатов (если настроено шаблоном).

Представление категории «Канбан»

В представлении категории Канбан задачи отображаются в виде колонок по статусам основного маршрута. Если основной маршрут не настроен — выводятся все статусы категории, а над блоками появляется сообщение «Не настроен основной маршрут».

Масштаб и фильтры

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

• Масштаб регулируется кнопками увеличения/уменьшения; сброс к стандартному — по кнопке сброса.
• Доступны фильтры: по статусам основного маршрута («Все», «Активные», «Закрытые», «Отклонённые»), по преднастроенным отборам категории, по роли пользователя (исполнитель, заказчик, акцептант, «в параметрах»).
• Фильтрация карточек по значениям полей — через фильтры-чипы над доской. В списке доступных фильтров канбана категории присутствуют как дополнительные параметры категории, так и основные поля задачи; список упорядочен по названию поля. Состав основных полей берётся из настроек колонок табличного представления категории: системная колонка, доступная в таблице, попадает и в фильтры канбана — с тем же названием. В список входят только поля с поддерживаемым типом фильтра, а набор операций сравнения ограничен теми, что допустимы для этой колонки.
• Настройки фильтров сохраняются для текущей категории между сессиями.

Карточка канбана

Содержимое карточки конфигурируется администратором; приоритет и сроки выделяются визуально.

• Администратор может настроить произвольный набор полей в карточке (кроме заголовка) через шаблон карточки канбана.
• Исполнители отображаются аватарками; срок — бейджем (просроченные красным). При наведении на аватар или на значение ДП «Выбор пользователей» открывается мини-карточка профиля — так же, как и в карточке галереи, которая использует тот же конструктор.
• Приоритет отображается цветовой индикацией и индикатором (5 уровней: критичный, высокий, обычный, низкий, самый низкий).
• Цвет колонки статуса соответствует цвету, настроенному администратором. Завершающие статусы всегда зелёные, отклоняющие — красные (для них смена цвета недоступна).
• Прогресс по подзадачам показывается бейджем «выполнено/всего»; у задач без подзадач бейдж не отображается. Клик по бейджу разворачивает под карточкой список подзадач первого уровня: название с номером, аватар, статус, исполнители и счётчик собственных подзадач; клик по строке открывает карточку подзадачи. Список свёрнут по умолчанию, состояние раскрытия не сохраняется.
• Прогресс по тудулисту (мультилукап со схемой «Список задач (To-do)») показывается отдельным бейджем «выполнено/всего» со своей иконкой и полосой прогресса. В отличие от счётчика подзадач, этот бейдж появляется только у задач, где такой список есть. Клик по нему разворачивает список задач тудулиста прямо на карточке; по умолчанию он свёрнут. Задача из списка учитывается как выполненная, когда она одновременно завершена и закрыта.

Сортировка и перенос

Карточки допускают ручную сортировку внутри колонок и перенос между статусами перетаскиванием.

• Карточки можно сортировать внутри колонки по сроку, приоритету, дате создания и др. Сортировка выполняется в браузере и применяется ко всем колонкам одновременно. По умолчанию отключена; настройка сохраняется для текущей категории.
• Если администратор настроил фиксированный порядок сортировки на уровне вида канбана — перетаскивание внутри колонки недоступно.
• Смена статуса — перетаскиванием карточки между колонками. По умолчанию только в разрешённые переходы основного маршрута.
• Пользователи с правом «Администратор задач» могут включить режим принудительной смены статуса (меню «Прочее») — тогда перетаскивание работает между любыми статусами.
• В режиме принудительной смены статуса при перетаскивании доступные колонки-цели различаются визуально: статусы по маршруту задачи (штатный переход) и статусы вне маршрута (принудительный переход) подсвечиваются по-разному — видно, ведёт ли перенос по маршруту категории или это принудительный переход.

Канбан по Lookup-полю: в меню «Статус» можно выбрать Lookup-параметр категории — тогда колонки строятся по его значениям. При переносе карточки между колонками меняется значение Lookup в задаче. Есть специальная колонка «Не заполнено» для задач без значения.

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

Представление категории «Галерея»

В представлении категории Галерея задачи отображаются сеткой карточек одинакового размера.

• По умолчанию в каждой карточке галереи отображаются заголовок задачи, исполнитель и срок.
• Администратор может расширить состав карточки дополнительными параметрами категории и обложкой, включая системные теги. Включить и отключить можно любые поля, кроме заголовка карточки.
• Настройка шаблона карточки выполняется администратором отдельно для вида «Галерея».
• В веб-интерфейсе карточка галереи строится по шаблону карточки категории — из него используется контекст «Галерея». Шаблон запрашивается отдельным обращением к /api/subcategories/templates по идентификатору категории и возвращается в варианте для того типа клиента, с которого пришёл запрос; лента задач при этом отдаёт только данные карточек — дополнительные параметры и исполнителей.
• Клик по карточке открывает задачу в текущей вкладке. Для открытия в новой вкладке используется контекстное меню (правая кнопка мыши по карточке).

Связи с другими доменами

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

• tasks/business.md — жизненный цикл и переходы задач;
• categories/business.md — включение канбана и галереи как представлений категории;
• ext-params/business.md — канбан по Lookup и фильтрация по ДП;
• grids/business.md — другие представления категории (таблица);
• users-and-groups/business.md — персональный канбан пользователя.