Расширенные функции поиска

Инструкции пользователю JIRA  на этой странице описывают, как использовать функции в JQL для определения структурированных поисковых запросов (queries) для поиска задач JIRA. Результаты поиска будут отображаться в Навигаторе задач, где вы можете экспортировать их в MS Excel и многие другие форматы. Вы также можете сохранить и подписаться на ваш расширенный поиск, если хотите.

Когда вы выполняете расширенный поиск, вы используете JIRA Query Language (JQL).

Справочник функций

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

Этот документ также охватывает зарезервированные символы и слова, которые использует JIRA.

Похожие темы:

  • Основной поиск
  • Расширенный поиск
  • Использование быстрого поиска
  • Выполнение поиска текста

Если не указано в поисковом запросе, обратите внимание, что поиск в поле JQL не возвращает пустые поля в результатах. Чтобы включить пустые поля (например, не назначенные задачи) при поиске задач, которые не назначены текущему пользователю, вы должны ввести (assignee != currentUser() OR assignee is EMPTY), чтобы включить в список результатов неадекватные задачи.

Список функций

cascadeOption ()

Поиск задач, соответствующих выбранным значениям настраиваемого поля «каскадный выбор». Параметр parentOption сопоставляется с первым уровнем параметров в каскадном поле выбора. Параметр childOption сопоставляется с вторым уровнем параметров в каскадном поле выбора и является необязательным.

Ключевое слово «none» можно использовать для поиска задач, когда один или оба параметра не имеют значения.

СИНТАКСИС

cascadeOption (parentOption)

или

cascadeOption (parentOption, childOption)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, когда пользовательское поле («Местоположение») имеет значение «США» для первого уровня и «Нью-Йорк» для второго уровня:

location in cascadeOption("USA","New York")

  • Найти задачи, когда пользовательское поле («Местоположение») имеет значение «США» для первого уровня и любое значение (или нет значения) для второго уровня:

location in cascadeOption("USA")

 

  • Найти задачи, когда пользовательское поле («Местоположение») имеет значение «США» для первого уровня и не имеет значения для второго уровня:

location in cascadeOption("USA",none)

  • Найти задачи, когда пользовательское поле («Местоположение») не имеет значения для первого уровня и не имеет значения для второго уровня:

location in cascadeOption(none)

  • Найти задачи, когда пользовательское поле («Referrer») имеет значение «none» для первого уровня и «none» для второго уровня:

referrer in cascadeOption("\"none\"","\"none\"")

 

  • Найти задачи, когда пользовательское поле («Referrer») имеет значение «none» для первого уровня и не имеет значения для второго уровня:

referrer in cascadeOption("\"none\"",none)

closedSprints()

 Доступно только в том случае, если вы используете JIRA Agile 6.7.

Найдите задачи, которые назначены заполненному Sprint. (Обратите внимание, что задачи могут принадлежать как завершенному Sprint (s), так и неполному Sprint (s)).

См. также openSprints().

СИНТАКСИС

closedSprints ()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти все задачи, связанные с завершенным Sprint.

sprint in closedSprints()

componentsLeadByUser()

Находит задачи в компонентах, которые ведет конкретный пользователь. Вы можете дополнительно указать пользователя, или если пользователь опущен, будет использоваться текущий пользователь (т. е. вы). Обратите внимание: если вы не вошли в JIRA, необходимо указать пользователя.

СИНТАКСИС

componentsLeadByUser ()

или

componentsLeadByUser (имя пользователя)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти открытые задачи в компонентах, которые вы ведете :

component in componentsLeadByUser() AND status = Open

  • Найти открытые задачи в компонентах, которые возглавляет Билл:

component in componentsLeadByUser(bill) AND status = Open

currentLogin()

Выполняет поиск в зависимости от времени начала сеанса текущего пользователя. См. Также lastLogin.

СИНТАКСИС

currentLogin ()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

 

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

  • Найти задачи, которые были созданы во время моего текущего сеанса:

Created> currentLogin ()

currentUser()

Выполняет поиск на основе текущего пользователя.

