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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы найти только те задачи, текст в которых в точности совпадает с текстом запроса, воспользуйтесь оператором #:
Summary: #"Lorem ipsum dolor sit amet"
Пример
Description: "Эта местность мне знакома, как окраина Китая"

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

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

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

Дата
  • MM/DD/YYYY

    Пример:

    04/30/2017
  • DD.MM.YYYY

    Пример:

    30.04.2017
  • DD-MM-YYYY

    Пример:

    30-04-2017
  • YYYY-MM-DD

    Пример:

    2017-04-30
Время

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

"XXw XXd XXh XXm XXs"

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

"3d 5h 32m"

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

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

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

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

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

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

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

  • Не равно

    параметр: !"значение"
  • Больше, Меньше, Меньше или равно, Больше или равно

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

    параметр: >число
    параметр: <число
    параметр: >=число
    параметр: <=число
  • Лежит в интервале

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

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

Функции

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

Created: today()
Функция Результат выполнения Пример
empty() 

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

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

Assignee: empty()
notEmpty()

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

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

Deadline: notEmpty()
me() 

Имя пользователя, выполнившего запрос

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

Author: me()
now()

Текущее время с точностью до минуты

Найти задачи, созданные за последние 12 часов:

Created: >now()-12h
today()
Интервал времени, соответствующий текущей дате

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

Created: today()
week()

Интервал дат, соответствующий текущей неделе

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

Created: week()
month() 

Интервал дат, соответствующий текущему месяцу

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

Created: month()
quarter() 

Интервал дат, соответствующий текущему кварталу

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

Created: quarter()
year()

Интервал дат, соответствующий текущему году

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

Created: year()
unresolved()

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

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

Resolution: unresolved()
group()

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

Найти задачи, над которыми работают сотрудники Коммерческого отдела:

Assignee: group(value: "Коммерческий отдел") 

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

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

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

Status: changed(to: "В работе" by: "Алиса Литл" date: 01.09.2017 .. 15.09.2017)

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

Вы можете отсортировать результаты фильтра, задав в конце запроса параметр "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

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

Параметр Значение Описание
"Access"

Логины или имена пользователей

Поиск задач, у которых в поле Доступ указаны заданные пользователи. Например:

Access: "user3370", "Алиса Литл"
"Affected Version"

Названия версий

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

"Affected Version": "14.09.1978"
"Assignee"

Логины или имена пользователей

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

Assignee: "user3370", "Алиса Литл"
"Author"

Логины или имена пользователей

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

Author: "user3370", "Алиса Литл"
"Block Queue"
Названия или ключи очередей

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

"Block Queue": TEST
"Clone"
Ключи задач

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

Clone: "TASK-123", "TASK-321"
"Clones Of Queue"
Названия или ключи очередей

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

"Clones Of Queue": TEST, DEVELOP
"Comment"

Текстовая строка

Поиск задач, у которых есть комментарии с заданным текстом. Например:

  • Найти задачи, комментарии к которым содержат слова и словоформы фразы:

    "Comment": "отличная работа"
  • Найти задачи, комментарии к которым в точности содержат фразу:

    "Comment": #"отличная работа"
"Comment Author"

Логины или имена пользователей

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

"Comment Author": "user3370", "Алиса Литл"
"Component Lead"

Логины или имена пользователей

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

"Component Lead": "user3370", "Алиса Литл"
"Components"

Названия компонентов

Поиск задач, относящихся к заданным компонентам. Например:

Components: "бекенд", " фронтенд"
"Created"
Дата или интервал дат

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

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

Дата или интервал дат

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

Deadline: 2017-01-30
"Depend On Queue"
Названия или ключи очередей

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

"Depend On Queue": Тестирование
"Depends On"
Ключи задач

Поиск задач, которые зависят от заданных задач (блокируются заданными задачами). Например:

"Depends On": "TASK-123", "TASK-321"
"Description"

Текстовая строка

Поиск задач, описание которых содержит заданный текст. Например:

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

    "Description": "изобрести велосипед"
  • Найти задачи, описание которых в точности содержат фразу:

    "Description": #"изобрести велосипед"
"Duplicated In Queue"
Названия или ключи очередей

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

"Duplicated In Queue": TEST
"Duplicates"

Ключи задач

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

Duplicates: "TASK-123", "TASK-321"
"Duplicates In Queue"
Названия или ключи очередей

Поиск задач, которые дублируют задачи из заданных очередей. Например:

"Duplicates In Queue": Тестирование
"End Date"

Дата или интервал дат

Поиск задач, у которых значение поля Дата завершения совпадает с заданной датой или находится в заданном интервале дат. Например:

"End Date": 2017-01-30
"Epic"

Ключи эпиков

Поиск задач, относящихся к заданным эпикам. Например:

Epic: "TASK-123", "TASK-321"
"Epics For Queue"
Названия или ключи очередей

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

"Epics For Queue": TEST, DEVELOP
"Favorited by"

В качестве значения параметра может использоваться только функция me()

Поиск ваших избранных задач. Например:

"Favorited by": me()
"Filter"

Идентификаторы или имена фильтров

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

Filter: "Задачи моего отдела"
"Fix Version"

Названия версий

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

"Fix Version": "12.11.1986"
"Followers"

Логины или имена пользователей

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

