Freigeben über

Referenzhandbuch für Verknüpfungstypen

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

Verwenden Sie verschiedene Verknüpfungstypen, um Beziehungen zwischen Arbeitsaufgaben und anderen Artefakten zu verwalten, z. B. Builds, Commits und Pullanforderungen. In diesem Artikel werden die folgenden Linktypen beschrieben.

  • Arbeitslinktyp: Verknüpft Arbeitsaufgaben, einschließlich ausgewählter Arbeitsaufgaben für die Testfallverwaltung
  • Hyperlink: Verbindet ein Arbeitselement mit einer beliebigen URL oder Netzwerkfreigabe
  • Externer Linktyp: Verbindet eine Arbeitsaufgabe mit einem externen Objekt, z. B. einem Codeobjekt, einem Build oder einer Wiki-Seite
  • Remotearbeitslinktyp: Verbindet Arbeitselemente, die in verschiedenen Organisationen definiert sind
  • GitHub-Linktyp: Verbindet eine Arbeitsaufgabe mit einem GitHub-Repository commit, Problem oder Pull-Anforderung.

Ein bestimmtes Feld verwaltet eine Anzahl von Verknüpfungen für die ersten vier Verknüpfungstypen, z. B. Die Anzahl verwandter Links, die Hyperlinkanzahl, die Anzahl externer Links und die Anzahl der Remotelinks.

Ein bestimmtes Feld verwaltet eine Anzahl von Verknüpfungen für die ersten drei Verknüpfungstypen, z. B. "Anzahl verwandter Verknüpfungen", "Hyperlinkanzahl" und "Anzahl externer Verknüpfungen".

Verknüpfungstypen haben topologische Einschränkungen. Verwenden Sie die Anleitungen in den folgenden Tabellen, um einen Linktyp basierend auf den Abfragen und Berichten auszuwählen, die Sie erstellen möchten. Weitere Informationen zu Topologien finden Sie unter Linktyptopologien und Einschränkungen.

Arbeitslinktypen werden vom System definiert, vom Prozess definiert oder benutzerseitig definiert (benutzerdefiniert). Die in der folgenden Tabelle aufgeführten Links sind systemdefiniert.

Jeder Arbeitslinktyp definiert Bezeichnungen, Topologien und Einschränkungen, die beim Erstellen von Verknüpfungen zwischen Arbeitsaufgaben verwendet werden. Beispielsweise definiert der Linktyp "Parent-child" zwei Bezeichnungen: "Parent" und "Child". Der Verknüpfungstyp verwendet eine Baumtopologie und verhindert Zirkelbezüge zwischen Arbeitselementen.

Screenshot eines konzeptionellen Diagramms eines Arbeitselements-Verknüpfungstyps.

Die Anzahl verwandter Verknüpfungen einer Arbeitsaufgabe entspricht der Summe aller Links, die mit einem Arbeitsverknüpfungstyp definiert sind.

In der folgenden Tabelle werden die Linktypen von Arbeitselementen beschrieben, die Sie für den Bereich eines Linksteuerelements mithilfe des XML-Elements WorkItemLinksFilter angeben können.

Name

Verweisname

Verwendung

Betrifft-Betroffen von (nur CMMI) Screenshot mit einem konzeptionellen Diagramm des Linktyps Screenshot mit einem konzeptionellen Diagramm des Linktyps

Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Topologietyp: Abhängigkeit
Linkkategorie: Prozessdefiniert

Verwenden Sie diese direktionale Verknüpfung, um Verknüpfungen zwischen Arbeitsaufgaben zu erstellen, ohne geschlossene Schleifen zu erstellen. Personen verwenden sie in der Regel zum Nachverfolgen von Änderungsanforderungen, die mit Anforderungen verknüpft sind.

