# Filtrage projets

Utilisez des filtres pour choisir les éléments à montrer dans les vues de votre projet.

Vous pouvez personnaliser les éléments à afficher dans vos vues en filtrant les métadonnées des éléments, comme les personnes responsables et les étiquettes appliquées aux problèmes, ainsi que les champs définis dans votre projet. Vous pouvez combiner des filtres et les enregistrer sous forme de vues. Pour plus d’informations, consultez « [Gestion de vos vues](/fr/enterprise-server@3.20/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views) ».

Pour filtrer une vue, cliquez <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> et commencez à taper les champs et les valeurs pour lesquelles vous souhaitez filtrer. Pendant la saisie, des valeurs possibles apparaissent. Vous pouvez également ouvrir la palette de commandes du projet, en appuyant sur et en tapant <kbd>Command</kbd>+<kbd>K</kbd> (Mac) ou <kbd>Ctrl</kbd>+<kbd>K</kbd> (Windows/Linux)« Filtrer par » pour choisir parmi les filtres disponibles.

![Capture d’écran du « projet de Mona ». Un champ intitulé « Filtrer par mot clé ou par champ » est mis en surbrillance avec un contour orange.](/assets/images/help/projects-v2/filter-example.png)

Dans la disposition de tableau, vous pouvez cliquer sur des données d’élément pour filtrer les éléments avec cette valeur. Par exemple, cliquez sur un destinataire pour afficher uniquement les éléments de ce destinataire. Pour supprimer le filtre, cliquez à nouveau sur les données d’élément.

L’utilisation de plusieurs filtres agit comme un filtre AND logique. Par exemple, `label:bug status:"In progress"` retourne les éléments avec l’étiquette `bug` et l’état « En cours ». Vous pouvez également fournir plusieurs valeurs pour que le même champ fasse office de filtre OU logique. Par exemple, `label:bug,support` retourne les éléments avec les étiquettes `bug` ou `support`.
Projects ne prend actuellement pas en charge les filtres OR logiques sur plusieurs champs.

Les mêmes filtres sont disponibles pour les graphiques que vous créez à l’aide d’insights, Projectsce qui vous permet de filtrer les données utilisées pour créer vos graphiques. Pour plus d’informations, consultez « [À propos des insights des Projects](/fr/enterprise-server@3.20/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects) ».

Quand vous filtrez une vue, puis ajoutez un élément, les métadonnées filtrées sont appliquées au nouvel élément. Par exemple, si vous filtrez par `status:"In progress"` et que vous ajoutez un élément, l’état du nouvel élément est défini sur « En cours ».

Vous pouvez utiliser des filtres pour produire des vues à des fins très spécifiques. Par exemple, vous pouvez utiliser `assignee:@me status:todo last-updated:5days` pour créer une vue de tout le travail affecté à l’utilisateur actuel, avec l’état « todo », qui n’a pas été mis à jour au cours des cinq derniers jours. Vous pouvez créer une vue de triage à l’aide d’un filtre négatif, tel que `no:label no:assignee repo:octocat/game`, qui affiche les éléments sans étiquette et sans personne affectées qui se trouvent dans le dépôt `octocat/game`.

## Filtrage des champs

| Qualificateur                                                                      | Exemple |
| ---------------------------------------------------------------------------------- | ------- |
| <code>assignee:<em>USERNAME</em></code>                                            |         |
| **assignee:octocat** affiche les éléments affectés à @octocat.                     |         |
| <code>label:<em>LABEL</em></code>                                                  |         |
| **label:bug** affiche les éléments avec l’étiquette « bug » appliquée.             |         |
| <code>field:<em>VALUE</em></code>                                                  |         |
| **status:done** affiche les éléments avec le champ « status » défini sur « done ». |         |
| <code>reviewers:<em>USERNAME</em>                                                  |         |
| **reviewers:octocat** affiche les éléments qui ont été révisés par @octocat.       |         |
| <code>milestone:"<em>MILESTONE</em>"                                               |         |
| **milestone:"QA release"** affiche les éléments affectés au jalon « QA release ».  |         |

