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

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

  • Объединять условия поиска с помощью логических операторов «И», «ИЛИ», «НЕ» и группировать их с помощью скобок.
  • Сравнивать числовые значения и даты (больше, меньше, равно, в диапазоне).
  • Использовать функции для работы с датами и пользователями.
  • Отсортировать список с результатами поиска по возрастанию или убыванию сразу нескольких параметров.

Куда ввести запрос

Запрос — это выражение, в котором перечислены условия поиска задач. Запрос нужно вписать в специальную строку на странице поиска.

Строка для запросов есть не только на странице «Все задачи», но и в списках задач очередей, проектов, портфелей и досок, а также в настройках виджетов.

  1. Откройте список задач с расширенными возможностями поиска: нажмите Задачи → Все задачи или перейдите по ссылке https://tracker.yandex.ru/issues

  2. Справа вверху нажмите кнопку Язык запросов.

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

  4. Чтобы свернуть подсказки и применить фильтр, нажмите любую свободную область на экране.

Как сформулировать запрос

Условие можно ввести тремя способами, их можно комбинировать в одном запросе:

  1. С названием параметра на русском языке: "Затрачено времени": "1ч 30м"
  2. С названием параметра на английском языке: "Time Spent": "1h 30m"
  3. С идентификатором параметра: spent: "1h 30m"

Названия и идентификаторы параметров можно проверить на странице https://tracker.yandex.ru/admin/fields .

  • Если название параметра или его значение состоит из нескольких слов, возьмите их в кавычки.

    Найти задачи, которые выполняет Иван Иванов: Исполнитель: "Иван Иванов"

    Найти закрытые задачи: Статус: Закрыт


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

    Найти задачи в статусах «Открыт» и «В работе»: Статус: Открыт, "В работе"


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

    Найти задачи очереди «TEST» в статусах «Открыт» и «В работе»: Очередь: TEST Статус: Открыт, "В работе"

Как изменить порядок действий

Логические операторы можно ввести только на английском языке.

  • AND — логический оператор «И». Нужен, чтобы найти задачи, которые соответствуют всем перечисленным условиям одновременно.
    Это оператор по умолчанию, он применяется каждый раз, когда вы перечисляете условия через пробел.

    Найти задачи очереди «TEST» в одном из статусов: «Открыт» или «В работе»:
    Очередь: TEST AND Статус: "В работе"
    Очередь: TEST Статус: "В работе"


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

    Найти задачи, где исполнитель Иван Иванов или Петр Петров:
    Исполнитель: "Иван Иванов" OR Исполнитель: "Петр Петров"


  • Если вы ввели несколько условий, сначала применяются операторы «И», затем «ИЛИ». Чтобы изменить порядок действий, объедините условия с помощью скобок: они проверяются в первую очередь, как в арифметических выражениях.

    Найти задачи очереди «TEST» со статусом «Открыт» или «В работе»:
    Очередь: TEST AND (Статус: Открыт OR Статус: "В работе")

    Тот же запрос без скобок
    Найти задачи в очереди «TEST» со статусом «Открыт», или все доступные вам задачи со статусом «В работе»:
    Очередь: TEST AND Статус: Открыт OR Статус: "В работе"

Как указать диапазон значений

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

Оператор Пример
Не равно ! Найти незакрытые задачи: Статус: !Закрыт
Больше > Найти задачи, созданные после 31 января 2025 года: Создано: >"2025-01-31"
Меньше < Найти задачи, созданные раньше 1 января 2025 года: Обновлено: <"2025-01-01"
Больше или равно >= Найти задачи, где оценка трудозатрат больше или равна 5 Story Points: "Story Points": >=5
Меньше или равно <= Найти задачи, где оценка трудозатрат меньше или равна 10 Story Points: "Story Points": <=10
В диапазоне .. Найти задачи, где оценка трудозатрат от 3 до 5 Story Points включительно: "Story Points": 3..5

Как указать функцию в значении параметра

Функция — это выражение, вместо которого в момент запроса будет подставлено полезное значение: например, сегодняшняя дата или имя пользователя.

Тип параметра можно проверить на странице https://tracker.yandex.ru/admin/fields .

Функция

Что возвращает

Где использовать

empty()

Пустое значение (параметр не задан)

Любые параметры задач.

Найти задачи без исполнителя: Исполнитель: empty()

notEmpty()

Любое непустое значение

Любые параметры задач.

Найти задачи с назначенным дедлайном: Deadline: notEmpty()

me()

Имя текущего пользователя

Для параметров с типом Пользователь.

