Фильтры позволяют быстро находить нужные задачи на доске, в таблице и других представлениях. Доступны два режима: визуальный фильтр по критериям и текстовые запросы TQL.
Панель фильтров
Кнопка «Фильтры» расположена в шапке проекта. При наличии активных фильтров на кнопке отображается индикатор. Рядом с кнопкой появляется кнопка сброса для быстрого снятия всех фильтров.
Над доской или таблицей отображается строка активных фильтров с перечислением применённых критериев и кнопкой «Сбросить».
В обычном режиме фильтрация выполняется через раскрывающиеся секции (аккордеоны) по критериям.
Критерий | Описание |
|---|---|
Название | Поиск по названию задачи |
Ключ задачи | Поиск по номеру/ключу задачи (если включено отображение ключей) |
Участники | Выбор одного или нескольких участников. Доступна опция «Без участника» |
Срок | Фильтрация по дедлайну: без даты, в течение суток, недели или месяца |
Теги | Выбор тегов проекта |
Статус | Фильтрация по колонке/статусу (доступно в табличном представлении) |
Тип задачи | Выбор типа: задача, баг, история и т. д. |
Приоритет | Выбор уровня приоритета |
Активность | За день, за неделю, за месяц или без активности за месяц |
Связи | По наличию родительских/дочерних задач или связей |
Чек-листы | По дедлайну элементов: в течение суток или просроченные |
Кастомные поля | Фильтрация по пользовательским полям (если поле настроено для отображения в фильтрах) |
Режим | Описание |
|---|---|
Полное (И) | Задача должна соответствовать всем выбранным критериям |
Любое (ИЛИ) | Достаточно совпадения хотя бы по одному критерию |
Опция | Описание |
|---|---|
Не родители и не потомки | Задачи без иерархических связей |
Родители, но не потомки | Только родительские задачи |
Потомки, но не родители | Только дочерние/подзадачи |
Потомки и родители | Задачи с любыми иерархическими связями |
Только связанные | Задачи, у которых есть хотя бы одна связь |
TQL (Task Query Language) — язык запросов для продвинутой фильтрации задач. Запросы выполняются на сервере, что позволяет строить сложные условия, недоступные в обычном режиме.
Режим TQL в фильтрах
Запрос строится по шаблону:
ПОЛЕ ОПЕРАТОР ЗНАЧЕНИЕ [AND|OR ПОЛЕ ОПЕРАТОР ЗНАЧЕНИЕ ...]Поле | Тип | Описание |
|---|---|---|
| Строка | Название задачи |
| Строка | Уникальный идентификатор задачи |
| Строка | Номер/ключ задачи (Git-метка) |
| Выбор | Статус задачи |
| Выбор | Колонка, в которой находится задача |
| Выбор | Приоритет задачи (значения настраиваются в проекте) |
| Выбор | Тип задачи (задача, баг, история и т. д.) |
| Выбор | Тип карточки (task, milestone) |
| Множ. выбор | Теги задачи |
| Участники | Исполнители задачи (указываются по имени) |
Поле | Тип | Описание |
|---|---|---|
| Дата | Плановая дата начала |
| Дата | Плановая дата завершения |
| Дата | Дата создания задачи |
| Дата | Дата последнего обновления |
Поле | Тип | Описание |
|---|---|---|
| Число | Плановая трудоёмкость |
| Число | Затраченное время |
Поле | Тип | Описание |
|---|---|---|
| Число | Количество вложений |
| Число | Количество комментариев |
| Число | Общее количество элементов чек-листа |
| Число | Количество выполненных элементов чек-листа |
| Логическое | Есть ли описание |
| Логическое | Есть ли ссылки |
| Логическое | Есть ли метка |
Поле | Тип | Описание |
|---|---|---|
| Логическое | Задача в архиве |
| Логическое | Перемещение разрешено |
| Логическое | Задача является мероприятием |
| Логическое | Отображается в календаре |
| Логическое | Уведомление включено |
| Логическое | Дедлайны чек-листа в календаре |
Поле | Тип | Описание |
|---|---|---|
| Число | Количество открытых мердж-реквестов |
| Логическое | Есть ли зеркала задачи |
| Строка | Источник зеркала |
Поле | Тип | Описание |
|---|---|---|
| Строка | ID проекта |
| Строка | ID рабочего пространства |
| Число | Порядковый номер в колонке |
| Число | Порядковый номер на диаграмме Ганта |
Значения полей типа «Выбор» (приоритет, тип задачи, теги и др.) зависят от настроек конкретного проекта. Автодополнение в редакторе подскажет актуальные варианты.
Доступные операторы зависят от типа поля:
Оператор | Описание | Типы полей |
|---|---|---|
| Равно | Все |
| Не равно | Все |
| Меньше | Число |
| Меньше или равно | Число, Дата |
| Больше | Число |
| Больше или равно | Число, Дата |
| Одно из значений | Выбор, Множ. выбор, Дата, Участники |
| Отрицание | Выбор, Множ. выбор, Строка, Дата, Участники |
| Содержит | Строка, Множ. выбор, Участники |
| Начинается с | Строка |
| Заканчивается на | Строка |
Оператор | Описание |
|---|---|
| Оба условия должны выполняться |
| Достаточно одного из условий |
| Отрицание условия |
Используются вместо конкретных дат для динамических запросов:
Функция | Описание |
|---|---|
| Текущая дата и время |
| Начало текущего дня |
| Конец текущего дня |
| Начало текущей недели |
| Конец текущей недели |
| Начало текущего месяца |
| Конец текущего месяца |
| Начало текущего года |
| Конец текущего года |
Функция | Описание |
|---|---|
| Текущий авторизованный пользователь |
Тип поля | Формат | Пример |
|---|---|---|
Строка | В кавычках |
|
Число | Без кавычек |
|
Дата |
|
|
Логическое |
|
|
Выбор | Значение варианта |
|
Участники | Полное имя в кавычках |
|
Список ( | В скобках через запятую |
|
priority = high AND taskType = bugВсе баги с высоким приоритетом.
members = "Иван Иванов" OR members = "Мария Петрова"Задачи Ивана или Марии.
planEnd <= endOfWeek() AND isArchive = falseНезаархивированные задачи с дедлайном до конца текущей недели.
tags CONTAINS important AND commentsAmount >= 5Задачи с тегом «important» и 5+ комментариями.
title STARTS_WITH "TASK-" AND createdAt >= startOfMonth()Задачи, название которых начинается с «TASK-», созданные в этом месяце.
members = currentUser() AND planStart >= startOfWeek()Мои задачи, начинающиеся на этой неделе.
checksAmount > 0 AND checksCompleteAmount = checksAmountЗадачи, у которых все элементы чек-листа выполнены.
Редактор TQL поддерживает контекстные подсказки на каждом шаге:
Начало запроса / после логического оператора — предлагает имена полей
После поля — предлагает операторы, допустимые для этого типа поля
После оператора — предлагает значения: варианты выбора, имена участников, true/false или функции дат
После значения — предлагает логические операторы AND, OR
Используйте Ctrl+Space для вызова подсказок и Tab для выбора варианта.
При наличии ошибок в запросе проблемный фрагмент подсвечивается красным. Наведите курсор на подсвеченный текст, чтобы увидеть описание ошибки.
Часто используемые фильтры можно сохранить для быстрого доступа. Обычные фильтры и TQL-запросы сохраняются отдельно.
Настройте нужные критерии (или напишите TQL-запрос).
Нажмите «Сохранить».
Укажите название.
При необходимости отметьте «Общий фильтр доступный всей команде» — фильтр будет виден всем участникам проекта.
Применить — нажмите на сохранённый фильтр в списке
Редактировать — измените критерии и сохраните заново
Переименовать — измените название сохранённого фильтра
Удалить — удалите фильтр с подтверждением
Сохранённые фильтры
Действие | Описание |
|---|---|
Сбросить всё | Кнопка в панели фильтров — снимает все критерии |
Сбросить критерий | Кнопка в каждом аккордеоне — снимает только этот критерий |
Сбросить (шапка) | Кнопка рядом с кнопкой «Фильтры» — снимает все фильтры |
Сбросить (строка) | Кнопка в строке активных фильтров над доской/таблицей |
При переходе между проектами фильтры сбрасываются автоматически.