## Combinaison de filtres

Vous pouvez créer des filtres pour plusieurs champs. Votre vue affiche les éléments qui correspondent à tous les filtres.

| Qualificateur                                               | Exemple                                                                                              |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| <code>assignee:<em>USERNAME</em>field:<em>VALUE</em></code> | **assignee:octocat priority:1** affiche les éléments affectés à @octocat qui ont une priorité **1**. |

Vous pouvez également filtrer plusieurs valeurs du même champ. Si vous séparez les valeurs par des virgules, votre vue montre les éléments qui correspondent à l’une des valeurs fournies.

| Qualificateur                                                                          | Exemple |
| -------------------------------------------------------------------------------------- | ------- |
| <code>assignee:<em>USERNAME</em>,<em>USERNAME</em></code>                              |         |
| **assignee:octocat,stevecat** affiche les éléments affectés à @octocat ou à @stevecat. |         |

Pour filtrer plusieurs valeurs du même champ, mais afficher les éléments qui correspondent à toutes les valeurs fournies, vous pouvez répéter le qualificateur pour chaque valeur.

| Qualificateur                                                     | Exemple                                                                                                   |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| <code>assignee:<em>USERNAME</em>assignee:<em>USERNAME</em></code> | **assignee:octocat assignee:stevecat** affiche les éléments affectés à la fois à @octocat et à @stevecat. |

Vous pouvez également combiner des filtres qui correspondent à certains éléments et à tous les éléments.

| Qualificateur                                                                         | Exemple                                                                                                                                                                                |
| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <code>field:<em>VALUE</em>,<em>VALUE</em>assignee:<em>USER</em>assignee:<em>USER</em> | **label:bug,onboarding assignee:octocat assignee:stevecat** affiche les éléments qui ont les étiquettes bug ou onboarding, mais qui sont affectés à la fois à @octocat et à @stevecat. |

## Annulation d’un filtre

Vous pouvez inverser n’importe quel filtre, y compris les combinaisons, en préfixant avec un trait d’union.

| Qualificateur                                                           | Exemple |
| ----------------------------------------------------------------------- | ------- |
| <code>-assignee:<em>USERNAME</em></code>                                |         |
| **-assignee:octocat** n’affiche aucun élément affecté à @octocat.       |         |
| <code>-field:<em>VALUE</em></code>                                      |         |
| **-status:done** n’affiche aucun élément avec l’état « done ».          |         |
| <code>-field:<em>VALUE,VALUE</em></code>                                |         |
| **-priority:1,2** n’affiche aucun élément ayant une priorité de 1 ou 2. |         |

## Filtrage des éléments qui ont une valeur

Vous pouvez utiliser `has:` pour filtrer les éléments qui ont une valeur

| Qualificateur                                                               | Exemple |
| --------------------------------------------------------------------------- | ------- |
| <code>has:assignee</code>                                                   |         |
| **has:assignee** affiche les éléments avec un attributaire.                 |         |
| <code>has:label</code>                                                      |         |
| **has:label** affiche les éléments avec une étiquette.                      |         |
| <code>has:<em>FIELD</em>                                                    |         |
| **has:priority** affiche les éléments avec une valeur de champ de priorité. |         |

## Filtrage des éléments qui ont une valeur manquante

Vous pouvez utiliser `no:` pour filtrer les éléments qui ont une valeur manquante

| Qualificateur                                                           | Exemple |
| ----------------------------------------------------------------------- | ------- |
| <code>no:assignee</code>                                                |         |
| **no:assignee** affiche tous les éléments non affectés.                 |         |
| <code>no:reviewers</code>                                               |         |
| **no:reviewers** affiche les pull requests qui n’ont pas d'examinateur. |         |
| <code>no:<em>FIELD</em>                                                 |         |
| **no:priority** affiche les éléments avec un champ de priorité vide.    |         |

