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

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



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

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

  1. Быстрый.
  2. Базовый.
  3. Продвинутый (JQL).

В данной статье мы поговорим о«базовом» и «быстром» поиске. Как использовать «продвинутый» JQL поиск — расскажем в следующей публикации.

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

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


Наименее точный и самый быстрый способ поиска задач в 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 — поиск задач,
автор которых не задан.
<prоject name>
или
<prоject key>
Поиск всех задач
определенного проекта
по его имени или ключу.
Yat project
YAT
yat
overdue Поиск задач, срок исполнения которых
истекает сегодня, либо уже закончился.
overdue
created:
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 — задачи, созданные
за последние сутки
и обновленные в течении
предыдущих четырех
часов.

<priоrity> Поиск задач по заданному приоритету. critical
high
medium
low
<issuе type> Поиск задач определенного типа.

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

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

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

3.0
3.0 eap
3.0 beta

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

3.0.1
3.0.0.4

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

v:3.0*

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

3.0
3.0 eap
3.0 beta
3.0.1
3.0.0.4

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

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

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

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

  • «Summary» («Тема»);
  • «Description» («Описание»);
  • «Comments» («Комментарии»).

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


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

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



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



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

  1. Критерий «Проект» из выпадающего списка для выбора проектов, содержащих интересующие вас задачи.
  2. Критерий «Задача/Тип» из выпадающего списка для выбора типа задач.
  3. Критерий «Статус» из выпадающего списка для отбора задач по статусам workflow.
  4. Критерий «Исполнитель» для отбора задач, назначенных на определенных исполнителей. В качестве исполнителей можно выбрать конкретных пользователей JIRA, либо JIRA-группу (отобразятся задачи, назначенные на эту группу).
  5. Критерий «Содержит текст» для отбора задач, которые могут содержать конкретный текст в полях «Summary» (Тема), «Description» (Описание) или «Comments» (Комментарии).

Если нужно добавить к критериям поиска какое-то другое поле, то:

  1. Для начала рекомендуем определить проекты для поиска в поле «Проект»;
  2. Определить тип задач в поле «Тип»;
  3. В выпадающем списке «Еще» начните ввод названия поля, которое будет использовано в качестве критерия отбора.



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


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

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

  1. запрос содержит оператор OR;
  2. запрос содержит оператор NOT;
  3. запрос содержит оператор EMPTY;
  4. содержит любой из операторов сравнения !=, IS, IS NOT, >, >=, <, <=.
  5. в запросе указываются поля, которые в «базовом» поиске становятся доступными только после выбора критериев проекта и типа задач.

Внимание

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

Об особенностях «продвинутого» JQL поиска поговорим в следующей статье ;)

Комментарии (6)


  1. nick_gabpe
    22.04.2019 20:23

    Jira на русском?! Вроде бы просто и логично, но выглядит всё-таки странно, глаз немного режет.


    1. aayatsenko Автор
      23.04.2019 08:10

      Добрый день! nick_gabpe
      Да, в рамках только пользовательского интерфейса — выглядит все логично. В рамках админской части — уже не столь логично.


  1. pphilips
    23.04.2019 08:26

    Мне кажется, или советы в статье отчасти version specific? В упор не вижу бытсрого поиска в cloud версии, только advanced и basic.


    1. aayatsenko Автор
      23.04.2019 08:45

      Добрый день!
      Да, все верно. Статья про серверную (не cloud) версию.
      Но и в Cloud версии тоже есть быстрый поиск. Он находится на левой панели, под значком «Favorite».


    1. aurora_win
      24.04.2019 05:49

      Поддерживаю. Это больше похоже не на статью, а на заметки для себя по конкретному проекту.
      Отличный манул по поиске легко найти так:
      -> Search for Issues -> Advanced Search -> круглая иконка вопроса
      И попадаете на страничку описания sql-подобного языка запросов, очень легко и просто его осовоить, настроить фильтры для поиска и сохранить.


      1. aayatsenko Автор
        24.04.2019 05:54

        Добрый день, aurora_win
        Не смею отрицать, что мануал, предоставленный atlassian достаточно развернут и понятен. Но он больше подходит для людей, связанных с IT.
        В случае, когда JIRA пользуются люди не из IT (Например: Административно-хозяйственное управление, бухгалтерия, бизнес и т.д.) — то, как показывает практика, данный мануал уже не столь понятен. :-)