Шпаргалка по JQL

Используйте эту шпаргалку по JQL в качестве подробного руководства по освоению Jira Query Language для расширенного поиска и фильтрации в инструменте управления проектами от Atlassian.

Знакомство с Jira Query Language (JQL)

JQL — это мощный язык поиска для Jira, на котором пользователи могут составлять сложные запросы для отслеживания задач, расширенной фильтрации и создания отчетов. Благодаря гибкости JQL в Jira руководителям проектов и Agile-командам будет проще ориентироваться в больших наборах данных.

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

Базовая структура запросов JQL

Типичный запрос JQL состоит из следующих компонентов.

Поле. Поля JQL представляют различные типы информации, такие как приоритет, fixVersion (версия решения) или тип задачи.
Оператор. Операторы — это основа запроса, связывающая поле со значением. К стандартным операторам относятся, например, «равно» (=), «не равно» (!=) и «меньше » (<).
Значение и функция. Значения представляют собой это конкретные искомые единицы данных. Функции JQL выполняют вычисления или возвращают динамические результаты.
Ключевые слова. Ключевые слова JQL — это специальные слова с заранее определенными значениями, такие как AND (И) и OR (ИЛИ). Их используют для создания более сложных запросов.

Пример: project = “Маркетинговая кампания” AND status = “В работе”

По этой структуре пользователи могут быстро формулировать запросы и искать конкретные задачи или группы в Jira.

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

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

=: точное совпадение. Пример: Project = “Marketing Campaign”. Запрос покажет все задачи, относящиеся к проекту Marketing Campaign.
!=: не равно. Пример: assignee != currentUser( ). По этому запросу можно найти все задачи, не назначенные текущему пользователю, и определить задания, которые могут потребовать внимания со стороны других.
AND: объединяет несколько условий (должны выполняться все условия сразу). Пример: priority = High AND status = Open. Запрос вернет только открытые задачи высокого приоритета, что поможет определить важнейшие задания, требующие немедленного внимания.
OR: объединяет несколько условий (должно выполняться хотя бы одно условие). Пример: component = “User Interface” OR component = “API”. По этому запросу можно увидеть задачи, относящиеся к пользовательскому интерфейсу или компонентам API, и просмотреть связанную работу в разных частях системы.
IN: требует совпадения с любым значением из указанного списка. Пример: status IN (“In Progress”, “Under Review”, “Testing”). Запрос вернет все задачи с любым из трех указанных статусов, что дает возможность быстро посмотреть все активные рабочие задачи.

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

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

ORDER BY: сортирует результаты. Пример: project = "Marketing" ORDER BY created DESC. Запрос вернет все задачи в маркетинговом проекте, отсортированные по дате создания от новых к старым. Так можно быстро определить самые последние задания.
WAS: производит поиск задач по предыдущему состоянию. Пример: status WAS "Resolved" AND status = "Open". Запрос позволит найти все задачи, которые были решены, а затем вновь открыты, что поможет отслеживать повторяющиеся проблемы.
CHANGED: выявляет задачи, измененные в течение определенного периода времени. Пример: status CHANGED AFTER -1w. Запрос вернет все задачи, статус которых изменился за последнюю неделю, что будет полезно при анализе недавнего прогресса или изменений в проекте.
MEMBERSOF: фильтрует по участию в группе. Пример: assignee IN MEMBERSOF("developers"). Запрос найдет все задачи, назначенные кому-либо из группы "developers" (разработчики), что позволит оценить рабочую нагрузку в команде.

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

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

Найти все назначенные вам задачи с высоким приоритетом: priority = High AND assignee = currentUser()
Перечислить просроченные задачи в конкретном проекте: project = "Customer Support" AND duedate < now() AND status != Closed
Показать недавно созданные задачи: created >= -7d ORDER BY created DESC

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

С расширенным поиском JQL вы сможете извлечь больше из пользовательских полей и сложных запросов.

Использование пользовательских полей. "Custom Field Name" ~ "search term". С помощью JQL можно выполнять поиск по пользовательским полям, чтобы составлять более специализированные и точные запросы на основе уникальной структуры данных вашей компании.
Подзапросы. project IN subTaskIssueTypes() AND assignee = currentUser(). Составляйте вложенные запросы JQL, чтобы фильтровать задачи по результатам другого запроса. Это особенно полезно для сложных иерархических отношений в проектах.
Конкретные типы задач. issuetype = Epic AND status != Done. Вычлените с помощью JQL конкретные типов задач и их статусов, чтобы отслеживать определенные категории работ в проектах и управлять ими.

Как стать экспертом по JQL

Благодаря этой шпаргалке по JQL от Atlassian вы будете хорошо подготовлены к работе с расширенным поиском JQL и улучшите свои навыки управления проектами.

Освойте JQL, и вы сможете получать ключевые аналитические данные о проекте и находить ответы на все актуальные для команды вопросы. Три вида поиска в Jira — быстрый, основной и расширенный — помогут отыскать важнейшую информацию о проектах. А результаты запросов можно сохранять и использовать в качестве фильтров и представлений в Jira, в том числе на досках.

Готовы узнать больше о гибкости JQL в Jira?

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

Шпаргалка по JQL

Знакомство с Jira Query Language (JQL)

Базовая структура запросов JQL

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

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

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

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

Как стать экспертом по JQL

продукты

Ресурсы

Обучение