Vous pouvez également préfixer avec un trait d’union pour annuler ce comportement et retourner uniquement les éléments qui ont une valeur.

| Qualificateur                                                                                  | Exemple |
| ---------------------------------------------------------------------------------------------- | ------- |
| <code>-no:assignee</code>                                                                      |         |
| **-no:assignee** affiche uniquement les éléments affectés.                                     |         |
| <code>-no:<em>FIELD</em></code>                                                                |         |
| **-no:priority** affiche uniquement les éléments qui ont une valeur dans le champ de priorité. |         |

## Filtrage par emplacement d’élément

Utilisez le qualificateur `repo` pour filtrer les éléments d’un dépôt en particulier.

| Qualificateur                                                         | Exemple |
| --------------------------------------------------------------------- | ------- |
| <code>repo:<em>OWNER/REPO</em></code>                                 |         |
| **repo:octocat/game** affiche les éléments du dépôt « octocat/game ». |         |

## Filtrage de l’état ou du type d’élément

Vous pouvez utiliser le qualificateur `is` pour filtrer des types particuliers d’élément ou d’éléments dans des états particuliers.

| Qualificateur                                                             | Exemple |
| ------------------------------------------------------------------------- | ------- |
| <code>is:<em>STATE</em></code>                                            |         |
| **is:open** affiche les problèmes et les pull requests qui sont ouverts.  |         |
|                                                                           |         |
| **is:closed** affiche les problèmes et demandes de tirage fermés.         |         |
|                                                                           |         |
| **is:merged** affiche toutes les pull requests fusionnées.                |         |
| <code>is:<em>TYPE</em></code>                                             |         |
| **is:issue** affiche uniquement les problèmes.                            |         |
|                                                                           |         |
| **is:pr** affiche uniquement les pull requests.                           |         |
|                                                                           |         |
| **is:draft** affiche les brouillons de problème et de demandes de tirage. |         |
|                                                                           |         |
| **is:issue is:open** affiche les problèmes ouverts.                       |         |

## Filtrage par motif de fermeture

Vous pouvez filtrer les éléments fermés par motif de fermeture.

| Qualificateur                                                                         | Exemple |
| ------------------------------------------------------------------------------------- | ------- |
| <code>reason:<em>CLOSE REASON</em></code>                                             |         |
| **reason:completed** affiche les éléments fermés parce qu’ils ont été achevés.        |         |
|                                                                                       |         |
| **reason:"not planned"** affiche les éléments fermés pour le motif « non planifié ».  |         |
|                                                                                       |         |
| **reason:reopened** affiche les éléments qui ont été rouverts après avoir été fermés. |         |

## Filtrage de la date de dernière mise à jour d’un élément

Le champ de filtre `updated` offre un moyen plus puissant et flexible de filtrer les éléments en fonction de leur date de dernière modification.

| Qualificateur                                                                                                    | Exemple |
| ---------------------------------------------------------------------------------------------------------------- | ------- |
| <code>updated:<em>NUMBER</em>days</code>                                                                         |         |
| \*\*                                                                                                             |         |
| updated:@today                                                                                                   |         |
| \*\* affiche les éléments mis à jour aujourd’hui.                                                                |         |
|                                                                                                                  |         |
| \*\*                                                                                                             |         |
| updated:@today-1d                                                                                                |         |
| \*\* affichera les articles mis à jour il y a un jour.                                                           |         |
|                                                                                                                  |         |
| **mis à jour :>@today-1w** affichera les éléments dont la dernière mise à jour remonte à sept jours ou plus.     |         |
|                                                                                                                  |         |
| **mis à jour :>@today-30d** affichera les éléments mis à jour pour la dernière fois il y a trente jours ou plus. |         |
|                                                                                                                  |         |
| \*\*                                                                                                             |         |
| -updated:@today                                                                                                  |         |
| \*\* exclut les articles mis à jour aujourd'hui.                                                                 |         |

