Dela via

Referensguide för länktyper

  • Artikel

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

Du kan använda olika länktyper för att hantera de olika relationerna mellan arbetsobjekt och andra artefakter, till exempel byggen, incheckningar, pull-begäranden med mera. I den här artikeln beskriver vi följande länktyper.

  • Typ av arbetslänk: Länkar arbetsobjekt inklusive välj arbetsobjekt för hantering av testfall
  • Hyperlänk: Anslut ett arbetsobjekt till en URL eller nätverksresurs
  • Extern länktyp: Anslut ett arbetsobjekt till ett externt objekt, till exempel ett kodobjekt, en build- eller wiki-sida
  • Länktyp för fjärrarbete: Anslut arbetsobjekt som definieras i olika organisationer
  • GitHub-länktyp: Anslut ett arbetsobjekt till en GitHub-lagringsplats för incheckning, problem eller pull-begäran.

Ett specifikt fält upprätthåller antalet länkar för de fyra första länktyperna, till exempel Antal relaterade länkar, antal hyperlänkar, antal externa länkar och antal fjärrlänkar.

  • Typ av arbetslänk: länkar arbetsobjekt, inklusive välj arbetsobjekt för hantering av testfall
  • Hyperlänk: ansluter ett arbetsobjekt till valfri URL eller nätverksresurs
  • Extern länktyp: ansluter ett arbetsobjekt till ett externt objekt, till exempel ett kodobjekt, en build- eller wiki-sida
  • GitHub-länktyp: Ansluter ett arbetsobjekt till en Incheckning av GitHub-lagringsplats eller pull-begäran.

Ett visst fält upprätthåller antalet länkar för de tre första länktyperna, till exempel Antal relaterade länkar, hyperlänkantal och antal externa länkar.

Länktyper omfattas av vissa begränsningar baserat på deras topologi. Använd vägledningen i följande tabeller för att välja vilken länktyp som ska användas baserat på de typer av frågor och rapporter som du vill skapa. Mer information om de olika topologierna finns i Topologier och begränsningar för länktyp.

Typer av arbetslänkar är systemdefinierade, processdefinierade eller användardefinierade (anpassade). Länkarna i följande tabell är systemdefinierade.

Varje typ av arbetslänk definierar länketiketter, topologityp och begränsningar som används när länkar mellan arbetsobjekt skapas. Till exempel definierar länktypen överordnad-underordnad två etiketter: Överordnad och Underordnad. Länktypen stöder också en hierarkisk topologi eller trädtopologi och förhindrar att cirkelreferenser skapas mellan arbetsobjekt.

Konceptbild av en länktyp för arbetsobjekt.

Ett arbetsobjekts antal relaterade länkar motsvarar summan av alla länkar som definierats med en typ av arbetslänk.

I följande tabell beskrivs de länktyper för arbetsobjekt som du kan ange för att begränsa en länkkontroll med xml-elementet WorkItemLinksFilter.

Namn

Referensnamn

Användning

Påverkar påverkas av (endast CMMI) Konceptbild av Påverkar länktyp.Konceptbild av Påverkad av länktyp.

Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Topologityp: Beroende
Länkkategori: Processdefinierad

Använd den här riktningslänken om du vill skapa länkar mellan en uppsättning arbetsobjekt, men inte de som skulle skapa stängda loopar. Används vanligtvis för att spåra ändringsbegäranden som görs i krav.

Begränsningar och rekommendationer:

  • Du kan länka en ändringsbegäran till endast ett krav med hjälp av Påverkar. Du kan länka krav till så många underordnade ändringsbegäranden som behövs med hjälp av Påverkad av.
  • Använd endast Påverkar påverkas av länkar för att länka arbetsobjekt i samma projekt. Vi rekommenderar den här åtgärden om du planerar att använda Excel för att ändra eller uppdatera arbetsobjektdata.

Underordnad överordnad
Konceptbild av en underordnad länktyp.
Konceptbild av en överordnad länktyp.

System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Topologityp: Träd
Länkkategori: Systemdefinierad

