что такое advanced search в jira

Начните работу с расширенным поиском и JQL

Расширенный поиск

Выполняйте поиск задач по всем проектам с помощью языка запросов Jira Query Language (JQL). Результаты запросов можно сохранять и использовать в качестве фильтров, а также для настройки просмотра в Jira (включая доски).

2. Выберите Search issues (Поиск задач) (быстрые клавиши g + i).

3. Используйте быстрые фильтры для стандартного поиска или переключитесь на JQL для расширенного поиска.

4. (Необязательно) Переключайтесь между просмотром в виде списка и подробным просмотром с помощью кнопки Change Views (Изменить режим просмотра) в верхнем правом углу экрана (быстрая клавиша t). Просмотр в виде списка позволяет охватить множество задач и настроить количество столбцов на экране.

Загрузите плагин для Excel или аддон для Google Sheets, чтобы просматривать запросы в удобном инструменте для работы с таблицами.

Изучите синтаксис JQL

Простой запрос в JQL (также называемый «выражением») состоит из последовательности, которая включает поле, оператора и одно или несколько значений или функций. Например:

Посмотрите обучающее видео, чтобы увидеть, как это работает:

Источник

Поиск задач в JIRA (простым языком). Часть 1: Быстрый и базовый поиск

В последнее время JIRA активно используют организации, не имеющие прямой связи с IT. Специалистам, не знакомым ранее с JIRA, бывает сложно понять структуру JQL-запросов, если не привести примеры.

Для упрощения восприятия, мы решили собрать всю документацию, локализовать и разместить в одном месте. И начнем мы с «базового» и «быстрого» поиска.

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

Существует три способа поиска задач в JIRA:

Стоит отметить, что, независимо от выбранного способа поиска, в качестве ответа будут возвращены только доступные для вашего просмотра задачи. Доступность определяется схемами прав доступа и безопасности в проектах, которым принадлежат данные задачи.

Быстрый поиск

Наименее точный и самый быстрый способ поиска задач в JIRA. Поле ввода расположено в правом верхнем углу экрана. Чтобы использовать его, просто начните вводить искомое.

1. Быстрый переход к задаче

Если известен ключ задачи, над которой вы работаете, то для быстрого перехода нужно ввести его и нажать Enter.

Предположим, вы работаете над задачей с ключом «YAT-106», в этом случае можно ввести в поле «Поиск» значение «YAT-106» или «yat-106».

Зачастую вам даже не нужно вводить полный ключ, достаточно ввести цифровую часть. Если вы работаете над проектом «YAT», то при вводе в поле «106» система автоматически перенаправит вас на «YAT-106».

2. Интеллектуальный быстрый поиск

JIRA позволяет использовать «интеллектуальный» быстрый поиск с минимальной типизацией. Например, для поиска всех задач типа «Task» в проекте «YAT», имеющих статус «Done», необходимо искать строку «Task Done YAT». И JIRA перенаправит вас в окно навигатора с отобранными по заданному критерию задачами.

В таблице ниже представлены специальные термины для «интеллектуального» быстрого поиска:

Параметр поиска	Описание	Пример строки поиска
my	Поиск задач, назначенных на вас.	my open task
r:	Поиск задач, автором которых являетесь вы или другой пользователь, либо автор не определен.

Внимание
Между «r:» и определением автора
не должно быть пробелов.r:me — поиск задач,
автором которых являетесь вы.

r:demo_3 — поиск задач, автором которых
является пользователь с логином demo_3.

r:none — поиск задач,
автор которых не задан.

Поиск всех задач
определенного проекта
по его имени или ключу.Yat project
YAT
yatoverdueПоиск задач, срок исполнения которых
истекает сегодня, либо уже закончился.overduecreated:
updated:
due:Поиск задач, чьи параметры дат
«Created» (Создано),
«Updated» (Обновлено),
«Due Date» (Срок исполнения)
отвечали бы заданным критериям.

Соответственно,
параметру «Created» (Создано)
будет соответствовать «created»,
«Updated» (Обновлено) — «updated»,
«Due Date» (Срок исполнения) — «due».

При простановке условий можно использовать термины
«today», «yesterday», «tomorrow».

Также возможна запись вида «-1w»,«1w» обозначающая,
что интересующая нас дата лежит в интервале
от (-1 неделя) до (+1 неделя) от текущего
системного времени.

Запись вида «1w» обозначает, что интересующая нас
дата лежит в диапазоне от (+1 неделя)
от текущего системного времени.

Валидные аббревиатуры для даты и времени:
‘w’ (week), ‘d’ (day), ‘h’ (hour), ‘m’ (minute).created:today — отбор задач,
созданных за текущий день.

created:yesterday —
задачи, созданные за вчерашний день.

updated:-1w — задачи,
обновленных за последнюю неделю.

due:1w — срок исполнения начинается через
одну неделю от текущей даты.

due:-1d,1w — срок исполнения
лежит в диапазоне
от ( — 1 день)
до ( + 1 неделя)