Обратите внимание: эта функция может использоваться только зарегистрированными пользователями. Поэтому, если вы создаете сохраненный фильтр, который вы ожидаете использовать анонимными пользователями, не используйте эту функцию.

СИНТАКСИС

текущий пользователь()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

  •             Представитель Assignee
  •             Репортер Reporter
  •             Избиратель Voter
  •             Наблюдатель Watcher
  •             Пользовательские поля типа Пользователь

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, которые мне присвоены:

assignee= currentUser ()

 

  • Найти задачи, о которых я сообщил, но не назначены мне:

reporter = currentUser() AND (assignee != currentUser() OR assignee is EMPTY)

 

earliestUnreleasedVersion()

Выполняет поиск на основе самой ранней неизданной версии (то есть следующей версии, которая должна быть выпущена) указанного проекта. См. также unreleasedVersions.

Обратите внимание, что «самый ранний» определяется порядком, назначенным версиям, а не фактическими сроками версии (датами) исполнения.

СИНТАКСИС

СearliestUnreleasedVersion (проект)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, FixVersion которых является самой ранней неизданной версией проекта ABC:

FixVersion = earlyliestUnreleasedVersion (ABC)

  • Найти задачи, связанные с неизданной версией проекта ABC:

AffectedVersion = earlyliestUnreleasedVersion (ABC) или fixVersion = earlyliestUnrelea

endOfDay()

Выполняет поиск в зависимости от конца текущего дня.  См. также endOfWeek, endOfMonth и endOfYear; и startOfDay, startOfWeek, startOfMonth and startOfYear.

СИНТАКСИС

endOfDay()

или

endOfDay("inc")

где inc - необязательное приращение (+/-) nn (y | M | w | d | h | m)Если спецификатор единицы измерения времени опущен, по умолчанию устанавливается естественный период функции, например. EndOfDay ("+ 1") совпадающий с endOfDay ("+ 1d").

Если знак плюс / минус (+/-) опущен, предполагается плюс.

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

  • Найти задачи до конца сегодняшнего дня:

due < endOfDay()

  • Найти задачи, связанные с окончанием завтрашнего дня:

due < endOfDay("+1")

endOfMonth()

Выполняет поиск в зависимости от конца текущего месяца.  См. Также endOfDay, endOfWeek и endOfYear; и startOfDay, startOfWeek, startOfMonth и startOfYear.

СИНТАКСИС

endOfMonth()

или

endOfMonth("inc")

где inc - необязательное приращение (+/-) nn (y | M | w | d | h | m)

  • если спецификатор единицы измерения времени опущен, по умолчанию устанавливается естественный период функции, например. EndOfMonth ("+ 1") совпадающий с endOfMonth ("+ 1M").
  • Если знак плюс / минус (+/-) опущен, предполагается плюс.

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

  • Найти задачи до конца этого месяца:

Due <endOfMonth()

 

  • Найти задачи, возникшие до конца следующего месяца:

due endOfMonth("+1")

 

  • Найти задачи, возникшие до 15 числа следующего месяца:

due endOfMonth("+15d")

 

endOfWeek()

Выполняет поиск по окончании текущей недели. См. также  endOfDay, endOfMonth и endOfYear; и startOfDay, startOfWeek, startOfMonth и startOfYear.

Для функции endOfWeek () результат зависит от вашего местонахождения. Например, в Европе первый день недели обычно считается понедельником, а в США считается воскресеньем.

СИНТАКСИС

endOfWeek ()

 или

endOfWeek ("inc")

где inc - необязательное приращение (+/-) nn (y | M | w | d | h | m)

  • Если спецификатор единицы измерения времени опущен, по умолчанию устанавливается естественный период функции, например. EndOfWeek («+ 1») совпадающий с endofWeek («+ 1w»).
  • Если знак плюс / минус (+/-) опущен, предполагается плюс.

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

  • Найти задачи, которые должны возникнуть к концу этой недели:

Due <endOfWeek ()

  • Найти задачи, возникшие до конца следующей недели:

Due <endOfWeek ("+ 1")

 

 

endOfYear()