Einschränkungen und Empfehlungen:

  • Verknüpfen Sie eine Änderungsanforderung mit nur einer Anforderung mithilfe von "Affects". Verknüpfen Sie Anforderungen mit so vielen untergeordneten Änderungsanforderungen wie erforderlich, indem Sie "Betroffen von" verwenden.
  • Verwenden Sie Affects-Affected nur mithilfe von Links, um Arbeitsaufgaben im selben Projekt zu verknüpfen. Dies wird empfohlen, wenn Sie beabsichtigen, Excel zum Ändern oder Aktualisieren von Arbeitsaufgabendaten zu verwenden.

Kind-Eltern
Screenshot eines konzeptionellen Diagramms des Typs
Screenshot eines konzeptionellen Diagramms des Übergeordneten Verknüpfungstyps.

System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Topologietyp: Baumstruktur
Linkkategorie: Systemdefiniert

Verwenden Sie diese direktionalen Verbindung, um 1:n-Beziehungen zwischen einem einzelnen übergeordneten und einem oder mehreren untergeordneten Elementen zu erstellen. Verwenden Sie sie, um Arbeitsaufgaben in einer Hierarchie zu organisieren. Sie können diese Hierarchie zwischen Backlogelementen mithilfe der Zuordnungsfunktion oder zwischen Backlogelementen und -aufgaben mithilfe des Sprint-Backlogs oder des Taskboards erstellen.

Typische Verwendungen umfassen:

  • Beziehungen zwischen Aufgaben und Zusammenfassungen aufrechterhalten. Verknüpfungen zwischen übergeordneten und untergeordneten Elementen stellen Sammelvorgänge und ihre untergeordneten Aufgaben dar.
  • Verknüpfen Sie Aufgaben mit PBIs, Benutzergeschichten oder Anforderungen. Unterstützt Backlog-Übersicht, Story-Übersicht und Anforderungsübersicht-Berichte.

Einschränkungen und Empfehlungen:

  • Verwenden Sie Excel für die Massenbearbeitung von Arbeitselementen und Links zwischen übergeordneten und untergeordneten Elementen. Weitere Informationen finden Sie unter Massenhinzufügen oder -ändern von Arbeitselementen mit Excel.
  • Ein Arbeitselement kann nur ein übergeordnetes Element besitzen. Ein übergeordnetes Arbeitselement kann viele Kinder haben.
  • Verwenden Sie ausschließlich die Links zwischen übergeordneten und untergeordneten Elementen für das Verknüpfen von Arbeitselementen im selben Projekt. Dies wird empfohlen, wenn Sie beabsichtigen, Excel zum Ändern oder Aktualisieren von Arbeitsaufgabendaten zu verwenden.

Duplikat-Duplikat vonScreenshot, der ein konzeptionelles Diagramm des Verknüpfungstyps Screenshot, der ein konzeptionelles Diagramm des Verknüpfungstyps

System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Topologietyp: Baumstruktur
Linkkategorie: Systemdefiniert

Verwenden Sie diesen gerichteten Link, um 1:n-Beziehungen zu erstellen, die Aufgaben, Fehler oder andere Arbeitsaufgaben nachverfolgen, die sich gegenseitig duplizieren.

Einschränkungen und Empfehlungen:

  • Eine Arbeitsaufgabe kann nur ein Duplikat aufweisen.
  • Verwenden Sie nur „Duplikat“ oder „Duplikat von Links“, um Arbeitselemente im selben Projekt zu verknüpfen. Dies wird empfohlen, wenn Sie beabsichtigen, Excel zum Ändern oder Aktualisieren von Arbeitsaufgabendaten zu verwenden.

Referenzierte By-References
Screenshot eines konzeptionellen Diagramms des Linktyps Screenshot eines konzeptionellen Diagramms des Verknüpfungstyps

Microsoft.VSTS.TestCase.
SharedParameterReferencedBy
Topologietyp: Abhängigkeit
Linkkategorie: Prozessdefiniert

