Шпаргалка по JQL
Используйте эту шпаргалку по JQL в качестве подробного руководства по освоению Jira Query Language для расширенного поиска и фильтрации в инструменте управления проектами от Atlassian.
Знакомство с Jira Query Language (JQL)
JQL — это мощный язык поиска для Jira, на котором пользователи могут составлять сложные запросы для отслеживания задач, расширенной фильтрации и создания отчетов. Благодаря гибкости JQL в Jira руководителям проектов и Agile-командам будет проще ориентироваться в больших наборах данных.
Базовая структура запросов 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 subTaskWorkitemTypes() AND assignee = currentUser(). Составляйте вложенные запросы JQL, чтобы фильтровать задачи по результатам другого запроса. Это особенно полезно для сложных иерархических отношений в проектах.Конкретные типы задач:
itemtype = Epic AND status != Done. Вычлените с помощью JQL конкретные типов задач и их статусов, чтобы отслеживать определенные категории работ в проектах и управлять ими.
Как стать экспертом по JQL
Благодаря этой шпаргалке по JQL от Atlassian вы будете хорошо подготовлены к работе с расширенным поиском JQL и улучшите свои навыки управления проектами.
Освойте JQL, и вы сможете получать ключевые аналитические данные о проекте и находить ответы на все актуальные для команды вопросы. Три вида поиска в Jira — быстрый, основной и расширенный — помогут отыскать важнейшую информацию о проектах. А результаты запросов можно сохранять и использовать в качестве фильтров и представлений в Jira, в том числе на досках.