Prüfen von Pull Requests

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Wenn Sie eine pull-Anforderung (PR) erstellen und erforderliche und optionale Prüfer angeben, Azure Repos die Prüfer darüber benachrichtigt, dass Ihre PR zur Überprüfung bereit ist. Alle erforderlichen Reviewer müssen die Änderungen in Ihrem PR genehmigen, bevor diese in den Zielzweig zusammengeführt werden können. Für PRs, die kritische Branches wie main ändern, gibt es in Ihrem Team möglicherweise Branchrichtlinien, die die Reviewer festlegen oder eine Mindestanzahl von Reviewern vorschreiben. Wenn Branchrichtlinien Ihrem PR optionale Reviewer hinzufügen, können Sie diese beibehalten, anfordern oder entfernen. Wenn Branchrichtlinien Ihrem PR erforderliche Reviewer hinzufügen, können Sie diese nicht als optional festlegen oder sie entfernen. Informationen über die Zuweisung von Reviewern über Branchrichtlinien finden Sie unter Automatisches Einbeziehen von Codereviewern.

Wenn Sie eine PR überprüfen, geben Sie konstruktives Feedback, das präzise und leicht verständlich ist. Weitere Informationen finden Sie unter Feedback zu Pull Requests.

Sie können Azure DevOps-PRs nur im Webportal mithilfe Ihres Browsers überprüfen.

Voraussetzungen

Änderungen überprüfen

Pull Requests ermöglichen es bestimmten Reviewern, vorgeschlagene Änderungen zu prüfen, zu diskutieren und darüber abzustimmen, bevor sie in einen Ziel-Branch zusammengeführt werden. Wenn die gleichen Dateien sowohl in den Quell- als auch in den Zielzweigen geändert werden, werden möglicherweise Zusammenführungskonflikte angezeigt. Analysieren Sie Konflikte sorgfältig, und bearbeiten Sie die Dateien manuell, um die richtigen Änderungen aus den einzelnen Verzweigungen anzuwenden. Wenn Sie mit nur einem Klick alle Änderungen nur aus der Quelle oder nur aus dem Ziel übernehmen, können erforderliche Änderungen verloren gehen. Sie können Konflikte in Azure DevOps oder in einem Entwicklungstool wie Visual Studio lösen.

Weitere Informationen finden Sie unter Auflösen von Zusammenführungskonflikten.

Eine Copilot-Codeüberprüfung anfordern

Sie können GitHub Copilot bitten, eine Pull-Anforderung zusammen mit menschlichen Prüfern zu überprüfen. Copilot veröffentlicht Kommentare und Vorschläge direkt am geänderten Code, sodass Sie häufige Probleme beheben können, bevor ein menschlicher Prüfer seine Freigabe erteilt.

Um eine Überprüfung anzufordern, öffnen Sie eine Pullanforderung, und wählen Sie Request neben GitHub Copilot im Abschnitt Reviewers aus. Copilot hinterlässt immer eine Kommentar-Überprüfung, sodass sein Feedback die Richtlinien für erforderliche Prüfer nicht erfüllt und das Mergen nicht blockiert.

Dieses Feature befindet sich in einer eingeschränkten öffentlichen Vorschau und erfordert die Registrierung. Informationen zu Setup, Abrechnung und Grenzwerten finden Sie unter Get started with Copilot code review for pull requests.

Änderungen als menschlicher Prüfer überprüfen

Die folgenden Schritte beschreiben, wie Reviewer von PRs in Azure Repos durch einen PR navigieren können, um die vorgeschlagenen Änderungen zu verstehen:

1. Öffnen Sie in Ihrem Webbrowser das Teamprojekt für Ihre Azure DevOps-Organisation. Wählen Sie Repos>Pull Requests aus, um die PRs aufzulisten. Ein neu geöffneter PR befindet sich standardmäßig auf der Registerkarte Übersicht.

2. Auf der Registerkarte "Übersicht " einer PR werden Titel, Beschreibung, Bearbeiter, verknüpfte Arbeitsaufgaben, Verlauf, Status und Kommentare angezeigt. Lesen Sie die PR-Beschreibung, um die vorgeschlagenen Änderungen zu prüfen. Sehen Sie sich die Kommentare an, um zu verstehen, welche Probleme von anderen Reviewern ausgelöst wurden.

   Hinweis

   Jede Datei ist mit einem "+"-Zeichen oder einer Bezeichnung "Umbenennen, Bearbeiten" neben dem Namen gekennzeichnet, um den Änderungstyp anzugeben. Wenn eine Datei mehr als 50 Prozent geändert hat, betrachtet Git sie als umbenannt. Dieser Schwellenwert ist die Standardeinstellung für Git-Repositorys und kann nicht geändert werden.

   