Verwenden Sie diese Methode, um Testfälle mit freigegebenen Parametern zu verknüpfen und das Wiederholen eines Tests mit unterschiedlichen Daten zu unterstützen. Gewöhnlich fügen Sie diesen Linktyp nicht zu einem Steuerelement für bereichsgebundene Links hinzu.

Zugehörig
Screenshot eines konzeptionellen Diagramms des Typs

System.LinkTypes.Related
Topologietyp: Netzwerk
Linkkategorie: Systemdefiniert

Verwenden Sie diese nichtdirektionale Verknüpfung, um Beziehungen zwischen Arbeitsaufgaben zu erstellen. Verwenden Sie sie, um Arbeitsaufgaben auf derselben Ebene zu verknüpfen (z. B. zwei überlappende Benutzergeschichten). Der Typ "Verwandter Link" erstellt einfache Beziehungen mit wenigen Einschränkungen.

  • Verknüpfen von Arbeitsaufgaben, die sich auf derselben Ebene befinden.
  • Verknüpfen Sie Arbeitsaufgaben, die in verschiedenen Projekten definiert sind und von verschiedenen Teams verwaltet werden.
  • Suchen und anzeigen von Arbeitsaufgaben und deren verknüpften Aufgaben in einer zweistufigen Ansicht.
  • Erstellen Sie einfache Beziehungen mit wenigen Einschränkungen.

Nachfolger-Vorgänger
Ein Bildschirmfoto zeigt ein konzeptionelles Diagramm der Nachfolgerabhängigkeit. Ein Bildschirmfoto zeigt ein konzeptionelles Diagramm der Vorgängerabhängigkeit.

System.LinkTypes.Dependency
Topologietyp: Abhängigkeit
Linkkategorie: Systemdefiniert
Wählen Sie "Vorgänger " aus, wenn Sie eine Verknüpfung mit einer Arbeitsaufgabe herstellen, die vor dem aktuellen Element abgeschlossen werden soll. Wählen Sie "Nachfolger" aus, wenn Sie eine Verknüpfung mit einer Arbeitsaufgabe herstellen, die nach dem aktuellen Element abgeschlossen werden soll.

Verwenden Sie diese direktionale Verknüpfung, um Vorgänge nachzuverfolgen, die abgeschlossen werden müssen, bevor andere beginnen. Verknüpfte Vorgänge werden als Vorgänger-Nachfolgerlinks in Azure Boards angezeigt.

  • Nachverfolgen von Aufgaben, die abgeschlossen werden müssen, bevor andere beginnen können.
  • Unterstützung von Eins-zu-viele-Beziehungen.
  • Suchen Sie nach Vorgänger- und Nachfolger-Arbeitselementen in einer zweistufigen Direktlink-Abfrageansicht.

Einschränkungen und Empfehlungen:

  • Wenn Sie versuchen, Zirkelbeziehungen zu erstellen, wird ein Fehler angezeigt.
  • Erstellen Sie Vorgänger-Nachfolgerverknüpfungslinks nur für Arbeitsaufgaben innerhalb desselben Projekts, wenn Sie nach Excel exportieren möchten. Sie können Vorgänger-Nachfolgerverknüpfungen für Projekte erstellen, aber Excel-Export/Import enthält nur Elemente für das Projekt, das die Abfrage definiert.

Getestet durch Tests
Screenshot eines konzeptionellen Diagramms des Linktyps Screenshot eines konzeptionellen Diagramms des Linktyps

Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Topologietyp: Abhängigkeit
Linkkategorie: Prozessdefiniert

Verknüpfen Sie Testfälle mit Arbeitsaufgaben wie Fehlern, Benutzergeschichten, Anforderungen und PBIs. Verwenden Sie diese Methode, um Testfälle zu verfolgen, die Benutzergeschichten (Agile), PBIs (Scrum) oder Anforderungen (CMMI) überprüfen. Für lokale Azure DevOps sind mehrere SQL-Berichte von diesen Links abhängig. Sehen Sie sich "Überprüfen Sie Teamaktivitäten, um nützliche Berichte zu erstellen" an.

