JQL (Jira Query Language) - язык запросов для поиска задач и отчетности в Jira. Он является основным инструментом для поиска и фильтрации задач, а также для создания отчетов в Jira. В этой статье мы рассмотрим основы JQL и как использовать его для поиска задач в Jira на базовом уровне.
Что даёт базовый уровень владения JQL?
Базовый уровень владения JQL необходим для решения задач, связанных с:
- Искать задачи по статусу, приоритету и назначенному исполнителю
- Искать задачи по тексту в названии, описании или комментариях
- Искать задачи по дате создания или изменения
- Искать задачи по компоненту, версии или эпику
- Искать задачи, которые не были обработаны в течение определенного периода времени
- Искать задачи, которые были созданы или изменены в определенный период времени
- Искать задачи, которые относятся к определенному проекту или проектам
Знание базовых параметров и функций JQL поможет менеджеру, аналитику или другому специалисту управлять проектами, контролировать сроки выполнения задач и обеспечить высокое качество работы.
Структура JQL запроса
Для того, чтобы начать писать JQL запросы, важно знать, из каких элементов они состоят? А также что из себя представляют простые и сложные JQL запросы?
Структура простого JQL запроса
С помощью данного запроса вы сможете найти задачи (корректнее говорить issue), назначенные на пользователя "test.user@work.com". Результат поиска будет отсортирован по полю "priority".
Запрос состоит из следующих элементов:
- "assignee" – поле
- "=" – оператор сравнения
- "test.user@work.com" – значение
- "order by priority DESC" – сортировка, где:
o "order by" – функция сортировки
o "priority" – поле сортировки
o "desc" – значение, отвечающее за сортировку по убыванию
Как видите, конструкция вполне понятна. Но как дела обстоят со сложными запросами?
Структура сложного JQL запроса
Структура сложного запроса включает в себя логические операторы, сложное сочетание функций и скобок и т.д. Но для базового уровня достаточно совмещать несколько условий в один запрос. В JQL для этого применяются операторы «AND», «OR».
В данном запросе совмещены две поисковые конструкции:
- Поиск issue (условно говоря задач), которые назначены на пользователя "test.user@work.com"
- Поиск issue, которые созданы в проекте “MAINPRODUCT"
- Результат поиска будет отсортирован по полю "priority"
Issue будут найдены только если выполняться условия в п.1 и п.2. Поисковых конструкций может быть больше двух, главное, чтобы при поиске вы использовали логический оператор "AND" и "OR".
Поля, операторы, функции для поиска
Для того чтобы эффективно решать поставленные задачи связанные эффективным управлением проектами, контролем сроков выполнения задач и обеспечить высокое качество работы, необходимо знать базовый набор полей, операторов, а также значений, которые могут быть функциями, булевыми значениями. Данный список полей и функций, предложенный в данной статье, не является исчерпывающим, однако, представляет собой базовый набор знаний.
Логические операторы JQL
Операторы сравнения JQL
Поля поиска JQL
Функции JQL
Советы
1. Используйте подсказки в поиске
При наборе текста в поле поиска вам сначала будут доступны поля, затем операторы и, наконец, значения. Несмотря на то, что есть исключения из этого правила, оно в основном справедливо для большинства полей.
2. Переключайтесь из базового поиска в расширенный поиск
Базовый поиск поможет перехойти от начального уровня поиска в более продвинутый уровень. Иногда проще подобрать фильтры в базовом поиске, чтобы посмотреть как выглядит запрос в JQL.
3. Читайте официальную документацию Atlassian
В поиске встроена ссылка на документацию Atlassian. Читайте документацию, чтобы расширить свои знания о полях, функциях, ключевых словах.
4. Подсказки поиска
Обратите внимание на поисковые подсказки. Значок ❌свидетельствует, что запрос был написан не правильно, и в обратной ситуации значок ✅, который свидетельствует о том, что запрос написан правильно. Такде под полем для ввода запроса можно увидеть текстовую подсказку, если запрос написан не правильно.
Заключение
В заключении можно подчеркнуть важность знания базовых принципов JQL для работы с Jira и выделить, что использование данного языка запросов позволяет упростить поиск задач, улучшить качество отчетности и повысить эффективность управления проектами. Кроме того, можно подчеркнуть, что базовые знания JQL могут стать отличным стартом для дальнейшего изучения более сложных запросов и функций, доступных в Jira.
Надеюсь, что данный материал помог вам лучше понять, что такое JQL и как его использовать на базовом уровне для поиска задач в Jira. Если вы хотите изучить больше инструментов разработки, не забудьте подписаться на мой канал.
Также, если у вас есть какие-либо вопросы или комментарии относительно данной статьи, не стесняйтесь оставлять их ниже. Мне важно узнать ваше мнение и помочь вам получить дополнительные знания в области JQL и Jira.
А вот другие интересные статьи про Jira и JQL: