Skip to main content

Фильтрация projects

Используйте фильтры для выбора элементов, отображаемых в представлениях проекта.

Вы можете настроить элементы, отображаемые в представлениях, с помощью фильтров для метаданных элементов, таких как назначенные и метки, примененные к проблемам, а также по полям в проекте. Фильтры можно объединять и сохранять как представления. Дополнительные сведения см. в разделе Управление представлениями.

Чтобы отфильтровать представление, щелкните и начните вводить поля и значения, которые вы хотите отфильтровать. По мере ввода будут отображаться возможные значения. Вы также можете открыть палитру команд проекта, нажав Command+K (Mac) or Ctrl+K (Windows/Linux), и ввести "фильтр", чтобы выбрать нужный фильтр из доступных.

Снимок экрана: расположение значка фильтра

В макете доски можно щелкнуть данные элемента, чтобы отфильтровать элементы с таким значением. Например, можно щелкнуть уполномоченного, чтобы отобразить только назначенные ему элементы. Чтобы удалить фильтр, щелкните данные элемента еще раз.

Если выбрать несколько фильтров, они будут объединены логическим И. Например, label:bug status:"In progress" возвращает элементы с bug меткой и состоянием "Выполняется". Вы также можете указать несколько значений для одного поля в качестве логического фильтра ИЛИ. Например, label:bug,support возвращает элементы с bug метками или support . Projects в настоящее время не поддерживает фильтры с логическим ИЛИ по нескольким полям.

Те же фильтры доступны для диаграмм, создаваемых с помощью аналитических сведений для Projects, что позволяет фильтровать данные, используемые для создания диаграмм. Дополнительные сведения см. в разделе Использование аналитических сведений с проектами.

При фильтрации представления и последующем добавлении элемента отфильтрованные метаданные будут применены к новому элементу. Например, если вы фильтруете status:"In progress" по и добавляете элемент, состояние нового элемента будет иметь значение "Выполняется".

Фильтры можно использовать для создания представлений для конкретных целей. Например, можно использовать для assignee:@me status:todo last-updated:5days создания представления всех работ, назначенных текущему пользователю с состоянием "Todo", которое не обновлялось за последние пять дней. Представление рассмотрения можно создать с помощью отрицательного фильтра, например no:label no:assignee repo:octocat/game, который будет отображать элементы без метки и без получателя, расположенные в репозитории octocat/game .

Фильтрация полей

КвалификаторПример
assignee:USERNAMEassignee:octocat отобразит элементы, назначенные @octocat.
label:LABELв label:bug будут отображаться элементы с примененной меткой "ошибка".
field:VALUEВ status:done будут отображаться элементы с полем "состояние", равным "готово".
reviewers:USERNAMEreviewers:octocat будет отображать элементы, которые были проверены @octocat.
milestone:"MILESTONE"веха: "Бета-выпуск" будет отображать элементы, назначенные вехе "Бета-выпуск".

Объединение фильтров

Вы можете создать фильтры для нескольких полей. В представлении будут отображаться элементы, соответствующие всем фильтрам.

КвалификаторПример
assignee:USERNAME field:VALUEassignee:octocat priority:1 будет отображать элементы, назначенные @octocat им с приоритетом 1.

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

КвалификаторПример
assignee:USERNAME,USERNAMEassignee:octocat,stevecat отображает элементы, назначенные @octocat или @stevecat.

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

КвалификаторПример
assignee:USERNAME assignee:USERNAMEassignee:octocat assignee:stevecat будут отображаться элементы, назначенные и @octocat @stevecat.

Вы также можете объединять фильтры, которые соответствуют некоторым элементам и соответствуют всем элементам.

КвалификаторПример
field:VALUE,VALUE assignee:USER assignee:USERLabel:bug, onboarding assignee:octocat assignee:stevecat будет отображать элементы, которые имеют метки ошибки или подключения, но назначены как , так @octocat и @stevecat.

Отрицание фильтра

Вы можете инвертировать любой фильтр, включая комбинации, путем добавления префикса дефисом.

КвалификаторПример
-assignee:USERNAMEПараметр -assignee:octocat не будет отображать элементы, назначенные @octocat.
-field:VALUEПараметр -status:done не отображает элементы с состоянием "готово".
-field:VALUE,VALUE-priority:1,2 не будет отображать элементы с приоритетом 1 или 2.

Фильтрация элементов, для которых отсутствует значение

Вы можете использовать для no: фильтрации элементов, для которых отсутствует значение

КвалификаторПример
no:assigneeNo:assignee будет отображать все неназначенные элементы.
no:reviewersno:reviewers будут отображать запросы на вытягивание, у которых нет рецензента.
no:FIELDNo:priority будет отображать элементы с пустым полем приоритета.

Можно также добавить префикс к дефису, чтобы отрицать это поведение и возвращать только элементы со значением.

КвалификаторПример
-no:assigneeПараметр -no:assignee будет отображать только назначенные элементы.
-no:FIELDПараметр -no:priority будет отображать только элементы, имеющие значение в поле приоритета.

Фильтрация по расположению элемента

repo Используйте квалификатор для фильтрации элементов в определенном репозитории.

КвалификаторПример
repo:OWNER/REPOrepo:octocat/game содержит элементы в репозитории octocat/game.

Фильтрация по состоянию или типу элемента