Test Case-Shared Schritte
Screenshot eines konzeptionellen Diagramms des Links Screenshot eines konzeptionellen Diagramms des Links

Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Topologietyp: Abhängigkeit
Linkkategorie: Prozessdefiniert

Verwenden Sie diese Funktion, um Testfälle mit gemeinsamen Schritten zu verknüpfen. Teilen Sie Schritte zwischen Testfällen , um zu vermeiden, dass dieselbe Abfolge von Schritten dupliziert wird.

Ein Link verknüpft eine Arbeitsaufgabe mit einer beliebigen URL. Die Hyperlinkanzahl verfolgt die Anzahl der Hyperlinks in einer Arbeitsaufgabe.

Screenshot eines konzeptionellen Diagramms eines Hyperlinks.

Linkname

Unterstütztes Tool

Artefakttyp

Verwendung

Verknüpfung

Arbeitselementverfolgung

Verknüpfung

Verwenden Sie dies, um eine Arbeitsaufgabe mit einer URL zu verknüpfen. Arbeitselementhyperlink ist der Name dieses Linktyps in der Artefaktlinktyp-API.

Externe Verknüpfungstypen sind systemdefiniert und verknüpfen Arbeitsaufgaben mit anderen Objekten, die in Azure DevOps gespeichert sind. Die Anzahl der externen Verknüpfungen einer Arbeitsaufgabe entspricht der Summe aller Verknüpfungen, die mit externen Verknüpfungstypen definiert sind.

Screenshot eines konzeptionellen Diagramms externer Verknüpfungstypen.

Hinweis

Verwenden Sie einen externen Linktyp nur, um eine Verknüpfung mit einem Azure DevOps-Objekt zu erstellen. Verwenden Sie einen Link, um Arbeitsaufgaben mit Objekten außerhalb von Azure DevOps zu verknüpfen.

In der folgenden Tabelle werden die externen Verknüpfungstypen beschrieben, die Sie auswählen können, wenn Sie einen Link aus einer Arbeitsaufgabe oder einem Testfall hinzufügen.

In der folgenden Tabelle werden die externen Verknüpfungstypen beschrieben, die Sie beim Hinzufügen eines Links aus einer Arbeitsaufgabe oder einem Testfall auswählen können. Sie können auch einen dieser Verknüpfungstypen angeben, um ein Verknüpfungssteuerelement mithilfe des ExternalLinksFilter-XML-Elements festzulegen.

Linkname

Unterstütztes Tool

Artefakttyp

Verwendung

Sicherheitswarnung

Erweiterte Sicherheit

Erweiterte Sicherheit

Wird verwendet, um eine Arbeitsaufgabe mit einer erweiterten Sicherheitswarnung zu verknüpfen.

Filiale

Git

Filiale

Dient zum Verknüpfen einer Arbeitsaufgabe mit einer Verzweigung.

Pipelines/Build

Bauen

Bauen

Dient zum Verknüpfen einer Arbeitsaufgabe mit einem Build.

Changeset (oder behoben in Changeset)

Versionskontrolle

Changeset

Zum Verknüpfen eines Arbeitselements mit einem Changeset verwenden.

Commit (oder behoben im Commit)

Git

Commit

Dient zum Verknüpfen einer Arbeitsaufgabe mit einem Commit.

Gefunden in Build

Pipelines/Build

Bauen

Dient zum Verknüpfen einer Arbeitsaufgabe mit einem Build.

Integriert im Build

Bauen

Buildpipeline

Dient zum Verknüpfen einer Arbeitsaufgabe mit einem Build.

Integriert in Release-Umgebung

Freigabe

Releasepipeline

Dient zum Verknüpfen einer Freigabe mit einer Arbeitsaufgabe. Das System erstellt diesen Typ, wenn ein Benutzer den Bereitstellungsstatus an Arbeit melden für eine Freigabedefinition aktiviert.