Выполняет поиски в зависимости от конца текущего года. См. также startOfDay, startOfWeek и startOfMonth; и endOfDay, endOfWeek, endOfMonth и endOfYear.

endOfYear()

или

endOfYear("inc")

где inc - необязательное приращение (+/-) nn (y | M | w | d | h | m)

  • Если спецификатор единицы измерения времени опущен, по умолчанию устанавливается естественный период функции, например. EndOfYear («+ 1») совпадающий с endofYear («+ 1y»).
  • Если знак плюс / минус (+/-) опущен, предполагается плюс.

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

  • Найти задачи, которые должны возникнуть к концу этого года:

Due <endOfYear ()

 

  • Найти задачи в конце марта следующего года:

due < endOfYear("+3M")

 

issueHistory()

Находит задачи, которые вы недавно просмотрели, то есть задачи, которые находятся в разделе «Последние задачи» в раскрывающемся меню «Задачи».

Заметка:

  • IssueHistory () возвращает до 50 задач, в то время как раскрывающийся список «Недавние задачи» возвращает только 5.
  • Если вы не вошли в JIRA, будут включены только те задачи, которые из вашего текущего сеанса браузера.

СИНТАКСИС

issueHistory ()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Задача Issue

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, которые я недавно просмотрел, которые мне присваиваются:

Issue in issueHistory () AND assignee = currentUser ()

issuesWithRemoteLinksByGlobalId()

Выполняет поиск на основе задач, связанных с удаленными ссылками, имеющими какие-либо из указанных глобальных идентификаторов.

Заметка :

  • Эта функция принимает от 1 до 100 глобальных идентификаторов. Задание 0 или более 100 глобальных идентификаторов приведет к ошибкам.

СИНТАКСИС

issuesWithRemoteLinksByGlobalId ()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Задача Issue

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, связанные с удаленными ссылками, которые имеют globalId «abc»:

issue in issuesWithRemoteLinksByGlobalId(abc)

  • Найти задачи, связанные с удаленными ссылками, которые имеют либо globalId "abc", либо "def"

issue in issuesWithRemoteLinksByGlobalId(abc, def)

issue in issuesWithRemoteLinksByGlobalId(abc, def)

lastLogin()

Выполняет поиск в зависимости от времени начала предыдущего сеанса текущего пользователя. См. Также currentLogin.

СИНТАКСИС

lastLogin()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

Находит задачи, которые были созданы во время моего последнего сеанса:


created > lastLogin()

latestReleasedVersion()

Выполняет поиск на основе последней выпущенной версии (то есть самой последней версии, которая была выпущена) указанного проекта. См. Также releasedVersions().

Обратите внимание, что «последний» определяется порядком, назначенным версиям, а не соотвествующими  датами версии.

СИНТАКСИС

latestReleasedVersion (проект)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, чьи FixVersion - последняя выпущенная версия проекта ABC:

FixVersion = latestReleasedVersion (ABC)

 

  • Найти задачи, связанные с последней выпущенной версией проекта ABC:

AffectedVersion = latestReleasedVersion (ABC) или fixVersion = latestReleasedVersion (ABC)

 

linkedIssues()

Выполняет поиск по задачам, связанной с указанной задачей. Вы можете опционально ограничить поиск ссылками определенного типа. Обратите внимание, что LinkType чувствителен к регистру.

СИНТАКСИС

linkedIssues (issueKey)

или

linkedIssues (issueKey, LinkType)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Задача Issue

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, связанные с определенной задачей:

issue in linkedIssues(ABC-123)

 

  • Найти задачи, связанные с определенной задачей через определенный тип ссылки:

Issue in linkedIssues (ABC-123, “is dublicated by”)

 

membersOf()

Выполняет поиск на основе членов определенной группы.

СИНТАКСИС

Члены (группы)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

  •             Представитель Assignee
  •             Репортер Reporter
  •             Избиратель Voter
  •             Наблюдатель Watcher
  •             Пользовательские поля типа Пользователь

 

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, в которых Assignee является членом группы «jira-разработчиков»:

assignee in membersOf("jira-developers")

 

  • Поиск по нескольким группам и конкретному пользователю, например:

reporter in membersOf("jira-developers") или  reporter in membersOf("jira-administrators") или reporter=jsmith

 

  • Найти определенную группу, но исключите конкретного участника или членов, например:

assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones")

 

  • Исключить членов определенной группы:

assignee not in membersOf(QA)

 

now()

Выполняет поиск на основе текущего времени.

СИНТАКСИС

now()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

  • Найти задачи, которые были просрочены:

duedate < now() and status not in (closed, resolved)

 

openSprints()

Доступно только в том случае, если вы используете JIRA Agile 6.7.

Найдите задачи, которые назначены Sprint, который еще не завершен. (Обратите внимание, что задача может принадлежать как завершенному Sprint (s), так и не завершенному Sprint (ам)).

См. Также closedSprints().

СИНТАКСИС

openSprints ()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Sprint

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти все задачи, которые назначены Sprint, который еще не завершен.

sprint in openSprints()

projectsLeadByUser()

Находит задачи в проектах, которые ведет конкретный пользователь.

Вы можете с помощью опции  указать пользователя, или если пользователь опущен, текущий пользователь будет использоваться.

Обратите внимание: если вы не вошли в JIRA, необходимо указать пользователя.

СИНТАКСИС

projectsLeadByUser ()

или

projectsLeadByUser (имя пользователя)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Проект Project

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найдите открытые задачи в проектах, которые вами ведомы:

project in projectsLeadByUser() AND status = Open

 

  • Найдите открытые задачи в проектах, которые возглавляет Билл:

project in projectsLeadByUser(bill) AND status = Open

 

projectsWhereUserHasPermission()

Находит задачи в проектах, где у вас есть определенное разрешение.

Примечание. Эта функция работает на уровне проекта. Это означает, что если разрешение (например, «Редактировать задачи») предоставляется репортеру задач в проекте, вы можете увидеть некоторые проблемы, которые были возвращены туда, где вы не репортер и поэтому не имеют указанного разрешения.

Также обратите внимание, что эта функция доступна только в том случае, если вы вошли в JIRA.

СИНТАКСИС

projectsWhereUserHasPermission (разрешение)

Для параметра разрешения вы можете указать любое из следующего:

Разрешения на проект

Объяснение

Администрирование проектов

Разрешение на администрирование проекта в JIRA. Это включает в себя возможность редактирования членства в роли проекта, компонентов проекта, версий проекта и некоторых деталей проекта («Название проекта», «URL», «Ведение проекта», «Описание проекта»).

Просмотр проектов

 

Разрешение на просмотр проектов, использование Навигатора задач и просмотр отдельных задач (кроме задач, которые были ограничены с помощью безопасности задач). Многие другие разрешения зависят от этого разрешения, например. Разрешение «Работа над задачами» действует только для пользователей, у которых также есть разрешение «Обзор проектов».

Просмотреть инструменты разработки

 

Разрешение на просмотр панели разработки, которая отображает информацию от Bitbucket, GitHub, FishEye, Crucible и Bamboo, если JIRA интегрирована с совместимыми версиями этих приложений.Для более старых версий сервера Bitbucket (ранее Stash) и FishEye или для Subversion и CVS это дает разрешение на просмотр связанного исходного кода для какой-либо задачи на вкладках «Commits» и «Source». Обратите внимание, что для CVS для просмотра связанного исходного кода проект должен быть связан как минимум с одним репозиторием.

Режим просмотра (только для чтения)

рабочего процесса

Разрешение просматривать рабочий процесс проекта «только для чтения» при просмотре задачи. Это разрешение предоставляет ссылку «Просмотр рабочего процесса» в поле «Статус» на странице «Просмотр задачи».

Разрешения на задачу

 

объяснение

Назначение  задач

 

Разрешение назначать пользователям задачи. Также разрешает автозаполнение пользователей в раскрывающемся списке Назначить задачу . (См. также «Назначаемое разрешение пользователя» ниже)

Назначаемый пользователь

 

Разрешение на назначение задач. (Обратите внимание, что это не включает возможность назначать задачи, см. раздел «разрешение назначения задачи выше»).