GitHub marque une question ou une demande d'extraction comme étant mise à jour lorsqu'elle l'est :

* Créé
* Rouverte
* Modifié(e)
* Commenté
* Étiquetage
* Les destinataires sont mis à jour
* Les jalons sont mis à jour
* Transféré vers un autre référentiel

## Filtrage des champs de nombre, de date et d’itération

Vous pouvez utiliser `>`, `>=`, `<` et `<=` pour comparer les champs de nombre, de date et d’itération. Les dates doivent être fournies au format `YYYY-MM-DD`.

| Qualificateur                                                                               | Exemple |
| ------------------------------------------------------------------------------------------- | ------- |
| <code>field:><em>VALUE</em></code>                                                          |         |
| **priority:>1** affiche les éléments dont la priorité est supérieure à 1.                   |         |
| <code>field:>=<em>VALUE</em></code>                                                         |         |
| **date:>=2022-06-01** affiche les éléments dont la date est « 2022-06-01 » ou ultérieure.   |         |
| <code>field:<<em>VALUE</em></code>                                                          |         |
| **iteration:<"Iteration 5"** affiche les éléments avec une itération avant « Iteration 5 ». |         |
| <code>field:<=<em>VALUE</em></code>                                                         |         |
| **points:<=10** affiche les éléments avec 10 points ou moins.                               |         |

Vous pouvez également utiliser `..` pour filtrer une plage inclusive. Lors de l’utilisation d’une plage, `*` peut être fourni comme opérateur générique.

| Qualificateur                                                                                                                                 | Exemple |
| --------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| <code>field:<em>VALUE</em>..<em>VALUE</em></code>                                                                                             |         |
| **priority:1..3** affiche les éléments avec une priorité 1, 2 ou 3.                                                                           |         |
|                                                                                                                                               |         |
| **date:2022-01-01..2022-12-31** affiche les éléments de l’année 2022.                                                                         |         |
|                                                                                                                                               |         |
| **points:\*..10** affiche les éléments avec une valeur de points allant jusqu’à 10 inclus.                                                    |         |
|                                                                                                                                               |         |
| **iteration :« Iteration 1..Iteration 4 »** affiche les éléments dans « Iteration 1 », « Iteration 2 », « Iteration 3 », and « Iteration 4 ». |         |

## Filtrage des destinataires et des réviseurs avec des mots clés

Vous pouvez utiliser le mot clé `@me` pour vous représenter dans un filtre.

| Qualificateur                                                                   | Exemple |
| ------------------------------------------------------------------------------- | ------- |
| <code>field:<em>@me</em></code>                                                 |         |
| \*\*                                                                            |         |
| assignee:@me                                                                    |         |
| \*\* affiche les éléments affectés à l’utilisateur connecté.                    |         |
|                                                                                 |         |
| \*\*                                                                            |         |
| -reviewers:@me                                                                  |         |
| \*\* affiche les éléments qui n’ont pas été révisés par l’utilisateur connecté. |         |

## Filtrage des champs d’itération et de date avec des mots clés

Vous pouvez utiliser les mots clés `@previous`, `@current` et `@next` pour filtrer les itérations relatives à l’itération actuelle. Vous pouvez également utiliser `@today` pour filtrer sur le jour actuel.

| Qualificateur                                                          | Exemple |
| ---------------------------------------------------------------------- | ------- |
| <code>field:<em>@keyword<em></code>                                    |         |
| \*\*                                                                   |         |
| iteration:@current                                                     |         |
| \*\* affiche les éléments affectés à l’itération actuelle.             |         |
|                                                                        |         |
| \*\*                                                                   |         |
| iteration:@next                                                        |         |
| \*\* affiche les éléments affectés à la prochaine itération.           |         |
| <code>field:<em>@today</em></code>                                     |         |
| \*\*                                                                   |         |
| date:@today                                                            |         |
| \*\* affiche les éléments dont la date est définie sur le jour actuel. |         |