Квалификатор можно использовать is для фильтрации по определенным типам элементов или элементов в определенных состояниях.

КвалификаторПример
is:STATEis:open отобразит открытые проблемы и запросы на вытягивание.
is:closed отобразит закрытые проблемы и запросы на вытягивание.
is:merged отображает все объединенные запросы на вытягивание.
is:TYPEis:issue будет отображать только проблемы.
is:pr будет отображать только запросы на вытягивание.
is:draft будет отображать черновик проблем и черновик запросов на вытягивание.
is:issue is:open отобразит открытые проблемы.

Фильтрация по причине закрытия

Вы можете отфильтровать закрытые элементы по причине их закрытия.

КвалификаторПример
reason:CLOSE REASONreason:completed отображает элементы, закрытые из-за их завершения.
reason:"not planned" отображает закрытые элементы с причиной "не запланировано".
в функции reason:reopened отображаются элементы, которые были вновь открыты после закрытия ранее.

Фильтрация по полю отслеживания

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

КвалификаторПример
tracked-by:"OWNER/REPO#ISSUE NUMBER"tracked-by:"octocat/game#11" отображает любую проблему, отслеживаемую списком задач в проблеме No 11 репозитория octocat/game .

Фильтрация по времени последнего обновления элемента

С помощью синтаксиса {number}days можно отфильтровать время последнего обновления элементов.

КвалификаторПример
last-updated:NUMBERdayslast-updated:1day будет отображать элементы, последние обновленные один или несколько дней назад.
last-updated:7days будут отображаться элементы, последние обновленные семь или более дней назад.
-last-updated:10days отобразит элементы, которые были обновлены за последние десять дней.

Фильтрация полей числа, даты и итерации

Вы можете использовать >, >=, <и <= для сравнения полей числа, даты и итерации. Даты должны быть указаны в YYYY-MM-DD формате .

КвалификаторПример
field:>VALUEpriority:>1 будет отображать элементы с приоритетом больше 1.
field:>=VALUEdate:>=2022-06-01 будет отображать элементы с датой "2022-06-01" или более поздней.
field:<VALUEiteration:< "Итерация 5" будет отображать элементы с итерацией перед "Итерация 5".
field:>=VALUEpoints:<=10 отображает элементы с 10 или меньше баллов.

Вы также можете использовать для .. фильтрации инклюзивного диапазона. При работе с диапазоном * можно указать в качестве оператора с подстановочными знаками.

КвалификаторПример
field:VALUE..VALUEpriority:1..3 отображает элементы с приоритетом 1, 2 или 3.
date:2022-01-01..2022-12-31 будет отображать элементы за 2022 год.
points:*.. 10 отображает элементы со значением баллов до 10 включительно.
итерация:"Итерация 1".. Итерация 4" будет отображать элементы в "Итерация 1", "Итерация 2", "Итерация 3" и "Итерация 4".

Фильтрация назначенных и рецензентов с помощью ключевых слов

Ключевое слово можно использовать для @me представления себя в фильтре.

КвалификаторПример
field:@meassignee:@me будут отображаться элементы, назначенные вошедшего пользователя.
-reviewers:@me будут отображаться элементы, которые не были проверены вошедшего пользователя.

Фильтрация полей итерации и даты с помощью ключевых слов

Ключевые @previousслова , @currentи @next можно использовать для фильтрации итераций относительно текущей итерации. Вы также можете использовать для @today фильтрации по текущему дню.

КвалификаторПример
field:@keyworditeration:@current будут отображаться элементы, назначенные текущей итерации.
iteration:@next будут отображаться элементы, назначенные следующей итерации.
field:@todaydate:@today будут отображаться элементы с датой, заданной текущим днем.

Вы также можете использовать >диапазоны , >=, <, <=, +и .. -с ключевыми словами.

КвалификаторПример
field:@keyword..@keyword+niteration:@current..@current +3 отобразит элементы, назначенные текущей итерации и следующим трем итерациям.
date:@today..@today +7 отобразит элементы с датой, заданной сегодня или на следующие семь дней.
field:<@keyworditeration:<@current будут отображаться элементы, назначенные любой итерации перед текущей итерацией.
field:>=@keyworddate:>=@today будут отображаться элементы с датой, заданной сегодня или более поздней.

Фильтрация по текстовым полям

Вы можете фильтровать по определенным текстовым полям или использовать общий фильтр по всем текстовым полям и заголовкам. При фильтрации текста, содержащего пробелы или специальные символы, заключайте текст в " кавычки или ' .

КвалификаторПример
field:"TEXT"title:"НЕрекомендуемые API" будут отображать элементы с заголовками, которые точно соответствуют "нерекомендуемые API".
field:TEXTNote:complete будет отображать элементы с текстовым полем заметки, которые точно соответствуют "завершено".
TEXTAPI будет отображать элементы с "API" в заголовке или любом другом текстовом поле.
field:TEXT TEXTlabel:bug rendering будет отображать элементы с меткой "ошибка" и с "отрисовкой" в заголовке или любом другом текстовом поле.

Вы также можете использовать в * качестве подстановочного знака.

КвалификаторПример
field:*TEXT*в label:*bug* будут отображаться элементы с меткой, содержащей слово "ошибка".
field:TEXT*title:API* будут отображаться элементы с заголовком, начинающимся с "API".
field:*TEXTlabel:*support будет отображать элементы с меткой, которая заканчивается на "support".