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

  • Berechtigungen:

    • Zum Anzeigen, Verfolgen oder Ändern von Arbeitselementen: Berechtigungen Arbeitselemente in diesem Knoten anzeigen und Arbeitselemente in diesem Knoten bearbeiten auf Zulassen festgelegt. Standardmäßig sind diese Berechtigungen für die Gruppe Mitwirkende festgelegt. Weitere Informationen finden Sie unter Festlegen von Berechtigungen für die Arbeitsnachverfolgung.
    • Zum Hinzufügen von Tags zu Arbeitselementen: Neue Tagdefinition erstellen-Berechtigungssatz auf Zulassen festgelegt Die Gruppe Mitwirkende verfügt standardmäßig über diese Berechtigung.

  • Zugriffsebenen:

    • Projektmitglied.
    • Zum Hinzufügen von Tags zu Arbeitsaufgaben oder Anzeigen oder Verfolgen von Pull-Anfragen an: Mindestens Basic-Zugriff.
    • Zum Anzeigen oder Verfolgen von Arbeitsaufgaben: Mindestens Stakeholder-Zugriff. 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.
    • Standardmäßig können alle Mitwirkenden und Stakeholder in öffentlichen Projekten neue und bestehende Tags hinzufügen. In privaten Projekten können Projektbeteiligte nur vorhandene Tags hinzufügen. Um die Möglichkeit zum Erstellen neuer Tags zu steuern, legen Sie die Berechtigung Tag-Definition erstellen auf der Projektebene fest. Weitere Informationen finden Sie unter Ändern von Berechtigungen auf Projektebene.

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