Язык запросов в Tracker

Если возможностей простых фильтров вам не хватает, задайте фильтр с помощью языка запросов.

Язык запросов позволяет:

• искать задачи по имени, описанию и комментариям;

• фильтровать задачи по нескольким значениям одного параметра;

• использовать в фильтрах операции сравнения и логические операторы;

• указывать функции в качестве значения для сравнения;

• задавать порядок сортировки задач в результатах фильтра.

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

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

1. Откройте страницу Задачи.

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

3. Введите запрос и нажмите кнопку Применить.

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

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

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

Примеры

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

  "Queue": "TEST"
  

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

  "Assignee": "Иван Иванов"
  

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

  "Status": "Открыт", "В работе"
  

• Задачи, созданные с 1 по 30 января 2017 года:

  "Created": "2017-01-01".."2017-01-30"
  

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

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

<параметр>: "<значение_1>", "<значение_2>", "<значение_3>"

Пример

author: "vpupkin","iivanov"

Такой фильтр выведет все задачи, автор которых — пользователь vpupkin или iivanov.

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

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

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

  Пример:

  <параметр_1>: "<значение_1>" AND <параметр_2>: "<значение_2>"
  

  Такой запрос выведет задачи, у которых <параметр_1> имеет значение <значение_1> И <параметр_2> имеет значение <значение_2>.

  Примечание

  Вместо оператора AND вы можете просто перечислить поля через пробел.

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

  Пример:

  <параметр_1>: "<значение_1>" OR <параметр_2>: "<значение_2>"
  

  Такой запрос выведет задачи, у которых выполнено хотя бы одно из условий: <параметр_1> имеет значение <значение_1> Или <параметр_2> имеет значение <значение_2>.

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

<параметр_1>: "<значение_1>" AND <параметр_2>: "<значение_2>" OR <параметр_3>: "<значение_3>"

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

<параметр_1>: "<значение_1>" AND (<параметр_2>: "<значение_2>" OR <параметр_3>: "<значение_3>")

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

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

Поиск по всем полям

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

• В поле ввода запросов введите текст, который нужно найти, и нажмите Применить.

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

• Вы также можете использовать для поиска по тексту адресную строку браузера. Для этого введите запрос вида:

  https://tracker.yandex.ru/issues/?_q="<строка>"
  

  где <строка> — текст, который вы ищете.

Такой запрос выведет задачи, в названии, описании или в комментариях которых есть слова и словоформы исходной строки.

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

Поиск по заданному полю

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

• Summary — название задачи.

• Description — описание задачи.

• Comment — текст комментария.

• History — текст в истории изменений.

Description: "Эта местность мне знакома, как окраина Китая"

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

Операторы для текстового поиска

• Чтобы найти только те задачи, у которых в заданном поле есть точное совпадение с текстом запроса, воспользуйтесь оператором #:

  Summary: #"Version 2.0"
  

  Такой фильтр выведет только те задачи, в названии которых присутствует точное совпадение с текстом запроса.

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

  Description: #"\"Избранное\""
  

  Такой фильтр выведет только те задачи, в описании которых содержится текст "Избранное".

  "Description": #"Вкл\\Выкл"
  

  Такой фильтр выведет только те задачи, в описании которых содержится текст Вкл\Выкл.

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

  Summary: !"UI"
  

  Такой фильтр выведет только те задачи, в названии которых отсутствует фрагмент текста UI.

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

  Summary: ~"UI Update 2.0"
  

  Такой фильтр выведет только те задачи, название которых не совпадает с текстом запроса.

Поиск по пользователю

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

• Логин с символом @ в конце: логин@ — для поиска по точному совпадению с логином пользователя.

  Пример:

  Assignee: user3370@ 
  

  Такой запрос выведет задачи, исполнитель которых — пользователь с логином user3370. Это самый точный способ поиска по пользователю.

• Имя и фамилия в кавычках: "<имя_фамилия>" — для поиска по совпадению с именем и фамилией пользователя.

  Пример:

  Author: "Иван Иванов"
  

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

