Verknüpfen mit Arbeitselementen aus anderen Objekten

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Durch Die Verknüpfung mit Arbeitselementen aus anderen Objekten, z. B. Builds, Commits, Pullanforderungen und mehr, unterstützen Sie die Fähigkeit Ihres Teams, einen Überwachungspfad verwandter Arbeiten zu verwalten. Alle Benutzer können Links zu ihren Arbeitselementen hinzufügen.

Sie können innerhalb der folgenden Bereiche eingeben #ID , um eine Verknüpfung zu Ihren Arbeitselementen zu erstellen:

  • Eine Arbeitsaufgabendiskession oder ein beliebiges Rich-Text-Feld
  • Git Commit-Kommentare und Pullanforderungsbeschreibungen
  • TFVC-Änderungen oder Regaletkommentare
  • Wiki-Seiten
  • Eine Diskussion zu Arbeitsaufgaben
  • Git Commit-Kommentare und Pullanforderungsbeschreibungen
  • TFVC-Änderungen oder Regaletkommentare

Tipp

Sie können automatische Verknüpfungen und andere Einstellungen einrichten, die Arbeitselemente mit Git Commits, Pullanforderungen, Builds und mehr verknüpfen. Informationen dazu finden Sie in den folgenden Ressourcen:

Die Verknüpfungstypen, die verwendet werden, um Arbeitselemente mit Devops-Objekten zu verknüpfen – wie in der folgenden Abbildung dargestellt – sind Build, in Build gefunden, integriertin Build, integriert in version für Build- und Releasepipelinen; Branch, Commit, Pull Request und Tag für Git-Repositorys und Changeset, Shelveset und VersionedItem für Team Foundation-Versionskontrolle (TFVC)-Repositorys. Diese werden alle als externe Linktypen bezeichnet.

Conceptual image of link types used to link work items to devops objects.

Auf der Registerkarte " Links " können Sie alle Objekte anzeigen, die mit der Arbeitsaufgabe verknüpft sind , wie weiter unten in diesem Artikel beschrieben. Sie können jedoch keine Arbeitselementabfrage erstellen, um diese Links auflisten zu können. Arbeitselementabfragen geben nur Arbeitselemente zurück, die mit anderen Arbeitselementen verknüpft sind. Sie können jedoch eine Abfrage erstellen, in der Arbeitselemente aufgelistet werden, die externe Links enthalten. Informationen dazu finden Sie unter "Abfrage nach Link" oder "Anlagenanzahl".

Hinweis

Sie können auch verknüpfungen mit Arbeitselementen aus GitHub Commits, Pullanforderungen und Problemen herstellen. Dies erfordert die Verbindung ihres Azure DevOps Projekts mit Ihrem GitHub-Repository. Weitere Informationen finden Sie unter Azure Boards-GitHub Integration.

  1. Geben Sie die Eingabe # ein, um die #ID Arbeitsaufgabenauswahl in Ihren Pull-Anforderungs-Commits, Commitkommentare, Änderungskommentare, Regaletkommentare, Beschreibungen und vieles mehr auszulösen. Es wird eine Liste von 50 Arbeitselementen angezeigt, die Sie kürzlich geändert haben oder ihnen zugewiesen sind.

    Screenshot of work item list produced when entering # in PR description.

  2. Schmalen Sie die Liste der vorgeschlagenen Arbeitsaufgaben, indem Sie Schlüsselwörter eingeben, die dem Arbeitselementtyp, der ID oder dem Titel entsprechen.

    Screenshot of entering keyword after # and resulting work item in search

    Um die Liste weiter zu filtern, geben Sie weiterhin Schlüsselwörter ein, bis Sie eine Übereinstimmung finden. Sie können bis zu fünf Schlüsselwörter eingeben.

Festlegen des Arbeitselementstatus in der Pullanforderung