Найти ваши задачи: Исполнитель: me()

today()

Сегодняшняя дата

Для параметров с типом Дата.

Найти задачи, созданные сегодня: Created: today()

now()

Текущее время

Для параметров с типом Время и дата.

Найти задачи, созданные за последние 12 часов: Created: >now()-12h

week()

Текущая неделя

Для параметров с типом Дата.

Найти задачи, созданные на этой неделе: Created: week()

month()

Текущий месяц

Для параметров с типом Дата.

Найти задачи, созданные в этом месяце: Created: month()

quarter()

Текущий квартал

Для параметров с типом Дата.

Найти задачи, созданные в этом квартале: Created: quarter()

year()

Текущий год

Для параметров с типом Дата.

Найти задачи, созданные в этом году: Created: year()

unresolved()

Резолюция не задана

Только для параметра Резолюция.

Найти задачи без резолюции: Resolution: unresolved()

group()

Список сотрудников подразделения

Для параметров с типом Пользователь.

Найти задачи сотрудников отдела: Исполнитель: group(value: "Коммерческий отдел")

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

Найти задачи, созданные вчера: Создано: today()-1d

Найти задачи с дедлайном в течение недели: Дедлайн: today()..today()+1w

Как искать по тексту

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

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

  • Задача — название задачи.
  • Описание — описание задачи.
  • Комментарий — текст комментария.
  • История — текст в истории изменений.

Найти точное совпадение

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

Найти задачи, в названии которых есть фрагмент текста «Version 2.0» с учетом регистра: Задача: #"Version 2.0"

Экранировать служебный символ

Когда в тексте есть символы " и \, их нужно экранировать с помощью обратного слеша \, чтобы Трекер правильно прочитал ваш запрос.

Найти задачи со словом «Избранное» в записях истории изменений: История: #"\"Избранное\""

Найти задачи с текстом «Вкл\Выкл» в описании: Описание: #"Вкл\\Выкл"

Исключить фрагмент из поиска

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

Найти задачи, в названии которых нет слова «UI»: Задача: !"UI"

Как указать пользователя

  • В значении параметра с типом «Пользователь» можно указать имя или логин. По умолчанию Трекер будет искать совпадение хотя бы с одним словом из запроса.

    Найти задачи, где автор — Иван Иванов: Автор: "Иван Иванов"

    Найти задачи, где наблюдатель — это пользователь с именем Иван и любой фамилией: Наблюдатели: Иван

    Найти задачи, где наблюдатель — это пользователь с логином ivan@ или пользователь с именем Ivan (если имя указано по-английски): Наблюдатели: ivan


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

    Найти задачи исполнителя с логином user3370: Исполнитель: user3370@

Как указать дату или время

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

Указать дату изменения задачи

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

  • MM/DD/YYYY: 04/30/2025
  • DD.MM.YYYY: 30.04.2025
  • DD-MM-YYYY: 30-04-2025
  • YYYY-MM-DD: 2025-04-30

Найти задачи исполнителя с логином «ivan», которые он взял в работу после 1 декабря 2025 года: Исполнитель: ivan@ "Дата начала": >"2025-12-01"

Указать затраченное время

Единицы измерения времени можно указывать с помощью русских или английских сокращений. Например, отрезок времени в 2 месяца 3 дня 5 часов и 32 минуты можно записать как "2M 3d 5h 32m" или "2М 3д 5ч 32м".

Найти задачи исполнителя с логином «ivan» за текущий месяц, над которыми он работал 3 часа и больше: Исполнитель: ivan@ "Дата начала": month() "Затрачено времени": >=3h

Указать интервал дат или времени

Задать интервал дат можно с помощью символов .. в любом допустимом формате записи: дата начала..конечная дата.

Найти задачи, созданные с 1 января по 2 марта 2025 года: Создано: 01-01-2025..02-03-2025

Найти задачи с дедлайном вчера, сегодня или завтра: Дедлайн: today()-1d..today()+1d

Как искать по локальному полю задачи

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

Найти задачи, где в локальном поле «Разработчик» указан Иван Иванов: DEVS.Разработчик: "Иван Иванов"

Найти задачи, где в локальном поле «Ведущий тестировщик» указан пользователь с логином «user3370»: TEST."Ведущий тестировщик": "user3370@"

Как искать по изменениям параметра

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

параметр: changed(from: "старое значение" to: "новое значение" by: "кто изменил" date: "когда изменил")

Найти задачи, которые Иван Иванов взял в работу с 1 по 15 сентября 2025 года:
Статус: changed(to: "В работе" by: "Иван Иванов" date: "01.09.2025..15.09.2025")

