Для упрощения восприятия, мы решили собрать всю документацию, локализовать и разместить в одном месте. И начнем мы с «базового» и «быстрого» поиска.
Многие сталкивались с необходимостью либо найти подходящую задачу в многообразии уже созданных, либо отобрать группу задач, отвечающих определенным критериям. Для этого JIRA предоставляет гибкую функциональность, рассчитанную как на технического специалиста, так и на обычного пользователя, а также позволяет сохранять поисковые запросы для последующего использования. Сохраненный запрос называется фильтром.
Существует три способа поиска задач в JIRA:
- Быстрый.
- Базовый.
- Продвинутый (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).
Перейдите по пункту меню Поиск > Поиск запросов;
и выберете критерии поиска:
Стандартно «базовый» поиск содержит:
- Критерий «Проект» из выпадающего списка для выбора проектов, содержащих интересующие вас задачи.
- Критерий «Задача/Тип» из выпадающего списка для выбора типа задач.
- Критерий «Статус» из выпадающего списка для отбора задач по статусам workflow.
- Критерий «Исполнитель» для отбора задач, назначенных на определенных исполнителей. В качестве исполнителей можно выбрать конкретных пользователей JIRA, либо JIRA-группу (отобразятся задачи, назначенные на эту группу).
- Критерий «Содержит текст» для отбора задач, которые могут содержать конкретный текст в полях «Summary» (Тема), «Description» (Описание) или «Comments» (Комментарии).
Если нужно добавить к критериям поиска какое-то другое поле, то:
- Для начала рекомендуем определить проекты для поиска в поле «Проект»;
- Определить тип задач в поле «Тип»;
- В выпадающем списке «Еще» начните ввод названия поля, которое будет использовано в качестве критерия отбора.
4. Поставьте галочку напротив необходимого поля;
5. Определите критерий отбора по этому полю.
Для удаления добавленного критерия отбора просто воспользуйтесь кнопкой
для данного критерия.
Запрос из «базового» поиска можно перевести в «продвинутый» JQL поиск, и наоборот. Однако запрос из «продвинутого» JQL поиска нельзя перевести в «базовый», если:
- запрос содержит оператор OR;
- запрос содержит оператор NOT;
- запрос содержит оператор EMPTY;
- содержит любой из операторов сравнения !=, IS, IS NOT, >, >=, <, <=.
- в запросе указываются поля, которые в «базовом» поиске становятся доступными только после выбора критериев проекта и типа задач.
Внимание
Общее правило: если запрос не может быть создан в форме «базового» поиска, то его не получится перевести из «продвинутого» JQL в «базовый».
Об особенностях «продвинутого» JQL поиска поговорим в следующей статье ;)
Комментарии (6)
pphilips
23.04.2019 08:26Мне кажется, или советы в статье отчасти version specific? В упор не вижу бытсрого поиска в cloud версии, только advanced и basic.
aayatsenko Автор
23.04.2019 08:45Добрый день!
Да, все верно. Статья про серверную (не cloud) версию.
Но и в Cloud версии тоже есть быстрый поиск. Он находится на левой панели, под значком «Favorite».
aurora_win
24.04.2019 05:49Поддерживаю. Это больше похоже не на статью, а на заметки для себя по конкретному проекту.
Отличный манул по поиске легко найти так:
-> Search for Issues -> Advanced Search -> круглая иконка вопроса
И попадаете на страничку описания sql-подобного языка запросов, очень легко и просто его осовоить, настроить фильтры для поиска и сохранить.aayatsenko Автор
24.04.2019 05:54Добрый день, aurora_win
Не смею отрицать, что мануал, предоставленный atlassian достаточно развернут и понятен. Но он больше подходит для людей, связанных с IT.
В случае, когда JIRA пользуются люди не из IT (Например: Административно-хозяйственное управление, бухгалтерия, бизнес и т.д.) — то, как показывает практика, данный мануал уже не столь понятен. :-)
nick_gabpe
Jira на русском?! Вроде бы просто и логично, но выглядит всё-таки странно, глаз немного режет.
aayatsenko Автор
Добрый день! nick_gabpe
Да, в рамках только пользовательского интерфейса — выглядит все логично. В рамках админской части — уже не столь логично.