3. Wählen Sie die Registerkarte Dateien aus, um alle Änderungen am Inhalt im Quellbranch des PR zu überprüfen. Die anfängliche Ansicht zeigt eine Zusammenfassungsansicht aller Dateiänderungen an. Wählen Sie die Schaltfläche Anzeigen neben einer Datei aus, um nur die Änderungen an dieser Datei anzuzeigen. Wenn die Datei geändert wurde, öffnet die Schaltfläche Anzeigen eine Vergleichsansicht. Wenn die Datei hinzugefügt oder gelöscht wurde, öffnet die Schaltfläche Anzeigen einen Inhaltsbereich.

   

   Hinweis

   Aus Leistungsgründen zeigt die Zusammenfassungsansicht keine Änderungen für eine Datei an, die größer als 0,5 MB ist.

4. In einer Vergleichsansicht für eine Datei können Sie entweder ein paralleles oder Inline-Vergleichslayout auswählen.

   

   Tipp

   Für jede einzelne Datei, die größer als 5 MB ist, zeigt die Vergleichsansicht abgeschnittene Dateiinhalte an. Für eine Diff-Ansicht des vollständigen Inhalts laden Sie diese Dateien mithilfe eines lokalen Diff-Tools herunter, und überprüfen Sie sie.

   Verwenden Sie die Dateistruktur auf der linken Seite, um eine andere Datei anzuzeigen, oder wählen Sie den Stamm der Dateistruktur aus, um eine Übersicht über alle Dateiänderungen zu erhalten.

5. Um das Changeset zu überprüfen, das durch bestimmte Pushvorgänge in den Quellzweig eingeführt wurde, wählen Sie ein oder mehrere Changesets aus der Dropdown-Liste der Änderungen aus. Wenn Sie ein oder mehrere Changesets auswählen, wird die Vergleichsansicht so aktualisiert, dass nur die Änderungen aus den ausgewählten Changesets angezeigt werden. Dieses Feature ist nützlich, wenn Änderungen seit der letzten Überprüfung an die PR verschoben werden und Sie nur die neuen Änderungen sehen möchten. Die Dropdownliste der Änderungen benennt jedes Changeset mit der Commitnachricht des letzten Commits in jedem Pushvorgang.

   

   Tipp

   Halten Sie die UMSCHALTTASTE gedrückt, wenn Sie mehrere Changesets aus der Dropdownliste der Änderungen auswählen.

6. Wählen Sie die Registerkarte Updates aus, um alle gepushten Changesets anzuzeigen und zu bestätigen, dass Sie keine Änderungen im Quellbranch übersehen haben. Die Changesets sind nummeriert und das neueste Changeset wird am Listenanfang angezeigt. Jeder Änderungssatz zeigt die Commits an, die bei diesem Pushvorgang hochgeladen wurden. Ein per Force-Push übertragenes Changeset überschreibt den Changeset-Verlauf nicht und erscheint in der Changeset-Liste wie jedes andere Changeset.

   

7. Wählen Sie die Registerkarte Commits aus, um den Commitverlauf für den Quellbranch nach der Abweichung vom Zielbranch anzuzeigen. Der Commitverlauf auf der Registerkarte " Commits " wird überschrieben, wenn der PR-Autor einen anderen Commit-Verlauf erzwingt, sodass sich die auf der Registerkarte " Commits " angezeigten Commits möglicherweise von den Commits unterscheiden, die auf der Registerkarte "Updates " angezeigt werden.

   

Verwenden von Kommentaren

PR-Ersteller und Reviewer können miteinander kommunizieren, indem sie PR-Kommentare hinzufügen und darauf antworten. Wenn Sie eine PR überprüfen, verwenden Sie Kommentare, um Probleme mit den vorgeschlagenen Änderungen hervorzuheben, Änderungen vorzuschlagen und auf vorherige Kommentare zu reagieren. Bemühen Sie sich um konstruktives Feedback, das präzise und leicht verständlich ist. Adressieren Sie die Empfänger direkt, indem Sie ihre @username verwenden. Verweisen Sie auf Arbeitselemente mithilfe von #workitemID und auf andere PRs mithilfe von !pullrequestID. Manchmal verfassen PR-Ersteller zu Dokumentationszwecken Kommentare für sich selbst.