В запросе необязательно указывать все критерии. Например, оставьте только «from» и «by».

Как отсортировать результаты поиска

Параметр сортировки можно ввести только на английском языке.

  • Чтобы отсортировать список задач, в конце запроса добавьте "Sort By": параметр сортировки.

    Отсортировать задачи в очереди «TEST» по дате создания: Очередь: TEST "Sort By": Created


  • Если нужно, задайте порядок сортировки по возрастанию (ASC) или по убыванию (DESC).

    Отсортировать задачи в очереди «TEST» по убыванию даты создания: Очередь: TEST "Sort By": Created DESC


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

    Отсортировать задачи в очереди «TEST» по убыванию даты создания, а задачи с одинаковой датой — по возрастанию даты обновления: Очередь: TEST "Sort By": Создано DESC, Обновлено ASC

Справочник параметров задач

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

Базовые параметры задачи

Эти параметры отображаются на странице задачи или на панели слева.

Описание Название параметра Значение параметра
Найти задачи с указанными ключами. Ключ или Key Ключ задачи.

Key: TASK-123, TASK-321
Найти задачи в указанной очереди. Очередь или Queue Ключ очереди.

Queue: TEST
Найти задачи, описание которых содержит определенный текст. Описание или Description Строка текста.


• Описание: "изобрести велосипед" — описание содержит хотя бы одно слово или словоформу.
• Описание: #"изобрести велосипед" — описание содержит точное совпадение.
Найти задачи, название которых содержит определенный текст. Задача или Summary Строка текста.


• Summary: "изобрести велосипед" — название содержит хотя бы одно слово или словоформу.
• Summary: #"изобрести велосипед" — название содержит точное совпадение.
Найти задачи, где есть комментарии с определенным текстом. Комментарий или Comment Строка текста.


• Comment: "отличная работа" — комментарий содержит хотя бы одно слово или словоформу.
• Comment: #"отличная работа" — комментарий содержит точное совпадение.
Найти задачи, в истории изменений которых есть определенный текст. История или History Строка текста.


• History: "В ответ на" — история содержит хотя бы одно слово или словоформу.
• History: #"В ответ на" — история содержит точное совпадение.
Найти задачи, где в поле Исполнитель указаны выбранные пользователи. Исполнитель или Assignee Логин или имя пользователя.

Исполнитель: user3370@, "Иван Иванов"
Найти задачи, где в поле Автор указаны выбранные пользователи. Автор или Author Логин или имя пользователя.

Автор: user3370@, "Иван Иванов"
Найти задачи, где в поле Наблюдатели указаны выбранные пользователи. Наблюдатели или Followers Логин или имя пользователя.

Наблюдатели: user3370@, "Иван Иванов"
Найти задачи, где в поле Доступ указаны выбранные пользователи. Доступ или Access Логин или имя пользователя.

Access: user3370@, "Иван Иванов"
Найти задачи, где используются выбранные компоненты. Компоненты или Components Название компонента.

Components: бекенд, фронтенд
Найти задачи, созданные в выбранный день или интервал дат. Создано или Created Дата или интервал дат.

Created: 2025-01-01..2025-01-30
Найти задачи, где в поле Дедлайн указан выбранный день или интервал дат. Дедлайн или Deadline Дата или интервал дат.

Deadline: 2025-01-30
Найти задачи, где в поле Дата завершения указан выбранный день или интервал дат. "Дата завершения" или "End Date" Дата или интервал дат.

"End Date": 2025-01-30
Найти задачи с определенным приоритетом. Приоритет или Priority Название приоритета на русском или английском языке.

Priority: Minor, Средний
Найти задачи, которые были решены (закрыты с резолюцией) в выбранный день или в заданном интервале дат. Разрешен или Resolved Дата или интервал дат.

Resolved: 2025-01-01..2025-01-30
Найти задачи, которые находятся в определенных статусах. Статус или Status Название статуса на русском или английском языке.

Статус: Open
Найти задачи, отмеченные определенными тегами. Теги или Tags Название тега.

Tags: Поддержка, wiki
Найти задачи с определенным типом. Тип или Type Тип задачи.

Type: Epic
Найти задачи, где в поле Найдено в версиях указано заданное значение. "Найдено в версиях" или "Affected Version" Название версии.

"Affected Version": "Декабрь'25"
Найти задачи, где определенных пользователей призвали в комментарии. "Нужен ответ пользователя" или "Pending Reply From" Логин или имя пользователя.