Vous pouvez également utiliser les plages `>`, `>=`, `<`, `<=`, `+``-` et `..` avec des mots clés.

| Qualificateur                                                                                                               | Exemple |
| --------------------------------------------------------------------------------------------------------------------------- | ------- |
| <code>field:<em>@keyword</em>..<em>@keyword</em>+<em>n</em></code>                                                          |         |
| \*\*                                                                                                                        |         |
| iteration:@current..\@current+3\*\* affiche les éléments affectés à l’itération actuelle et aux trois itérations suivantes. |         |
|                                                                                                                             |         |
| \*\*                                                                                                                        |         |
| date:@today..\@today+7\*\* affiche les éléments dont la date est définie sur aujourd’hui ou les sept prochains jours.       |         |
| <code>field:<<em>@keyword</em></code>                                                                                       |         |
| **iteration:<@current** affiche les éléments affectés à n’importe quelle itération avant l’itération actuelle.              |         |
| <code>field:>=<em>@keyword</em></code>                                                                                      |         |
| **date:>=@today** affiche les éléments dont la date est définie sur aujourd’hui ou plus tard.                               |         |

## Filtrage par champs de texte

Vous pouvez filtrer par champs de texte spécifiques ou utiliser un filtre de texte général sur tous les champs de texte et les titres. Lorsque vous filtrez avec du texte qui contient des espaces ou des caractères spéciaux, placez votre texte entre guillemets `"` ou `'`.

| Qualificateur                                                                                                              | Exemple                                                                                                                                 |
| -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <code>field:"<em>TEXT</em>"                                                                                                |                                                                                                                                         |
| **title:"Correctif de bogue"** affiche les éléments avec des titres qui correspondent exactement à « Correctif de bogue ». |                                                                                                                                         |
| <code>field:<em>TEXT</em>                                                                                                  |                                                                                                                                         |
| **note:complete** affiche les éléments avec un champ de texte « note » qui correspond exactement à « complet ».            |                                                                                                                                         |
| <code><em>TEXT</em></code>                                                                                                 |                                                                                                                                         |
| **API** affiche les éléments avec « API » dans le titre ou dans tout autre champ de texte.                                 |                                                                                                                                         |
| <code>field:<em>TEXT</em>TEXT                                                                                              | **label:bug rendering** affiche les éléments avec l’étiquette « bug » et avec « rendering » dans le titre ou tout autre champ de texte. |

Pour la recherche de texte général sur tous les champs de texte et titres, les correspondances sont basées uniquement sur le début d’un mot, et non sur une partie de celui-ci.
Par exemple, si le titre du problème est **« Recherche en texte intégral de document »**:

* **Correspondances** : « Doc », « full », « search »
* **Ne correspond pas** : « cument », « ext », « arch »

Cette approche permet de maintenir la recherche en texte général plus précise et plus pertinente.

## Filtrage par type de problème

Si votre organisation utilise les types de problèmes, vous pouvez filtrer pour des types particuliers.

| Qualificateur                                                      | Exemple |
| ------------------------------------------------------------------ | ------- |
| <code>type:"<em>ISSUE TYPE</em>"                                   |         |
| **type:"bogue"** va afficher les problèmes avec le type « bogue ». |         |

## Filtrage par problème parent

Vous pouvez filtrer vos sous-problèmes par problème parent.

| Qualificateur                                                                                                      | Exemple |
| ------------------------------------------------------------------------------------------------------------------ | ------- |
| <code>parent-issue:<em>OWNER/REPO#ISSUE NUMBER</em></code>                                                         |         |
| **parent-issue:octocat/game#4** affiche les problèmes liés au problème #4 dans octocat/game comme problème parent. |         |