# Фильтрация проекты

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

Вы можете настроить элементы в представлениях с помощью фильтров для метаданных элементов, таких как назначаемые и метки, примененные к проблемам, а также поля в проекте. Фильтры можно объединять и сохранять как представления. Дополнительные сведения см. в разделе [Управление представлениями](/ru/enterprise-server@3.21/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views).

Чтобы отфильтровать представление, щелкните и начните <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-filter" aria-label="Filter by keyword or by field" role="img"><path d="M.75 3h14.5a.75.75 0 0 1 0 1.5H.75a.75.75 0 0 1 0-1.5ZM3 7.75A.75.75 0 0 1 3.75 7h8.5a.75.75 0 0 1 0 1.5h-8.5A.75.75 0 0 1 3 7.75Zm3 4a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z"></path></svg> вводить поля и значения, для чего вы хотите отфильтровать. По мере ввода будут отображаться возможные значения. Вы также можете открыть палитру команд проекта, нажав клавишу <kbd>Command</kbd>+<kbd>K (Mac) или <kbd>CTRL</kbd><kbd></kbd>+</kbd> (Windows/Linux)"Фильтр по", чтобы выбрать из доступных фильтров.

![Снимок экрана: проект Mona. Поле с меткой "Фильтр по ключевому слову или по полю" выделено оранжевым контуром.](/assets/images/help/projects-v2/filter-example.png)

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

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

Те же фильтры доступны для диаграмм, для которых вы создаете аналитические Projectsсведения, что позволяет фильтровать данные, используемые для создания диаграмм. Дополнительные сведения см. в разделе [Аналитические сведения для Projects](/ru/enterprise-server@3.21/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects).

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

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

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

| Квалификатор                                                                       | Пример |
| ---------------------------------------------------------------------------------- | ------ |
| <code>assignee:<em>USERNAME</em></code>                                            |        |
| **assignee:octocat** отображает элементы, назначенные @octocat.                    |        |
| <code>label:<em>LABEL</em></code>                                                  |        |
| **label:bug** отображает элементы с примененной меткой "ошибка".                   |        |
| <code>field:<em>VALUE</em></code>                                                  |        |
| **status:done** отображает элементы с полем "состояние", равным "готово".          |        |
| <code>reviewers:<em>USERNAME</em>                                                  |        |
| **рецензенты:octocat** будут отображать элементы, которые были проверены @octocat. |        |
| <code>milestone:"<em>MILESTONE</em>"                                               |        |
| **веха:"Выпуск QA"** будет отображать элементы, назначенные вехе "выпуск QA".      |        |

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

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

| Квалификатор                                                | Пример                                                                                         |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| <code>assignee:<em>USERNAME</em>field:<em>VALUE</em></code> | **assignee:octocat priority:1** отображает элементы, назначенные @octocat с приоритетом **1**. |

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

| Квалификатор                                                                                  | Пример |
| --------------------------------------------------------------------------------------------- | ------ |
| <code>assignee:<em>USERNAME</em>,<em>USERNAME</em></code>                                     |        |
| **assignee:octocat, стивкат** будет отображать элементы, назначенные либо @octocat\@stevecat. |        |

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

| Квалификатор                                                      | Пример                                                                                                    |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| <code>assignee:<em>USERNAME</em>assignee:<em>USERNAME</em></code> | **assignee:octocat assignee:stevecat** будет отображать элементы, назначенные обоим @octocat и @stevecat. |

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

| Квалификатор                                                                          | Пример                                                                                                                                                 |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <code>field:<em>VALUE</em>,<em>VALUE</em>assignee:<em>USER</em>assignee:<em>USER</em> | **label:bug,onboardee:octocat assignee:stevecat** будет отображать элементы с метками ошибки или подключения, но назначены обоим @octocat и @stevecat. |

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

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

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

## Фильтрация элементов с значением

Можно использовать `has:` для фильтрации элементов, имеющих значение

| Квалификатор                                                       | Пример |
| ------------------------------------------------------------------ | ------ |
| <code>has:assignee</code>                                          |        |
| **has:assignee** отображает элементы с назначаемой.                |        |
| <code>has:label</code>                                             |        |
| **has:label** отображает элементы с меткой.                        |        |
| <code>has:<em>FIELD</em>                                           |        |
| **has:priority** отображает элементы со значением поля приоритета. |        |

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

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