created:-1w,-30m — дата создания
лежит в диапазоне от
( — 1 неделя)
до (
— 30 минут)

created:-1d updated:-4h — задачи, созданные
за последние сутки
и обновленные в течении
предыдущих четырех
часов.

Поиск задач по заданному приоритету.critical
high
medium
lowПоиск задач определенного типа.

Внимание
Можно использовать значения во множественном числе.bug
task
bugs
tasksПоиск задач по значению поля «Resolution» (Решение).fixed
duplicatec:Поиск задач с определенным
значением поля «Component/s» (Компоненты).

Внимание
Между «с:» и определением компонента
не должно быть пробелов.c:security — задачи,
в названии компонентов которых
содержится слово «security».v:Поиск задач по значению
поля «Affects Version/s»
(Проявляется в версиях)

Внимание
Между «v:» и определением версии не должно быть пробелов.v:3.0 — отбираются задачи,
со значениями для поля
«Affects Version/s»
(Проявляется в версиях):

Но не включает задачи
со следующими значениями
для поля «Affects Version/s»
(Проявляется в версиях):

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

В результат запуска будут отобраны задачи
со значениями для поля
«Affects Version/s»
(«Проявляется в версиях»):

ff:Поиск задач по значению
поля «Fix Version/s»
(Исправлено в версиях).

Поиск по параметру «ff:» производится
подобно поиску по параметру «v:».ff:3.0
ff:3.0*

3. Быстрый поиск по тексту

Также вы можете отбирать задачи, содержащие определенный текст — просто введите его в поле «Поиск». JIRA ищет задачи по тексту только в трёх определенных полях:

Базовый поиск

Это удобный пользовательский интерфейс для отбора задач. Чтобы им пользоваться, вам не обязательно знать JIRA Query Language (JQL).

Перейдите по пункту меню Поиск → Поиск запросов;

и выберете критерии поиска:

Стандартно «базовый» поиск содержит:

4. Поставьте галочку напротив необходимого поля;
5. Определите критерий отбора по этому полю.

Для удаления добавленного критерия отбора просто воспользуйтесь кнопкой
для данного критерия.

Запрос из «базового» поиска можно перевести в «продвинутый» JQL поиск, и наоборот. Однако запрос из «продвинутого» JQL поиска нельзя перевести в «базовый», если:

Источник

Поиск задач в JIRA (простым языком). Часть 2: Продвинутый поиск

Структуру 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), то можете использовать круглые скобки, обозначая приоритет логических операторов в запросе.

(project=SysAdmin AND status=resolved) OR assignee=admin

В JQL есть зарезервированные символы.

Внимание!
Также в JIRA есть зарезервированные слова.

Если в тексте поиска упомянуто одно из перечисленных ниже слов, этот текст нужно выделить либо двойными кавычками («. «), либо одинарными (‘. ‘).

Список зарезервированных слов:

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

2. Использование шаблонов для поиска по тексту

Специальные символы могут быть использованы для определения шаблонов поиска по тексту. Рассмотрим несколько примеров:

Знак	Область применения и описание	Пример
?	«?» используется для замены одного символа в шаблоне. Например, написание слов «text» и «test» отличается одним символом. Для поиска обоих вариантов достаточно задать шаблон: te?t	summary

«te?t»*«*» используется для замены в текстовом шаблоне
нуля или нескольких символов. Например, для отбора текста
«Windows», «Win95» или «WindowsNT» можно использовать
шаблон: win*
Для отбора текста «Win95» или «Windows95»
можно использовать шаблон: wi*95summary

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

»
подставляется в конце нужного слова. Например,
чтобы найти термин, орфографически похожий на «roam»,
используйте шаблон: roam

В результате могут быть найдены слова «foam» или «roams».

3. Логические операторы JQL

Оператор	Описание	Пример
AND	Логическая операция «И», соединяющая два или несколько условий. Используется для уточнения условий отбора.	project = «YAT» and status = «Оpen» — отобрать все задачи проекта «YAT» в статусе «Open»
OR	Логическая операция «ИЛИ», соединяющая два или несколько условий.	reporter = demo_1 or reporter = demo_2 — отобрать все задачи проекта, автором которых является пользователь demo_1 или пользователь demo_2.
NOT	Для реверсирования результата логического условия.	not assignee = demo_1 — отобрать все задачи, исполнителем которых не является пользователь demo_1.
ORDER BY	Сортировать по.

По умолчанию будет использоваться собственный порядок,
применяемый для этого поля. Вы можете переопределить направление сортировки —
по возрастанию («asc») или убыванию («desc»).duedate = empty order by created —
отобрать все задачи, у которых пустые поля «Due date» (Срок исполнения),
отсортировать результаты выборки по полю «Created» (Создано).

duedate = empty order by created, priority desc —
отобрать все задачи, у которых пустые поля «Due date» (Срок исполнения),
отсортировать результаты выборки по полю «Created» (Создано)
в собственном порядке, затем по полю «Priority» (Приоритет)
в убывающем порядке.

