Перейти к основному содержимому

JQL Reference

JQL (Jira Query Language) — это SQL-подобный синтаксис Jira для фильтрации задач. Многие функции Jira Helper принимают JQL-выражения для настройки — определения, какие карточки окрашиваются, какие условия вызывают появление значков или какие задачи отображаются на диаграмме Ганта.

Примечание о производительности: Сложные JQL-запросы с множеством OR или вложенными подзапросами могут замедлить отрисовку. Для лучшей производительности доски используйте простые, сфокусированные запросы.

Где вводить JQL​

У каждой функции своё поле ввода JQL, расположенное в разных местах расширения:

ФункцияМесто ввода JQL
Card ColorsНастройки доски Jira → Card Colors — родная таблица цветовых правил Jira (не диалог Jira Helper)
Issue Condition ChecksНастройки доски → Информация на карточках → Issue Condition Checks — у каждого условия своё поле JQL
Issue Links DisplayНастройки доски → Информация на карточках → Issue Links — JQL для фильтрации исходных и связанных задач
Gantt ChartНастройки диаграммы Ганта → Bar Colour Rules (для цветовых правил) или Quick Filters (для фильтрации)

Поддерживаемые функции JQL​

Jira Helper поддерживает весь стандартный JQL, который поддерживает ваш экземпляр Jira, включая:

  • Сравнения полей: =, !=, >, <, >=, <=, ~ (содержит), !~ (не содержит)
  • Логические операторы: AND, OR, NOT
  • Ключевые слова: EMPTY, NULL, IS, IN, NOT IN, WAS, CHANGED
  • Сортировка: ORDER BY
  • Функции: currentUser(), membersOf(), now(), startOfDay(), endOfWeek() и все остальные функции, поддерживаемые Jira

Card Colors​

JQL-запросы определяют, какие карточки получают какой цвет фона. Они используют родную функцию Card Colors Jira — Jira Helper расширяет её, заполняя карточку целиком.

Примеры​

priority = Highest OR priority = High

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

type = Bug AND status != Closed

Окрашивает открытые баги для видимости.

labels = hotfix AND fixVersion = EMPTY

Отмечает задачи с меткой hotfix, которым не назначен релиз.

Issue Condition Checks​

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

Примеры​

assignee = currentUser() AND status not in (Done, Closed)

Показывает значок на карточках, назначенных вам, которые ещё не завершены.

duedate < now() AND resolution = Unresolved

Отмечает просроченные неразрешённые задачи значком предупреждения.

"Story Points" > 13

Отмечает большие истории, которые, возможно, нужно разделить.

fixVersion is EMPTY AND type != Epic

Подсвечивает задачи без целевого релиза.

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

Фильтрация исходных задач​

type = Story

Показывать связанные задачи только на карточках Story.

type != Sub-task

Исключить подзадачи из отображения значков связей.

Фильтрация связанных задач​

status != Done

Показывать только связанные задачи, которые ещё открыты.

Диаграмма Ганта​

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

Правила цвета полос (Bar Colour Rules)​

type = Bug

Окрашивает все полосы багов красным на временной шкале.

priority >= High

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

Быстрые фильтры (Quick Filters, интерактивная фильтрация)​

assignee = currentUser()

Показывать только ваши задачи на диаграмме.

type = Sub-task

Фильтровать только подзадачи.

Фильтры исключения (Exclusion Filters)​

status = Cancelled

Не допускать отменённые задачи на временную шкалу.

priority = Low

Исключить низкоприоритетные элементы из диаграммы.

Частые ошибки​

ПроблемаПричинаРешение
Запрос не возвращает результатовНесовпадение имени поляКопируйте имена полей из автодополнения редактора JQL Jira
Ошибка синтаксиса при сохраненииНезакрытые кавычки или скобкиИспользуйте встроенный поиск JQL Jira (Задачи → Поиск задач) для проверки запроса
currentUser() работает не так, как ожидалосьФункция вычисляется для текущего пользователя Jira, а не для зрителя доскиПроверьте запрос в поиске задач Jira, войдя как целевой пользователь
Пустые результаты для запросов fixVersionАрхивированные или невыпущенные версии могут не совпадатьИспользуйте fixVersion is EMPTY для неназначенных; проверьте написание имени версии
Карточки не окрашиваются, несмотря на совпадение JQLCard Colors использует родные правила Jira — см. устранение неполадок WIP LimitsПроверьте, что JQL-правило существует в настройках Card Colors Jira, а не только в Jira Helper

Устранение неполадок​

Мой JQL работает в поиске Jira, но не в Jira Helper​

  1. Проверьте JQL в расширенном поиске задач Jira (Задачи → Поиск задач → Расширенный)
  2. Скопируйте проверенный запрос точно
  3. Некоторые поля ввода Jira Helper имеют ограничения по длине — упростите длинные запросы
  4. Перезагрузите доску после вставки запроса

Запрос применяется медленно​

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

  • Заменить списки OR на IN, где возможно: status IN (Open, "In Progress", Review)
  • Избегать text ~ "..." на больших досках
  • Разделить одно сложное правило на несколько простых

Цвета карточек не совпадают​

JQL-правила Card Colors оцениваются сверху вниз, и побеждает первое совпадение. Измените порядок правил в родных настройках Card Colors Jira.