Verknüpfen von Arbeitsaufgaben mit Objekten

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

Arbeitselementverknüpfungen sind Zuordnungen zwischen zwei Arbeitsaufgaben oder einer Arbeitsaufgabe und einem anderen Objekt. Verknüpfungen beschreiben die Beziehung zwischen Objekten. Sie können Arbeitsaufgabenlinks verwenden, um Abhängigkeiten und verwandte Arbeit zur Rückverfolgbarkeit nachzuverfolgen, Informationen zu teilen, komplexe Projekte, die mehrere Teams oder Produkte umfassen, zu verwalten, Codeänderungen und Tests nachzuverfolgen und vieles mehr.

Voraussetzungen

Verknüpfungstypen

Mit den folgenden Links können Sie die verschiedenen Beziehungen zwischen Arbeitsaufgaben und anderen Objekten verwalten.

Weitere Informationen zu Arbeitselement-Verknüpfungstypen, einschließlich Übergeordnet/Untergeordnet, Verwandt und Vorgänger-Nachfolger, finden Sie unter Arbeitselement-Verknüpfungstypen.

Verknüpfen von Arbeitsaufgaben mit verschiedenen Objekten

Führen Sie die folgenden allgemeinen Schritte aus, um Arbeitsaufgaben mit verschiedenen Objekten zu verknüpfen:

1. Melden Sie sich bei Ihrer Organisation an (https://dev.azure.com/{Your_Organization}).

2. Öffnen Sie die vorhandene Arbeitsaufgabe, aus der Sie eine Verknüpfung herstellen möchten, oder erstellen Sie eine neue.

3. Wählen Sie Verknüpfungen>Verknüpfung hinzufügen und dann entweder Bestehendes Element oder Neues Element.

   

4. Im Dropdown-Menü Verknüpfungstyp wählen Sie den Verknüpfungstyp aus, den Sie erstellen möchten.

5. Geben Sie im folgenden Feld das Objekt ein, mit dem Sie eine Verknüpfung herstellen möchten, oder wählen Sie es aus.

6. (Optional) Geben Sie einen Kommentar ein, um den Link zu beschreiben.

7. Wählen Sie Verknüpfung hinzufügen, um die Verknüpfung zu erstellen.

Spezifischere Anweisungen zum Verknüpfen verschiedener Arten von Arbeitsaufgaben finden Sie in den folgenden Abschnitten.

Verknüpfen einer Arbeitsaufgabe mit einer anderen Arbeitsaufgabe

Führen Sie die folgenden Schritte aus, um einen Link zu einer anderen Arbeitsaufgabe im Webportal hinzuzufügen:

1. Öffnen Sie das Arbeitselement, aus dem Sie eine Verknüpfung herstellen möchten.

2. Im Arbeitsaufgabenformular können Sie aus zwei Möglichkeiten wählen, um diese Aufgabe zu erledigen:

   • Gehen Sie zum Abschnitt Verwandte Arbeit und wählen Sie Verknüpfung hinzufügen>Bestehendes Element.
   • Wählen Sie Verknüpfungen>Verknüpfung hinzufügen>Bestehendes Element.

   

3. Wählen Sie in der Dropdown-Liste Verknüpfungstyp den Verknüpfungstyp aus, den Sie erstellen möchten, z. B. Untergeordnet, Übergeordnet oder Verwandt.

4. Geben Sie im Feld Arbeitselemente zu verknüpfen die ID des Arbeitselements ein, das Sie verknüpfen möchten, oder wählen Sie es aus dem Dropdown-Menü aus, und wählen Sie dann Verknüpfung hinzufügen.

   Im folgenden Beispiel wird der Verknüpfungstyp Verwandt verwendet, um eine Testfall-ID mit 280 zu verknüpfen.

   

   Sie können Links nur einzeln hinzufügen. Sie können ihre IDs nicht durch Kommas oder Leerzeichen getrennt eingeben.

   Um eine Verknüpfung mit mehreren Arbeitselementen zu erstellen, geben Sie deren IDs durch Kommas oder Leerzeichen getrennt ein. Wenn Sie die IDs nicht kennen oder ein Element in einem anderen Projekt verknüpfen möchten, wählen Sie Weitere Aktionen.

Verknüpfen mehrerer Arbeitselemente

1. Öffnen Sie in dem Webportal ein Backlog oder eine Abfrageergebnisseite.

2. Markieren Sie mehrere (hervorgehobene) Arbeitselemente, um eine Verknüpfung hinzuzufügen.

3. Wählen Sie für die ausgewählten Arbeitselemente Weitere Aktionen, dann Verknüpfung hinzufügen und anschließend Verknüpfung zu einem bestehenden Element... oder Verknüpfung zu einem neuen Arbeitselement....

   Im folgenden Beispiel wählen wir aus dem Produkt-Backlog mehrere Elemente aus und wählen Verknüpfung zu einem bestehenden Element....

   

4. Wählen Sie im Dropdown-Menü Verknüpfungstyp, z. B. Übergeordnet, Untergeordnet oder Verwandt.

5. Geben Sie im Feld Arbeitselement die ID des Arbeitselements ein, das Sie verknüpfen möchten, und wählen Sie dann Verknüpfung hinzufügen.

Verknüpfen von Arbeitsaufgaben mit neuen Arbeitsaufgaben

Führen Sie die folgenden Schritte aus, um eine Arbeitsaufgabe mit einer neuen Arbeitsaufgabe zu verknüpfen.

1. Wählen Sie in Ihrem Arbeitselement Verknüpfungen>Verknüpfung hinzufügen>Neues Element.

   

2. Geben Sie den Verknüpfungstyp und den Arbeitselementtyp an und fügen Sie einen Titel für das neue Arbeitselement sowie einen optionalen Kommentar hinzu. Wählen Sie Verbindung hinzufügen aus.

   

   Das neue Arbeitselement wird geöffnet.

3. Geben Sie zusätzliche Informationen ein, und speichern Sie das Arbeitselement.

   

Weitere Informationen finden Sie unter Verknüpfung zu Arbeitsaufgaben aus Pullanforderungen, Commits und Kommentaren.

Verknüpfen von Arbeitsaufgaben mit GitHub-Objekten

Weitere Informationen finden Sie unter Verknüpfen von GitHub-Commits, Pull Requests, Branches und Issues mit Arbeitselementen und Automatisches Abschließen von Arbeitselementen mithilfe von Pull Requests.

Verknüpfen mehrerer Arbeitselemente mit neuen Git-Branches

1. Öffnen Sie eine Backlog- oder Abfrageergebnisseite und wählen Sie mehrere Arbeitselemente aus, die Sie mit einem neuen Git-Filiale verknüpfen möchten.

2. Wählen Sie das Aktionssymbol und dann Neue Filiale.... Weitere Informationen finden Sie unter Verknüpfen von Arbeitselementen mit Git-Entwicklungsobjekten.

   

Verknüpfen von Arbeitselementen mit Builds

Führen Sie die folgenden Schritte aus, um Arbeitsaufgaben mit vorhandenen Builds zu verknüpfen. Diese Builds können sich in Ihrem Projekt oder in anderen Projekten in Ihrer Organisation oder Sammlung befinden.

Verknüpfen von Arbeitselementen mit Bereitstellungen

Während Sie Ihre Software entwickeln, können Sie erfassen, welche Codeänderungen und Builds den Abschluss eines Arbeitselements unterstützen. Ihr Team kann verstehen, welche Arbeit geleistet wurde oder wie ein Fehler über den Überwachungspfad von Änderungen an der Codebasis behoben wurde.

Die Verknüpfungstypen zum Erstellen dieser Verknüpfungen sind: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item, and Integrated in release environment. Diese Typen werden in der folgenden Abbildung angezeigt.

Wie in der folgenden Abbildung dargestellt, zeigt das Steuerelement „Bereitstellung“ Versionsinformationen für zwei Releasephasen an. Es enthält Arbeitsaufgaben, die mit einem Git-Commit oder einer Pull-Anforderung für eine Releasepipeline verknüpft sind, die für die Integration in Azure Boards konfiguriert wurde.

Bereitstellungssteuerung

Das Steuerelement „Bereitstellung“ bietet mehrere Funktionen, um den Freigabestatus von Arbeitselementen zu verwalten und nachzuverfolgen: In der folgenden Liste werden die folgenden Features beschrieben:

• Standardansicht: Das Steuerelement „Bereitstellung“ erscheint standardmäßig in den Arbeitselementformularen für User Story (Agile), Product Backlog Item (Scrum), Issue (Basic), Requirement (CMMI), Feature, Epic, Bug, Task und Test Case.

• Benutzerdefinierte Arbeitsaufgabentypen: Benutzerdefinierte Arbeitsaufgabentypen, die den geerbten Prozess verwenden, werden automatisch aktiviert.

• Freigabeinformationen: Das Steuerelement „Bereitstellung“ zeigt die Freigabeinformationen für zwei Stufen der Release-Pipeline, die in Azure Boards integriert ist.

• Verknüpfte Arbeitsaufgaben: Dieses Steuerelement zeigt nur die Arbeitsaufgaben an, die mit einem Git Commit oder Pull-Anforderung für diese Pipeline verknüpft sind.

• Visuelle Einblicke: Verschaffen Sie sich visuelle Einblicke in den Status eines Arbeitselements, während es in verschiedene Release-Umgebungen bereitgestellt wird, und navigieren Sie schnell zu jeder Release-Stufe und jedem Durchlauf.

  

• Commit-Verknüpfungen: Arbeitselemente, die mit Commits im Build verknüpft sind, zeigen den Status der Freigabe an.

• Projektumfang: Nur Arbeitselemente innerhalb desselben Projekts werden mit der Releasepipeline verknüpft, in der sie definiert ist.

  

• Phasensichtbarkeit: Wenn Sie eine Arbeitsaufgabe öffnen, können Sie die Phasen in Echtzeit sehen.

  

Führen Sie zum Auffüllen des Steuerelements Bereitstellung die folgenden Schritte aus:

1. Gehen Sie wie im Artikel zum Definieren Ihrer mehrstufigen Continuous Deployment-Pipeline (CD) beschrieben vor, um eine klassische Releasepipeline zu definieren und die Releasestufen einzurichten.

2. Konfigurieren Sie die Pipeline.

3. Verknüpfen Sie Arbeitselemente mit einem Commit oder Pull Request im Azure Repos-Git-Repository. Weitere Informationen finden Sie unter:

   • Steuern der Git-Entwicklung aus einem Arbeitselement
   • Verknüpfen von Arbeitselementen mit anderen Objekten

4. Ausführen der Pipeline.

Verknüpfen von Arbeitsaufgaben mit der TFVC-Codeentwicklung

Team Foundation Version Control (TFVC) ermöglicht es Ihnen, Arbeitselemente mit Änderungen in der Versionskontrolle oder versionierten Quellcodedateien zu verknüpfen, indem Sie die Verknüpfungstypen Änderungssatz und Versioniertes Element verwenden. Wenn Sie ausstehende Änderungen einchecken oder "Meine Arbeit" zum Einchecken von Änderungen verwenden, werden Arbeitsaufgaben automatisch mit Ihren Änderungen verknüpft. Weitere Informationen finden Sie unter Einchecken Ihrer Arbeit.

Verknüpfen von Arbeitsaufgaben mit Tests

Testbezogene Verknüpfungstypen verknüpfen Testfallverwaltungsaufgaben miteinander oder mit anderen Arbeitsaufgaben. Im Webportal oder Microsoft Test Manager können Sie anzeigen, welche Testfälle für eine Testsuite definiert sind und welche Testsuiten für einen Testplan definiert sind. Diese Objekte werden nicht über Verknüpfungstypen miteinander verknüpft.

Sie können Arbeitselemente mit Testfällen verknüpfen, indem Sie die Linktypen Tested/Tested By (Getestet/Getestet durch) verwenden. Verwenden Sie dieselben Linksteuerelemente, die Sie zum Verknüpfen von Arbeitsaufgaben mit anderen Arbeitsaufgaben verwenden. Siehe "Arbeitsaufgaben verknüpfen".

Die folgende Abbildung zeigt die vollständige Sammlung von Linktypen, die beim Verknüpfen von Arbeitselementtypen für die Testverwaltung verwendet werden. Die meisten Verknüpfungen zwischen Testverwaltungsobjekten treten auf, indem eine Aufgabe von den Testseiten oder microsoft Test Manager ausgeführt wird.

Wenn Sie einem Testfall beispielsweise freigegebene Schritte hinzufügen, werden diese automatisch mithilfe der Linktypen Testfall/Freigegebene Schritte verknüpft. Weitere Informationen finden Sie unter Freigeben von Schritten zwischen Testfällen.

Im Abschnitt Test können Sie Testpläne, Testsammlungen und Testfälle hinzufügen, die automatisch verknüpft werden. Sie können diese Elemente nicht über einen bestimmten Linktyp hinzufügen. Das Testsystem erstellt und verwaltet die Zuordnungen von Testergebnissen zu Testfällen und Testplänen.

Mit einer Website, einer Netzwerkfreigabe, einem Storyboard oder einem Dokument verknüpfte Arbeitselemente

Sie können einen Hyperlink- oder Storyboard-Verknüpfungstyp verwenden, um ein Arbeitselement mit einer Website, einem Netzwerkpfad oder einem Dokument auf einem Netzwerkpfad zu verknüpfen. Beide Verknüpfungstypen sind unidirektionale Links. Wenn Sie diese Verknüpfungstypen hinzufügen möchten, verwenden Sie die gleichen Steuerelemente, die weiter oben beschrieben wurden. Siehe "Arbeitsaufgaben verknüpfen".

Wenn Sie den Storyboard-Linktyp verwenden, geben Sie ein Storyboard oder ein Dokument an, das Spezifikationen für Arbeitselemente bereitstellt. Dieser Linktyp ermöglicht es Ihrem Team, auf die freigegebene Datei zuzugreifen und ihre Kommentare hinzuzufügen.

Anzeigen von Abhängigkeiten und Nachverfolgen verwandter Arbeiten

Azure DevOps bietet verschiedene Möglichkeiten zum Anzeigen von Abhängigkeiten und zum Nachverfolgen verwandter Arbeiten:

• Abfrage-Editor: Sie können den Abfrage-Editor verwenden, um benutzerdefinierte Abfragen zu erstellen, die alle Arbeitsaufgaben anzeigen, die mit einer bestimmten Arbeitsaufgabe verknüpft sind.
• Backlogs und Boards: Die Ansichten „Backlogs“ und „Boards“ zeigen Übergeordnet-Untergeordnet-Beziehungen zwischen Arbeitselementen, sodass Abhängigkeiten auf einen Blick erkennbar sind.
• Abhängigkeits-Tracker: Der Abhängigkeits-Tracker ist ein Power BI Bericht, der eine visuelle Darstellung von Abhängigkeiten zwischen Arbeitselementen bietet.

Führen Sie die folgenden Schritte aus, um die Liste aller Objekte anzuzeigen, die mit einer Arbeitsaufgabe verknüpft sind:

1. Öffnen Sie die Arbeitsaufgabe und wählen Sie Verknüpfungen aus. Die Registerkarte „Verknüpfungen“ gibt die Anzahl aller verknüpften Objekte an. Verknüpfte Objekte werden unter ihrem Linktyp gruppiert, mit der Angabe der Anzahl innerhalb jeder Gruppe.

   

2. (Optional) Sie können jede Gruppe erweitern oder reduzieren und innerhalb jeder Gruppe nach Status, Neuester Aktualisierung oder Kommentar sortieren, indem Sie den entsprechenden Spaltentitel auswählen.

   Die folgende Registerkarte Links zeigt beispielsweise einen Teil der 64 verknüpften Objekte für ein Arbeitselement an.

   

   Links, die mit einem Ausrufezeichen versehen sind, weisen darauf hin, dass der Build, das Release oder ein anderes Objekt gelöscht wird. Aufgrund von Aufbewahrungsrichtlinien werden diese Objekte nach einem bestimmten Zeitraum automatisch gelöscht.

Abfragen von verknüpften Arbeitselementen

Um Elemente basierend auf hierarchischen Links zu filtern, verwenden Sie den Abfragetyp Struktur von Arbeitselementen. Um Elemente auf Grundlage aller Linktypen zu filtern, verwenden Sie Arbeitselemente und Direktlinks.

Um Arbeitsaufgaben zu finden, die mit anderen Arbeitsaufgaben mit bestimmten Verknüpfungstypen verknüpft sind, verwenden Sie eine Abfrage, die eine primäre und eine sekundäre Gruppe von Arbeitsaufgaben anzeigt:

• Das Primärset erfüllt die Feldkriterien.
• Das Sekundärset ist mit dem Primärset verknüpft.

Sie können in Versionen keine Arbeitsaufgaben abfragen, aber Sie können Arbeitsaufgaben mit externen Links abfragen. Fügen Sie weitere Abfragefilter hinzu, um Ihre Suche zu verfeinern.

Weitere Informationen finden Sie unter Abfragen von Arbeitselementen nach Anzahl der Verknüpfungen oder Anlagen.

Sie können keine Abfrage erstellen, die eine hierarchische Ansicht von Testplänen, Testsammlungen und Testfällen anzeigt. Diese Elemente werden nicht mithilfe von über- und untergeordneten oder anderen Linktypen miteinander verknüpft. Sie können die Hierarchie nur über die Seite "Testpläne> testen" anzeigen. Weitere Informationen finden Sie unter Erstellen von Testplänen und Testsuiten.

az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org]
                                 [--target-id]
                                 [--target-url]