Закрытие задач

 

Разрешение на закрытие задач. (Это разрешение полезно, когда, например, разработчики решают задачи, а тестеры закрывают их). Также см. разрешение «Разрешить проблемы».

Создание задач

 

Разрешение на создание задач в проекте. (Обратите внимание, что для создания вложений требуется разрешение Create Attachments.) Включает возможность создания подзадач (если подзадачи включены).

Удаление задач

 

Разрешение на удаление задач. Подумайте о том, какие группы или роли проекта назначают это разрешение; Обычно он предоставляется только администраторам. Обратите внимание, что удаление задачи удаляет все свои комментарии и вложения, даже если у пользователя нет разрешений «Удалить комментарии» или «Удалить вложения». Однако разрешение «Удалить задачи» не включает возможность удаления отдельных комментариев или вложений.

Редактирование задач

 

Разрешение на редактирование задач (за исключением поля «Дата погашения» - см. Разрешение «Расписание задач»). Включает возможность преобразования задач в подзадачи и наоборот (если подзадачи включены). Обратите внимание, что для удаления задач требуется разрешение «Удалить задачу». Разрешение «Редактировать задачу» обычно предоставляется любым группам или ролям проекта, у которых есть разрешение «Создать задачу» (возможно, единственное исключение - если вы даете каждому возможность создавать проблемы), может быть нецелесообразно давать каждому возможность редактировать тоже ). Обратите внимание, что все изменения записываются в историю изменений задачи для целей аудита.

Ссылки на задачи

 

Разрешение на связывание задач вместе. (Только релевантных, а также тех у которых включена ссылка на задачу).

Изменить репортера

 

Разрешение на изменение «Репортера» задачи. Это позволяет пользователю создавать задачи «от имени кого-то другого». Это разрешение обычно предоставляется только администраторам.

Перемещение задачи

 

Разрешение переместить задачи из одного проекта в другой или из одного рабочего процесса в другой рабочий процесс в рамках одного проекта. Обратите внимание, что пользователь может перемещать только задачи в проект, для которого у них есть разрешение на создание задачи.

Решение задач

 

Разрешение на решение и повторное открытие задач. Это также включает возможность установки поля «Исправить  версии» для задач. Также см. разрешение «Закрыть задачи».

Планирование задач

 

Разрешение планировать задачу, то есть редактировать «Срок выполнения» задачи. В более ранних версиях JIRA это также контролировало разрешение на просмотр «Дата выполнения» задачи.

Установление безопасности задачи

 

Разрешение установить уровень безопасности на задачу, чтобы контролировать, кто может получить доступ к этой задаче. Только релевантно, если  безопасность задачи включена.

Задача перехода

 Разрешение на переход (изменение) статуса задачи.

Разрешение избирателей и наблюдателей

 

Объяснение

Управление списком наблюдателей

 

Разрешение на управление (т. е. Просмотр / добавление / удаление пользователей в / из) списка наблюдателей задачи.

Просмотр избирателей и наблюдателей

 

Разрешение на просмотр списка избирателей и списка наблюдателей. Также см. разрешение «Управление списком наблюдателей».

Разрешения комментирования

 

объяснение

Добавить комментарий

 

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

Удалить все комментарии

 

Разрешение удалять любые комментарии, независимо от того, кто их добавил.

Удалить собственные комментарии

Разрешение удалять комментарии, добавленные пользователем.

Редактировать все комментарии

 

Разрешение на редактирование любых комментариев, независимо от того, кто их добавил.

Редактировать собственные комментарии

 

Разрешение редактировать комментарии, добавленные пользователем.

Разрешения вложений

 

объяснение

Создать вложения

 

Разрешение на прикрепление файлов к задаче. (Учитывается только в том случае, если вложения включены). Обратите внимание, что это не включает возможность удаления вложений.

Удалить все вложения

 

Разрешение удалять любые вложения, независимо от того, кто их добавил.

Удалить собственные вложения

 

Разрешение на удаление вложений, добавленных пользователем.

Разрешения на отслеживание времени

 

