Как отфильтровать задачи на доске с помощью языка запросов

Язык запросов позволяет задать сложные условия поиска задач с операциями сравнения и логическими операторами.

На доске задач c помощью языка запросов можно:

• Выбирать задачи для автоматического добавления на доску: Как настроить автоматическое добавление задач.

• Настроить быстрые фильтры, чтобы отображать или скрывать задачи на доске или в бэклоге.

Формат запросов

Чтобы задать фильтр задач с помощью языка запросов:

1. Откройте страницу, на которой хотите использовать запрос:

   • На странице доски или бэклога в правом верхнем углу включите опцию  Фильтры, затем нажмите QL.

   • На странице настройки доски в блоке Добавление задач на доску включите опцию Язык запросов.

2. Введите запрос:

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

     Ключи параметров можно узнать в Трекере на странице Поля задачи.

   • Укажите значение параметра, по которому хотите отфильтровать задачи.

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

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

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

3. Сохраните фильтр или настройки доски.

Общий формат записи запроса:

<название параметра 1>: <значение 1> AND <название параметра 2>: <значение 2>

Примеры

• Задачи, входящие в очередь TEST:

  

• Задачи, исполнитель в которых — Иван Иванов:

  

• Задачи со статусами «Открыт» или «В работе».

  

• Задачи, созданные после 1 сентября 2024 года:

  

Несколько значений параметра

Если вы хотите отфильтровать задачи по нескольким значениям одного параметра, перечислите значения запятую:

<параметр>: <значение 1>, <значение 2>, <значение 3>

Пример

Тип: Задача, Ошибка

Такой фильтр выведет все задачи, которые имеют тип «Задача» или «Ошибка».

Фильтры с несколькими условиями

Вы можете объединять несколько условий в одном фильтре с помощью логических операторов:

• AND — логический оператор И. Условия, объединенные таким оператором, должны выполняться одновременно.

  Пример:

  Тип: Задача AND Статус: В работе
  

  Такой запрос выведет задачи, у которых одновременно тип имеет значение «Задача» и статус имеет значение «В работе».

• OR — логический оператор ИЛИ. Должно выполняться хотя бы одно из условий, объединенных таким оператором.

  Пример:

  Тип: Ошибка OR Компоненты: Тестирование
  

  Такой запрос выведет задачи, у которых выполнено хотя бы одно из условий: тип имеет значение «Ошибка» или в поле Компоненты есть значение «Тестирование».

Вы можете создавать сложные фильтры, комбинируя несколько операторов в одном запросе:

Тип: Задача AND Автор: Иван Иванов OR Компоненты: Тестирование

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

Тип: Задача AND (Автор: Иван Иванов OR Компоненты: Тестирование)

Поиск по тексту

С помощью языка запросов вы можете искать по текстовым параметрам задачи, например названию или описанию.

Если в тексте для поиска несколько слов, возьмите его в кавычки. Например:

Описание: "Новая задача"

Поиск по локальным полям

Чтобы указать в запросе значение локального поля задачи:

1. Начните вводить название или ключ локального поля.

   В подсказке после названия локального поля отобразится название очереди, к которой оно относится.

   

2. Выберите параметр, который относится к вашей очереди.

3. Укажите значение для поиска.

Параметры даты и времени

• Чтобы указать дату в качестве значения параметра задачи, используйте формат: YYYY-MM-DD. Пример:

  2024-10-30
  

• Чтобы указать, что значение параметра больше или меньше определенной даты, используйте операции сравнения. Пример:

  Создано: >= 2024-10-30
  

Операции сравнения

Кроме проверки на точное совпадение значений, язык запросов поддерживает операции сравнения:

• Не равно

  <параметр>: !<значение>
  

• Больше, Меньше, Меньше или равно, Больше или равно

  Операции применяются только для числовых параметров и параметров даты и времени.

  <параметр>: > <число>
  <параметр>: < <число>
  <параметр>: >= <число>
  <параметр>: <= <число>
  

Пример:

Story Points: > 8

Функции

Язык запросов поддерживает функцию empty(), которая означает, что параметр не задан. Например:

Исполнитель: empty()

Резолюция: empty()