Значения указываются как список с разделителями-запятыми, окруженный скобками. Поиск задач, с которыми пользователь выполнил работу. Вы можете выполнить поиск по полному имени пользователя, идентификатору или адресу электронной почты. Обратите внимание, что вы можете найти только те задачи, для которых у вас есть разрешения «Отслеживание времени», если вы не ищете проблемы, с которыми вы работали. Оператор «NOT IN» используется для поиска задач, в которых значение указанного поля не является одним из нескольких заданных значений. Поле JQL «текст», как в тексте ~ «несколько слов», выполняет поиск «Резюме», «Описание», «Среда», «Комментарии».
Оператор «IS» может использоваться только с EMPTY ПУСТО или NULL. То есть он используется для поиска задач, когда указанное поле не имеет значения. Вы можете выполнить поиск по ключевому слову задачи или по идентификатору задачи (т. е. по номеру, который JIRA автоматически присваивает задаче). Этот оператор будет соответствовать имени значения (например, «Решено»), которое было настроено в вашей системе в то время, когда поле было изменено. Этот оператор также будет соответствовать идентификатору значения, связанному с этим именем значения, то есть он будет соответствовать «4», а также «Разрешен».
POM объявляет зависимости вашего приложения, настройки и метаданные (информация о вашем приложении). Если вы хотите пропустить или проверить свою работу, когда закончите, вы можете найти исходный код приложения на Atlassian Bitbucket. Функции JQL – это мощный инструмент, который улучшает функциональность поиска Jira.
С другой стороны, вызов roleMembers (‘testrole’) возвращает всех пользователей в роли testrole во всех проектах, которые может видеть поисковик. В следующей статье мы рассмотрим какие существуют функции в JQL и полезные возможности по управлению вашими запросами JQL. Также ключевые слова используются для сортировки, поиска задач, когда поле не имеет значения — «EMPTY», «NULL», для отрицания условия — «NOT».
Сортировать По Order By
Разработчики могут создавать свои собственные JQL-функции с использованием модуля плагина JQL-функции. Ранее на NTA рассматривали статью по Jira (Ссылка). У рядовых пользователей Jira часто возникают вопросы непосредственно по поиску необходимых задач. Это поле не поддерживает автоматическое заполнение.
Поиск задач, относящихся к проектам в определенной категории. Использование «WAS NOT IN» эквивалентно использованию нескольких операторов WAS_NOT, но короче и удобнее. То есть, тип ввода НЕ ВХОДИТ («Решено», jql запросы «Выполняется (Продолжено)») совпадает с типом состояния НЕ БЫЛО «Решено» И НЕ БЫЛО «Продолжено». Использование «WAS IN» эквивалентно использованию нескольких операторов WAS, но короче и удобнее.
Расширенный Поиск Jira Использование Jql (jira Question Language)
Мы можем указать несколько пользователей внутри скобок через запятую, чтобы найти задачи так, как будто мы используем OR для их поиска. Значение — это та информация, которая содержится в полях. Это может быть номер версии в случае AffectedVersion, градация Severity, Priority (приоритет дефекта), статус бага в системе, имя Assignee или Reporter.
Для этого урока вам нужен модуль плагина JQL Function. Вы добавите его, используя команду atlas-create-HOSTAPP-plugin-module. Это хорошая идея, чтобы ознакомиться с файлом конфигурации проекта, известным как POM (то есть, файл определения модели объекта проекта). На этом этапе вы просмотрите и настроите файл pom.xml. Файл объявляет зависимости проекта и другую информацию.
Обратите внимание, что вы можете использовать круглые скобки для управления порядком, в котором выполняются предложения. Вы также можете использовать круглые скобки для групповых предложений, чтобы вы могли применить оператор NOT к группе. Вы можете использовать круглые скобки в сложных операторах JQL для обеспечения приоритета операторов. Вы можете создать собственные виджеты для результатов поиска JQL и отображать их на дашбоарде.
Обратите внимание, что операторы WAS, WAS_NOT, WAS_IN и WAS_NOT_IN могут использоваться только с именем (а не с идентификатором). Поиск задач, о которых сообщил конкретный пользователь. Это может быть то же самое, что и создатель, но может быть разным. Доступно только в том случае, если подзадачи были включены администратором JIRA.
Запрос выполняется в специальном поле на JQL по кнопкам Enter или Search. Также в конце поля поиска содержится помощь по синтаксису (“?”). При работе с Jira часто возникает необходимость в поиске определенных задач из разных проектов по определенным критериям.
- В этом учебном курсе показана реализация новой функции JQL, называемой roleMembers.
- Это может быть номер версии в случае AffectedVersion, градация Severity, Priority (приоритет дефекта), статус бага в системе, имя Assignee или Reporter.
- Доступно только в том случае, если администратор JIRA активировал защиту уровня задачи.
- Этот оператор также будет соответствовать идентификатору значения, связанному с этим именем значения, то есть он будет соответствовать «4», а также «Разрешен».
- POM объявляет зависимости вашего приложения, настройки и метаданные (информация о вашем приложении).
В этом примере используется поле Project, оператор EQUALS и значение «TEST». Помните, что с помощью JQL сравнивать два поля невозможно. Вы можете выполнить расширенный поиск по всем проектам. Простой запрос в JQL (также называемый «выражением») состоит из последовательности, которая включает поле, оператор и одно или несколько значений или функций. Для получения дополнительной информации о пользовательских JQL-функциях см. Обратите внимание, что автозаполнение предлагает вам новую функцию в своих предложениях по завершению проекта.
Поиск задач с конкретным ключом задачи или идентификатором задачи (то есть номер, который JIRA автоматически выделяет для задачи). (Обратите внимание, что полные остановки являются зарезервированными символами, поэтому их нужно окружать кавычками). Поиск запросов, в которых среда содержит определенный текст.
Поиск задач, в которых особое пользовательское поле имеет определенное значение. Поиск запросов, которые были созданы определенным пользователем. Используется для поиска проблем, когда заданное поле не имеет значения. В общем случае запрос, созданный с использованием «Простого поиска», может быть переведена в «Расширенный поиск» (т. е. JQL) и обратно.
Это было бы полезно в системах, которые имеют много проектов, и где пользователи обычно заботятся только о немногих. Чтобы сделать функцию действительно готовой, вашей RoleFunction также необходимо внедрить ClauseSanitisingJqlFunction. Сохраненный JQL-поиск (фильтр) может использоваться совместно с несколькими пользователями.
Найти задачи, которые назначены определенной исправленной версии. Вы можете выполнить поиск по имени версии или идентификатору версии (то есть номер, который JIRA автоматически присваивает версии). В разных проектах могут быть компоненты с одинаковым именем, поэтому поиск по имени компонента может возвращать проблемы из нескольких проектов. Администратор JIRA также может изменить имя компонента, который может сломать любые сохраненные фильтры, которые полагаются на это имя. Идентификаторы компонентов, однако, уникальны и не могут быть изменены.
Basic Search удобно использовать, если сложность запроса невысока. Недостатком такого поиска является невозможность построения комплексных запросов. Администратор JIRA может изменить имя типа, которое может сломать любой сохраненный фильтр, который полагается на это имя. Идентификаторы типов, однако, уникальны и не могут быть изменены.
Некоторые операторы могут использовать ключевое слово NOT. Используется для указания полей, значения которых будут отсортированы по результатам поиска. По умолчанию будет использоваться собственный порядок сортировки поля. Вы можете переопределить это, указав восходящий порядок («asc») или убывающий порядок («desc»). Расширенный поиск позволяет использовать структурированные запросы (queries) для поиска задач проекта JIRA. Результаты поиска будут отображаться в Навигаторе задач, где вы можете экспортировать их в MS Excel и многие другие форматы.
Используется для объединения нескольких предложений, что позволяет расширить поиск. Наряду с этим, вы также можете определить и выполнить поиск, используя быстрый поиск или используя основной поиск.
Поиск задач, в которых исходная оценка установлена на определенное значение (т. е. число, а не дату или диапазон дат). Доступно только в том случае, если администратор JIRA активировал защиту уровня задачи. Возможно, имя фильтра будет изменено, что может сломать сохраненный фильтр, который вызывает другой фильтр по имени. Идентификаторы фильтров, однако, уникальны и не могут быть изменены.
ProjectManager, который мы использовали для получения проектов, не выполняет проверку прав и возвращает все проекты, соответствующие запросу. Поскольку вы будете использовать ProjectService, проекты, которые не отображаются для пользователя, не будут найдены. На этом этапе вы будете использовать команду atlas для создания кода-заглушки для вашего приложения. Команды atlas являются частью SDK Atlassian Plugin и автоматизируют большую часть разработки приложений для вас. В этом учебном курсе показана реализация новой функции JQL, называемой roleMembers.
