Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.

Фильтрация projects

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

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

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

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

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

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

Те же фильтры доступны для диаграмм, создаваемых с помощью аналитических сведений для 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:VALUEstatus:done будут отображаться элементы с полем "состояние", равным "готово".
reviewers:USERNAMEreviewers:octocat отображает элементы, которые были проверены @octocat.
milestone:"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:TYPEв is: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 будут отображаться элементы с датой "01.06.2022" или более поздней.
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 будет отображать элементы с меткой, которая заканчивается на "поддержка".