Оператор	Описание	Пример
=	Эквивалент.

Используется для задания
критерия полного соответствия.reporter = demo_1!=Не равен.

либо можно использовать запись
NOT reporter = demo_1>Больше, чем.

Используется для создания выражений
с полями формата «Version»,
формата дата-время и числовых полей.votes > 4
duedate > now()>=Больше либо равно.

Используется для создания выражений
с полями формата «Version»,
формата дата-время и числовых полей.votes >= 4
duedate >= «2008/12/31»
created >= «-5d», >=,
currentLogin()currentUser()Возвращает логин текущего авторизованного пользователя.

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

Применяется для создания выражений с полями «AffectedVersion» (Проявляется в версиях»), «FixVersion» (Исправлено в версиях), кастомными полями формата Version.earliest
Unreleased
Version(project)IN, NOT INaffectedVersion =
earliestUnreleased
Version
(ABC)

fixVersion =
earliestUnreleased
Version
(ABC)endOfDay()Для поиска по концу текущего дня.

Используется в выражениях с полями
«Created» (Создано),
«Due Date»
(Срок исполнения),
«Resolved»
(Дата решения),
«Updated» (Обновлено), кастомными полями формата даты-времени.endOfDay()

где inc —
опциональный
инкримент
(±)nn(y|M|w|d|h|m).

Если спецификатор единицы
измерения времени опущен,
по умолчанию используется
естественный период функции,
т. е. 1 день.

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

fixVersion =
latestReleased
Version(ABC)linkedIssues()Для отбора задач по признаку наличия связи с определенной задачей.

Внимание
LinkType чувствителен к регистру.linkedIssues
(issueKey)

linkedIssues
(issueKey,linkType)IN, NOT INissue in linkedIssues
(ABC-123,
«is duplicated by»)membersOf()Для отбора задач по признаку принадлежности пользователя из определенного поля определенной JIRA-группе.

Используется для создания выражений с полями «Reporter» (Автор), «Assignee» (Исполнитель), «Voter», «Watcher» и кастомными полями формата «User».membersOf
(Group)IN, NOT INassignee 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()Для поиска за текущее время.

created >
startOfDay
(«-3d») – задачи,
созданные за
последние три дня.startOf
Month()Для поиска по началу текущего месяца.

Используется в выражениях с полями
«Created» (Создано),
«Due Date»
(Срок исполнения),
«Resolved»
(Дата решения),
«Updated» (Обновлено), кастомными полями формата дата-время.startOfMonth()

где inc —
опциональный
инкримент
(±)nn(y|M|w|d|h|m).

Если спецификатор единицы
измерения времени опущен,
по умолчанию используется
естественный период функции,
т. е. 1 месяц.

created > startOfMonth
(«+14d») — задачи,
созданные с пятнадцатого
числа текущего месяца.startOf
Week()Для поиска по началу текущей недели.

Используется в выражениях с полями
«Created» (Создано),
«Due Date»
(Срок исполнения),
«Resolved»
(Дата решения),
«Updated» (Обновлено), кастомными полями формата даты-времени.startOfWeek()

где inc —
опциональный
инкримент
(±)nn(y|M|w|d|h|m).

Если спецификатор единицы
измерения времени опущен,
по умолчанию используется
естественный период функции,
т. е. 1 неделя.

created >
startOfWeek
(«-1») — задачи,
дата создания которых
старше начала
прошлой недели.startOf
Year()Для поиска по началу текущего года.

Используется в выражениях с полями
«Created»
(Создано),
«Due Date»
(Срок исполнения),
«Resolved»
(Дата решения),
«Updated» (Обновлено), кастомными полями формата дата-время.startOfYear()

где inc —
опциональный
инкримент
(±)nn(y|M|w|d|h|m).

Если спецификатор единицы
измерения времени опущен,
по умолчанию используется
естественный период функции,
т. е. 1 год.

created >
startOfYear
(«-1») — задачи,
дата создания
которых старше
начала прошлого года.subtask
IssueTypes()Для отбора подзадач.subtask
IssueTypes()IN, NOT INissuetype in
subtask
IssueTypes()unreleased
Versions()Для поиска по не выпущенным версиям определенного проекта или сразу всем JIRA-проектам.

Применяется для создания выражений с полями «AffectedVersion» (Проявляется в версиях), «FixVersion» (Исправлено в версиях), кастомными полями формата Version.unreleasedVersions()
используется
для отбора задач
по всем проектам.

unreleased
Versions
(project)IN, NOT INfixVersion in
unreleased
Versions(ABC)voted
Issues()Для отбора задач, за которые вы отдали свой голос.votedIssues()IN, NOT INissue in
votedIssues()watched
Issues()Для отбора задач, наблюдателем которых являетесь вы.watchedIssues()IN, NOT INissue in
watchedIssues()

Надеюсь, что разбор продвинутого режима поможет вам при поиске задач.
Пользуйтесь и не теряйтесь 😉

Источник