объяснение

Работа над задачами

 

Разрешение на работу журнала с задачей, т. е. создание записи в рабочий журнал. (Учитывается только, если включена функция отслеживания времени).

Удалить все журналы

 

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

Удаление собственных журналов

 

Разрешение на удаление записей в журнале, которые были добавлены пользователем. (Учитывается только, если включена функция отслеживания времени). Также см. разрешение «Работа над запросами».

Редактировать все журналы

 

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

Редактировать собственные рабочие журналы

 

Разрешение редактировать записи в журнале, которые были добавлены пользователем. (Учитывается только, если включена функция отслеживания времени). Также см. Разрешение «Работы над задачами».

 

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти открытые задачи в проектах, где у вас есть разрешение «Решение задачи»:

project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open

 

projectsWhereUserHasRole()

Находит задачи в проектах, где у вас есть определенная роль.

Обратите внимание, что эта функция доступна только в том случае, если вы вошли в JIRA.

СИНТАКСИС

projectsWhereUserHasRole (RoleName)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

 

ПРИМЕРЫ

  • Найдите открытые задачи в проектах, в которых у вас есть роль «Разработчики»:

project in projectsWhereUserHasRole("Developers") AND status = Open

 

releasedVersions()

Выполняет поиск на основе выпущенных версий (то есть версий, которые администратор JIRA выпустил) указанного проекта.

Вы также можете выполнять поиск по выпущенным версиям всех проектов, опуская параметр проекта.

См. также latestReleasedVersion().

СИНТАКСИС

releasedVersions()

или

releasedVersions (проект)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

 

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачу, FixVersion которых является выпущенной версией проекта ABC:

fixVersion in releasedVersions(ABC)

 

  • Найти задачи, связанные с выпущенными версиями проекта ABC:

(affectedVersion in releasedVersions(ABC)) or (fixVersion in releasedVersions(ABC))

 

 

standardIssueTypes()

Выполняет поиск на основе «стандартных» типов задач, то есть ищет задачи, которые не являются подзадачами.

См. также subtaskIssueTypes().

СИНТАКСИС

standardIssueTypes ()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, которые не являются подзадачами (например, задачи, тип  которых является стандартным типом задачи, а не типом подзадачи):

issuetype in standardIssueTypes()

 

startOfDay()

Выполняет поиск в зависимости от начала текущего дня.  См. также startOfWeek, startOfMonth и startOfYear; и endOfDay, endOfWeek, endOfMonth и endOfYear.

СИНТАКСИС

startOfDay ()

или

startOfDay ( "inc")

где inc - необязательное приращение (+/-) nn (y | M | w | d | h | m)

  • Если спецификатор единицы измерения времени опущен, по умолчанию устанавливается естественный период функции, например. StartOfDay («+ 1») совпадает с startofDay («+ 1d»).
  • Если знак плюс / минус (+/-) опущен, предполагается плюс.

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

  • Найти новые задачи, созданные с начала сегодняшнего дня:

created > startOfDay()

 

  • Найти новые задачи, созданные с начала вчерашнего дня:

created > startOfDay("-1")

 

  • Найти новые задачи, созданные за последние три дня:

created > startOfDay("-3d")

 

startOfMonth()

Выполняет поиск в зависимости от начала текущего месяца.  См. Также endOfDayendOfMonth и endOfYear; и startOfDaystartOfWeekstartOfMonth и startOfYear.

СИНТАКСИС

startOfMonth ()

или

startOfMonth ( "inc")

Где inc - необязательное приращение (+/-) nn (y | M | w | d | h | m)

  • Если спецификатор единицы измерения времени опущен, по умолчанию устанавливается естественный период функции, например. StartOfMonth ("+ 1") совпадает с startofMonth ("+ 1M").
  • Если знак плюс / минус (+/-) опущен, предполагается плюс.

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

ПРИМЕРЫ

  • Найти новые задачи с начала этого месяца:

created> startOfMonth ()

 

  • Найти новые задачи с начала прошлого месяца:

created> startOfMonth ("- 1")

 

  • Найти новые задачи с 15 числа этого месяца:

