Эта функция возвращает пользователей, которые являются членами конкретной роли проекта Jira. В данной части мы рассмотрели расширенный функционал JQL. В следующей статье мы рассмотрим, какие существуют функции в JQL и полезные возможности по управлению вашими запросами JQL. LinkedIssues() ‒ функция ищет задачи, которые связаны с другой задачей. В запросе JQL функции предшествует оператор, перед которым стоит название поля.
То есть, тип ввода WAS IN («Решено», «Закрыто») совпадает с типизированным статусом. Для получения дополнительной информации, включая информацию о включении специальных символов в ваши поиски, см. JQL дает вам SQL-подобный синтаксис, такой как ключевое слово ORDER BY SQL и ISNULL () SQL (т. е. ключевое слово NULL в JQL). Однако JQL не является языком задач к базе данных. Когда вы выполняете расширенный поиск, вы используете язык JIRA Query Language (JQL).
Поиск задач, назначенных конкретному пользователю. Оператор «WAS NOT» используется для поиска запросов, которые никогда не имели указанного значения для указанного поля. Оператор «WAS IN» используется для поиска задач, которые в настоящее время имеют или ранее имели любое из нескольких заданных значений для указанного поля. Расширенная функция поиска позволяет создавать структурированные запросы на языке запросов Jira (Jira Query Language, JQL) для поиска задач в одном или нескольких проектах. Результаты запросов можно сохранять и использовать в качестве фильтров и представлений в Jira (в том числе на досках). WatchedIssues() ‒ поиск происходит по задачам, в которых текущий пользователь является наблюдателем.
- Идентификаторы разрешения, однако, уникальны и не могут быть изменены.
- Кроме того, функции, как правило, должны проверять разрешения в Jira, чтобы они возвращали только проекты, к которым у пользователя есть доступ.
- Разработчики могут создавать свои собственные JQL-функции с использованием модуля плагина JQL-функции.
- Помните, что с помощью JQL сравнивать два поля невозможно.
Поиск задач, которые назначаются конкретной затронутой версии (иям). Оператор «WAS» используется для поиска задач, которые в настоящее время имеют или ранее имели указанное значение для указанного поля. Approver() ‒ ищет задачи, которые были утверждены определенным пользователем.
Важную роль в жизненном цикле разработки программного обеспечения играют системы управления проектами. Находит задачи, в которых есть комментарий в записи журнала работы, в котором содержится конкретный текст. Если у вас несколько спринтов с похожими (или идентичными) именами, вы можете просто выполнить поиск, используя имя спринта – или даже просто его часть.
Администратор JIRA также может изменить имя версии, которая может сломать любые сохраненные фильтры, которые полагаются на это имя. Оператор «WAS NOT IN» используется для поиска задач, когда значение указанного поля никогда не было одним из нескольких заданных значений. Если у вас много текстовых полей, вы можете повысить производительность своих запросов, выполнив поиск по определенным полям, например. В этом учебном пособии показано, как добавить JQL-функцию в Jira. Затем вы сможете использовать функцию в расширенной форме поиска, чтобы находить задачи только в тех проектах, к которым вы недавно обращались. В реальном мире пользователь, скорее всего, будет использовать эту функцию в сочетании с другим предложением поиска.
Tutorials For Superior Search In Jira
Ищите задачи с определенным количеством наблюдателей. Вы можете искать по имени разрешения или идентификатору разрешения (то есть номер, который JIRA автоматически назначает на разрешение). Поиск задач,описание в которых содержит определенный текст. Можно использовать синтаксис текстового поиска JIRA.
При желании, Вы также можете сохранить построенные задачи и оформить на них подписку. Благодаря функции поиска в Jira вы сможете получить ключевые аналитические данные о проекте и найти ответы на актуальные для команды вопросы. Три вида поиска в Jira — быстрый, основной и расширенный — помогут отыскать важную информацию о проектах. List указывает, возвращает ли эта функция список задач или одно значение. На этом этапе вы будете использовать команду atlas- для создания кода-заглушки для вашего приложения и настройки кода-заглушки. Атлас-команды являются частью Atlasian Plugin SDK и автоматизируют большую часть разработки приложений для вас.
Хотя эта функциональность очень полезна, она также позволяет утечке информации. Например, предположим, что у вас есть фильтр, который содержит assignee in roleMembers(Administrators, Proj), и вы делитесь фильтром с Janice, который не может видеть Proj. Однако поиск не вернет никаких результатов, однако Janice будет знать, что проект Proj существует, хотя у нее нет разрешения на его просмотр. Функция JQL, которая может предоставлять конфиденциальную информацию, также должна реализовывать дополнительный интерфейс ClauseSanitisingJqlFunction. Если у вас много текстовых полей, вы можете повысить производительность своих задач, выполнив поиск по определенным полям, например.
Обзор Учебника
CurrentUser() ‒ поиск происходит по текущему пользователю. Вы можете выполнить поиск по имени пользовательского поля или пользовательскому идентификатору поля (т. е. номер, который JIRA автоматически назначает настраиваемому полю). Поле jql запросы в JQL – это слово, представляющее поле JIRA (или пользовательское поле, которое уже определено в JIRA). В предложении за полем следует оператор, который, в свою очередь, сопровождается одним или несколькими значениями (или функциями).
Любой пользователь может использовать эту функцию, поэтому вместо этого мы используем getProjectHistoryWithoutPermissionChecks (). Вы можете выполнить поиск по имени приоритета или идентификатору приоритета (т. е. по номеру, который JIRA автоматически назначает приоритету). Администратор JIRA также может изменить имя настраиваемого поля, которое может сломать любые сохраненные фильтры, которые полагаются на это имя. Пользовательские идентификаторы полей, однако, уникальны и не могут быть изменены.
Имя fname представляет собой имя для нашей функции, так как оно будет использоваться в операторах JQL. SDK добавила JQL-модуль функции в наш дескриптор приложения, который описывает приложение для Jira. В этом случае операнд является литеральной строкой fred. Jira поставляется со многими встроенными функциями. Отсюда вы можете продолжать работать, когда вы продолжаете разработку приложения. Чтобы перезагрузить приложение, используйте QuickReload.
Jql Для Начинающих Пользователей (часть
Идентификаторы разрешения, однако, уникальны и не могут быть изменены. Для этого поля вы можете использовать только операторы ПУСТО EMPTY или ПУСТО. Функция roleMembers должна проверять, что прошедший пользователь может видеть все аргументы проекта. Если все прошедшие проекты видны, мы можем просто вернуть функцию FunctionOperand как переданную.
Для эффективного поиска важно понимать, какие значения способно приобретать то или иное поле. Вы можете выполнить поиск по имени статуса или индентификатору (ID) статуса (например, номер, который JIRA автоматически присваивает статусу). Вы можете использовать сохраненный фильтр, чтобы сузить область поиска. Вы можете искать по имени фильтра или идентификатору фильтра (т. е. по номеру, который JIRA автоматически присваивает сохраненному фильтру). Оператор «IS NOT» может использоваться только сEMPTY ПУСТО или NULL. То есть он используется для поиска задач, когда указанное поле имеет значение.
С другой стороны, если некоторые из проектов не видны, то дезинфицирующее средство должно возвращать новую FunctionOperand, в которой имена заменены идентификаторами проекта. Первый аргумент – это имя роли, члены которой мы пытаемся найти. Любые другие аргументы называются проектами, роли которых должны быть проверены. Когда проект не указан, запрашиваются все проекты, которые может видеть поисковик. Например, вызов roleMembers (trole, tproj) найдет всех пользователей в роли trole для проекта tproj.
Возможные совпадения будут показаны в раскрывающемся списке автозаполнения, с указанием дат спринта, чтобы помочь вам различить их. (Идентификатор спринта также будет показан в скобках). Поиск задач, которые заданы для конкретного спринта в JIRA Agile.
С водными разобрались, теперь рассмотрим некоторые существующие функции и примеры написания в запросе. Функция в JQL отображается в виде слова, за которым идут круглые скобки. В этих скобках могут содержаться значения переменных, названий полей или, откуда функция возьмет эти значения. Рассмотрим подробнее на примерах пункты 2 и four как искать некоторые задачи. Созданные запросы можно сохранять и использовать в качестве фильтров, а также для настройки просмотра в Jira (включая доски) в будущем. Названия полей могут изменяться в зависимости от проекта, поэтому важно знать названия полей именно на своем проекте.
Если у вас много текстовых пользовательских полей, вы можете повысить производительность своих задач, выполнив поиск по определенным полям, например. В разных проектах могут быть версии с одинаковым именем, поэтому поиск по имени версии может возвращать задачи из нескольких проектов. Администратор JIRA также может изменить имя версии, которая может разорвать любые сохраненные фильтры, которые полагаются на это имя. Идентификаторы версий, однако, уникальны и не могут быть изменены.
Оператор сравнивает значение поля с одним или несколькими значениями или функциями справа, так что только предложение возвращает только истинные результаты. Оператор «CHANGED» используется для поиска задач, имеющих значение, которое было изменено для указанного поля. Чтобы расширить функцию JQL, вы можете заставить ее принять параметр. Кроме того, функции, как правило, должны проверять разрешения в Jira, чтобы они возвращали только проекты, к которым у пользователя есть доступ. В нашем случае, поскольку мы используем недавнюю функцию истории, мы уже знаем, что пользователь может получить доступ к возвращенным проектам. Для получения дополнительной информации по этим темам см.
Это облегчит отслеживание и мониторинг работы в разных проектах. SDK был достаточно полезен, чтобы предоставить нам единичные и интеграционные тестовые файлы-заглушки для нашего кода приложения. Тем не менее, они действительно предназначены для того, чтобы стать отправными точками для вашего тестирования, поэтому они требуют больше внимания, чтобы быть полезными. Тестирование – большая тема, поэтому мы оставляем это для другого учебника под названием «Написание и запуск тестов приложений». Теперь вы будете использовать генератор модуля плагина (то есть другую команду atlas) для создания кода заглушки для модулей, требуемых приложением. SDK создает исходные файлы проекта приложения в каталоге jira-simple-jql-function.
Вы должны были пройти хотя бы один учебник для начинающих, прежде чем работать с этим учебником. Мы используем ProjectRoleManager для получения ProjectRoleActors для указанных роли проекта и проекта, а затем конвертируем их в ApplicationUser. Теперь давайте создадим функцию JQL, на которую была ссылка в дескрипторе приложения. Мы собираемся сделать это простым, чтобы начать с этого, и строим этот класс по мере того, как мы идем. Вы должны были пройти хотя бы один промежуточный учебник, прежде чем работать с этим учебником. Для хранения нужно нажать «Save as» и добавить название фильтра, после чего фильтр будет добавлен в остальные фильтры, находящиеся в боковом меню.
Leave A Comment