Wenn Sie eine Pullanforderung erstellen, können Sie den Statuswert der verknüpften Arbeitselemente in der Beschreibung festlegen. Folgen Sie der Syntax: {state value}: #ID. Wenn Sie die Pullanforderung zusammenführen, liest das System die Beschreibung und aktualisiert den Arbeitselementstatus. Im folgenden Beispiel legen wir Arbeitselemente #300 und #301 auf "Aufgelöst" und "#323" und "#324" auf "Geschlossen" fest.

Screenshot of setting work item state within a PR.

Hinweis

Dieses Feature erfordert die Installation von Azure DevOps Server 2020.1-Update. Weitere Informationen finden Sie unter Azure DevOps Server 2020 Update 1 RC1 Release Notes, Boards.

Funktionsweise

Das System betrachtet die folgenden drei verschiedenen Kriterien (in dieser Reihenfolge), wenn versucht wird, den Status von #mentioned Arbeitselementen festzulegen:

  • State
  • Statuskategorie
  • Schlüsselwort (keyword)

Kriterienlogik

In der folgenden Tabelle wird die Logik beschrieben.

Kriterien Aktion
Wenn der Wert einem Zustand entspricht, Legen Sie ihn dann auf diesen Zustand fest.
Andernfalls wenn der Wert einer Statuskategorie entspricht, Legen Sie dann das Arbeitselement auf den ersten Status in dieser Kategorie fest. Siehe die folgende Notiz.
Andernfalls wenn der Wert einem Schlüsselwort entspricht, Legen Sie dann das Arbeitselement auf den übereinstimmenden Schlüsselwortstatus fest. Siehe die folgende Tabelle.
Oder Ignorieren Sie sie, und führen Sie nichts aus.

Schlüsselwortlogik

Schlüsselwortlogik hilft beim Abgleich von Absichten. Sie können z. B. "Auflösen" eingeben, aber Sie haben wirklich "Aufgelöst" bedeutet.

Schlüsselwort Aktion
Vorgeschlagen, Vorschlagen Legen Sie den ersten Status in der Kategorie "Vorgeschlagen" fest.
InProgress Legen Sie den ersten Status in der Kategorie "In Bearbeitung" fest.
Abgeschlossen, Abgeschlossen, Abgeschlossen Legen Sie den ersten Status in der Kategorie "Abgeschlossen" fest.
Aufgelöst, Aufgelöst, Auflösen Legen Sie den ersten Status in der Kategorie "Aufgelöst" fest.
Korrekturen, Behoben, Fix Arbeitsaufgabe schließen. Außer Fehler, der auf "Behoben" festgelegt wird.

Hinweis

Die Kategorieabgleich wird für Projekte mit einem gehosteten XML-Prozess nicht unterstützt. Kategorieabgleich ist nur für Projekte mit einem geerbten Prozess verfügbar.

Sie können Arbeitselemente mit vorhandenen Builds aus dem Dialogfeld "Link hinzufügen" verknüpfen. Diese Builds können sich in Ihrem Projekt oder in anderen Projekten in Ihrer Organisation oder Sammlung befinden.

Hinweis

Dieses Feature erfordert die Installation von Azure DevOps Server 2020.1-Update. Weitere Informationen finden Sie unter Azure DevOps Server 2020 Update 1 RC1 Release Notes, Boards.

  1. Wählen Sie auf der Registerkarte "Links" einer Arbeitsaufgabe das Element "LinkExisting hinzufügen"> aus.

  2. Wählen Sie im Dialogfeld "Link hinzufügen" einen der Buildlinktypen aus– "Build", "In Build", "Integriert im Build", und geben Sie die Buildnummer an.

    Wenn Sie die Buildnummer – eine Kombination aus Pipeline und Buildname – nicht kennen, können Sie nach der Buildnummer suchen, indem Sie das Symbol auswählen.

    Add link dialog with Build link type selected.

  3. Wählen Sie im Dialogfeld "Verknüpfungsbuilds " die Parameter aus, um die Suche nach Builds zu filtern.

    Wenn Sie eine Verknüpfung mit einem Build in einem anderen Projekt herstellen, wählen Sie zuerst die Project aus, deren Build Sie verknüpfen möchten.

    Sie können beispielsweise eine Buildnummer angeben, eine Buildpipeline, ein Buildergebnis auswählen– z. B. "Alle", "Alle", "teilweiseerfolgreich", "fehlgeschlagen" oder "abgebrochen". Oder wählen Sie "Alle" für "Ergebnis" ausgewählt aus, um die verfügbaren Builds auflisten zu können, mit der Sie eine Verknüpfung herstellen können.

    Find builds dialog with project selected and builds listed.

  4. Wählen Sie den Build aus der Liste aus, mit der Sie verknüpfen möchten, und wählen Sie dann OK aus.

  5. Wählen Sie im Dialogfeld " Link hinzufügen " "OK " aus, um den Vorgang abzuschließen.

    Add link dialog with Build number filled in.