Pull-Anforderung

Git

PullRequestId

Dient zum Verknüpfen einer Arbeitsaufgabe mit einer Pullanforderung.

Ergebnisanhang

Testverwaltung

TcmResultAttachment

Verwenden Sie diese Funktion, um ein Arbeitselement mit einem Anhang zu verknüpfen, der einem Testergebnis zugeordnet ist. Diese Links werden angezeigt, wenn Sie eine Arbeitsaufgabe einem Testergebnis aus Test oder Microsoft Test Manager zuordnen.

Quellcodedatei

Versionskontrolle

NeuesteArtikelversion

Dient zum Verknüpfen einer Arbeitsaufgabe mit einer Datei unter der Team Foundation-Versionssteuerung (TFVC).

Storyboard

Anforderungen

Storyboard

Dient zum Verknüpfen einer Arbeitsaufgabe mit einer PowerPoint-Datei oder einer anderen Datei, die Storyboardinformationen in einem Netzwerk enthält.

Tag

Git

Tag

Dient zum Verknüpfen einer Arbeitsaufgabe mit einem Tag, das für einen Git-Commit oder ein Repository definiert ist. Mehr Informationen finden Sie unter "Arbeiten mit der Git-Eingabeaufforderung".

Testergebnis

Testverwaltung

TcmResult

Dient zum Verknüpfen einer Arbeitsaufgabe mit einem Testergebnis. Diese Links werden angezeigt, wenn Sie eine Arbeitsaufgabe einem Testergebnis aus Test oder Microsoft Test Manager zuordnen.

Versioniertes Element

Versionskontrolle

NeuesteArtikelversion

Dient zum Verknüpfen einer Arbeitsaufgabe mit einer Datei oder einem Changeet, die in einem TFVC-Repository definiert ist. Die Quellcodedatei ist der Name dieses Verknüpfungstyps in der Artefaktlinktypen-API.

Wiki

Wiki

Wiki

Dient zum Verknüpfen einer Arbeitsaufgabe mit einer Wiki-Seite. Unterstützt für TFS 2018.2 und höhere Versionen.

GitHub-Linktypen sind systemdefiniert und verknüpfen Arbeitsaufgaben mit GitHub-Objekten, wie hier gezeigt.

Screenshot eines konzeptionellen Diagramms von GitHub-Linktypen.

Von Bedeutung

Sie können GitHub-Artefakte nur für Repositories verknüpfen, die mit Azure Boards verbunden sind.

In der folgenden Tabelle werden die GitHub-Linktypen beschrieben, die Sie beim Hinzufügen eines Links aus einer Arbeitsaufgabe auswählen können.

Linkname

Artefakttyp

Verwendung

GitHub-Commit

GitHub-Repositorycommit

Dient zum Verknüpfen einer Arbeitsaufgabe mit einem GitHub-Commit.

GitHub-Problem

GitHub-Repositoryproblem

Dient zum Verknüpfen einer Arbeitsaufgabe mit einem GitHub-Problem.

GitHub-Pullanforderung

GitHub-Repository-Pullanforderung

Dient zum Verknüpfen einer Arbeitsaufgabe mit einer GitHub-Pullanforderung.

Remote-Arbeitslinktypen unterstützen das Verknüpfen von Arbeitsaufgaben, die in verschiedenen Organisationen definiert sind, solange dieselbe Microsoft Entra-ID diese Organisationen verwaltet (siehe Verbinden Ihrer Organisation mit Microsoft Entra ID).

Die Remote-Link-Anzahl eines Arbeitselements entspricht der Summe aller Links, die mit einem Remote-Link-Typ für die Arbeit definiert sind.

Name

Verweisname

Verwendung

Verbraucht From-Produced für
(Abhängigkeitstopologie) Screenshot, der ein konzeptionelles Diagramm der Screenshot, der ein konzeptionelles Diagramm der

System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Topologietyp: Abhängigkeit
Linkkategorie: Systemdefiniert

