Affichez, filtrez et ouvrez des demandes de tirage

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

Lister les demandes de tirage

Vous pouvez répertorier les demandes de tirage à l’aide du site web du projet Azure DevOps, de Visual Studio ou de la ligne de commande Azure DevOps.

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

    Capture d’écran de l’affichage de vos demandes de tirage.

  2. Vérifiez que vous avez sélectionné le référentiel approprié.

    Capture d’écran du choix de votre référentiel.

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

    Capture d’écran des onglets d’affichage pour les demandes de tirage dans Azure Repos.

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

    Capture d’écran de l’affichage de toutes vos demandes de tirage.

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.

Capture d’écran montrant le bouton Personnaliser l’affichage sur 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.

Capture d’écran montrant la page Personnaliser l’affichage avec le bouton 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.

Capture d’écran montrant la page Personnaliser la section.

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. Capture d’écran de la page Demandes de tirage montrant les sections réductibles.

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.

Capture d’écran de l’onglet Fichiers avec les options de filtre.

  • 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.
  • Commentaires : Afficher (par défaut), Nouveautés, Masquer.
  • É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.

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.

Capture d’écran montrant l’onglet Vue d’ensemble de la demande de tirage.

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

Capture d’écran des écrans de demande de tirage Azure Repos sur un appareil mobile.

Étapes suivantes