| Квалификатор                                                                          | Пример |
| ------------------------------------------------------------------------------------- | ------ |
| <code>no:assignee</code>                                                              |        |
| **no:assignee** будет отображать любые неподписанные элементы.                        |        |
| <code>no:reviewers</code>                                                             |        |
| **Нет:рецензенты будут отображать запросы** на вытягивание, у которых нет рецензента. |        |
| <code>no:<em>FIELD</em>                                                               |        |
| **no:priority** отображает элементы с пустым полем приоритета.                        |        |

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

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

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

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

| Квалификатор                                                      | Пример |
| ----------------------------------------------------------------- | ------ |
| <code>repo:<em>OWNER/REPO</em></code>                             |        |
| **repo:octocat/game будет элементы в репозитории octocat/game** . |        |

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

С помощью `is` квалификатора можно фильтровать определенные типы элементов или элементов в определенных состояниях.

| Квалификатор                                                                   | Пример |
| ------------------------------------------------------------------------------ | ------ |
| <code>is:<em>STATE</em></code>                                                 |        |
| **is:open** отображает открытые проблемы и запросы на вытягивание.             |        |
|                                                                                |        |
| **is:closed** отображает закрытые проблемы и запросы на вытягивание.           |        |
|                                                                                |        |
| **is:merged** отображает все объединенные запросы на вытягивание.              |        |
| <code>is:<em>TYPE</em></code>                                                  |        |
| **is:issue** отображает только проблемы.                                       |        |
|                                                                                |        |
| **is:pr** отображает только запросы на вытягивание.                            |        |
|                                                                                |        |
| **is:draft** отображает черновики вопросов и черновик запросов на вытягивание. |        |
|                                                                                |        |
| **is:issue is:open** отображает открытые проблемы.                             |        |

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

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

| Квалификатор                                                                                        | Пример |
| --------------------------------------------------------------------------------------------------- | ------ |
| <code>reason:<em>CLOSE REASON</em></code>                                                           |        |
| **reason:completed** отображает элементы закрыты, так как они были завершены.                       |        |
|                                                                                                     |        |
| **причина:"не запланировано"** будет отображать закрытые элементы с причиной "не запланировано".    |        |
|                                                                                                     |        |
| **причина:повторное открытие** отобразит элементы, которые были вновь открыты после закрытия ранее. |        |

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

Поле `updated` фильтра обеспечивает более мощный и гибкий способ фильтрации элементов на основе даты последнего изменения.

| Квалификатор                                                                              | Пример |
| ----------------------------------------------------------------------------------------- | ------ |
| <code>updated:<em>NUMBER</em>days</code>                                                  |        |
| \*\*                                                                                      |        |
| updated:@today                                                                            |        |
| \*\* будут отображаться элементы, обновленные сегодня.                                    |        |
|                                                                                           |        |
| \*\*                                                                                      |        |
| updated:@today-1d                                                                         |        |
| \*\* будут отображаться элементы, обновленные 1 день назад.                               |        |
|                                                                                           |        |
| **обновлено:>@today-1w** отображает элементы, последние обновленные семь дней назад.      |        |
|                                                                                           |        |
| **обновлено:>@today-30d** отображает элементы, последние обновленные тридцати дней назад. |        |
|                                                                                           |        |
| \*\*                                                                                      |        |
| -updated:@today                                                                           |        |
| \*\* исключает элементы, обновленные сегодня.                                             |        |

GitHub помечает ошибку или запрос на вытягивание при обновлении:

* Создание
* Открыто повторно
* Изменено
* Прокомментировал
* Меченый
* Назначения обновляются
* Обновления вех
* Перенос в другой репозиторий

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

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

| Квалификатор                                                                             | Пример |
| ---------------------------------------------------------------------------------------- | ------ |
| <code>field:><em>VALUE</em></code>                                                       |        |
| **priority:>1** отображает элементы с приоритетом больше 1.                              |        |
| <code>field:>=<em>VALUE</em></code>                                                      |        |
| **date:>=2022-06-01** отображает элементы с датой "2022-06-01" или более поздней версии. |        |
| <code>field:<<em>VALUE</em></code>                                                       |        |
| **итерация:<"Итерация 5"** будет отображать элементы с итерацией до "Итерация 5".        |        |
| <code>field:<=<em>VALUE</em></code>                                                      |        |
| **точки:<=10** отображают элементы с 10 или менее точками.                               |        |

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

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

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

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

