Affichez, filtrez et ouvrez des demandes de tirage
Article
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Vous créez des demandes de tirage (PR) pour passer en revue et fusionner les modifications de code dans un Référentiel Git sur Azure Repos. Les membres de l’équipe et les parties prenantes peuvent passer en revue les modifications et envoyer des commentaires avant de fusionner le code dans la branche cible. Les réviseurs peuvent également commenter les modifications et voter pour approuver ou rejeter le code.
Les équipes peuvent exiger des demandes de tirage pour toute modification apportée aux branches protégées, et définir des stratégies de branche pour exiger que certaines demandes de tirage répondent à des critères spécifiques.
Il existe plusieurs façons de répertorier, de filtrer, d’afficher et d’ouvrir des demandes de tirage pour un projet.
Prérequis
Les référentiels doivent être activés sur votre projet. Si le hub Repos et les pages associées ne s’affichent pas, consultez Activer ou désactiver un service Azure DevOps pour réactiver Repos.
Pour afficher les demandes de tirage, vous devez être membre du projet Azure DevOps dans lequel se trouve la demande de tirage, avec un accès De base ou supérieur. Si vous n’êtes pas membre du projet, soyez ajouté.
Notes
Pour les projets publics, les utilisateurs autorisés à accéder aux Parties prenantes ont un accès complet à Azure Repos.
Les référentiels doivent être activés sur votre projet. Si le hub Repos et les pages associées ne s’affichent pas, consultez Activer ou désactiver un service Azure DevOps pour réactiver Repos.
Pour afficher les demandes de tirage, vous devez être membre du projet Azure DevOps avec un accès De base ou supérieur. Si vous n’êtes pas membre du projet, soyez ajouté.
Pour répertorier les demandes de tirage d’un référentiel spécifique d’un projet, accédez à ce projet dans le portail web et sélectionnez Référentiels>Demandes de tirage.
Vérifiez que vous avez sélectionné le référentiel approprié.
L’affichage par défaut affiche vos demandes de tirage dans l’onglet À moi. Sélectionnez Actif pour afficher toutes les demandes de tirage actives pour le référentiel actuel. Sélectionnez Terminé ou Abandonné pour afficher des listes de demandes de tirage fermées.
Sélectionnez n’importe quelle demande de tirage dans la liste pour accéder à la page Vue d’ensemble de cette demande de tirage.
Vous pouvez répertorier toutes vos demandes de tirage sur différents projets dans votre organisation en choisissant Demandes de tirage dans l’affichage Mon travail.
Pour répertorier les demandes de tirage à partir de Visual Studio, dans le menu Git, sélectionnez <votre service Git>>Afficher les demande de tirage.
Visual Studio 2019 version 16.8 et versions ultérieures fournit une expérience de contrôle de version Git tout en conservant l’interface utilisateur Git de Team Explorer. Pour utiliser Team Explorer, décochez Outils>Options>Fonctionnalités en préversion>Nouvelle expérience utilisateur Git dans la barre de menu. Vous pouvez exercer les fonctionnalités Git à partir de l’une ou l’autre interface de manière interchangeable.
Pour accéder aux demandes de tirage à partir de Visual Studio Team Explorer :
URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=<ORG_URL>. Obligatoire s’il n’est pas configuré par défaut ou récupéré via git config. Exemple : https://dev.azure.com/MyOrganizationName/.
--project-p
Nom ou ID du projet. Vous pouvez configurer le projet par défaut en utilisant az devops configure -d project=<NAME_OR_ID>. Obligatoire s’il n’est pas configuré par défaut ou récupéré par le biais de la configuration git.
--query-examples
Chaîne JMESPath recommandée. Vous pouvez copier l’une des requêtes et la coller après le paramètre --query entre guillemets doubles pour afficher les résultats. Vous pouvez ajouter un ou plusieurs mots clés positionnels afin que les suggestions soient basées sur ces mots clés.
--repository-r
Nom ou ID du référentiel.
--reviewer
Limitez les résultats aux demandes de tirage pour lesquelles cet utilisateur est un réviseur.
--skip
Nombre de demandes de tirage à ignorer.
--source-branch-s
Limitez les résultats aux demandes de tirage provenant de cette branche source.
--status
Limitez les résultats aux demandes de tirage avec cet état. Valeurs acceptées : abandoned, active, all, completed.
--subscription
Nom ou ID de l’abonnement Azure. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s <NAME_OR_ID>.
--target-branch-t
Limitez les résultats aux demandes de tirage qui ciblent cette branche.
--top
Nombre maximal de demandes de tirage à lister.
Exemple
La commande suivante répertorie toutes les demandes de tirage dans le référentiel, quel que soit l’état et affiche la sortie dans un tableau. L’exemple utilise la configuration par défaut az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".
az repos pr list --status all --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------------------------- --------- --------- ------------
11 2021-10-04 jamalh@fabrikam.com Revert 'Updated parameterized-functions.md' Completed False Fabrikam
10 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Completed False Fabrikam
9 2021-10-04 ke@fabrikam.com New pull request Completed False Fabrikam
8 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Abandoned False Fabrikam
7 2021-09-30 jamalh@fabrikam.com Added note-new-git-tool.md to / Completed False Fabrikam
6 2021-09-29 jamalh@fabrikam.com Revert 'Added parameterized-functions.md to /' Abandoned False Fabrikam
5 2021-09-29 jamalh@fabrikam.com Updated README.md Completed False Fabrikam
4 2021-09-29 jamalh@fabrikam.com Added parameterized-functions.md to / Completed False Fabrikam
3 2021-09-28 jamalh@fabrikam.com WIP New file Abandoned False Fabrikam
2 2021-09-28 jamalh@fabrikam.com Update README.md Abandoned False Fabrikam
1 2021-09-28 jamalh@fabrikam.com Edit README.md Completed False Fabrikam
Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.
Définissez un affichage de demande de tirage personnalisé
Le filtrage de la liste des demandes de tirage vous permet de rechercher et d’organiser les demandes de tirage pour classer par ordre de priorité les fichiers les plus importants dans votre flux de travail.
Pour filtrer la liste de demande de tirage, dans la page Demandes de tirage, sélectionnez l’icône Filtrer en haut à droite. Sélectionnez ensuite Branche cible ou autre en-tête de colonne, puis sélectionnez la branche ou une autre valeur sur laquelle vous souhaitez effectuer un filtrage.
Pour personnaliser davantage votre affichage de la liste des demandes de tirage, sélectionnez Personnaliser l’affichage en haut à droite de la page Demandes de tirage.
Dans la page Personnaliser l’affichage, vous pouvez réorganiser les sections d’affichage actuelles, les modifier ou les supprimer. Pour créer une nouvelle section, sélectionnez Ajouter une section.
Dans la page Personnaliser la section, entrez et sélectionnez des valeurs pour filtrer la section par paramètres tels que l’état brouillon ou la date de mise à jour. Vous pouvez choisir d’Afficher les demandes de tirage que j’ai approuvées ou rejetées dans un onglet distinct, ou d’Exclure les demandes de tirage (doublons) incluses dans les sections précédentes. Lorsque vous avez terminé la personnalisation de l’affichage, sélectionnez Enregistrer.
Ces affichages personnalisés créent des sections distinctes et réductibles sur la page de demande de tirage. Ces requêtes personnalisées fonctionnent également entre les référentiels dans l’onglet Mes demandes de tirage de la page d’accueil de l’organisation.
Pour modifier les paramètres des affichages personnalisés, sélectionnez le bouton Personnaliser en regard de l’affichage. Ou sélectionnez Personnaliser l’affichage, puis, dans l’écran Personnaliser l’affichage, sélectionnez l’affichage que vous souhaitez modifier. Certains affichages, comme Qui m’est attribué, ne peuvent pas être personnalisés, mais ils peuvent être réorganisés ou supprimés.
Dans un onglet Fichiers de demande de tirage, vous pouvez utiliser plusieurs filtres pour sélectionner des fichiers et des commentaires afin d’accélérer les révisions. Sélectionnez Filtrer, puis choisissez parmi les options.
Mot clé : entrez un mot clé.
Révisé/non révisé : Tout (par défaut), En attente, Révisé.
Fichiers commentés : Tous les fichiers (par défaut), Fichiers avec commentaires.
État du commentaire : Actif (par défaut), En attente, Résolu, Tel que conçu, Ne sera pas corrigé, Fermé.
Commenté par : Tous les commentaires (par défaut) ou une personne spécifique.
Vous pouvez également saisir une chaîne de caractères dans le champ Recherche pour afficher les résultats correspondants aux options précédentes.
Pour filtrer les demandes de tirage à partir de Visual Studio :
Dans le menu Git, sélectionnez <votre service Git>>Afficher les demandes de tirage.
Filtrez par Auteur, Étiquetteou d’autres attributs.
À partir de l’affichage Demandes de tirage de Team Explorer :
Sélectionnez Actifou Qui m’a été attribué ou qui a été attribué à mon équipe pour filtrer les listes de demandes de tirage par état ou affectation de demande de tirage.
Vous pouvez également saisir les champs Taper ici pour filtrer les listes afin de filtrer les listes de demande de tirage en fonction de la date, de l’auteur, de la branche ou d’autres attributs.
Vous pouvez utiliser plusieurs paramètres az repos pr list pour filtrer la liste des demandes de tirage, tels que --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branch, et --top.
Les valeurs --creator et --reviewer peuvent être des noms d’affichage ou des adresses e-mail. Le paramètre --top définit le nombre maximal de demandes de tirage à répertorier.
Par exemple, pour répertorier les détails sur la dernière demande de tirage que vous avez créée, quel que soit son état, utilisez :
az repos pr list --creator "My Name" --status all --top 1
Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.
Ouvrir une requête de tirage
Lorsque vous ouvrez une demande de tirage à partir du navigateur, de Visual Studio ou d’Azure CLI, la page Vue d’ensemble de la demande de tirage s’ouvre dans le navigateur.
Pour ouvrir une demande de tirage dans le navigateur, sélectionnez la demande de tirage dans la liste de la page Demandes de tirage. La demande de tirage s’ouvre dans son onglet Vue d’ensemble. L’onglet Vue d’ensemble affiche le titre, la description, les réviseurs, les éléments travaillés liés, l’historique et l’état. Vous pouvez voir un résumé des stratégies de branche qui réussissent ou échouent, et voir les commentaires que les réviseurs ont faits.
Dans l’onglet Fichiers de demande de tirage, vous pouvez passer en revue les modifications réelles dans les fichiers de demande de tirage. Dans les onglets Mises à jour et Validations, vous pouvez voir les modifications apportées par l’auteur pour mettre à jour la branche de demande de tirage.
Pour ouvrir une demande de tirage à partir de Visual Studio, dans le menu Git, sélectionnez <votre service Git>>Afficher les demandes de tirage, puis sélectionnez une demande de tirage pour l’ouvrir.
Ou, dans l’affichage Demandes de tirage de Team Explorer, faites un clic droit sur la demande de tirage et sélectionnez Ouvrir dans le navigateur pour ouvrir la demande de tirage dans le portail web.
Extrayez une branche
Dans Visual Studio 2019, vous pouvez extraire la branche source d’une demande de tirage directement à partir de l’affichage Demandes de tirage. Faites un clic droit sur une demande de tirage, puis choisissez Branche source de la validation.
Notes
Visual Studio 2019 version 16.8 et versions ultérieures fournissent un nouveau menu Git pour gérer le flux de travail Git avec moins de changement de contexte que Team Explorer. Les procédures fournies dans cet article sous l’onglet Visual Studio fournissent des informations sur l’utilisation de l’expérience Git et Team Explorer. Pour plus d'informations, voir Comparaison côte à côte de Git et de Team Explorateur.
Pour afficher les détails d’une seule demande de tirage, utilisez az repos pr show avec le paramètre --id requis. Pour ouvrir la demande de tirage dans votre navigateur, utilisez --open.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
Ouvrez la demande de tirage dans votre navigateur web.
--org--organization
URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=<ORG_URL>. Obligatoire s’il n’est pas configuré par défaut ou récupéré via git config. Exemple : https://dev.azure.com/MyOrganizationName/.
--query-examples
Chaîne JMESPath recommandée. Vous pouvez copier l’une des requêtes et la coller après le paramètre --query entre guillemets doubles pour afficher les résultats. Vous pouvez ajouter un ou plusieurs mots clés positionnels afin que les suggestions soient basées sur ces mots clés.
--subscription
Nom ou ID de l’abonnement Azure. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s <NAME_OR_ID>.
Exemple
L’exemple suivant montre les détails de la demande de tirage #21, affiche la sortie de commande sous forme de tableau et ouvre la demande de tirage dans le navigateur :
az repos pr show --id 21 --open --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------- -------- --------- ------------
21 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam
Extrayez une branche
Utilisez Validation de demande de tirage az repos avec le paramètre requis --id pour extraire une branche de demande de tirage localement, tant qu’il n’y a pas de modifications locales.
az repos pr checkout --id
[--remote-name]
[--subscription]
Paramètres
Paramètre
Description
--id
ID de la demande de tirage.
--remote-name
Nom de dépôt distant git sur lequel la demande de tirage est effectuée. Valeur par défaut : origin.
--subscription
Nom ou ID de l’abonnement Azure. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s <NAME_OR_ID>.
Exemple
Par exemple, pour extraire la branche pour la demande de tirage #21 localement, utilisez :
az repos pr checkout --id 21
Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.
Pour passer en revue les modifications, faire des commentaires ou des suggestions, ou approuver ou voter sur la demande de tirage, consultez Passer en revue les demandes de tirage.
Affichez et mettez à jour les demandes de tirage à partir d’un appareil mobile
Vous pouvez utiliser des appareils mobiles pour afficher tous les écrans de demande de tirage Azure Repos et prendre des mesures.