Sie können Arbeitselemente mit vorhandenen Builds im Dialogfeld "Link hinzufügen " verknüpfen.

  1. Wählen Sie auf der Registerkarte "Links " eines Arbeitselements das Element "LinkExisting> hinzufügen" aus.

  2. Wählen Sie im Dialogfeld "Link hinzufügen " eine der Buildlinktypen aus –Build, In Build, Integriert in Build – und geben Sie die Buildnummer an.

    Wenn Sie die Buildnummer nicht kennen – eine Kombination aus der Pipeline und dem Buildnamen – können Sie nach dieser Suchen suchen, indem Sie das Symbol auswählen.

    Add link dialog with Build link type selected.

  3. Wählen Sie im Dialogfeld "Link-Builds " die Parameter aus, um die Suche nach Builds zu filtern.

    Sie können beispielsweise eine Buildnummer angeben, eine Buildpipeline, ein Buildergebnis auswählen– z. B. "Alle", "Alle", "teilweiseerfolgreich", "fehlgeschlagen" oder "abgebrochen". Oder wählen Sie "Alle" für "Ergebnis" ausgewählt aus, um die verfügbaren Builds auflisten zu können, mit der Sie eine Verknüpfung herstellen können.

    Find builds dialog, link to a build within your project.

  4. Wählen Sie den Build aus der Liste aus, mit der Sie verknüpfen möchten, und wählen Sie dann OK aus.

  5. Wählen Sie im Dialogfeld " Link hinzufügen " "OK " aus, um den Vorgang abzuschließen.

    Add link dialog with Build number filled in.

Geben Sie # die Eingabe ein, um die #ID Arbeitselementauswahl in einer Wiki-Seite auszulösen.

Weitere Informationen zum integrierten Wiki finden Sie unter Hinzufügen & von Wiki-Seiten und Wiki-Markdown-Anleitungen.

Sie können auch eine Abfrageergebnissetabelle mit einem Wiki verknüpfen. Dadurch wird der schnelle Zugriff auf jedes verknüpfte Arbeitselement in der Abfrage unterstützt. Weitere Informationen finden Sie unter Wiki Markdown-Anleitungen.

Liste verknüpfter Objekte anzeigen

Um die Liste aller Objekte anzuzeigen, die mit einem Arbeitselement verknüpft sind, öffnen Sie das Arbeitselement, und wählen Sie die Registerkarte "Links" aus. Die Registerkarte "Links" gibt die Anzahl aller verknüpften Objekte an.

Screenshot of Links tab with count of linked objects.

Verknüpfte Objekte werden unter ihrem Linktyp gruppiert, wobei jede Gruppe eine Anzahl enthält. Sie können jede Gruppe erweitern oder reduzieren und innerhalb jeder Gruppe nach Status, Neuestes Update 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.

Screenshot of Links tab with many linked objects.

Links, die mit dem roten Ausrufezeichen versehen sind, weisen darauf hin, dass das Build-, Release- oder andere Objekt gelöscht wurde. Dies ist in der Regel auf Aufbewahrungsrichtlinien zurückzuführen, die diese Objekte nach einem bestimmten Zeitraum automatisch löschen.

Azure Repos, Git