Verwenden Sie diese direktionale Verknüpfung, um Abhängigkeiten zwischen arbeitsbezogenen Elementen zu erstellen, die in verschiedenen Organisationen definiert sind, solange die gleiche Microsoft Entra-ID sie verwaltet. Personen verwenden dies in der Regel, um Änderungsanforderungen zu verfolgen, die mit Anforderungen über Organisationsgrenzen hinweg verknüpft sind.

Remoteverbindung
Screenshot eines konzeptionellen Diagramms der remotebezogenen Topologie.

System.LinkTypes.Remote.Related
Topologietyp: Netzwerk
Linkkategorie: Systemdefiniert

Verwenden Sie diesen nicht direktionalen Link, um Arbeitsaufgaben zu verknüpfen, die in verschiedenen Organisationen definiert sind, solange die gleiche Microsoft Entra-ID sie verwaltet.

Erstellen sie benutzerdefinierte Linktypen, exportieren und importieren Sie Linktypdefinitionen, und löschen, aktivieren, deaktivieren oder reaktivieren Sie benutzerdefinierte Verknüpfungstypen. Siehe:

Sie können Verknüpfungstypen mithilfe der unterstützten Befehlszeilentools auflisten.

az boards Arbeitsaufgabe Beziehung Listen-Typ

Listenverknüpfungstypen, die von Ihrer Organisation mit dem Befehl "Arbeitsaufgabenbeziehungsliste" oder "Listen-REST-API" unterstützt werden. Ausführliche Informationen finden Sie unter "Erste Schritte mit Azure DevOps CLI".

az boards work-item relation list-type [--org]

Optionale Parameter

  • org: URL der Azure DevOps-Organisation. Sie können die Standard-Organisation mit az devops configure -d organization=ORG_URL konfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird. Beispiel: --org https://dev.azure.com/MyOrganizationName/.

Beispiel

Der folgende Befehl listet die Verknüpfungstypen für Arbeitsaufgaben im Tabellenformat auf, die für die Fabrikam-Organisation definiert sind.

az boards work-item relation list-type --org fabrikam --output table
Name                  ReferenceName                                                Enabled    Usage
--------------------  -----------------------------------------------------------  ---------  ------------
Produces For          System.LinkTypes.Remote.Dependency-Forward                   True       workItemLink
Consumes From         System.LinkTypes.Remote.Dependency-Reverse                   True       workItemLink
Duplicate             System.LinkTypes.Duplicate-Forward                           True       workItemLink
Duplicate Of          System.LinkTypes.Duplicate-Reverse                           True       workItemLink
Referenced By         Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward  True       workItemLink
References            Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse  True       workItemLink
Tested By             Microsoft.VSTS.Common.TestedBy-Forward                       True       workItemLink
Tests                 Microsoft.VSTS.Common.TestedBy-Reverse                       True       workItemLink
Test Case             Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward       True       workItemLink
Shared Steps          Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse       True       workItemLink
Successor             System.LinkTypes.Dependency-Forward                          True       workItemLink
Predecessor           System.LinkTypes.Dependency-Reverse                          True       workItemLink
Child                 System.LinkTypes.Hierarchy-Forward                           True       workItemLink
Parent                System.LinkTypes.Hierarchy-Reverse                           True       workItemLink
Related               System.LinkTypes.Related                                     True       workItemLink
Remote Related        System.LinkTypes.Remote.Related                              True       workItemLink
Attached File         AttachedFile                                                 True       resourceLink
Hyperlink             Hyperlink                                                    True       resourceLink
Artifact Link         ArtifactLink                                                 True       resourceLink

Das standardmäßige JSON-Format enthält zusätzliche Informationen zu den Attributen, die für die Verknüpfungstypen definiert sind. Die Informationen für die Verknüpfungstypen "Produziert für" und "Verbraucht von" werden z. B. wie folgt aufgeführt.

  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": true,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Produces For",
    "referenceName": "System.LinkTypes.Remote.Dependency-Forward",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
  },
  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": false,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Consumes From",
    "referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
  },

