Freigeben über

Automatisches Abschließen von Arbeitselementen mit Pull Requests

  • Artikel

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

Wenn Sie ein Arbeitselement mit einem Pull Request (PR) verknüpfen, können Sie diese Arbeitselemente automatisch abschließen, wenn Sie den PR abschließen. Alternativ können Sie den Workflowstatus angeben, in den das Arbeitselement beim Zusammenführen des PR übergehen soll.

Wenn Sie ein Arbeitselement mit einem Pull Request (PR) verknüpfen, können Sie diese Arbeitselemente automatisch abschließen, wenn Sie den PR abschließen.

Weitere Informationen finden Sie unter Erstellen, Anzeigen und Verwalten von Pull Requests.

Voraussetzungen

  • Projektzugriff: Ein Projektmitglied sein.

  • Berechtigungen:

    • Wenn Sie Arbeitsaufgaben anzeigen, folgen und bearbeiten möchten, müssen Sie arbeitsaufgaben in diesem Knoten anzeigen und Arbeitsaufgaben in diesen Knotenberechtigungen auf "Zulassen" festlegen. Standardmäßig sind diese Berechtigungen für die Gruppe Mitwirkende festgelegt. Weitere Informationen finden Sie unter Festlegen von Berechtigungen für die Arbeitsnachverfolgung.

  • Wenn Sie Arbeitsaufgaben Tags hinzufügen möchten, müssen Sie die Berechtigung "Neue Tagdefinition erstellen" auf Projektebene auf "Zulassen" festlegen. Die Gruppe Mitwirkende verfügt standardmäßig über diese Berechtigung.

  • Zugriffsebenen:

    • Wenn Sie arbeitsaufgaben neue Tags hinzufügen oder Pullanforderungen anzeigen oder folgen möchten, verfügen Sie über mindestens einfachen Zugriff.
    • Um Arbeitsaufgaben anzuzeigen oder zu folgen, haben Sie mindestens Zugriff auf die Projektbeteiligten . Weitere Informationen finden Sie unter Informationen zu Zugriffsebenen.
    • Alle Projektmitglieder, einschließlich derJenigen in der Gruppe "Leser ", können E-Mails senden, die Arbeitsaufgaben enthalten.

    Hinweis

    • Ermöglichen Sie den Stakeholder-Zugriff auf Mitglieder, die zur Diskussion beitragen und den Fortschritt überprüfen möchten. Dies sind in der Regel Mitglieder, die nicht zum Code beitragen, aber Arbeitselemente, Backlogs, Boards und Dashboards anzeigen möchten.
    • Projektbeteiligte können aufgrund ihrer Zugriffsebene keine neuen Tags hinzufügen, auch wenn die Berechtigung explizit festgelegt ist. Weitere Informationen finden Sie unter Kurzreferenz zu Beteiligtenzugriff.
  • GitHub-Berechtigungen: Ein Mitwirkender für das GitHub-Repository.

Automatisches Abschließen von Arbeitselementen

Aktivieren Sie wie in der folgenden Abbildung gezeigt das Kontrollkästchen Verknüpfte Arbeitselemente nach dem Mergen abschließen. Das System wird für zukünftige PRs standardmäßig auf Ihre Auswahl festgelegt.

Dialogfeld „Pull Request abschließen“ – Verknüpfte Arbeitselemente nach dem Mergen abschließen

Dialogfeld „Pull Request abschließen“ – Option zum automatischen Abschließen von Arbeitselementen bei Abschluss des PR

In den folgenden Fällen aktualisiert das System den Arbeitselementstatus nicht automatisch auf Erledigt, Geschlossen oder Abgeschlossen für den Arbeitselementtyp (Work Item Type, WIT):

  • Das Arbeitselement, dessen WIT mit dem Vererbungsprozessmodell verwaltet wird, befindet sich bereits im Status Gelöst. In diesem Fall aktualisiert das System den Status nicht. Wenn sich beispielsweise ein vom Agile-Prozess abgeleiteter Fehler im Status Gelöst befindet, geht das System nicht in den Status Geschlossen über.
  • Das Arbeitselement hat bereits den Status Abgeschlossen. Es ist kein weiterer Übergang erforderlich.
  • Der WIT enthält Workflowfeldregeln, die verhindern, dass das Arbeitselement in den nächsten Status wechselt. Eine Regel kann z. B. verlangen, dass ein weiteres Feld beim Schließen des Arbeitselements definiert wird.
  • Bei lokalen Bereitstellungen und beim gehosteten Azure Boards-Prozessmodell müssen Sie den Workflow so ändern, dass Aktionen (ElementACTION) angegeben werden, die beim Übergang des Workflows ausgeführt werden sollen. Weitere Informationen finden Sie unter Ändern des Workflows für einen Arbeitselementtyp, Angeben von Aktionen.

Weitere Informationen finden Sie unter Anpassen Ihrer Arbeitsverfolgungserfahrung.

Angeben des Workflowstatus von verknüpften Arbeitselementen

Um ein Arbeitselement in einen bestimmten Workflowstatus zu überführen, können Sie die Informationen in der Pull Request-Beschreibung eingeben. Stellen Sie #ID einen gültigen Workflowstatus für das genannte Arbeitselement voran.

Hinweis

Für dieses Feature wird Azure DevOps Server 2020.1, Update 1 oder höher benötigt.

Das folgende Beispiel zeigt User Storys, bei denen der Übergang erfolgte: in einem Fall in den Status Gelöst und im anderen Fall in den Status Überprüfung . Außerdem sind zwei Aufgaben als Erledigt markiert.

Screenshot: Pull Request – Festlegen des Workflowstatus für den Übergang von #ID-Arbeitselementen

Deaktivieren des automatischen Abschließens zugeordneter Arbeitselemente

Führen Sie die folgenden Schritte aus, um das automatische Abschließen von zugeordneten Arbeitselementen beim Abschließen von Pull Requests durch Benutzer zu deaktivieren:

  1. Gehen Sie zu Projekteinstellungen>Repositorys> wählen Sie das Repository aus.
  2. Verschieben Sie auf der Registerkarte Einstellungen den Umschalter für Auflösung von Arbeitselementen mit Commiterwähnungen auf Aus.

Erwähnungen in Commitkommentaren zum Schließen von Arbeitselementen (z. B. "Korrigiert #123") sind nicht zulässig.