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

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

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

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

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

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

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

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

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

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

1. На верхней панели Tracker выберите Задачи → Найти задачи.

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")

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

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

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

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

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

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

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

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

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

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

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

  Summary: #"Version 2.0"
  

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

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

  Summary: !"UI"
  

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

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

  Summary: ~"UI Update 2.0"
  

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

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

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

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

  Пример:

  Author: "Алиса Литл"
  

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

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

  Пример:

  Assignee: user3370@ 
  

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

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

  Примеры:

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

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

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

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

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"

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

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

  "XXw XXd XXh XXm XXs"
  

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

  "3d 5h 32m"
  

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

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

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

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

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

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

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

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

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

• Не равно

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

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

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

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

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

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

  параметр: число1 .. число2
  

Функции

Кроме точных значений параметров вы можете использовать функции. Функция — это переменная, значение которой вычисляется в момент выполнения запроса. Например, функция 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
  

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