Followers: "user3370", "Алиса Литл"
"Has Epic"
Ключи задач

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

"Has Epic": TASK-123
"Have Links To Queue"
Названия или ключи очередей

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

"Have Links To Queue": TEST
"History"

Текстовая строка

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

Поиск осуществляется только по значениям полей Название задачи и Описание задачи.

Например:

History: "проще простого"
"In Epics Of Queue"
Названия или ключи очередей

Поиск задач, которые относятся к эпикам заданной очереди. Например:

"In Epics Of Queue": Тестирование
"Is Dependent By"
Ключи задач

Поиск задач, которые блокируют (от которых зависят) заданные задачи. Например:

"Is Dependent By": "TASK-123", "TASK-321"
"Is Duplicated By"
Ключи задач

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

"Is Duplicated By": "TASK-123", "TASK-321"
"Is Epic Of"
Ключи задач

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

"Is Epic Of": "TASK-123", "TASK-321"
"Is Parent Task For"

Ключи задач

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

"Is Parent Task For": "TASK-123", "TASK-321"
"Is Subtask For"

Ключи задач

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

"Is Subtask For": "TASK-123", "TASK-321"
"Key"

Ключи задач

Поиск задач с заданными ключами. Например:

KEY: "TASK-123", "TASK-321"
"Linked to"

Ключи задач

Поиск задач, которые имеют связи любого типа (родительские, дочерние, связанные, дубликат и так далее) с заданными задачами. Например:

"Linked to": "TASK-123", "TASK-321"
"Maillists"

Названия отделов или команд

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

Maillists: "Хелпдеск"
"Modifier"

Логины или имена пользователей

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

Modifier: "user3370", "Алиса Литл"
"Old Queue"

Названия или ключи очередей

Поиск задач, перенесенных из заданных очередей. Например:

"Old Queue": TEST
"Original"

Ключи задач

Поиск клонов заданных задач. Например:

Original: "TASK-123", "TASK-321"
"Original Estimate"

Отрезок времени в формате "XXw XXd XXh XXm XXs"

Поиск задач с заданной первоначальной оценкой. Например:

"Original Estimate": "5d 2h 30m"
"Originals Of Queue"
Названия или ключи очередей

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

"Originals Of Queue": Тестирование
"Parent Tasks For Queue"
Названия или ключи очередей

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

"Parent Tasks For Queue": TEST, DEVELOP
"Priority"

Значения приоритета

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

Priority: "Minor", "Средний"
"Project"

Названия проектов

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

Project: "Perpetuum mobile"
"Queue"

Названия или ключи очередей

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

Queue: TEST
"Queue Lead"

Логины или имена пользователей

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

"Queue Lead": "user3370", "Алиса Литл"
"Related"

Логины или имена пользователей

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

Related: "user3370", "Алиса Литл"
"Related To Queue"
Названия или ключи очередей

Поиск задач, которые связаны с задачами определенных очередей (связь типа «Связанные»). Например:

"Related To Queue": Тестирование
"Relates"

Ключи задач

Поиск задач, связанных с определенными задачами (связь типа «Связанные»). Например:

Relates: "TASK-123", "TASK-321"
"Resolved"

Дата или интервал дат

Поиск задач, которые были закрыты (была установлена резолюция) в заданный день или в заданном интервале дат. Например:

Resolved: 2017-01-01..2017-01-30
"Resolver"

Логины или имена пользователей

Поиск задач, которые закрыли (установили резолюцию) заданные пользователи. Например:

Resolver: "user3370", "Алиса Литл"
"Sprint"

Идентификаторы или названия спринтов

Поиск задач, относящихся к заданным спринтам. Например:

Sprint: "TrackerSprint32"
"Sprint In Progress By Board"
Идентификатор доски задач (можно узнать в URL страницы доски)

Поиск задач, относящихся к активному спринту на заданной доске задач. Например:

"Sprint In Progress By Board": 87
"Sprints By Board"

Идентификатор доски задач (можно узнать в URL страницы доски)

Поиск задач, относящихся к заданной доске задач. Например:

"Sprints By Board": 87
"Start Date"

Дата или интервал дат

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

"Start Date": <2017-01-30
"Status"

Названия статусов

Поиск задач, имеющих заданные статусы. Например:

Status: Open, Resolved, Closed
"Story Points"

Число очков Story Points

Поиск задач, имеющих заданную трудоемкость в очках Story Points. Например:

"Story Points": >=5
"Subtasks For Queue"
Названия или ключи очередей

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

"Subtasks For Queue": TEST
"Summary"

Текстовая строка

Поиск задач, название которых содержит заданный текст. Например:

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

    "Summary": "изобрести велосипед"
  • Найти задачи, название которых полностью совпадает с фразой:

    "Summary": #"изобрести велосипед"
"Tags"

Теги задач

Поиск задач, отмеченных заданными тегами. Например:
Tags: "Поддержка", "wiki"
"Time Spent"

Отрезок времени в формате "XXw XXd XXh XXm XXs"

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

"Time Spent": >"5d 2h 30m"
"Updated"

Дата или интервал дат

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

Updated: >2017-01-30
"Voted by"

Логины или имена пользователей

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

"Voted By": "user3370", "Алиса Литл"
"Votes"

Число голосов

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

Votes: > 6