Поиск задач в JIRA (простым языком). Часть 2: Продвинутый поиск07.05.2019 15:17
Функция
Описание
Синтаксис
Доступные операторы
Примеры
approved ()
Только для JIRA Service Desk.Для отбора задач JIRA Service Desk, требующих согласования, окончательное решение по которым одобрено.Применяется к полям типа «Approvals».
approved ()
=
approval = approved ()
approver ()
Только для JIRA Service Desk.Для отбора задач JIRA Service Desk, требующих согласования или уже согласованные одним или всеми из указанных пользователей.Применяется к полям типа «Approvals».
approver (user, user)
=
approval = approver (demo_1, demo_2)
cascadeOption ()
Для отбора задач по значению каскадного поля (полей зависимых списков).
cascadeOption (parentOption)cascadeOption (parentOption, childOption)
IN, NOT IN
«Вид запроса» in cascadeOption («Застройщик», «Пролонгация»)
closedSprints ()
Применимо к полю «Sprint».Для отбора задач, добавленных в завершенные спринты.
closedSprints ()
IN, NOT IN
sprint in closedSprints ()
componentsLeadByUser ()
Применимо к полю «Components» (Компоненты).Для отбора задач, в поле «Components» (Компоненты) которых выбран компонент, лидом которого являетесь вы сами или выбранный вами пользователь.
ComponentsLeadByUser () используетсядля отбора задач по текущему пользователюcomponentsLeadByUser (username)
IN, NOT IN
component in componentsLeadByUser () — лидом компонентов являетесь вы сами.component in componentsLeadByUser (demo_1) — лидом компонентов является пользователь demo_1.
currentLogin ()
Возвращает время начала сеанса текущего пользователя.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата дата-время.
currentLogin ()
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
created > currentLogin ()
currentUser ()
Возвращает логин текущего авторизованного пользователя.Используется для создания выражений с полями «Reporter» (Автор), «Assignee» (Исполнитель), «Voter», «Watcher» и кастомными полями формата «User».
currentUser ()
=, !=
reporter = currentUser ()assignee!= currentUser () OR assignee is EMPTY
earliestUnreleasedVersion ()
Для поиска на основе самой ранней не выпущенной версии (т. е. следующей версии, которая должна быть выпущена) указанного проекта.ВниманиеСамая ранняя не выпущенная версия определяется порядком, а не датами.Применяется для создания выражений с полями «AffectedVersion» (Проявляется в версиях»), «FixVersion» (Исправлено в версиях), кастомными полями формата Version.
earliestUnreleasedVersion (project)
IN, NOT IN
affectedVersion = earliestUnreleasedVersion (ABC)fixVersion = earliestUnreleasedVersion (ABC)
endOfDay ()
Для поиска по концу текущего дня.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата даты-времени.
endOfDay ()endOfDay («inc»)где inc — опциональный инкримент (±)nn (y|M|w|d|h|m).Если спецификатор единицы измерения времени опущен, по умолчанию используется естественный период функции, т. е. 1 день. Если опущен знак ±, то по умолчанию предполагается +.
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
due < endOfDay() — срок исполнения до конца текущего дня.due < endOfDay("+1") —срок исполнения до конца завтрашнего дня.
endOfMonth()
Для поиска по концу текущего месяца.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата дата-время.
endOfMonth()endOfMonth(«inc»)где inc — опциональный инкримент (±)nn(y|M|w|d|h|m).Если спецификатор единицы измерения времени опущен, по умолчанию используется естественный период функции, т. е. 1 месяц. Если опущен знак ±, то по умолчанию предполагается +.
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
due < endOfMonth() — срок исполнения до конца текущего месяца.due < endOfMonth("+15d") — срок исполнения до 15-го числа следующего месяца.
endOfWeek()
Для поиска по концу текущей недели.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата дата-время.
endOfWeek()endOfWeek(«inc»),где inc — опциональный инкримент (±)nn(y|M|w|d|h|m).Если спецификатор единицы измерения времени опущен, по умолчанию используется естественный период функции,т. е. 1 неделя. Если опущен знак ±, то по умолчанию предполагается +.
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
due < endOfWeek() — срок исполнениядо конца текущей недели.due < endOfWeek("+1") — срок исполнения до конца следующей недели.
endOfYear()
Для поиска по концу текущего года.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата дата-время.
endOfYear()endOfYear(«inc»)где inc — опциональный инкримент (±)nn(y|M|w|d|h|m).Если спецификатор единицы измерения времени опущен, по умолчанию используется естественный период функции, т. е. 1 год. Если опущен знак ±, то по умолчанию предполагается +.
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
due < endOfYear() — срок исполнения до конца текущего года.due < endOfYear("+3M") — срок исполнения до конца марта следующего года.
issueHistory()
Возвращает последние 50 просмотренных вами задач.
issueHistory()
IN, NOT IN
issue in issueHistory()
issuesWithRemoteLinksByGlobalId()
Для отбора задач, имеющих внешние ссылки с определенными global ids.ВниманиеФункция позволяет вводить идентификаторы global id в количестве от 1 до 100. Пустой вызов функции или вызов функции с количеством параметров > 100 приведет к ошибке.
issuesWithRemoteLinksByGlobalId ()
IN, NOT IN
issue in issuesWithRemoteLinksByGlobalId (abc, def)
lastLogin ()
Возвращает время начала предыдущего сеанса текущего пользователя.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата дата-время.
lastLogin ()
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
created > lastLogin ()
latestReleasedVersion ()
Для поиска на основе самой последней выпущенной версии указанного проекта.ВниманиеСамая последняя выпущенная версия определяется порядком, а не датами.Применяется для создания выражений с полями «AffectedVersion» (Проявляется в версиях), «FixVersion» (Исправлено в версиях), кастомными полями формата Version.
latestReleasedVersion (project)
=, !=
affectedVersion = latestReleasedVersion (ABC)fixVersion = latestReleasedVersion (ABC)
linkedIssues ()
Для отбора задач по признаку наличия связи с определенной задачей.ВниманиеLinkType чувствителен к регистру.
linkedIssues (issueKey)linkedIssues (issueKey, linkType)
IN, NOT IN
issue in linkedIssues (ABC-123, «is duplicated by»)
membersOf ()
Для отбора задач по признаку принадлежности пользователя из определенного поля определенной JIRA-группе.Используется для создания выражений с полями «Reporter» (Автор), «Assignee» (Исполнитель), «Voter», «Watcher» и кастомными полями формата «User».
membersOf (Group)
IN, NOT IN
assignee not in membersOf (QA)
myApproval ()
Только для JIRA Service Desk.Для отбора задач JIRA Service Desk, требующих согласования текущего пользователя или уже согласованных текущим пользователем.Применяется к полям типа «Approvals».
myApproval ()
=
approval =myApproval ()
myPending ()
Только для JIRA Service Desk.Для отбора задач JIRA Service Desk, требующих согласования текущего пользователя.Применяется к полям типа «Approvals».
myPending ()
=
approval = myPending ()
now ()
Для поиска за текущее время.Используется для создания выражений с полями «Reporter» (Автор), «Assignee» (Исполнитель), «Voter», «Watcher» и кастомными полями формата «User».
now ()
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
duedate < now() and status not in (closed, resolved)
openSprints()
Применимо к полю «Sprint».Для отбора задач, добавленных в незавершенные спринты
openSprints()
IN, NOT IN
sprint in openSprints()
pending()
Только для JIRA Service Desk.Для отбора задач JIRA Service Desk, требующих согласования.Применяется к полям типа «Approvals».
pending()
=
approval = pending()
pendingBy()
Только для JIRA Service Desk.Для отбора задач JIRA Service Desk, требующих согласования определенного(ых) пользователя(ей).Применяется к полям типа «Approvals».
pendingBy(user1,user2)projectsLeadByUser()
=
approval = pending(demo_1)approval = pending(demo_1, demo_2)
projectsLeadByUser()
Для отбора задач из проектов, на роль Project Lead которых назначен определенный пользователь.Применяется к полю «Project».
projectsLeadByUser() — для отбора задач по текущему пользователю.projectsLeadByUser(username)
IN, NOT IN
project in projectsLeadByUser() AND status = Openproject in projectsLeadByUser(demo_1) AND status = Open
projectsWhereUserHasPermission()
Для отбора задач из проектов, в которых текущий пользователь имеет определенное разрешение.Применяется к полю «Project».
projectsWhereUserHasPermission(permission)
IN, NOT IN
project inprojectsWhereUserHasPermission(«Resolve Issues») AND status = Open
projectsWhereUserHasRole()
Для отбора задач из проектов, в которых текущий пользователь имеет определенную проектную роль.Применяется к полю «Project».
projectsWhereUserHasRole(rolename)
IN, NOT IN
project in projectsWhereUserHasRole(«Developers») AND status = Open
releasedVersions()
Для поиска по выпущенным версиям определенного проекта или сразу всем JIRA-проектам.Применяется для создания выражений с полями «AffectedVersion» (Проявляется в версиях), «FixVersion» (Исправлено в версиях), кастомными полями формата Version.
ReleasedVersions() — для отбора задач по всем проектам.releasedVersions(project)
IN, NOT IN
fixVersion in releasedVersions(ABC)affectedVersion in releasedVersions(ABC)
standardIssueTypes()
Для отбора задач родительского типа.
standardIssueTypes()
IN, NOT IN
issuetype in standardIssueTypes()
startOfDay()
Для поиска по началу текущего дня.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата дата-время.
startOfDay()startOfDay(«inc»)где inc — опциональный инкримент (±)nn(y|M|w|d|h|m).Если спецификатор единицы измерения времени опущен, по умолчанию используется естественный период функции, т. е. 1 день. Если опущен знак ±, то по умолчанию предполагается +.
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
created > startOfDay () — задачи, созданные за текущий день.created > startOfDay (»-3d») — задачи, созданные за последние три дня.
startOfMonth ()
Для поиска по началу текущего месяца.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата дата-время.
startOfMonth ()startOfMonth («inc»)где inc — опциональный инкримент (±)nn (y|M|w|d|h|m).Если спецификатор единицы измерения времени опущен, по умолчанию используется естественный период функции, т. е. 1 месяц. Если опущен знак ±, то по умолчанию предполагается +.
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
created > startOfMonth () — задачи, созданные за текущий месяцcreated > startOfMonth (»+14d») — задачи, созданные с пятнадцатого числа текущего месяца.
startOfWeek ()
Для поиска по началу текущей недели.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата даты-времени.
startOfWeek ()startOfWeek («inc»), где inc — опциональный инкримент (±)nn (y|M|w|d|h|m).Если спецификатор единицы измерения времени опущен, по умолчанию используется естественный период функции, т. е. 1 неделя. Если опущен знак ±, то по умолчанию предполагается +.
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
created > startOfWeek ()- задачи, созданные за текущую неделю.created > startOfWeek (»-1») — задачи, дата создания которых старше начала прошлой недели.
startOfYear ()
Для поиска по началу текущего года.Используется в выражениях с полями «Created» (Создано), «Due Date» (Срок исполнения), «Resolved» (Дата решения), «Updated» (Обновлено), кастомными полями формата дата-время.
startOfYear ()startOfYear («inc»)где inc — опциональный инкримент (±)nn (y|M|w|d|h|m).Если спецификатор единицы измерения времени опущен, по умолчанию используется естественный период функции, т. е. 1 год. Если опущен знак ±, то по умолчанию предполагается +.
=, !=, >, >=, <, <=в предикатах операторов WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
created > startOfYear () — задачи созданные за текущий год.created > startOfYear (»-1») — задачи, дата создания которых старше начала прошлого года.
subtaskIssueTypes ()
Для отбора подзадач.
subtaskIssueTypes ()
IN, NOT IN
issuetype in subtaskIssueTypes ()
unreleasedVersions ()
Для поиска по не выпущенным версиям определенного проекта или сразу всем JIRA-проектам.Применяется для создания выражений с полями «AffectedVersion» (Проявляется в версиях), «FixVersion» (Исправлено в версиях), кастомными полями формата Version.
unreleasedVersions () используетсядля отбора задач по всем проектам.unreleasedVersions (project)
IN, NOT IN
fixVersion in unreleasedVersions (ABC)
votedIssues ()
Для отбора задач, за которые вы отдали свой голос.
votedIssues ()
IN, NOT IN
issue in votedIssues ()
watchedIssues ()
Для отбора задач, наблюдателем которых являетесь вы.
watchedIssues ()
IN, NOT IN
issue in watchedIssues ()
© Habrahabr.ru