Справочник QQL

QQL (Quevell Query Language) это язык, на котором задаются вопросы о задачах: в поиске, в сохраненных фильтрах, на досках и в условиях правил автоматизации. Везде один и тот же язык с одним и тем же разбором: запрос, работающий в поиске, дословно работает в условии правила.

Тому, кто пишет на JQL, синтаксис знаком: =, in, ~, and, order by означают то, что вы ожидаете. Чего в языке нет намеренно: предикатов по истории (was, changed). Каждый оператор QQL исполняется с предсказуемой стоимостью.

Синтаксис#

Запрос это условие и, при желании, сортировка:

status = "In progress" and assignee = currentUser() order by updated desc

• Условия соединяются and и or, группируются скобками, отрицаются not.
• Регистр не важен: Status, status и STATUS это одно поле, AND и and это один союз.
• Пустота проверяется словами: dueDate is empty, assignee is not empty. Пустота как равенство «ничему» не выражается намеренно.
• Списки значений: status in ("To do", "In progress"), assignee not in (anna@example.com, ivan@example.com).
• Запрос из одной сортировки тоже запрос: order by updated desc означает «все, что мне видно, свежее сверху».

Запрос всегда отвечает в пределах видимости спрашивающего: задачи из проектов, которые вам не видны, не существуют для вашего запроса. Это относится и к правилам автоматизации: их условия отвечают глазами аккаунта правила.

Операторы#

Не каждый оператор применим к каждому полю: у даты нет ~, у текста нет >. Такой запрос не выполняется «в никуда», а отклоняется при разборе с указанием места и списка операторов, которые поле принимает. Полный перечень: в таблицах ниже.

Приоритет операторов#

not сильнее and, and сильнее or. Запрос a or b and c означает a or (b and c). Скобки всегда выигрывают: (a or b) and c.

Кавычки и экранирование#

Значение с пробелами или служебными символами берется в кавычки, двойные или одинарные: status = "In progress", summary ~ 'новый офис'. Внутри кавычек нет экранирования: строка с двойными кавычками берется в одинарные и наоборот. Значения без пробелов пишутся как есть: OFFICE-13, -7d, 2026-08-24, anna@example.com.

Значения перечислимых полей распознаются по любому написанию: ключу, названию по умолчанию и каждому переводу. status = "В работе" и status = "In progress" это один запрос: значение становится стабильным ключом, и фильтр переживает переименование статуса.

Системные поля#

Таблица генерируется из кода продукта и не может от него отстать.

Замечания к отдельным полям:

• key и parent принимают ключи задач: key in (OFFICE-1, OFFICE-2), parent = OFFICE-13. Регистр ключа не важен.
• text это то же, что ищет строка поиска: название и описание вместе. Только ~.
• team спрашивает, отмечена ли команда на задаче: team = "Логистика". Одна задача может нести несколько команд, поэтому равенство здесь означает «содержит».
• statusCategory принимает три значения: TODO, IN_PROGRESS, DONE, а также написания to do и in progress.
• priority принимает highest, high, medium, low, lowest.
• Длительности (timeSpent, originalEstimate, remainingEstimate) сравниваются в формате учета времени: timeSpent > 1d, originalEstimate <= 2w, где 1w = 5 дней, 1d = 8 часов.
• startDate и dueDate это календарные дни: «срок на этой неделе» означает одно и то же в любом часовом поясе. created и updated это моменты времени.

Кастомные поля#

Кастомное поле спрашивается по своему имени: Бюджет > 100000, "Дата запуска" < startOfMonth(). Операторы определяются типом поля:

• У числа нет ~: подстрока числа ничего о нем не говорит. У абзаца нет =: точное равенство со страницей текста никто никогда не имел в виду. Многозначный выбор спрашивается только in и not in.
• Поля определяются в проектах, поэтому одно имя может означать несколько определений. Запрос по имени означает их все, пока они одного типа; имя, означающее в одном проекте дату, а в другом абзац, ведет себя как текст.
• Запрос хранит стабильные идентификаторы, а не имена: переименование поля или варианта не ломает сохраненный фильтр.

Функции#

myReports(), myVertical() и myTeammates() называют нескольких людей, поэтому спрашиваются через in: assignee in (myReports()). Форма assignee = myReports() отклоняется с подсказкой. «Моя команда и я» составляется так: assignee in (myReports(), currentUser()).

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

Даты и относительное время#

Поля дат и моментов сравниваются с:

• фиксированной датой: duedate <= 2026-09-15;
• относительным сдвигом: updated > -7d (семь дней назад), duedate <= +7d (семь дней вперед); единицы d, w, m: дни, недели, месяцы;
• функциями: created >= startOfMonth(), updated > startOfWeek().

Люди#

Человек называется по имени или по адресу почты: assignee = "Анна Петрова", assignee = anna@example.com. Если в компании два человека с одним именем, запрос по имени отклоняется и просит адрес: два человека с одним именем это факт о компании, и запрос должен сказать, кого имел в виду.

Сортировка#

order by поле и направление: asc (по умолчанию) или desc. Сортируемость поля указана в таблицах выше; попытка сортировать несортируемое поле отклоняется при разборе. Один ключ сортировки на запрос.

project = OFFICE and status != Done order by duedate asc

Сообщения об ошибках#

Ошибка разбора указывает на позицию в запросе и говорит, что именно не так. Типичные сообщения и их смысл:

Примеры#

assignee = currentUser() and status != Done order by duedate asc

Мои незакрытые задачи, ближайшие сроки сверху.

project in (OFFICE, WAREHOUSE) and priority in (highest, high) and status = "In progress"

Горящее в работе по двум проектам.

assignee in (myVertical()) and duedate < startOfWeek() and status != Done

Просроченное у всех, кто подо мной по структуре.

summary ~ "переезд" or description ~ "переезд"

Задачи, где переезд упомянут в названии или описании. То же самое короче: text ~ "переезд".

type = Bug and created >= -30d and assignee is empty

Дефекты за месяц, у которых нет исполнителя.

"Бюджет" > 500000 and "Дата запуска" <= startOfMonth()

Кастомные поля: число и дата.

team = "Логистика" and remainingEstimate > 1w

Задачи команды, где осталось больше недели работы.