created> startOfMonth ("+ 14d")

 

startOfWeek()

Выполняет поиск в зависимости от начала текущей недели.См. также startOfDay, startOfMonth и startOfYear; и endOfDay, endOfWeek, endOfMonth и endOfYear.

Для функции startOfWeek () результат зависит от вашего местонахождения. Например, в Европе первый день недели обычно считается понедельником, а в США считается воскресеньем.(Info) См. «Настройка региона» в JIRA для получения дополнительной информации.

СИНТАКСИС

startOfWeek ()

или

startOfWeek ( "inc")

Где inc - необязательное приращение (+/-) nn (y | M | w | d | h | m)

  • Если спецификатор единицы измерения времени опущен, по умолчанию устанавливается естественный период функции, например. StartOfWeek («+ 1») совпадает с startofWeek («+ 1w»).
  • Если знак плюс / минус (+/-) опущен, предполагается плюс.

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

 

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

 

ПРИМЕРЫ

  • Найти новые задачи с начала этой недели:

created > startOfWeek()

 

  • Найти новые задачи с начала прошлой недели:

created > startOfWeek("-1")

 

startOfYear()

Выполняет поиск по состоянию на начало текущего года. См. также  startOfDay, startOfWeek и startOfMonth; и endOfDay, endOfWeek, endOfMonth и endOfYear.

или

 startOfYear ( "inc ")

где inc - необязательное приращение (+/-) nn (y | M | w | d | h | m)

  • Если спецификатор единицы измерения времени опущен, по умолчанию устанавливается естественный период функции, например. StartOfYear («+ 1») совпадает с startofYear («+ 1y»).
  • Если знак плюс / минус (+/-) опущен, предполагается плюс.

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS нет
IS NOT нет
IN нет
NOT IN нет
WAS (только в предикате)
WAS IN (только в предикате)
WAS NOT (только в предикате)
WAS NOT IN (только в предикате)
CHANGED (только в предикате)

 

 

ПРИМЕРЫ

  • Найти новые задачи с начала этого года:

created> startOfYear ()

  • Найти новые задачи с начала прошлого года:

created> startOfYear ("- 1")

 

subtaskIssueTypes()

Выполняет поиск по задачам, которые являются подзадачами.

См. также standardIssueTypes ().

СИНТАКСИС

subtaskIssueTypes()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Тип Type

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, которые являются подзадачами (например, задачи, тип которых является типом задачи подзадачи):

Issueetype в subtaskIssueTypes ()

 

unreleasedVersions()

Выполняет поиск на основе неизданных версий (то есть версий, которые администратор JIRA еще не выпустил) указанного проекта.

Вы также можете выполнять поиск по невыпущенным версиям всех проектов, опустив параметр проекта.

См. также earlyUnreleasedVersion().

СИНТАКСИС

unreleasedVersions()

или

unreleasedVersions (проект)

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

 

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найдите задачи, чьи FixVersion являются невыпущенной версией проекта ABC:

fixVersion in unreleasedVersions(ABC)

 

  • Найдите задачи, связанные с невыпущенными версиями проекта ABC:

affectedVersion in unreleasedVersions(ABC)
или
fixVersion in unreleasedVersions(ABC)

 

votedIssues()

Выполняет поиск по тем задачам, за которые вы голосовали. Также см. Поле «Избиратель».Обратите внимание: эта функция может использоваться только зарегистрированными пользователями.

СИНТАКСИС

votedIssues ()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Задача Issue

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, за которые вы голосовали:

issue in votedIssues()

 

watchedIssues()

Выполняет поиск на основе задач, которые вы наблюдаете. Также см. Поле Наблюдатель.

Обратите внимание: эта функция может использоваться только зарегистрированными пользователями.

СИНТАКСИС

watchedIssues ()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Задача Issue

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, за которыми вы наблюдаете:

issue in watchedIssues()

ПОДДЕРЖИВАЕМЫЕ ПОЛЯ

Задача Issue

ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ

Оператор Поддержка
= нет
!= нет
~ нет
!~ нет
> нет
>= нет
< нет
<= нет
IS нет
IS NOT нет
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

