Вы можете настроить элементы, отображаемые в представлениях, с помощью фильтров для метаданных элементов, таких как назначенные и метки, применяемые к проблемам, а также по полям в проекте. Фильтры можно объединять и сохранять как представления. Дополнительные сведения см. в разделе Управление представлениями.
Чтобы отфильтровать представление, щелкните и начните вводить поля и значения, которые вы хотите отфильтровать. По мере ввода будут отображаться возможные значения. Вы также можете открыть палитру команд проекта, нажав Команды+ 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:USERNAME | assignee:octocat будут отображаться элементы, назначенные .@octocat |
label:LABEL | в поле label:bug будут отображаться элементы с примененной меткой "ошибка". |
field:VALUE | status:done будут отображаться элементы с полем "состояние", равным "готово". |
reviewers:USERNAME | reviewers:octocat отображает элементы, которые были проверены @octocat. |
milestone:"MILESTONE" | milestone:"Бета-выпуск" будет отображать элементы, назначенные вехе "Бета-выпуск". |
Объединение фильтров
Можно создать фильтры для нескольких полей. В представлении будут отображаться элементы, соответствующие всем фильтрам.
Квалификатор | Пример |
---|---|
assignee:USERNAME field:VALUE | assignee:octocat priority:1 отобразит элементы, назначенные @octocat с приоритетом 1. |
Можно также отфильтровать несколько значений из одного поля. Если вы разделите значения запятыми, в представлении будут отображаться элементы, которые соответствуют любому из указанных значений.
Квалификатор | Пример |
---|---|
assignee:USERNAME,USERNAME | assignee:octocat,stevecat будут отображать элементы, назначенные @octocat или @stevecat. |
Чтобы отфильтровать несколько значений из одного поля, но отобразить элементы, которые соответствуют всем указанным значениям, можно повторить квалификатор для каждого значения.
Квалификатор | Пример |
---|---|
assignee:USERNAME assignee:USERNAME | assignee:octocat assignee:stevecat будут отображаться элементы, назначенные и @octocat @stevecat. |
Вы также можете объединять фильтры, которые соответствуют некоторым и всем элементам.
Квалификатор | Пример |
---|---|
field:VALUE,VALUE assignee:USER assignee:USER | label: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:assignee | no:assignee будет отображать все неназначенные элементы. |
no:reviewers | no:reviewers будут отображать запросы на вытягивание, у которых нет рецензента. |
no:FIELD | no:priority будут отображаться элементы с пустым полем приоритета. |
Вы также можете префиксировать дефис, чтобы отрицать это поведение и возвращать только элементы со значением.
Квалификатор | Пример |
---|---|
-no:assignee | Параметр -no:assignee будет отображать только назначенные элементы. |
-no:FIELD | Параметр -no:priority будет отображать только те элементы, которые имеют значение в поле приоритета. |
Фильтрация по расположению элемента
repo
Используйте квалификатор для фильтрации элементов в определенном репозитории.
Квалификатор | Пример |
---|---|
repo:OWNER/REPO | repo:octocat/game содержит элементы в репозитории octocat/game. |
Фильтрация по состоянию или типу элемента
Квалификатор можно использовать is
для фильтрации по определенным типам элементов или элементов в определенных состояниях.
Квалификатор | Пример |
---|---|
is:STATE | is:open отобразит открытые проблемы и запросы на вытягивание. |
is:closed отобразит закрытые проблемы и запросы на вытягивание. | |
is:merged отобразит все объединенные запросы на вытягивание. | |
is:TYPE | в is:issue будут отображаться только проблемы. |
параметр is:pr будет отображать только запросы на вытягивание. | |
параметр is:draft будет отображать черновики проблем и черновики запросов на вытягивание. | |
is:issue is:open отобразит открытые проблемы. |
Фильтрация по причине закрытия
Вы можете отфильтровать закрытые элементы по причине их закрытия.
Квалификатор | Пример |
---|---|
reason:CLOSE REASON | reason: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:NUMBERdays | last-updated:1day будут отображаться элементы, которые были обновлены один или несколько дней назад. |
last-updated:7days будут отображаться элементы, последние обновленные семь или более дней назад. | |
-last-updated:10days будут отображаться элементы, которые были обновлены за последние десять дней. |
Фильтрация полей числа, даты и итерации
Вы можете использовать >
, >=
, <
и <=
для сравнения полей числа, даты и итерации. Даты должны быть указаны в YYYY-MM-DD
формате .
Квалификатор | Пример |
---|---|
field:>VALUE | priority:>1 будет отображать элементы с приоритетом больше 1. |
field:>=VALUE | date:>=2022-06-01 будут отображаться элементы с датой "01.06.2022" или более поздней. |
field:<VALUE | iteration:< "Итерация 5" будет отображать элементы с итерацией перед "Итерация 5". |
field:>=VALUE | points:<=10 — отображаются элементы с 10 или менее точками. |
Можно также использовать для ..
фильтрации инклюзивного диапазона. При работе с диапазоном *
может быть указан в качестве оператора с подстановочными знаками.
Квалификатор | Пример |
---|---|
field:VALUE..VALUE | priority:1..3 будет отображать элементы с приоритетом 1, 2 или 3. |
date:2022-01-01..2022-12-31 будут отображаться элементы за 2022 год. | |
points:*.. Значение 10 отображает элементы со значением баллов до 10 включительно. | |
итерация:"Итерация 1".". Итерация 4" будет отображать элементы в "Итерация 1", "Итерация 2", "Итерация 3" и "Итерация 4". |
Фильтрация назначенных и рецензентов с помощью ключевых слов
Вы можете использовать @me
ключевое слово, чтобы представить себя в фильтре.
Квалификатор | Пример |
---|---|
field:@me | assignee:@me будут отображать элементы, назначенные вошедшего пользователя. |
-reviewers:@me будут отображать элементы, которые не были проверены вошедшего пользователя. |
Фильтрация полей итерации и даты с помощью ключевых слов
Ключевые @previous
слова , @current
и @next
можно использовать для фильтрации итераций относительно текущей итерации. Можно также использовать для @today
фильтрации по текущему дню.
Квалификатор | Пример |
---|---|
field:@keyword | iteration:@current будет отображать элементы, назначенные текущей итерации. |
iteration:@next будет отображать элементы, назначенные для следующей итерации. | |
field:@today | date:@today будет отображать элементы с датой текущего дня. |
Можно также использовать >
диапазоны , , >=``<
, +``<=
, -
, и ..
с ключевыми словами.
Квалификатор | Пример |
---|---|
field:@keyword..@keyword+n | iteration:@current..@current +3 отобразит элементы, назначенные текущей итерации и следующим трем итерациям. |
date:@today..@today +7 отобразятся элементы с датой сегодня или на следующие семь дней. | |
field:<@keyword | iteration:<@current отображает элементы, назначенные любой итерации, перед текущей итерацией. |
field:>=@keyword | date:>=@today будет отображать элементы с датой сегодня или более поздней. |
Фильтрация по текстовым полям
Можно фильтровать по определенным текстовым полям или использовать общий текстовый фильтр по всем текстовым полям и заголовкам. При фильтрации текста, содержащего пробелы или специальные символы, заключите текст в "
кавычки или '
.
Квалификатор | Пример |
---|---|
field:"TEXT" | title:"Устаревание API" будут отображаться элементы с заголовками, которые точно соответствуют "устаревание API". |
field:TEXT | note:complete отображает элементы с текстовым полем примечания, которое точно соответствует "завершено". |
TEXT | API будет отображать элементы с "API" в заголовке или любом другом текстовом поле. |
field:TEXT TEXT | label:bug rendering (метка:ошибка) будут отображать элементы с меткой "ошибка" и "отрисовкой" в заголовке или любом другом текстовом поле. |
Можно также использовать в *
качестве подстановочного знака.
Квалификатор | Пример |
---|---|
field:*TEXT* | в label:*bug* будут отображаться элементы с меткой, содержащей слово "ошибка". |
field:TEXT* | title:API* будут отображаться элементы с заголовком, начинающимся с "API". |
field:*TEXT | Label:*support будет отображать элементы с меткой, которая заканчивается на "поддержка". |