az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2807

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org]
                                    [--yes]

az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805 

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org]

az boards work-item relation show --id 2931 --output table
Relation Type    Url
---------------  -----------------------------------------------------------------------------------------------------------------------------------
Related          https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

Löschen von Arbeitselementlinks

Führen Sie die folgenden Schritte aus, um einen Arbeitsaufgabenlink zu löschen.

1. Öffnen Sie die Arbeitsaufgabe.
2. Wählen Sie die Registerkarte Links aus, um die Liste der Links anzuzeigen.
3. Wählen Sie den Link aus, den Sie löschen möchten, und wählen Sie dann Link entfernen aus.
4. Bestätigen Sie, dass Sie den Link löschen möchten.

Nachdem eine Arbeitsaufgabe mit einer Commit- oder Pullanforderung verknüpft wurde, wird sie weiterhin als Teil der Veröffentlichungsphasen angezeigt. Wenn Sie beispielsweise ein Arbeitselement haben, das die Testkriterien nicht erfüllt hat, möchten Sie es vielleicht aus den Builds und Releases entfernen.

Um das Arbeitselement aus zukünftigen Builds und Releases zu entfernen, löschen Sie den Link zum letzten Commit und Pull Request.

Verwandte Artikel

• Überprüfen des Referenzhandbuchs für Linktypen
• Steuern der Git-Entwicklung aus einem Arbeitselement
• Nachverfolgen von Abhängigkeiten mithilfe von Lieferplänen
• Organisieren des Backlogs und Zuordnen untergeordneter Arbeitsaufgaben
• Laden Sie die Erweiterung für die Visualisierung von Arbeitselementen herunter