Använd den här riktningslänken för att skapa en-till-många-relationer mellan en överordnad till ett eller flera underordnade objekt. Använd för att organisera arbetsobjekt i en hierarki. Du kan snabbt skapa den här hierarkin bland kvarvarande objekt med hjälp av mappningsfunktionen eller bland kvarvarande uppgifter med hjälp av sprint-kvarvarande uppgifter eller Aktivitetstavla.

Vanliga användningsområden är:

  • Underhåll aktivitetssammanfattningsrelationer. Länkar mellan överordnad och underordnad skapas för sammanfattningsaktiviteter och deras underordnade uppgifter.
  • Länka uppgifter till PBI:er, användarberättelser eller krav. Har stöd för rapporter med översikt över kvarvarande uppgifter, översikt över berättelser och krav.

Begränsningar och rekommendationer:

  • Använd Excel för att massredigera både arbetsobjekt och överordnade och underordnade länkar. Se Masstillägg eller ändring av arbetsobjekt med Excel.
  • Ett arbetsobjekt kan bara ha en överordnad. Ett överordnat arbetsobjekt kan ha många underordnade objekt.
  • Använd endast överordnade och underordnade länkar för att länka arbetsobjekt i samma projekt. Den här åtgärden rekommenderas om du planerar att använda Excel för att ändra eller uppdatera arbetsobjektdata.

Duplicerad dubblett avKonceptbild av Dubblett av träd framåt.Konceptbild av Dubblett av omvänd trädbild.

System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Topologityp: Träd
Länkkategori: Systemdefinierad

Använd den här riktningslänken för att skapa en-till-många-relationer mellan en överordnad till ett eller flera underordnade objekt. Använd för att spåra uppgifter, buggar eller andra arbetsobjekt som är dubbletter av varandra.

Begränsningar och rekommendationer:

  • Ett arbetsobjekt kan bara ha en Dubblett.
  • Använd endast duplicerade eller duplicerade länkar för att länka arbetsobjekt i samma projekt. Den här åtgärden rekommenderas om du planerar att använda Excel för att ändra eller uppdatera arbetsobjektdata.

Refererade efter referenser
Konceptbild av Testad efter länktyp.Konceptbild av testlänktyp.

Microsoft.VSTS.TestCase.
SharedParameterReferencedBy
Topologityp: Beroende
Länkkategori: Processdefinierad

Använd för att länka testfall till delade parametrar. Använd för att länka testfall till delade parametrar för att stödja möjligheten att upprepa ett test med olika data. I allmänhet skulle du inte lägga till den här länktypen i en begränsad länkkontroll.

Relaterat
Konceptbild av relaterad länktyp.

System.LinkTypes.Related
Topologityp: Nätverk
Länkkategori: Systemdefinierad

Använd den här icke-riktningslänken om du vill skapa länkar mellan en uppsättning arbetsobjekt. Använd för att länka arbetsobjekt som är på samma nivå, till exempel två användarberättelser som definierar funktioner som överlappar varandra. Den relaterade länktypen skapar enkla relationer med få begränsningar.

  • Relatera arbetsobjekt som är på samma nivå, till exempel två användarberättelser som definierar funktioner som överlappar varandra.
  • Länka arbetsobjekt som definieras i olika projekt och hanteras av olika team.
  • Hitta och visa arbetsobjekt och deras relaterade arbetsobjekt i en vy med två nivåer.
  • Skapa enkla relationer med få begränsningar.

Efterföljande föregångare
Konceptbild av Efterföljande beroende, framåt.Konceptbild av föregående beroende, omvänd.

System.LinkTypes.Dependency

Topologityp: Beroende
Länkkategori: Systemdefinierad
Välj Föregående länktyp när du länkar till ett arbetsobjekt som ska slutföras innan arbetsobjektet du länkar från. Välj Länktyp för efterföljande när du länkar till ett arbetsobjekt som ska slutföras efter till det arbetsobjekt som du länkar från.