Bereitstellen von Feedback in Kommentaren

Wenn sich Ihr Feedback auf eine bestimmte Zeile oder einen bestimmten Zeilenbereich in einer Datei bezieht, fügen Sie an dieser Stelle in der Datei einen Kommentar hinzu:

1. Bewegen Sie den Mauszeiger auf der Registerkarte Dateien für einen PR auf die Zeile, die Sie kommentieren möchten, und wählen Sie die Kommentarschaltfläche aus, um ein Inline-Kommentarfeld zu öffnen. Sie können auch mehrere Zeilen auswählen und dann die Kommentarschaltfläche wählen, die angezeigt wird, wenn Sie den Mauszeiger über diese Zeilen bewegen.

   

2. Geben Sie Ihren Kommentar in das Kommentarfeld ein, und wählen Sie Kommentieren aus.

   

Wenn sich Ihr Feedback auf die gesamte Datei bezieht, fügen Sie einen Kommentar auf Dateiebene hinzu, indem Sie Kommentar hinzufügen im Menü „Dateioptionen“ auswählen:

Um allgemeines Feedback bereitzustellen, das sich nicht auf eine bestimmte Datei bezieht, fügen Sie einen Kommentar auf der Registerkarte Übersicht hinzu:

PR-Reviewer können auch Kommentare verwenden, um Änderungen an bestimmten Dateizeilen vorzuschlagen, wie im nächsten Abschnitt beschrieben.

Vorschlagen von Änderungen in den Kommentaren

Verwenden Sie Kommentare, um Ersatztext für eine oder mehrere Zeilen in einer Datei vorzuschlagen:

1. Bewegen Sie den Mauszeiger auf der Registerkarte Dateien für einen PR auf die Zeile, die Sie kommentieren möchten, und wählen Sie die Kommentarschaltfläche aus, um ein Inline-Kommentarfeld zu öffnen. Sie können auch mehrere Zeilen auswählen und dann die Kommentarschaltfläche wählen, die angezeigt wird, wenn Sie den Mauszeiger über diese Zeilen bewegen. Wenn sie angenommen wird, ersetzt Der vorgeschlagene Inhalt die Zeile oder Zeilen, zu denen Ihr Kommentar hinzugefügt wurde.

   

2. Wählen Sie das Glühbirnensymbol unter dem Kommentarfeld aus, um Ihre Änderungsvorschläge im Kommentarfeld innerhalb eines eingegrenzten Codeblocks vorzunehmen, und wählen Sie dann Kommentieren aus. Es wird kein Glühbirnensymbol angezeigt, wenn Sie dem ursprünglichen Code (linksseitig) einer parallelen Diff-Ansicht einen Kommentar hinzufügen.

   

PR-Ersteller können Ihren Vorschlag wie folgt annehmen:

1. Wählen Sie Änderungen anwenden aus, um die Änderung in der Bereitschaft für einen Commit zu stagen.

   

2. Wählen Sie Alle Änderungen committen aus, um alle gestageten Änderungen zu committen. PR-Ersteller können einen Vorschlag aus dem Staging entfernen, indem sie Änderung rückgängig machen auswählen.

   

Bearbeiten oder Löschen von Kommentaren

Bearbeiten oder löschen Sie Ihren Kommentar, indem Sie mit dem Mauszeiger auf den Kommentar zeigen und das Symbol zum Bearbeiten oder Löschen auswählen:

„Gefällt mir“-Markierung für Kommentare

PR-Ersteller und Reviewer können ihren eigenen oder einen fremden Kommentar liken (mit „Gefällt mir“ markieren), indem sie den Mauszeiger über den Kommentar bewegen und das Symbol mit dem nach oben gerichteten Daumen auswählen:

Kommentare mit Likes zeigen ein ausgefülltes Daumen-up-Symbol und die Anzahl der Likes an. Bewegen Sie den Mauszeiger über das Symbol mit dem nach oben gerichteten Daumen, um die Liste der Personen anzuzeigen, denen der Kommentar gefallen hat.

Antworten auf Kommentare

PR-Ersteller sollten auf Kommentare antworten, um die Reviewer wissen zu lassen, wie sie Feedback und Vorschläge adressieren:

1. Um auf einen Kommentar zu antworten, geben Sie Ihre Antwort in das Feld Antwort schreiben ein. Adressieren Sie die Empfänger direkt, indem Sie ihre @username verwenden. Verweisen Sie auf Arbeitselemente mithilfe von #workitemID und auf andere PRs mithilfe von !pullrequestID.

   