"Pending Reply From": user3370@, "Иван Иванов"
Найти задачи, где пользователю ответили без призыва. "Пользователь получил ответ" или "Received Reply For" Логин или имя пользователя.

"Received Reply For": me()

Оценка и затраченное время

Эти параметры отображаются на панели слева.

Описание Параметр Значение параметра
Найти задачи с определенной первоначальной оценкой. "Первоначальная оценка" или "Original Estimate" Отрезок времени.

"Original Estimate": "1w 5d 2h 30m"
Найти задачи, где в поле Дата начала указан выбранный день или интервал дат. "Дата начала" или "Start Date" Дата или интервал дат.

"Start Date": 2025-01-30
Найти задачи с определенной оценкой трудозатрат в Story Points. "Story Points" Число Story Points.

"Story Points": >=5
Найти задачи, на решение которых потрачено определенное время. "Затрачено времени" или "Time Spent" Отрезок времени.

"Time Spent": 1ч

Проекты и спринты

Эти параметры отображаются на панели слева.

Описание Параметр Значение параметра
Найти задачи, связанные с выбранной целью. Цели или Goals Название цели.

Goals: "Догнать и перегнать"
Найти задачи, которые относятся к выбранным проектам. Проект или Project Название проекта.

Project: "Mobile"
Найти задачи, которые относятся к выбранным спринтам. Спринт или Sprint Идентификатор или название спринта.

Sprint: TrackerSprint32
Найти задачи, которые относятся к активному спринту на выбранной доске задач. "Sprint In Progress By Board" Идентификатор доски задач (можно посмотреть в URL доски).

"Sprint In Progress By Board": 87

Эти параметры отображаются в разделе «Связи».

Описание Параметр Значение параметра
Найти задачи, связанные с определенными задачами. Relates Ключ задачи.

Relates: TASK-123, TASK-321
Найти копии определенных задач. Копия или Clone Ключ задачи.

Clone: TASK-123, TASK-321
Найти задачи, которые зависят от определенных задач (блокируются ими). "Зависит от" или "Depends On" Ключ задачи.

"Depends On": TASK-123, TASK-321
Найти задачи, которые дублируют выбранные задачи. Дублирует или Duplicates Ключ задачи.

Duplicates: TASK-123, TASK-321
Найти задачи, которые относятся к определенному эпику. Epic Ключ эпика.

Epic: TASK-123, TASK-321
Найти родительские задачи для выбранных задач. "Родительская задача" или "Is Parent Task For" Ключ задачи.

"Is Parent Task For": TASK-123, TASK-321
Найти задачи, которые имеют любую связь с выбранными задачами. Linked to Ключ задачи.

"Linked to": TASK-123, TASK-321
Найти задачи, где есть зависимые (блокируемые) задачи определенной очереди. "Block Queue" Название или ключ очереди.

"Block Queue": TEST

Активность

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

Описание Параметр Значение параметра
Найти задачи, которые были изменены в выбранный день или интервал дат. Обновлено или Updated Дата или интервал дат.

Updated: 2025-01-30
Найти задачи, где определенные пользователи оставляли комментарий. "Comment Author" Логин или имя пользователя.

"Comment Author": user3370@, "Иван Иванов"
Найти задачи, где новые комментарии не появлялись какое-то время. "Последний комментарий" или "Last Comment" Дата и время добавления последнего комментария.

"Last Comment": 2025-01-30
Найти задачи, где последнее изменение сделано выбранным пользователем. Изменил или Modifier Логин или имя пользователя.

Modifier: user3370@
Найти ваши избранные задачи. "Favorited by" В качестве значения параметра может использоваться только функция me().

"Favorited by": me()
Найти задачи, авторами, исполнителями или наблюдателями которых являются выбранные пользователи. Related Логин или имя пользователя.

Related: user3370@, "Иван Иванов"
Найти задачи, которые закрыли с резолюцией определенные пользователи. Решивший или Resolver Логин или имя пользователя.

Resolver: user3370@, "Иван Иванов"
Найти задачи, за которые проголосовали выбранные пользователи. Проголосовали или "Voted by" Логин или имя пользователя.

"Voted By": user3370@, "Иван Иванов"
Найти задачи, за которые отдали определенное число голосов. Проголосовало или Votes Число голосов.

Votes: >=6

Резолюция — параметр задачи, который показывает, почему задачу закрыли. Например: Решен, Неактуально или Дубликат. Резолюции можно добавить в настройках очереди.

Локальное поле — это параметр задачи, который создал кто-то из сотрудников в настройках очереди.