Använd den här riktningslänken om du vill skapa länkar mellan en uppsättning arbetsobjekt, men inte de som skulle skapa stängda loopar. Använd för att spåra uppgifter som måste slutföras innan andra kan startas. Länkade uppgifter representeras som föregående efterföljande länkar i Azure Boards.

  • Spåra uppgifter som måste slutföras innan andra kan startas.
  • Stöder en-till-många-relationer.
  • Hitta och visa föregående arbetsobjekt och deras efterföljande arbetsobjekt i en frågevy med två nivåer och direktlänkar.

Begränsningar och rekommendationer:

  • Ett fel visas när du försöker skapa länkar som definierar cirkulära relationer.
  • Skapa föregående efterföljande länkar endast till arbetsobjekt som finns i samma projekt. Du kan skapa efterföljande länkar mellan arbetsobjekt som definieras i olika projekt. Men om du exporterar en fråga till Excel importeras endast de arbetsobjekt som definierats för projektet som frågan har definierats för.

Testad efter test
Konceptbild av Testad efter länktyp.Konceptbild av testlänktyp.

Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Topologityp: Beroende
Länkkategori: Processdefinierad

Länka testfall till arbetsobjekt, till exempel buggar, användarberättelser, krav och produktpost för kvarvarande uppgifter. Använd för att spåra testfall som testar användarberättelser (Agile), produkter med kvarvarande uppgifter (Scrum) eller krav (CMMI). Kan också länka till andra typer av arbetsobjekt, till exempel buggar, problem eller uppgifter. För lokala Azure DevOps finns det flera SQL-rapporter som är beroende av dessa länkar. Se Granska gruppaktiviteter för att stödja användbara rapporter.

Testa skiftlägesdelade steg
Konceptbild av Testad efter länktyp.Konceptbild av testlänktyp.

Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Topologityp: Beroende
Länkkategori: Processdefinierad

Använd för att länka testfall med delade steg. Dela steg mellan testfall för att undvika att behöva skapa flera poster i samma stegsekvens.

En hyperlänk kan länka ett arbetsobjekt till valfri URL. Hyperlänkantalet spårar antalet hyperlänkar till ett arbetsobjekt.

Konceptbild av en hyperlänk.

Länknamn

Verktyg som stöds

Artefakttyp

Användning

Hyperlänk

Spårning av arbetsobjekt

Hyperlänk

Används för att länka ett arbetsobjekt till en URL. Hyperlänk för arbetsobjekt är namnet på den här länktypen i API:et Artefaktlänktyper.

Externa länktyper är systemdefinierade länktyper som stöder länkning av arbetsobjekt till andra objekt som lagras i Azure DevOps enligt följande bild. Ett arbetsobjekts antal externa länkar motsvarar summan av alla länkar som definierats med en extern länktyp.

Konceptbild av extern länktyp.

Kommentar

Du kan bara använda en extern länktyp för att länka till ett Azure DevOps-objekt. Om du vill länka arbetsobjekt till andra objekt utanför Azure DevOps använder du en hyperlänk.

I följande tabell beskrivs de externa länktyper som du kan välja när du lägger till en länktyp från ett arbetsobjekt eller ett testfall.

I följande tabell beskrivs de externa länktyper som du kan välja när du lägger till en länktyp från ett arbetsobjekt eller ett testfall. Du kan också ange en av dessa länktyper för att begränsa en länkkontroll med xml-elementet ExternalLinksFilter.

Länknamn

Verktyg som stöds

Artefakttyp

Användning

Filial

Git

Filial

Används för att länka ett arbetsobjekt till en gren.

Pipelines/build

Skapa

Skapa

Används för att länka ett arbetsobjekt till en version.

Ändringsuppsättning (eller fast i ändringsuppsättning)

Versioncontrol

Changeset

Används för att länka ett arbetsobjekt till en ändringsuppsättning.

Incheckning (eller fast i incheckning)

Git

Checka in

Används för att länka ett arbetsobjekt till en incheckning.

Finns i build

Pipelines/build

Skapa