• Имя, фамилия или логин пользователя — для поиска по точному совпадению с любыми из этих данных.

  Примеры:

  • Followers: Иван — такой запрос выведет задачи, наблюдатели которых — пользователи с именем Иван и любой фамилией.

  • Followers: ivan — такой запрос выведет задачи, наблюдатель которых — пользователь с логином ivan@ или пользователь с именем Ivan (если имя указано по-английски).

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

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

DEVS.Тестировщик: "Иван Иванов"

DEVS."Ведущий тестировщик": "Иван Иванов"

DEVS.tester: user3370@

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

Многие параметры задач имеют значения даты и времени. В языке запросов поддерживается несколько форматов записи таких параметров:

Дата

• MM/DD/YYYY

  Пример:

  04/30/2017
  

• DD.MM.YYYY

  Пример:

  30.04.2017
  

• DD-MM-YYYY

  Пример:

  30-04-2017
  

• YYYY-MM-DD

  Пример:

  2017-04-30
  

Дата и время

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

"YYYY-MM-DD XXh:XXm:XXs"

Пример:

"2017-04-30 17:25:00"

Интервалы и отрезки времени

• Вы можете задавать отрезки времени в месяцах, неделях, днях, часах, минутах и секундах в формате:

  "XXM XXw XXd XXh XXm XXs"
  

  Например, отрезок времени в 2 месяца 3 дня 5 часов и 32 минуты можно записать как:

  "2M 3d 5h 32m"
  

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

  DD-MM-YYYY .. DD-MM-YYYY
  

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

  Created: 01-01-2017 .. 02-03-2017
  

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

  Например:

  Фильтр для задач, созданных не раньше недели и одного дня назад:

  Created: > today() - "1w 1d"
  

  Фильтр для задач в статусе «В работе», у которых дедлайн менее чем через один месяц:

  "Status": "В работе" AND Deadline: < today() + 1M
  

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

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

• Не равно

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

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

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

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

• Лежит в интервале

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

  <параметр>: <число_1> .. <число_2>
  

Примеры

Найти задачи, у которых дедлайн через несколько дней или сегодня:

• Задачи, у которых дедлайн через 3 дня:

  Deadline: <= today() +3d and deadline: >= today()
  

Чтобы кастомизировать параметры, используйте в запросе функции:

• Задачи, у которых дедлайн сегодня:

  Deadline: today()
  

Функции

Кроме точных значений параметров вы можете использовать функции. Функция — это переменная, значение которой вычисляется в момент выполнения запроса. Например, функция today() принимает значение сегодняшней даты. Чтобы вывести все задачи, созданные сегодня, воспользуйтесь запросом:

Created: today()

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

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

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

Например, чтобы узнать список задач, которые пользователь Иван Иванов перевел в статус «в работе» в определенный период времени, нужно составить запрос:

Status: changed(to: "В работе" by: "Иван Иванов" date: 01.09.2017 .. 15.09.2017)

Чтобы узнать список задач, которые пользователь Иван Иванов перевел в статус «в работе» за последнюю неделю, используйте в запросе функцию:

Status: changed(to: "В работе" by: "Иван Иванов" date: >today()-1w)

Сортировка результатов

Вы можете отсортировать результаты фильтра, задав в конце запроса параметр "Sort By". В качестве значения укажите имя поля для сортировки:

"Sort By": Created

При необходимости задайте порядок сортировки по возрастанию (ASC) или по убыванию (DESC):

"Sort By": Created ASC

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

"Sort By": Created ASC, Updated DESC

Полезные запросы

Попробуйте несколько готовых запросов, чтобы лучше разобраться в их работе:

• Активные задачи, автором которых вы являетесь:

  Author: me() Resolution: empty()
  

• Активные задачи, исполнителем которых вы являетесь:

  Assignee: me() Resolution: empty()
  

• Активные задачи, за которыми вы наблюдаете:

  Followers: me() Resolution: empty()
  

• Задачи с истекающим в течение недели дедлайном, исполнителем которых вы являетесь::

  Assignee: me() Deadline: week()
  

• Задачи с приоритетами Critical или Blocker, для которых вы являетесь автором, исполнителем или наблюдателем.

  (Followers: me() OR Assignee: me() OR Author: me()) AND Resolution: empty() AND Priority: Blocker, Critical
  

Параметры фильтров