ПРИМЕРЫ

  • Найти задачи, которые вы недавно просматривали:

issue in issueHistory ()

 

Зарезервированные символы

JQL имеет список зарезервированных символов:

  • Пространство(пробел)(" ")
  • "+"
  • "."
  • ","
  • ";"
  • "?"
  • "|"
  • "*"
  • "/"
  • "%"
  • "^"
  • "$"
  • "#"
  • "@"
  • "["
  • "]"

Если вы хотите использовать эти символы в задачах, вам необходимо:

  • Заключать их кавычками (вы можете использовать либо одиночные кавычки ('), либо двойные кавычки («));

и, если вы ищете текстовое поле и символ находится в списке зарезервированных символов для поиска текста,

  • предшествуют им две обратные косые черты.

 

Текстовые поля:

  • Резюме Summary
  • Описание Description
  • Окружающая среда Environment
  • Комментарии Comments
  • Настраиваемые поля, в которых используется «Free Text Searcher»; это включает настраиваемые поля следующих встроенных настраиваемых типов полей:
  • Свободное текстовое поле (неограниченный текст)
  • Текстовое поле (<255 символов)
  • Текстовое поле только для чтения

Поле JQL «текст», как в тексте ~ «несколько слов», выполняет поиск «Резюме», «Описание», «Среда», «Комментарии». Он также ищет все текстовые поля. Если у вас много текстовых полей, вы можете повысить производительность своих задач, выполнив поиск по определенным полям, например.Резюме ~ "несколько слов" ИЛИ Описание ~ "некоторые слова"

Например:


version = "[example]"
version = "4.2"
summary ~ "\\[example\\]"
summary ~ "4.2"

 

Зарезервированные слова:

JQL имеет список зарезервированных слов. Эти слова должны быть заключены кавычками, если вы хотите использовать их в запросах:

"abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "as", "asc",
"audit", "avg", "before", "begin", "between", "boolean", "break", "by", "byte", "catch", "cf",
"char", "character", "check", "checkpoint", "collate", "collation", "column", "commit", "connect", "continue",
"count", "create", "current", "date", "decimal", "declare", "decrement", "default", "defaults", "define", "delete",
"delimiter", "desc", "difference", "distinct", "divide", "do", "double", "drop", "else", "empty", "encoding",
"end", "equals", "escape", "exclusive", "exec", "execute", "exists", "explain", "false", "fetch", "file", "field",
"first", "float", "for", "from", "function", "go", "goto", "grant", "greater", "group", "having",
"identified", "if", "immediate", "in", "increment", "index", "initial", "inner", "inout", "input", "insert",
"int", "integer", "intersect", "intersection", "into", "is", "isempty", "isnull", "join", "last", "left",
"less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify",
"modulo", "more", "multiply", "next", "noaudit", "not", "notin", "nowait", "null", "number", "object",
"of", "on", "option", "or", "order", "outer", "output", "power", "previous", "prior", "privileges",
"public", "raise", "raw", "remainder", "rename", "resource", "return", "returns", "revoke", "right", "row",
"rowid", "rownum", "rows", "select", "session", "set", "share", "size", "sqrt", "start", "strict",
"string", "subtract", "sum", "synonym", "table", "then", "to", "trans", "transaction", "trigger", "true",
"uid", "union", "unique", "update", "user", "validate", "values", "view", "when", "whenever", "where",
"while", "with"

 

 

 

(Примечание для администраторов JIRA: этот список жестко закодирован в файле JqlStringSupportImpl.java.)

 

Оператор Поддержка
= есть
!= есть
~ нет
!~ нет
> есть
>= есть
< есть
<= есть
IS есть
IS NOT есть
IN есть
NOT IN есть
WAS нет
WAS IN нет
WAS NOT нет
WAS NOT IN нет
CHANGED нет

 

Эта функция принимает от 1 до 100 глобальных идентификаторов. Задание 0 или более 100 глобальных идентификаторов приведет к ошибкам.

По материалам Atlassian JIRA User's Guide: Advanced Searching Functions