Används för att länka ett arbetsobjekt till en version.

Integrerad i bygge

Skapa

Bygg-pipeline

Används för att länka ett arbetsobjekt till en version.

Integrerad i versionsmiljön

Frisläpp

Lanseringspipeline

Används för att länka en version till ett arbetsobjekt. Systemet skapar en länk av den här typen när en användare aktiverar alternativet Rapportdistributionsstatus till Arbete för en versionsdefinition.

Pull-begäran

Git

PullRequestId

Används för att länka ett arbetsobjekt till en pull-begäran.

Resultatbilaga

Testhantering

TcmResultAttachment

Används för att länka ett arbetsobjekt till en bifogad fil som är associerad med ett testresultat. Dessa länkar visas när du associerar ett arbetsobjekt med ett testresultat från Test eller Microsoft Test Manager.

Källkodsfil<

Versioncontrol

LatestItemVersion

Används för att länka ett arbetsobjekt till en fil under Team Foundations versionskontroll (TFVC).

Storyboard

Krav

Storyboard

Används för att länka ett arbetsobjekt till en PowerPoint-fil eller annan fil som innehåller information om storyboarding i ett nätverk.

Tagg

Git

Tagg

Används för att länka ett arbetsobjekt till en tagg som definierats för en git-incheckning eller git-lagringsplats. Mer information finns i Arbeta från Git-kommandotolken.

Testresultat

Testhantering

TcmResult

Används för att länka ett arbetsobjekt till ett testresultat. Dessa länkar visas när du associerar ett arbetsobjekt med ett testresultat från Test eller Microsoft Test Manager.

Versionshanterat objekt

Versioncontrol

LatestItemVersion

Används för att länka ett arbetsobjekt till en fil eller ändringsuppsättning som definierats i en TFVC-lagringsplats. Källkodsfilen är namnet på den här länktypen i API:et Artefaktlänktyper.

Wiki

Wiki

Wiki

Används för att länka ett arbetsobjekt till en wiki-sida. Stöds för TFS 2018.2 och senare versioner.

GitHub-länktyper är systemdefinierade och stöder länkning av arbetsobjekt till GitHub-objekt enligt följande bild.

Konceptbild av GitHub-länktyp.

Konceptbild av GitHub-länktyp.

Viktigt!

Du kan bara länka till GitHub-artefakter med lagringsplatser som är anslutna till Azure Boards.

I följande tabell beskrivs de GitHub-länktyper som du kan välja när du lägger till en länktyp från ett arbetsobjekt.

Länknamn

Artefakttyp

Användning

GitHub-incheckning

Incheckning av GitHub-lagringsplats

Används för att länka ett arbetsobjekt till en GitHub-incheckning.

GitHub-problem

Problem med GitHub-lagringsplats

Används för att länka ett arbetsobjekt till ett GitHub-problem.

GitHub-pullbegäran

Pull-begäran för GitHub-lagringsplats

Används för att länka ett arbetsobjekt till en GitHub-pull-begäran.

Länktyper för fjärrarbete är systemdefinierade länktyper som stöder länkning av arbetsobjekt som definierats i olika organisationer, så länge samma Microsoft Entra-ID hanterar dem enligt beskrivningen i Anslut din organisation till Microsoft Entra-ID.

Ett arbetsobjekts antal fjärrlänkar motsvarar summan av alla länkar som definierats med en länktyp för distansarbete.

Namn

Referensnamn

Användning

Förbrukar frånproducerat för
(Beroendetopologi) Konceptbild av Consumes From-topologi.Konceptbild av Producerad för topologi.

System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Topologityp: Beroende
Länkkategori: Systemdefinierad

Använd den här riktningslänken för att skapa länkar mellan arbetsobjekt som har beroenden och definieras i olika organisationer, så länge samma Microsoft Entra-ID hanterar dem. Används vanligtvis för att spåra ändringsbegäranden som görs i krav.

Fjärrrelaterad
Konceptbild av fjärrrelaterad topologi.

