Структуру JQL-запросов без примеров сложно понять специалистам, не знакомым ранее с JIRA.
Мы уже успели рассказать про быстрый и базовый поиск. Теперь же прейдем к самому мощному из трех методов — к продвинутому поиску.
В этом режиме вы можете указывать критерии, которые нельзя задавать в остальных предыдущих двух режимах (например, сортировку ORDER BY). Но придётся освоить создание структурированных запросов с помощью JIRA Query Language (JQL).
Для использования «продвинутого» поиска перейдите в пункт меню Поиск –> Поиск запросов.
1. Создание JQL-запросов
Простейший запрос на JQL состоит из поля, за которым следует оператор, а затем одно или несколько допустимых значений для этого поля. Например:
Такой запрос поможет найти все задачи проекта «YAT». Здесь использовано поле «project», оператор эквивалента “=” и допустимое значение «YAT».
project = «YAT» AND assignee = currentuser()
Так мы отберём все задачи проекта «YAT», назначенные на текущего пользователя
(то есть на вас). В запросе содержатся: логический оператор «AND», поле «assignee» для отбора задач по текущему пользователю, оператор эквивалента “=” и функция «currentuser()», возвращающая имя текущего пользователя системы.
При создании запроса в режиме «продвинутого» поиска JIRA показывает список всех возможных операторов для поля запроса.
Также JIRA показывает список доступных значений для полей “AffectedVersion“, “FixVersion“, “Components“, кастомных полей формата “Version” и выпадающих списков.
При использовании в поиске полей формата “User” JIRA позволяет найти необходимого пользователя по его фамилии.
Вы можете использовать круглые скобки в сложных JQL-запросах. Например, если хотите найти все разрешенные задачи в проекте «SysAdmin», а также все задачи (любого статуса, любого проекта), назначенные в настоящее время системному администратору (admin), то можете использовать круглые скобки, обозначая приоритет логических операторов в запросе.
В JQL есть зарезервированные символы.
Внимание!
Также в JIRA есть зарезервированные слова.
Если в тексте поиска упомянуто одно из перечисленных ниже слов, этот текст нужно выделить либо двойными кавычками (“……”), либо одинарными (‘……’).
2. Использование шаблонов для поиска по тексту
Специальные символы могут быть использованы для определения шаблонов поиска по тексту. Рассмотрим несколько примеров:
3. Логические операторы JQL
4. Операторы сравнения JQL
5. Функции JQL
Надеюсь, что разбор продвинутого режима поможет вам при поиске задач.
Пользуйтесь и не теряйтесь 😉
Задача
Бывает нужно найти задачи, по критерию, относящемуся к связанным задачам. Например, в проекте есть “улучшения” и связанные ними “ошибки”. Предположим, что нам нужно получить список открытых “улучшений”, по которым есть неисправленные и к тому же блокирующие “ошибки”.
Решение
Увы, штатными средствами JIRA решить такую задачу невозможно. На помощь приходит бесплатный плагин Script Runner. Помимо множества прочих полезных функций плагин добавляет в JIRA новый JQL-оператор “issueFunction“. В нём то и есть свойство, позволяющее задать параметры связанных задач.
Пример 1
У нас в JIRA ведутся сделки (тип sale) и карточки инстансов (instance). Есть задача – получить список неоплаченных клиентских инстансов на хостинге. Приведем это бизнес-требование к формату, понятному аналитику или системному администратору:
Покажи карточки работающих в промышленном режиме инстансов, у которых нет сделок в статусе “Поставка услуг”.
Пишем JQL-запрос:
reporter != robot AND issuetype = Instance AND "Режим работы" = Промышленный AND status = Работает AND issueFunction not in linkedIssuesOf("status = Delivering", "Инстансы по Сделке")
, где ключевым моментом, на который стоит обратить внимание в рамках данной задачи, является выражение, описывающее фильтр связанных сделок:
issueFunction not in linkedIssuesOf(“status = Delivering”, “Инстансы по Сделке”).
Дословно это означает: покажи все инстансы, у которых НЕТ задач с типом связи “Инстансы по Сделке” в статусе “Delivering”.
Обращаю внимание, данная конструкция не понимает статусы с пробелами, поэтому в данном примере наш статус был использован не в оргинале – “Поставка услуг”, а в переводе одним словом “Delivering”.
Скриншот с результатами:
Пример 2
Возможно ли сделать выборку заявок, не имеющих связи с другими заявками?
Пишем следующий JQL-запрос (перечисляйте все имена ваших связей – их обычно не много):
issueFunction not in hasLinkType("Дубликат") AND issueFunction not in hasLinkType("Связанные задачи")
Пример 3
Найти все запросы, где автор и исполнитель разные пользователи:
issueFunction in expression("", "assignee != reporter")
Полезные ссылки по теме
- Документация по использованию JQL-функций Script Runner
- Страница плагина Script Runner на Marketplace
Функция
Описание
Поддерживаемые поля
Операторы
Пример
Поддерживаемые
Неподдерживаемые
membersOf()
Возвращает список пользователей, которые входят в указанную группу AD
membersOf(Group)
Assignee, Reporter, Voter, Watcher, custom fields of type User
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки, исполнитель которых входит в группу GroupName:
assignee in (membersOf(“GroupName”))
closedSprints(),
openSprints()
Возвращает список закрытых/открытых спринтов
closedSprints(), openSprints()
Sprint
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти все заявки в завершенных спринтах:
sprint in closedSprints()
Найти все заявки в открытых спринтах:
sprint in openSprints()
componentsLeadByUser()
Возвращает список компонентов, владельцем которых является указанный пользователь. Если пользователь не указан, используется текущий пользователь
componentsLeadByUser(), componentsLeadByUser(username)
Component
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки со статусом “In Progress”, относящиеся к компоненту, владельцем которых является текущий пользователь:
component in componentsLeadByUser() AND status = “In Progress“
currentLogin(),
lastLogin()
Возвращает время начала текущей или предыдущей сессии текущего пользователя
currentLogin(), lastLogin()
Created, Due, Resolved, Updated, custom fields of type Date/Time
=, !=, >, >=, <, <=WAS*, WAS IN*, WAS NOT*, WAS NOT IN*, CHANGED** Только в предикате
~, !~, IS, IS NOT, IN, NOT IN
Найти заявки, которые были созданы во время текущей сессии:
created > currentLogin()
Найти заявки, которые были созданы во время предыдущей сессии или позже:
created > lastLogin()
currentUser()
Текущий пользователь.
Данная функция может быть использована только авторизованным пользователем. Если фильтр будет использоваться анонимными пользователями, не используйте эту функцию.
currentUser()
Assignee, Reporter, Voter, Watcher, custom fields of type User
=, !=
~, !~, >, >=, <, <=, 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()
Самая ранняя не выпущенная версия указанного проекта
earliestUnreleasedVersion(project)
AffectedVersion, FixVersion, custom fields of type Version
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки, у которых FixVersion является самой ранней не выпущенной версии проекта ProjectName:
fixVersion = earliestUnreleasedVersion(ProjectName)
Найти заявки, которые относятся к самой ранней не выпущенной версии проекта ProjectName:
affectedVersion = earliestUnreleasedVersion(ProjectName) or fixVersion = earliestUnreleasedVersion(ProjectName)
endOfDay(),
endOfMonth(),
endOfWeek(),
endOfYear(),
Окончание текущего дня (месяца, недели, года).
endOfDay(), endOfDay(“inc”), endOfMonth(), endOfMonth(“inc”), endOfWeek(), endOfWeek(“inc”), endOfYear(), endOfYear(“inc”)
Created, Due, Resolved, Updated, custom fields of type Date/Time
=, !=, >, >=, <, <=WAS*, WAS IN*, WAS NOT*, WAS NOT IN*, CHANGED** Только в предикате
~, !~, IS, IS NOT, IN, NOT IN
Найти заявки, которые должны быть выполнены до конца текущего дня: due < endOfDay()
До конца следующей недели:
due < endOfWeek(“+1”)
До 15-го числа следующего месяца: due < endOfMonth(“+15d”)
issueHistory()
Список недавно просмотренных заявок
issueHistory()
Issue
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти недавно просмотренные заявки, назначенные текущему пользователю:
issue in issueHistory() AND assignee = currentUser()
latestReleasedVersion()
Последняя выпущенная версия указанного проекта.
latestReleasedVersion(project)
AffectedVersion, FixVersion, custom fields of type Version
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки, у которых FixVersion является последней выпущенной версией проекта ProjectName:
fixVersion = latestReleasedVersion(ProjectName)
Найти заявки, которые относятся к последней выпущенной версии проекта ProjectName:
affectedVersion = latestReleasedVersion(ProjectName) or fixVersion = latestReleasedVersion(ProjectName)
linkedIssues()
Список заявок, связанных с указанной заявкой. Список можно ограничить ссылками определенного типа.
Внимание: LinkType чувствителен к регистру.
linkedIssues(issueKey), linkedIssues(issueKey, linkType)
Issue
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки, которые связаны с определенной заявкой: issue in linkedIssues(XXX-1000)
Найти заявки, которые связаны с определенной заявкой указанным типом связи: issue in linkedIssues(XXX-1000, “is mentioned by”)
now()
Текущие дата и время
now()
Created. Due, Resolved, Updated, custom fields of type Date/Time
=, !=, >, >=, <, <=WAS*, WAS IN*, WAS NOT*, WAS NOT IN*, CHANGED** Только в предикате
~, !~, IS, IS NOT, IN, NOT IN
Найти просроченные заявки:
duedate < now() AND status not in (Закрыт, Решенные)
projectsLeadByUser()
Возвращает список проектов, владельцем которых является указанный пользователь. Если пользователь не указан, используется текущий пользователь
projectsLeadByUser(), projectsLeadByUser(username)
Project
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти открытые заявки в проектах, владельцем которых является текущий пользователь:
project in projectsLeadByUser() AND status = “In Progress“
projectsWhereUserHasPermission()
Найти заявки в проектах, в которых у текущего пользователя есть указанное право доступа
projectsWhereUserHasPermission(permission)
Project
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки в статусе “In Progress” в проектах, в которых у текущего пользователя есть право доступа “Resolve Issues”:
project in projectsWhereUserHasPermission(“Resolve Issues”) AND status = “In Progress“
projectsWhereUserHasRole()
Найти заявки в проектах, в которых у текущего пользователя есть указанная роль
projectsWhereUserHasRole(rolename)
Project
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки в проектах, в которых у текущего пользователя есть указанное роль Developers:
project in projectsWhereUserHasRole(“Developers”) AND status = “In Progress“
releasedVersions()
Список выпущенных версий указанного проекта. Если проект не указан, отображаются выпущенные версии всех проектов
releasedVersions(), releasedVersions(project)
AffectedVersion, FixVersion, custom fields of type Version
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки, чьи FixVersion являются одной из выпущенных версий проекта ProjectName:
fixVersion in releasedVersions(ProjectName)
Найти заявки, которые относятся к одной из выпущенных версий проекта ProjectName:
affectedVersion in releasedVersions(ProjectName)) or (fixVersion in releasedVersions(ProjectName))
standardIssueTypes()
Список стандартных типов заявок (не включает подзадачи).
standardIssueTypes()
Type
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки только со стандартными типами:
issuetype in standardIssueTypes()
startOfDay(),
startOfMonth(),
startOfWeek(),
startOfYear()
Начало текущего дня (месяца, недели, года).
startOfDay(), startOfDay(“inc”), startOfMonth(), startOfMonth(“inc”), startOfWeek(), startOfWeek(“inc”), startOfYear(), startOfYear(“inc”)
Created, Due, Resolved, Updated, custom fields of type Date/Time
=, !=, >, >=, <, <=WAS*, WAS IN*, WAS NOT*, WAS NOT IN*, CHANGED** Только в предикате
~, !~, IS, IS NOT, IN, NOT IN
Найти заявки, созданные с начала текущего дня:
created > startOfDay()
Найти заявки, созданные с начала прошлой недели:
created > startOfWeek(“-1”)
Найти заявки, созданные с 15-го числа этого месяца:
created > startOfMonth(“+14d”)
subtaskIssueTypes()
Список типов подзадач
subtaskIssueTypes()
Type
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки с типами, которые соответствуют подзадачам:
issuetype in subtaskIssueTypes()
unreleasedVersions()
Список невыпущенных версий указанного проекта. Если проект не указан, отображаются невыпущенные версии всех проектов
unreleasedVersions(), unreleasedVersions(project)
AffectedVersion, FixVersion, custom fields of type Version
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки, чья FixVersion является одной из невыпущенных версий проекта ProjectName:
fixVersion in unreleasedVersions(ProjectName)
Найти заявки, которые касаются одной из не выпущенных версий проекта ProjectName:
affectedVersion in unreleasedVersions(ProjectName)
watchedIssues()
Список заявок, в которых текущий пользователь является наблюдателем
watchedIssues()
Issue
IN, NOT IN
=, !=, ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
Найти заявки, в которых текущий пользователь является наблюдателем:
issue in watchedIssues()
Инструкции пользователю 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)
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Пользовательские поля типа «Каскадный выбор»
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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 ()
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Спринт Sprint
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| IS | нет |
| IS NOT | нет |
| IN | есть |
| NOT IN | есть |
| WAS | нет |
| WAS IN | нет |
| WAS NOT | нет |
| WAS NOT IN | нет |
| CHANGED | нет |
ПРИМЕРЫ
- Найти все задачи, связанные с завершенным Sprint.
sprint in closedSprints()
componentsLeadByUser()
Находит задачи в компонентах, которые ведет конкретный пользователь. Вы можете дополнительно указать пользователя, или если пользователь опущен, будет использоваться текущий пользователь (т. е. вы). Обратите внимание: если вы не вошли в JIRA, необходимо указать пользователя.
СИНТАКСИС
componentsLeadByUser ()
или
componentsLeadByUser (имя пользователя)
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Компонент Component
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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 ()
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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 (проект)
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- AffectedVersion (затронутая версия)
- FixVersion (исправленная версия)
- Пользовательские поля типа Версии
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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”).
Если знак плюс / минус (+/-) опущен, предполагается плюс.
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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”).
- Если знак плюс / минус (+/-) опущен, предполагается плюс.
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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»).
- Если знак плюс / минус (+/-) опущен, предполагается плюс.
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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»).
- Если знак плюс / минус (+/-) опущен, предполагается плюс.
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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()
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| IS | нет |
| IS NOT | нет |
| IN | нет |
| NOT IN | нет |
| WAS | (только в предикате) |
| WAS IN | (только в предикате) |
| WAS NOT | (только в предикате) |
| WAS NOT IN | (только в предикате) |
| CHANGED | (только в предикате) |
ПРИМЕРЫ
Находит задачи, которые были созданы во время моего последнего сеанса:
created > lastLogin()
latestReleasedVersion()
Выполняет поиск на основе последней выпущенной версии (то есть самой последней версии, которая была выпущена) указанного проекта. См. Также releasedVersions().
Обратите внимание, что «последний» определяется порядком, назначенным версиям, а не соотвествующими датами версии.
СИНТАКСИС
latestReleasedVersion (проект)
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- AffectedVersion (затронутая версия)
- FixVersion (исправленная версия)
- Пользовательские поля типа Версии
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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()
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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 это также контролировало разрешение на просмотр «Дата выполнения» задачи. |
|
Установление безопасности задачи |
Разрешение установить уровень безопасности на задачу, чтобы контролировать, кто может получить доступ к этой задаче. Только релевантно, если безопасность задачи включена. |
|
Задача перехода |
Разрешение на переход (изменение) статуса задачи. |
|
Разрешение избирателей и наблюдателей |
Объяснение |
|
Управление списком наблюдателей |
Разрешение на управление (т. е. Просмотр / добавление / удаление пользователей в / из) списка наблюдателей задачи. |
|
Просмотр избирателей и наблюдателей |
Разрешение на просмотр списка избирателей и списка наблюдателей. Также см. разрешение «Управление списком наблюдателей». |
|
Разрешения комментирования |
объяснение |
|
Добавить комментарий |
Разрешение добавлять комментарии к задачам. Обратите внимание, что это не включает возможность редактирования или удаления комментариев. |
|
Удалить все комментарии |
Разрешение удалять любые комментарии, независимо от того, кто их добавил. |
|
Удалить собственные комментарии |
Разрешение удалять комментарии, добавленные пользователем. |
|
Редактировать все комментарии |
Разрешение на редактирование любых комментариев, независимо от того, кто их добавил. |
|
Редактировать собственные комментарии |
Разрешение редактировать комментарии, добавленные пользователем. |
|
Разрешения вложений |
объяснение |
|
Создать вложения |
Разрешение на прикрепление файлов к задаче. (Учитывается только в том случае, если вложения включены). Обратите внимание, что это не включает возможность удаления вложений. |
|
Удалить все вложения |
Разрешение удалять любые вложения, независимо от того, кто их добавил. |
|
Удалить собственные вложения |
Разрешение на удаление вложений, добавленных пользователем. |
|
Разрешения на отслеживание времени |
объяснение |
|
Работа над задачами |
Разрешение на работу журнала с задачей, т. е. создание записи в рабочий журнал. (Учитывается только, если включена функция отслеживания времени). |
|
Удалить все журналы |
Разрешение на удаление любых записей в журнале, независимо от того, кто их добавил. (Учитывается только, если включена функция отслеживания времени). Также см. разрешение «Работы над задачами». |
|
Удаление собственных журналов |
Разрешение на удаление записей в журнале, которые были добавлены пользователем. (Учитывается только, если включена функция отслеживания времени). Также см. разрешение «Работа над запросами». |
|
Редактировать все журналы |
Разрешение редактировать любые записи в журнале, независимо от того, кто их добавил. (Учитывается только, если включена функция отслеживания времени). Также см. разрешение «Работы над запросами». |
|
Редактировать собственные рабочие журналы |
Разрешение редактировать записи в журнале, которые были добавлены пользователем. (Учитывается только, если включена функция отслеживания времени). Также см. Разрешение «Работы над задачами». |
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Проект Project
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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)
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Проект Project
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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 (проект)
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- AffectedVersion (затронутая версия)
- FixVersion (исправленная версия)
- Пользовательские поля типа Версии
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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 ()
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Тип Type
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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»).
- Если знак плюс / минус (+/-) опущен, предполагается плюс.
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| IS | нет |
| IS NOT | нет |
| IN | нет |
| NOT IN | нет |
| WAS | (только в предикате) |
| WAS IN | (только в предикате) |
| WAS NOT | (только в предикате) |
| WAS NOT IN | (только в предикате) |
| CHANGED | (только в предикате) |
ПРИМЕРЫ
- Найти новые задачи, созданные с начала сегодняшнего дня:
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
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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»).
- Если знак плюс / минус (+/-) опущен, предполагается плюс.
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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»).
- Если знак плюс / минус (+/-) опущен, предполагается плюс.
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- Created
- Due
- Resolved
- Updated
- Пользовательские поля типа Дата /Время
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | есть |
| != | есть |
| ~ | нет |
| !~ | нет |
| > | есть |
| >= | есть |
| < | есть |
| <= | есть |
| 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 (проект)
ПОДДЕРЖИВАЕМЫЕ ПОЛЯ
- AffectedVersion (затронутая версия)
- FixVersion (исправленная версия)
- Пользовательские поля типа Версии
ПОДДЕРЖИВАЕМЫЕ ОПЕРАТОРЫ
| Оператор | Поддержка |
| = | нет |
| != | нет |
| ~ | нет |
| !~ | нет |
| > | нет |
| >= | нет |
| < | нет |
| <= | нет |
| 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 глобальных идентификаторов приведет к ошибкам.
–
Добавить комментарий
Введите свой комментарий…
Заполните поля или щелкните по значку, чтобы оставить свой комментарий:
E-mail (обязательно) (Адрес никогда не будет опубликован)
Имя (обязательно)
Сайт
Для комментария используется ваша учётная запись WordPress.com.
( Выход /
Изменить )
Для комментария используется ваша учётная запись Facebook.
( Выход /
Изменить )
Отмена
Connecting to %s
Уведомлять меня о новых комментариях по почте.
Уведомлять меня о новых записях по почте.