2. Nachdem Sie Ihre Antwort eingegeben haben, wählen Sie Antworten und auflösen aus, wenn Ihre Antwort vollständig ist. Andernfalls wählen Sie Antworten aus.

   

   Wenn Sie "Antworten" und "Auflösen" auswählen, ändert sich der Kommentarstatus in "Aufgelöst". PR-Ersteller können den Status eines Kommentars auch direkt ändern, wie im nächsten Abschnitt beschrieben.

Ändern des Kommentarstatus

Neue Kommentare beginnen mit einem aktiven Status. PR-Autoren aktualisieren den Status während des Überprüfungsprozesses, um anzugeben, wie sie feedback und Vorschläge des Prüfers behandelt haben. PR-Ersteller können einen Kommentarstatus aus der Dropdownliste „Status“ auswählen:

• Aktiv: Der Standardstatus für neue Kommentare.
• Ausstehend: Das in diesem Kommentar angesprochene Problem wird derzeit geprüft und wartet auf etwas anderes.
• Behoben: Das Problem in diesem Kommentar wurde behoben.
• Wird nicht behoben: Das in diesem Kommentar genannte Problem wurde zur Kenntnis genommen, wird aber nicht behoben.
• Geschlossen: Die Diskussion in diesem Kommentar ist geschlossen.

PR-Ersteller und Reviewer können den PR-Status durch Filterung des Kommentarstatus nachverfolgen, wie im nächsten Abschnitt beschrieben.

Filtern von Kommentaren

Sie können auswählen, welche Kommentare oder Updates auf der Registerkarte Übersicht angezeigt werden, indem Sie eine Filteroption aus der Dropdownliste für Kommentarfilter auswählen. Wählen Sie z. B. die Filteroption Neuigkeiten aus, um neue Kommentare und Updates seit dem letzten Öffnen des PRs anzuzeigen. Jede Filteroption zeigt die Anzahl der Elemente für ihre Kategorie an.

Dateien bearbeiten

PR-Ersteller können Dateien bequem direkt in Azure Repos bearbeiten. Sie können z. B. die vorgeschlagene Codeänderung eines Prüfers akzeptieren und ähnliche Änderungen an anderer Stelle vornehmen.

1. Wählen Sie Repos > Dateien, wählen Sie den PR-Quellbranch aus, wählen Sie eine Datei aus, und wählen Sie dann Bearbeiten.

   

2. Nehmen Sie Ihre Änderungen im Editor vor, und wählen Sie dann Commit aus, um das Dialogfeld Commit zu öffnen.

   

3. Bearbeiten Sie im Dialogfeld Commit die Commit-Nachricht, falls erforderlich, und wählen Sie dann Commit aus, um die Änderungen zu übernehmen und zu Ihrem PR zu senden.

   

Nachverfolgen überprüfter Dateien

PR-Reviewer können überprüfte Dateien nachverfolgen, indem sie Als überprüft markieren aus dem Menü „Dateioptionen“ auswählen oder das Kontrollkästchen neben einer Datei oder einem Ordner aktivieren:

Abstimmen über PR-Änderungen

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

Einen PR abschließen

PR-Ersteller können eine PR-Auflösungsoption auswählen:

• Abgeschlossen: Führen Sie die PR jetzt aus, wenn alle erforderlichen Prüfer sie genehmigt haben und alle erforderlichen Branch-Richtlinien erfüllt sind.
• Automatisches Abschließen festlegen: Die PR automatisch abschließen, wenn alle erforderlichen Prüfer sie genehmigen und alle erforderlichen Verzweigungsrichtlinien erfüllt sind.
• Als Entwurf markieren: Legen Sie die PR auf den Entwurfsstatus fest, um anzugeben, dass sie nicht zur Überprüfung bereit ist. Wählen Sie für einen Pr-Entwurf die Option "Veröffentlichen " aus, um den Entwurfsstatus zu entfernen, und markieren Sie ihn für die Überprüfung.
• Abbrechen: PR schließen. Wählen Sie für eine abgebrochene PR reaktivieren aus , um sie wiederherzustellen.

Weitere Informationen finden Sie unter Abschließen der Pullanforderung.

Nächster Schritt

Verwandte Artikel

• Erste Schritte mit der Copilot-Codeüberprüfung für Pull Requests
• Benachrichtigungen über Updates von Pull Requests
• Informationen zu Pull Requests und Berechtigungen