Skip to main content

Filtrage de projects

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 ».

Pour filtrer une vue, cliquez sur et commencez à taper les champs et les valeurs à filtrer. Pendant la saisie, des valeurs possibles apparaissent. Vous pouvez aussi ouvrir la palette de commandes du projet en appuyant sur Command+K (Mac) ou Ctrl+K (Windows/Linux), puis tapez « 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.

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. Actuellement, Projects ne prend 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 pour Projects, ce 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 ».

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ée qui se trouvent dans le dépôt octocat/game.

Filtrage des champs

QualificateurExemple
assignee:USERNAMEassignee:octocat affiche les éléments affectés à @octocat.
label:LABELlabel:bug affiche les éléments avec l’étiquette « bug » appliquée.
field:VALUEstatus:done affiche les éléments avec le champ « status » défini sur « done ».
reviewers:USERNAMEreviewers:octocat affiche les éléments qui ont été révisés par @octocat.
milestone:"MILESTONE"milestone:"Beta release" affiche les éléments affectés au jalon « Beta release ».

Combinaison de filtres

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

QualificateurExemple
assignee:USERNAME field:VALUEassignee: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.

QualificateurExemple
assignee:USERNAME,USERNAMEassignee: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.

QualificateurExemple
assignee:USERNAME assignee:USERNAMEassignee: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.

QualificateurExemple
field:VALUE,VALUE assignee:USER assignee:USERlabel: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.

QualificateurExemple
-assignee:USERNAME-assignee:octocat n’affiche aucun élément affecté à @octocat.
-field:VALUE-status:done n’affiche aucun élément avec l’état « done ».
-field:VALUE,VALUE-priority:1,2 n’affiche aucun élément ayant une priorité de 1 ou 2.

Filtrage des éléments qui ont une valeur manquante

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

QualificateurExemple
no:assigneeno:assignee affiche tous les éléments non affectés.
no:reviewersno:reviewers affiche les demandes de tirage qui n’ont pas de réviseur.
no:FIELDno: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.

QualificateurExemple
-no:assignee-no:assignee affiche uniquement les éléments affectés.
-no:FIELD-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.

QualificateurExemple
repo:OWNER/REPOrepo: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.

QualificateurExemple
is:STATEis:open affiche les problèmes et les demandes de tirage qui sont ouverts.
is:closed affiche les problèmes et les demandes de tirage qui sont fermés.
is:merged affiche toutes les demandes de tirage fusionnées.
is:TYPEis:issue affiche uniquement les problèmes.
is:pr affiche uniquement les demandes de tirage.
is:draft affiche les brouillons de problème et les brouillons de demande de tirage.
is:issue is:open affiche uniquement les problèmes ouverts.

Filtrage par motif de fermeture

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

QualificateurExemple
reason:CLOSE REASONreason:completed affiche les éléments fermés parce qu’ils ont été traités.
reason:"not planned" affiche les éléments fermés avec le motif « non planifié ».
reason:reopened affiche les éléments qui ont été rouverts après avoir été fermés.

Filtrage par le champ Suivi par

Vous pouvez filtrer les problèmes suivis par un autre problème dans une liste de tâches. Pour plus d’informations, consultez « Création d’une liste de tâches ».

QualificateurExemple
tracked-by:"OWNER/REPO#ISSUE NUMBER"tracked-by:"octocat/game#11" affiche les problèmes suivis par une liste de tâches dans le problème #11 du dépôt octocat/game.

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

Vous pouvez utiliser la syntaxe {number}days pour filtrer par la date de dernière mise à jour des éléments.

QualificateurExemple
last-updated:NUMBERdayslast-updated:1day affiche les éléments dont la dernière mise à jour remonte à un ou plusieurs jours.
last-updated:7days affiche les éléments dont la dernière mise à jour remonte à sept jours ou plus.
-last-updated:10days affiche les éléments qui ont été mis à jour au cours des dix derniers jours.

GitHub Enterprise Cloud marque un sujet ou une demande de tirage comme étant mis à jour lorsqu'il 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.

QualificateurExemple
field:>VALUEpriority:>1 affiche les éléments dont la priorité est supérieure à 1.
field:>=VALUEdate:>=2022-06-01 affiche les éléments dont la date est « 2022-06-01 » ou ultérieure.
field:<VALUEiteration:<"Iteration 5" affiche les éléments avec une itération avant « Iteration 5 ».
field:<=VALUEpoints:<=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.

QualificateurExemple
field:VALUE..VALUEpriority: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 » et « 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.

QualificateurExemple
field:@meassignee:@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.

QualificateurExemple
field:@keyworditeration:@current affiche les éléments affectés à l’itération actuelle.
iteration:@next affiche les éléments affectés à la prochaine itération.
field:@todaydate:@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.

QualificateurExemple
field:@keyword..@keyword+niteration:@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.
field:<@keyworditeration:<@current affiche les éléments affectés à n’importe quelle itération avant l’itération actuelle.
field:>=@keyworddate:>=@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 '.

QualificateurExemple
field:"TEXT"title:"Dépréciation de l’API" affiche les éléments avec des titres qui correspondent exactement à « Dépréciation de l’API ».
field:TEXTnote:effectuer affiche les éléments avec un champ de texte de note qui correspond exactement à « effectuer ».
TEXTAPI affiche les éléments avec « API » dans le titre ou dans tout autre champ de texte.
field:TEXT TEXTlabel:bug rendering affiche les éléments avec l’étiquette « bug » et avec « rendering » dans le titre ou tout autre champ de texte.

Vous pouvez également utiliser un * comme caractère générique.

QualificateurExemple
field:*TEXT*label:*bug* affiche les éléments avec une étiquette qui contient le mot « bug ».
field:TEXT*title:API* affiche les éléments dont le titre commence par « API ».
field:*TEXTlabel:*support affiche les éléments avec une étiquette qui se termine par « support ».