Фильтры оставляют на экране только нужные задачи. Они работают на доске, в таблице, бэклоге, релизах, календаре, диаграмме Ганта, на холсте и в нагрузке, а также при экспорте задач. Фильтр задаётся в одном из двух режимов: «Обычный» — выбором из списков, или «TQL» — текстовым запросом.
Окно «Поиск и фильтрация»
Кнопка «Фильтры» в шапке проекта открывает окно «Поиск и фильтрация». Когда фильтр задан, на кнопке появляется галочка, а рядом — кнопка «×» «Сбросить фильтр». На страницах графиков, документов и настроек кнопки нет.
На доске, доске с группами и в таблице над задачами появляется строка с выбранными значениями и кнопкой «Сбросить».
Кнопка со значком воронки и плюса справа от «Фильтров» показывает над задачами полосу быстрых фильтров — на всех страницах, где есть «Фильтры». Кнопка запоминает, показана полоса или нет.
«Поиск по названию» — задачи, в названии которых есть введённый текст
«Мои задачи» — задачи, где вы участник
«Высокий приоритет» — задачи с высоким приоритетом
«Срок истекает в течение суток» — задачи со сроком в ближайшие 24 часа
«Мои фильтры» — сохранённые фильтры: применить, сохранить текущий, изменить или удалить
Полоса быстрых фильтров
Быстрые фильтры меняют те же критерии, что и окно «Фильтры»: например, «Мои задачи» отмечает вас в секции «Участники». Сбрасываются они так же — кнопкой «×» рядом с «Фильтрами».
Выбранные значения применяются сразу, кнопки «Применить» нет. Внизу окна: «Сбросить» — снять все фильтры, «Сохранить» — сохранить фильтр в «Мои фильтры». В заголовке каждой секции — число выбранных значений и кнопка «Сбросить» этой секции.
Критерий | Описание |
|---|---|
Название | Задачи, в названии которых есть введённый текст, без учёта регистра |
Ключ задачи | Задача с точно таким ключом. Поле есть, если в настройках включён ключ задачи |
Участники | По участникам задачи; «Без участника» — задачи без участников |
Срок | «Без даты» или срок истекает в течение суток, недели, месяца |
Теги | По тегам задачи |
Этап | По колонке доски |
Тип задачи | По типу задачи |
Приоритет | По приоритету; «Без приоритета» — задачи без него |
Категория статуса | «Не указано», «Не начато», «В процессе», «Выполнено», «Отменено» |
Спринт | По спринту; «Бэклог» — задачи без спринта. Есть, если в проекте есть спринты |
Активность | Когда задачу меняли: за день, неделю, месяц или «Без активности за месяц» |
Связи | По иерархии и связям задачи — см. ниже |
Чек-листы | Срок пункта истекает в течение суток или пункты просрочены |
Время нахождения в колонке | Сколько дней задача стоит в текущей колонке: больше, меньше, равно или между |
Зависшие задачи | Задачи, которые стоят в колонке больше 7, 14, 28 или 56 дней либо дольше порога из настроек проекта |
Дата | Дата создания, изменения, попадания в колонку, начала или срок — за сегодня, вчера, последние 7 или 30 дней, этот или прошлый месяц, произвольный диапазон |
Релизы | По версии. Есть, если в проекте есть релизы |
Трудозатраты | Требуемое и затраченное время: больше, меньше, равно или между |
Содержимое | Есть описание, вложения, комментарии, чек-листы, референсы, зеркала или открытые merge request |
Кастомные поля | Поля, у которых включено «Добавить поле в фильтр в шапке проекта», — см. Кастомные поля |
Режим | Описание |
|---|---|
«Полное (И)» | Задача подходит под все заданные секции; в участниках, тегах, релизах, спринте, чек-листах и содержимом — под все выбранные значения. Выбран по умолчанию |
«Любое (ИЛИ)» | Достаточно одного совпадения |
В сроке, активности, этапе, типе, приоритете и категории статуса выбранные значения всегда объединяются через «или».
Опция | Какие задачи |
|---|---|
«Не родители и не потомки» | Без родительской задачи и без подзадач |
«Родители, но не потомки» | Есть подзадачи, но сама не подзадача — верхний уровень дерева |
«Потомки, но не родители» | Подзадача без своих подзадач |
«Потомки и родители» | Одновременно подзадача и родитель — середина дерева |
«Только связанные» | Есть хотя бы одна связь любого типа |
TQL — язык запросов к задачам. Переключитесь на «TQL», введите запрос в поле «Запрос TQL» и нажмите «Найти»; «Сбросить» снимает запрос. Значок ⓘ рядом с полем напоминает операторы и функции.
Режим TQL с подсказкой полей
Запрос — одно или несколько условий «поле оператор значение», соединённых логическими операторами. Условия можно брать в скобки.
ПОЛЕ ОПЕРАТОР ЗНАЧЕНИЕ [AND|OR [NOT] ПОЛЕ ОПЕРАТОР ЗНАЧЕНИЕ ...]Поля сгруппированы так же, как в подсказке редактора. Имя поля пишется точно, как в таблице.
Поле | Тип | Описание |
|---|---|---|
title | Строка | Название задачи |
taskStatus | Выбор | Категория статуса |
columnId | Выбор | Этап — колонка доски |
priority | Выбор | Приоритет |
taskType | Выбор | Тип задачи |
tags | Множ. выбор | Теги |
members | Участники | Участники задачи |
releases | Множ. выбор | Релизы |
sprint | Выбор | Спринт |
timeRequired | Число | Требуемое время |
timeSpent | Число | Затраченное время |
Поле | Тип | Описание |
|---|---|---|
planStart | Дата | Дата начала |
planEnd | Дата | Срок |
factStart | Дата | Фактическое начало |
factEnd | Дата | Фактическое окончание |
createdAt | Дата | Дата создания |
updatedAt | Дата | Дата изменения |
entryColumnDate | Дата | Дата попадания в колонку |
Поле | Тип | Описание |
|---|---|---|
attachmentsAmount | Число | Количество вложений |
commentsAmount | Число | Количество комментариев |
checksAmount | Число | Количество пунктов чек-листов |
checksCompleteAmount | Число | Количество выполненных пунктов |
hasDescription | Логическое | Есть описание |
hasReferences | Логическое | Есть референсы |
hasMirrors | Логическое | Есть зеркала |
mirrorOf | Строка | Зеркало задачи — идентификатор исходной задачи |
Поле | Тип | Описание |
|---|---|---|
gitLabel | Строка | Ключ задачи в Git |
openedMergesCount | Число | Количество открытых merge request |
Поле | Тип | Описание |
|---|---|---|
id | Строка | Идентификатор задачи |
subColumnId | Выбор | Подколонка |
cardType | Выбор | Вид карточки: задача, веха, разделитель |
isArchive | Логическое | Задача в архиве |
isEvent | Логическое | Мероприятие |
isMoveAllowed | Логическое | Перенос разрешён |
planTaskInCalendar | Логическое | Показывать в календаре |
planIsNotificationRequired | Логическое | Нужно уведомление |
showChecklistDeadlineInCalendar | Логическое | Дедлайны чек-листа в календаре |
columnSortNum | Число | Порядок в колонке |
sortNumberRoadmap | Число | Порядок на диаграмме Ганта |
В подсказке видно название поля; в запрос вставляется его идентификатор вида customFields.<id>.
Значения полей «Выбор» и «Множ. выбор» — точное название варианта, как в проекте, с учётом регистра, например High или Bug.
Оператор | Описание | Поля |
|---|---|---|
= | Равно; у тегов, участников и релизов — «есть такое значение» | Все |
!= | Не равно | Все |
< <= > >= | Меньше, не больше, больше, не меньше | Числа и даты |
IN (…) | Одно из значений списка | Все |
NOT IN (…) | Ни одно из значений списка | Все |
CONTAINS | Содержит текст, без учёта регистра | title, gitLabel, priority, taskType, taskStatus, cardType, кастомные поля |
STARTS_WITH | Начинается с текста | Те же |
ENDS_WITH | Заканчивается текстом | Те же |
Оператор | Описание |
|---|---|
AND | Выполняются оба условия |
OR | Выполняется хотя бы одно условие |
NOT | Условие не выполняется; ставится перед условием |
( ) | Группируют условия; без скобок AND связывает сильнее OR |
Логические операторы пишутся прописными буквами.
Используются как значение для полей-дат. Аргументов не принимают, считаются по UTC.
Функция | Описание |
|---|---|
now() | Текущие дата и время |
startOfDay() / endOfDay() | Начало и конец сегодняшнего дня |
startOfWeek() / endOfWeek() | Начало и конец текущей недели, с понедельника |
startOfMonth() / endOfMonth() | Начало и конец текущего месяца |
startOfYear() / endOfYear() | Начало и конец текущего года |
Функция | Описание |
|---|---|
currentUser() | Текущий пользователь — значение для поля members |
Тип | Формат | Пример |
|---|---|---|
Строка | В двойных кавычках, если есть пробелы | title = "Исправить баг" |
Число | Без кавычек | timeSpent = 10 |
Дата | ГГГГ-ММ-ДД или функция; «=» означает весь день | planStart = 2025-03-01 |
Логическое | true или false | hasDescription = true |
Выбор | Точное название варианта | priority = High |
Участники | Полное имя в кавычках или currentUser() | members = "Иван Иванов" |
Список | Значения через запятую в скобках | priority IN (High, Middle) |
priority = High AND taskType = BugЗадачи с высоким приоритетом типа Bug.
members = "Иван Иванов" OR members = "Мария Петрова"Задачи, где участвует Иван Иванов или Мария Петрова.
planEnd <= endOfWeek() AND hasDescription = trueЗадачи с описанием и сроком до конца недели.
tags = Важно AND commentsAmount >= 5Задачи с тегом «Важно» и не меньше чем пятью комментариями.
title STARTS_WITH "TASK-" AND createdAt >= startOfMonth()Задачи, название которых начинается с «TASK-», созданные в этом месяце.
members = currentUser() AND planStart >= startOfWeek() AND planStart <= endOfWeek()Мои задачи, которые начинаются на этой неделе.
taskStatus != Выполнено AND planEnd < now()Просроченные невыполненные задачи.
Пока курсор в поле запроса, под ним открывается подсказка:
В начале запроса и после AND / OR — поля: название и справа имя поля, по группам. Подсказка ищет по названию и по имени.
После поля — операторы.
После оператора — значения: варианты поля, участники и currentUser(), true / false, функции дат.
После значения — AND, OR и NOT.
Tab переводит фокус в подсказку и по её пунктам, Enter или щелчок вставляет пункт, Ctrl + Space скрывает и снова показывает подсказку.
Ошибочный фрагмент подчёркивается красным, при наведении видно, что не так; в углу поля — зелёная галочка или красный крестик. Если сервер не смог выполнить запрос, появится сообщение об ошибке, а список задач станет пустым.
Часто используемый фильтр можно сохранить. Обычные фильтры и TQL-запросы хранятся отдельно: «Мои фильтры» и «Мои запросы» — кнопка со звёздочкой в окне фильтров. Фильтры сохраняются в проекте.
Настройте фильтр или введите запрос.
Нажмите «Сохранить» внизу окна.
Введите «Название» — оно должно отличаться от названий ваших и общих фильтров проекта.
Отметьте «Общий фильтр доступный всей команде», чтобы фильтр видели все участники проекта.
Нажмите «Сохранить».
Окно «Сохранение фильтра»
Применить — нажмите на фильтр в списке
Изменить — карандаш: поправьте критерии, затем название и «Общий»
Удалить — корзина, с подтверждением
Изменять и удалять фильтр может только его автор.
Действие | Где |
|---|---|
«Сбросить» | Внизу окна фильтров — снять все фильтры |
«Сбросить» в секции | В заголовке секции — снять только её |
«×» «Сбросить фильтр» | Рядом с кнопкой «Фильтры» — снять всё, включая TQL |
«Сбросить» в строке | В строке выбранных значений над доской или таблицей |
Внутри проекта фильтры сохраняются при переходе между доской, таблицей и другими представлениями. При переходе в другой проект, на страницу без фильтров или после перезагрузки страницы они сбрасываются. В добавленных разделах фильтры хранятся в самом разделе.