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

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

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

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

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

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

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

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

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

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

• cascadeOption()
• closedSprints()
• componentsLeadByUser()
• currentLogin()
• currentUser()
• earliestUnreleasedVersion()
• endOfDay()
• endOfMonth()
• endOfWeek()
• endOfYear()
• issueHistory()
• issuesWithRemoteLinksByGlobalId()
• lastLogin()
• latestReleasedVersion()
• linkedIssues()
• membersOf()
• now()
• openSprints()
• projectsLeadByUser()
• projectsWhereUserHasPermission()
• projectsWhereUserHasRole()
• releasedVersions()
• standardIssueTypes()
• startOfDay()
• startOfMonth()
• startOfWeek()
• startOfYear()
• subtaskIssueTypes()
• unreleasedVersions()
• votedIssues()
• watchedIssues()

cascadeOption ()

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

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

СИНТАКСИС

cascadeOption (parentOption)

или

cascadeOption (parentOption, childOption)

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

• Пользовательские поля типа «Каскадный выбор»

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

 

ПРИМЕРЫ

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

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 ()

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

• Спринт Sprint

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

 

ПРИМЕРЫ

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

sprint in closedSprints()

componentsLeadByUser()

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

СИНТАКСИС

componentsLeadByUser ()

или

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

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

• Компонент Component

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

 

ПРИМЕРЫ

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

component in componentsLeadByUser() AND status = Open

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

component in componentsLeadByUser(bill) AND status = Open

currentLogin()

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

СИНТАКСИС

currentLogin ()

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

 

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

 

ПРИМЕРЫ

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

Created> currentLogin ()

currentUser()

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

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

СИНТАКСИС

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

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

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

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

 

ПРИМЕРЫ

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

assignee= currentUser ()

 

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

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

 

earliestUnreleasedVersion()

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

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

СИНТАКСИС

СearliestUnreleasedVersion (проект)

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

• AffectedVersion (затронутая версия)
• FixVersion (исправленная версия)

• Пользовательские поля типа Версии

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

 

ПРИМЕРЫ

• Найти задачи, 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").

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

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

ПРИМЕРЫ

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

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").
• Если знак плюс / минус (+/-) опущен, предполагается плюс.

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

ПРИМЕРЫ

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

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»).
• Если знак плюс / минус (+/-) опущен, предполагается плюс.

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

ПРИМЕРЫ

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

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»).
• Если знак плюс / минус (+/-) опущен, предполагается плюс.

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

ПРИМЕРЫ

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

Due <endOfYear ()

 

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

due < endOfYear("+3M")

 

issueHistory()

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

Заметка:

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

СИНТАКСИС

issueHistory ()

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

Задача Issue

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

 

ПРИМЕРЫ

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

Issue in issueHistory () AND assignee = currentUser ()

issuesWithRemoteLinksByGlobalId()

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

Заметка :

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

СИНТАКСИС

issuesWithRemoteLinksByGlobalId ()

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

Задача Issue

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

 

ПРИМЕРЫ

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

issue in issuesWithRemoteLinksByGlobalId(abc)

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

issue in issuesWithRemoteLinksByGlobalId(abc, def)

issue in issuesWithRemoteLinksByGlobalId(abc, def)

lastLogin()

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

СИНТАКСИС

lastLogin()

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

ПРИМЕРЫ

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

created > lastLogin()

latestReleasedVersion()

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

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

СИНТАКСИС

latestReleasedVersion (проект)

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

• AffectedVersion (затронутая версия)
• FixVersion (исправленная версия)
• Пользовательские поля типа Версии

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

 

ПРИМЕРЫ

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

FixVersion = latestReleasedVersion (ABC)

 

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

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

 

linkedIssues()

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

СИНТАКСИС

linkedIssues (issueKey)

или

linkedIssues (issueKey, LinkType)

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

Задача Issue

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

 

ПРИМЕРЫ

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

issue in linkedIssues(ABC-123)

 

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

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

 

membersOf()

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

СИНТАКСИС

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

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

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

 

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

 

ПРИМЕРЫ

• Найти задачи, в которых 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()

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

ПРИМЕРЫ

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

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

 

openSprints()

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

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

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

СИНТАКСИС

openSprints ()

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

Sprint

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

 

ПРИМЕРЫ

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

sprint in openSprints()

projectsLeadByUser()

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

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

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

СИНТАКСИС

projectsLeadByUser ()

или

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

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

Проект Project

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

 

ПРИМЕРЫ

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

project in projectsLeadByUser() AND status = Open

 

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

project in projectsLeadByUser(bill) AND status = Open

 

projectsWhereUserHasPermission()

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

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

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

СИНТАКСИС

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

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

 

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

• Проект Project

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

 

ПРИМЕРЫ

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

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

 

projectsWhereUserHasRole()

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

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

СИНТАКСИС

projectsWhereUserHasRole (RoleName)

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

• Проект Project

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

 

 

ПРИМЕРЫ

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

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

 

releasedVersions()

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

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

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

СИНТАКСИС

releasedVersions()

или

releasedVersions (проект)

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

• AffectedVersion (затронутая версия)
• FixVersion (исправленная версия)
• Пользовательские поля типа Версии

 

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

 

ПРИМЕРЫ

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

fixVersion in releasedVersions(ABC)

 

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

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

 

 

standardIssueTypes()

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

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

СИНТАКСИС

standardIssueTypes ()

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

• Тип Type

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

 

ПРИМЕРЫ

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

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»).
• Если знак плюс / минус (+/-) опущен, предполагается плюс.

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

ПРИМЕРЫ

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

created > startOfDay()

 

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

created > startOfDay("-1")

 

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

created > startOfDay("-3d")

 

startOfMonth()

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

СИНТАКСИС

startOfMonth ()

или

startOfMonth ( "inc")

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

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

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

ПРИМЕРЫ

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

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»).
• Если знак плюс / минус (+/-) опущен, предполагается плюс.

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

 

 

ПРИМЕРЫ

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

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»).
• Если знак плюс / минус (+/-) опущен, предполагается плюс.

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

• Created
• Due
• Resolved
• Updated
• Пользовательские поля типа Дата /Время

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

 

 

ПРИМЕРЫ

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

created> startOfYear ()

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

created> startOfYear ("- 1")

 

subtaskIssueTypes()

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

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

СИНТАКСИС

subtaskIssueTypes()

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

Тип Type

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

 

ПРИМЕРЫ

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

Issueetype в subtaskIssueTypes ()

 

unreleasedVersions()

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

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

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

СИНТАКСИС

unreleasedVersions()

или

unreleasedVersions (проект)

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

• AffectedVersion (затронутая версия)
• FixVersion (исправленная версия)
• Пользовательские поля типа Версии

 

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

 

ПРИМЕРЫ

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

fixVersion in unreleasedVersions(ABC)

 

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

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

 

votedIssues()

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

СИНТАКСИС

votedIssues ()

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

Задача Issue

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

 

ПРИМЕРЫ

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

issue in votedIssues()

 

watchedIssues()

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

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

СИНТАКСИС

watchedIssues ()

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

Задача Issue

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

 

ПРИМЕРЫ

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

issue in watchedIssues()

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

Задача Issue

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

 

ПРИМЕРЫ

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

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.)

 

 

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

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