Ключевое слово в JQL - это слово или фраза, которое разрешает любую операцию из следующего списка:
- объединяет два или большее количество предложений вместе для формирования сложного JQL- запроса (query)
- изменяет логику одного или нескольких условий
- изменяет логику операторов
- имеет явное определение в задаче JQL
- выполняет определенную функцию, которая изменяет результаты задачи JQL.
Список ключевых слов:
AND
Используется для объединения нескольких предложений, что позволяет уточнить ваш поиск.
Обратите внимание, что вы можете использовать круглые скобки для управления порядком, в котором выполняются предложения.
ПРИМЕРЫ
- Найти все открытые задачи в проекте «Новый офис»:
project = "New office" and status = "open"
- Найти все открытые, срочные задачи, которые назначены jsmith:
status = open and priority = urgent and assignee = jsmith
- Найти все задачи в конкретном проекте, которые не назначены jsmith:
project = JRA and assignee != jsmith
- Найти все задачи для конкретной версии, которая состоит из разных номеров версий в нескольких проектах:
project in (JRA,CONF) and fixVersion = "3.14"
- Найти все задачи, в которых ни Репортер, ни Правопреемник не Джек, Джилл или Джон:
reporter not in (Jack,Jill,John) and assignee not in (Jack,Jill,John)
ИЛИ OR
Используется для объединения нескольких предложений, что позволяет расширить поиск. Обратите внимание, что вы можете использовать круглые скобки для управления порядком, в котором выполняются предложения.(Примечание: также см. IN, что может быть более удобным способом поиска нескольких значений поля.)
ПРИМЕРЫ
- Найти все задачи, которые были созданы либо jsmith, либо jbrown:
reporter = jsmith or reporter = jbrown
- Найти все задачи, которые были просрочены или когда не установлен срок оплаты:
duedate < now() or duedate is empty
НЕ NOT
Используется для отрицания отдельных предложений или сложного JQL-запроса (query) (запроса query , состоящего из более чем одного предложения) с использованием круглых скобок, что позволяет уточнить ваш поиск.(Примечание: также см. НЕ РАВНО («! =»), НЕ СОДЕРЖИТ («! ~»), НЕ ВХОДИТ И НЕ.).
ПРИМЕРЫ
- Найти все задачи, которые назначены любому пользователю, кроме jsmith:
not assignee = jsmith
- Найти все задачи, которые не были созданы ни jsmith, ни jbrownnot (reporter = jsmith or reporter = jbrown)
not (reporter = jsmith or reporter = jbrown)
EMPTY
Используется для поиска задач, в которых заданное поле не имеет значения. См. также NULL.
Обратите внимание: EMPTY может использоваться только с полями, поддерживающими операторы IS и IS NOT. Чтобы увидеть поддерживаемые оператором поля, проверьте отдельную ссылку на поле.
(предупреждение) EMPTY не эквивалентно NOT EQUALS (! =)
ПРИМЕРЫ
- Найти все задачи без DueDate:
duedate = empty
или
duedate is empty
НОЛЬ NULL
Используется для поиска задач, в которых заданное поле не имеет значения. См. Также EMPTY.
Обратите внимание: NULL может использоваться только с полями, поддерживающими операторы IS и IS NOT. Чтобы увидеть поддерживаемые оператором поля, проверьте отдельную ссылку на поле.
ПРИМЕРЫ
- Найти все задачи без DueDate:
duedate = null
или
duedate is null
СОРТИРОВАТЬ ПО ORDER BY
Используется для указания полей, значения которых будут отсортированы по результатам поиска.
По умолчанию будет использоваться собственный порядок сортировки поля. Вы можете переопределить это, указав восходящий порядок («asc») или убывающий порядок («desc»).
ПРИМЕРЫ
- Найти все задачи без DueDate, отсортированные по CreationDate:
duedate = empty order by created
- Найти все задачи без DueDate, отсортированные по CreationDate, затем по приоритету (от самого высокого до самого низкого):
duedate = empty order by created, priority desc
- Найти все задачи без DueDate, отсортированные по CreationDate, затем по приоритету (от самого низкого до самого высокого):
duedate = empty order by created, priority asc
По материалам Atlassian JIRA User's Guide: Advanced Searching - Keywords Reference