witadmin listlinktypes

Sie können Verknüpfungstypen auflisten, die für Ihre Projektsammlung unterstützt werden, indem Sie das witadmin listlinktypes Befehlszeilentool oder den Befehl "Work Item Relation Types - List REST API" verwenden.

Hier ist eine Liste der Verknüpfungstypen für die fabrikam-sever-Standardauflistung:

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection

Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True

Die folgende Tabelle enthält Beschreibungen für jedes der Von Azure Boards CLI oder der REST-API zurückgegebenen Verknüpfungstypattribute.

Attribut

Beschreibung

Namen, name

Gibt den Anzeigenamen an, der den Verknüpfungstypen zugewiesen ist. Richtungslinks werden paarweise definiert, daher enthalten sie einen Vorwärts- und einen Rückwärtsnamen.

Verweisname, referenceName

Gibt den Namen an, der dem Verknüpfungstyp- oder Verknüpfungstyppaar zugewiesen ist.

acyclic

Gibt an, ob der Verknüpfungstyp kreisförmige Beziehungen zulässt oder (true) einschränkt (false). Beispielsweise beschränken Strukturtyplinks Zirkelbeziehungen. Weitere Informationen finden Sie unter LinkTypes-Elementreferenz.

directional

Gibt an, ob der Verknüpfungstyp direktional (true) ist oder nicht (false). Richtungslinktypen werden in Paaren mit einer Vorwärts- und einer Rückwärtskomponente definiert. Weitere Informationen finden Sie unter LinkTypes-Elementreferenz.

editable

Gibt an, ob der Verknüpfungstyp bearbeitet werden kann (true) oder nicht (false). Sie können nur benutzerdefinierte Linktypen für lokale Bereitstellungen hinzufügen und bearbeiten, indem witadmin Sie das Befehlszeilentool "Linktyp verwalten" verwenden. Systemlinktypen verfügen immer über editable=false.

Ist aktiv, enabled

Gibt an, ob der Verknüpfungstyp aktiv (true) ist oder nicht (false). Sie können nur benutzerdefinierte Linktypen für lokale Bereitstellungen mit dem witadmin Befehlszeilentool "Linktyp verwalten" verwenden.

isForward

Gibt an, ob der Verknüpfungstyp den Vorwärtslink (true) oder nicht (False) innerhalb eines Verknüpfungstyppaars angibt.

oppositeEndReferenceName

Gibt den Verweisnamen des Verknüpfungstyps an, der die Verknüpfung in entgegengesetzter Richtung eines Verknüpfungstyppaars definiert.

remote

Gibt an, ob der Verknüpfungstyp die Verknüpfung mit einem Remote-Arbeitsobjekt (true) unterstützt oder nicht (False). Verknüpfungstypen mit remote=false erfordern, dass sich die Zielarbeitsaufgabe in derselben Organisation oder Sammlung wie die Ursprungsarbeitsaufgabe befindet.

singleTarget

Gibt an, ob der Verknüpfungstyp mehr als ein Ziel () zulässt oder auf ein einzelnes Ziel (falsetrue) beschränkt ist.

topology

Gibt den Topologietyp an: dependency, network, und tree. Beschreibungen finden Sie unter Linktyptopologien und Einschränkungen.

usage

Gibt den Verwendungstyp an: resourceLink or "workItemLink. The workItemLink "-Wert gibt einen Verknüpfungstyp an, der zwei Arbeitsaufgaben verknüpft. Der resourceLink Wert gibt einen Verknüpfungstyp an, der verwendet wird, um eine Arbeitsaufgabe mit einer Ressource zu verknüpfen, z. B. eine URL oder Anlage.

url

Listet die Attribute des Linktyps im JSON-Format auf.

Verwandte Inhalte

  • Last updated on