System.LinkTypes.Remote.Related
Topologityp: Nätverk
Länkkategori: Systemdefinierad

Använd den här icke-riktningslänken för att skapa länkar mellan arbetsobjekt som definierats i olika organisationer, så länge samma Microsoft Entra-ID hanterar dem.

Du kan skapa en anpassad länktyp. exportera och importera definitioner av länktyper. och ta bort, aktivera, inaktivera och återaktivera typer av länkar. Mer information finns i följande artiklar:

Om du vill hämta en lista över länktyper kan du använda något av de kommandoradsverktyg som stöds.

az boards work-item relation list-type

Du kan lista länktyper som stöds av din organisation med kommandot az boards work-item relation list-type eller kommandot Work Item Relation Types – List REST API. Kom igång genom att läsa Komma igång med Azure DevOps CLI.

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

Valfria parametrar

  • org: Url för Azure DevOps-organisationen. Du kan konfigurera standardorganisationen med .az devops configure -d organization=ORG_URL Krävs om det inte är konfigurerat som standard eller hämtas med hjälp av git config. Exempel: --org https://dev.azure.com/MyOrganizationName/.

Exempel

Följande kommando visar de länktyper för arbetsobjekt i tabellformat som har definierats för fabrikam-organisationen.

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

Standardformatet json innehåller ytterligare information om de attribut som definierats för länktyperna. Informationen för länktyperna Producerar för och förbrukar från visas till exempel på följande sätt.

  {
    "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

Du kan visa en lista över länktyper som stöds för din projektsamling med hjälp av witadmin listlinktypes kommandoradsverktyget eller kommandot Arbetsobjektrelationstyper – LISTA REST API.

Här listar vi länktyperna för standardsamlingen fabrikam-sever:

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

Följande tabell innehåller beskrivningar för vart och ett av de länktypsattribut som returneras av Azure Boards CLI eller REST-API:et.

Attribut

Beskrivning

Namn name

Anger det egna namn som tilldelats länktyperna. Riktningslänkar definieras i par och innehåller därför ett framåt- och omvänd namn.

Referensnamn, referenceName

Anger det namn som tilldelats länktypen eller länktypsparet.

acyclic

Anger om länktypen tillåter eller (true) eller begränsar (false) cirkulära relationer. Till exempel begränsar trädtypslänkar cirkulära relationer. Mer information finns i Referens för LinkTypes-element.

directional

Anger om länktypen är riktning (true) eller inte (false). Riktningslänktyper definieras i par med en framåt- och omvänd komponent. Mer information finns i Referens för LinkTypes-element.

editable

Anger om länktypen är redigerbar (true) eller inte (false). Du kan bara lägga till och redigera anpassade länktyper för lokala distributioner med kommandoradsverktyget witadmin Hantera länktyp . Systemlänktyper har editable=falsealltid .

Är aktiv, enabled

Anger om länktypen är aktiv (true) eller inte (false). Du kan bara använda anpassade länktyper för lokala distributioner med kommandoradsverktyget witadmin Hantera länktyp .

isForward

Anger om länktypen anger länken (true) eller inte (False) inom ett länktypspar.

oppositeEndReferenceName

Anger referensnamnet för den länktyp som definierar länken i motsatt riktning för ett länktypspar.

remote

Anger om länktypen stöder länkning till ett fjärrarbetsobjekt (true) eller inte (False). Länktyper med remote=false kräver att målarbetsobjektet finns i samma organisation eller samling som ursprungsarbetsobjektet.

singleTarget

Anger om länktypen tillåter fler än ett mål (false) eller är begränsad till ett enda mål (true).

topology

Anger topologitypen – beroendenätverksträdet, , and . Beskrivningar finns i Länktyptopologier och begränsningar.

usage

Anger användningstyp – resourceLink eller workItemLink. Värdet för workItemLinkvalue indicates a link type that links two work items. TheresourceLink anger en länktyp som används för att länka ett arbetsobjekt till en resurs, till exempel en URL eller en bifogad fil.

url

Visar attributen för länktypen i json-format.