| Квалификатор                                                                           | Пример |
| -------------------------------------------------------------------------------------- | ------ |
| <code>field:<em>@me</em></code>                                                        |        |
| \*\*                                                                                   |        |
| assignee:@me                                                                           |        |
| \*\* отобразит элементы, назначенные пользователю, вошедшего в систему.                |        |
|                                                                                        |        |
| \*\*                                                                                   |        |
| -reviewers:@me                                                                         |        |
| \*\* отобразит элементы, которые не были проверены пользователем, вошедшего в систему. |        |

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

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

| Квалификатор                                               | Пример |
| ---------------------------------------------------------- | ------ |
| <code>field:<em>@keyword<em></code>                        |        |
| \*\*                                                       |        |
| iteration:@current                                         |        |
| \*\* отобразит элементы, назначенные текущей итерации.     |        |
|                                                            |        |
| \*\*                                                       |        |
| iteration:@next                                            |        |
| \*\* отобразит элементы, назначенные следующей итерации.   |        |
| <code>field:<em>@today</em></code>                         |        |
| \*\*                                                       |        |
| date:@today                                                |        |
| \*\* отображаются элементы с датой, заданной текущим днем. |        |

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

| Квалификатор                                                                                                           | Пример |
| ---------------------------------------------------------------------------------------------------------------------- | ------ |
| <code>field:<em>@keyword</em>..<em>@keyword</em>+<em>n</em></code>                                                     |        |
| \*\*                                                                                                                   |        |
| iteration:@current..\@current+3\*\* будет отображать элементы, назначенные текущей итерации, и следующие три итерации. |        |
|                                                                                                                        |        |
| \*\*                                                                                                                   |        |
| date:@today..\@today+7\*\* будет отображать элементы с датой, установленной сегодня или ближайшие семь дней.           |        |
| <code>field:<<em>@keyword</em></code>                                                                                  |        |
| **итерация:<@current** будет отображать элементы, назначенные любой итерации до текущей итерации.                      |        |
| <code>field:>=<em>@keyword</em></code>                                                                                 |        |
| **date:>=@today** отображает элементы с датой, заданной сегодня или более поздней.                                     |        |

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

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

| Квалификатор                                                                                                              | Пример                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <code>field:"<em>TEXT</em>"                                                                                               |                                                                                                                                    |
| **title:"Исправление ошибок"** будет отображать элементы с заголовками, которые точно соответствуют "Исправление ошибок". |                                                                                                                                    |
| <code>field:<em>TEXT</em>                                                                                                 |                                                                                                                                    |
| **примечание:complete** отображает элементы с текстовым полем заметки, которое точно соответствует "завершено".           |                                                                                                                                    |
| <code><em>TEXT</em></code>                                                                                                |                                                                                                                                    |
| **API** будет отображать элементы с "API" в заголовке или любом другом текстовом поле.                                    |                                                                                                                                    |
| <code>field:<em>TEXT</em>TEXT                                                                                             | **Label:bug отрисовка будет отображать элементы с меткой "ошибка" и с "отрисовкой** " в заголовке или любом другом текстовом поле. |

Для общего поиска текста во всех текстовых полях и заголовках совпадения основаны только на начале слова, а не на любой части.
Например, если заголовок проблемы — **"Поиск полнотекстового документа"**:

* **Совпадения**: "Doc", "full", "search"
* **Не соответствует**: "cument", "ext", "arch"

Этот подход помогает более точно и актуально использовать общий поиск текста.

## Фильтрация по типу проблемы

Если в организации используются типы проблем, можно отфильтровать определенные типы.

| Квалификатор                                         | Пример |
| ---------------------------------------------------- | ------ |
| <code>type:"<em>ISSUE TYPE</em>"                     |        |
| **type:"bug"** отображает проблемы с типом "ошибка". |        |

## Фильтрация по родительской проблеме

Вы можете отфильтровать вложенные проблемы по их родительской проблеме.

| Квалификатор                                                                                                               | Пример |
| -------------------------------------------------------------------------------------------------------------------------- | ------ |
| <code>parent-issue:<em>OWNER/REPO#ISSUE NUMBER</em></code>                                                                 |        |
| **parent-issue:octocat/game#4 будет отображать проблемы с проблемой #4** в октокате/игре в качестве родительской проблемы. |        |