Шпаргалка по Jira Query Language (JQL)

Jira Query Language (JQL) позволяет искать задачи в рабочей области Jira, фильтровать их и составлять отчеты с помощью гибких развернутых запросов для получения точных результатов. Это способ поиска задач Jira, когда одних только фильтров недостаточно.

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

Получить Jira бесплатно

Четыре основных компонента JQL-запроса

Каждое выражение на языке JQL состоит из следующих четырех частей.

Часть

Что это такое

Пример

Поле

Атрибут, по которому выполняется поиск

priority, assignee, fixVersion

Оператор

Сопоставляет поле со значением

=, !=, <, IN

Значение или функция

То, с чем сопоставляется поле

"High", currentUser()

Ключевые слова

Объединяют несколько условий вместе

AND, OR, ORDER BY

Стандартные операторы

Операторы определяют, как Jira сравнивает поле с искомым значением. Используйте их, чтобы находить точные совпадения, объединять условия, выполнять поиск по значениям из списка или проверять, содержит ли поле значение.

Оператор

Значение

Пример

=

Точное совпадение

project = "Маркетинговая кампания"

!=

Не равно

assignee != currentUser()

AND

Объединение нескольких условий (должны выполняться сразу все условия)

priority = High AND status = Open

или

Объединение нескольких условий (должно выполняться хотя бы одно условие)

status = Open OR status = Reopened

IN

Соответствие любому значению из списка

priority IN (High, Highest)

~

Содержит (текстовая строка для поиска)

summary ~ "ошибка входа"

IS EMPTY

У поля нет значения

assignee IS EMPTY

Ключевые функции JQL и способы их использования

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

Функция

Описание

Пример

ORDER BY

Сортирует результаты по значению поля

project = "Маркетинг" ORDER BY created DESC

WAS

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

status WAS "Resolved" AND status = "Open"

CHANGED

Выявляет задачи, измененные в течение определенного периода времени

status CHANGED AFTER -1w

MEMBERSOF

Фильтрует по участию в группе

assignee IN MEMBERSOF("developers")

Примеры распространенных запросов JQL при использовании Jira

Вот несколько примеров использования JQL в Jira.

Пример использования

JQL-запрос

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

priority = High AND assignee = currentUser()

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

project = "Поддержка пользователей" AND duedate < now() AND статус != Закрыто

Показать недавно созданные задачи

created >= -7d ORDER BY created DESC

Продвинутые методы JQL

Используя расширенный поиск JQL можно искать данные в пользовательских полях и выполнять сложные запросы.

Метод

Пример

Как пользоваться?

Использование пользовательских полей

"Имя пользовательского поля" ~ "Поисковое слово"

Выполняйте более специализированные запросы с помощью функции поиска в пользовательских полях.

Использование подзапросов

project IN subTaskIssueTypes() AND assignee = currentUser()

Фильтруйте задачи по результатам другого запроса.

Поиск конкретных типов задач

issuetype = Epic AND статус != Done

Ищите задачи определенного типа и в конкретном статусе.

Как выявлять ошибки до выполнения поискового запроса

Поиск ошибок в редакторе JQL

Следующие функции редактора JQL в Jira Cloud помогают выявить проблемы по мере ввода, а не после того, как вы нажмете кнопку поиска.

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

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

  • Автозаполнение. По мере ввода текста появляются подходящие ключевые слова и функции.

  • Многострочное редактирование. Можно развернуть редактор и искать ошибки по номерам строк.

  • Удобные способы упоминания пользователей. Можно использовать имена и аватары вместо идентификаторов аккаунтов.

  • Отладчик JQL. Когда запрос возвращает ошибку, Rovo предлагает исправленный запрос, который можно проверить и принять.

Поиск с помощью Rovo

Не нужно помнить синтаксис JQL наизусть, чтобы выполнять точный поиск. Rovo — ИИ в продуктах Atlassian — автоматически преобразует ваш текст в JQL. В строке поиска Jira выберите Ask Rovo (Запрос к Rovo) и введите свой вопрос так, как вы произнесли бы его вслух. Пример:

«Найти все ошибки, зарегистрированные в проекте мобильного приложения в этом месяце»

Rovo преобразует это в соответствующий запрос JQL, выполнит поиск и покажет результаты вместе со сгенерированным запросом. Последнее особенно важно: это по-настоящему полезный способ изучить JQL на примерах, поскольку вы можете увидеть, какие в точности поля, операторы и функции соответствуют вашему вопросу на естественном языке. Если запрос слишком сложен для Rovo, чтобы выполнить его в базовом режиме, он автоматически переключается в режим JQL, чтобы получить более точный результат. Вы можете в любое время вернуться к базовому режиму в меню «Другие действия».

Когда поиск Rovo наиболее результативен

Когда следует переходить к JQL

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

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

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

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

Вы хотите изучать синтаксис JQL по мере создания запросов.

Вы используете язык, отличный от английского.

JQL: часто задаваемые вопросы

Как с помощью JQL найти определенные задачи в Jira?

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

Можно ли сохранять JQL-запросы и делиться ими с командой?

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

Каковы распространенные примеры использования JQL в управлении проектами?

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

Как составлять более сложные JQL-запросы?

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