Dela via

Referensguide för länktyper

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 särskilda arbetsobjekt för testfallshantering
  • 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
  • Länktyp för fjärrarbete: Ansluter arbetsobjekt som definieras i olika organisationer
  • GitHub-länktyp: Ansluter ett arbetsobjekt till en commit, issue eller pull request till ett GitHub-repository.

Ett visst fält har ett antal länkar för de fyra första länktyperna, till exempel relaterat länkantal, hyperlänkantal, antal externa länkaroch antal fjärrlänkar.

  • Typ av arbetslänk: länkar samman arbetsobjekt inklusive hantering av testfallsrelaterade arbetsobjekt
  • 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 GitHub-lagringsplatsincheckning eller pull-begäran.

Ett visst fält har ett antal länkar för de tre första länktyperna, till exempel relaterat länkantal, hyperlänkantaloch 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 Link-topologier och begränsningar.

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 förälder-barn två etiketter: Förälder och Barn. 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 Relaterat länkantal 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 hjälp av WorkItemLinksFilter XML-elementet.

Namn

Referensnamn

Användning

Affects-Påverkad av (endast CMMI) Konceptuell bild av länktypen Påverkar.Konceptuell bild av länktypen Påverkad av.

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 funktionen Påverkad av.
  • Använd endast Affects-Affected via 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.

Barn-Förälder
Konceptbild av en barnlänktyp.
Konceptbild av en överordnad länktyp.

System.LinkTypes.Hierarchy-Forward
System.Länktyper.Hierarki-Omvänd
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 backlogobjekt med hjälp av -mappningsfunktionen eller bland backlogobjekt och uppgifter med hjälp av sprintkvarvarande eller Taskboard.

Vanliga användningsområden är:

  • Underhåll uppgiftssammanfattningsrelationer. 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. Stödjer rapporter om backlogöversikt, användarberättelseöversikt och kravöversikt.

Begränsningar och rekommendationer:

  • Använd Excel för att redigera flera arbetsobjekt och förälder-barn länkar samtidigt. Se Masslägg till eller ändra arbetsobjekt med Excel.
  • Ett arbetsobjekt kan bara ha en överordnad. Ett överordnat arbetsobjekt kan ha många underordnade objekt.
  • Använd endast förälder-barn-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.

Duplicate-Duplicate avkonceptbild av dubblett av träd framåtriktad.konceptbild av dubblett av träd omvänt.

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 länkar av typen Duplicera eller Duplicera av 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 av-Referenser
konceptbild av Testad av länktyp. konceptbild av testlänktypen.

Microsoft.VSTS.TestCase.
DeladParameterRefereradAv
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.

Relaterade
Konceptbild av relaterad länktyp.

System.Länktyper.Relaterad
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.

efterträdare-föregångare
konceptbild av efterföljande beroende, framåt. konceptbild av föregående beroende, bakåt.

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 som du länkar från. Välj Efterföljande länktyp när du länkar till ett arbetsobjekt som ska slutföras efter till arbetsobjektet 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 av tester
konceptuell bild av testad av länkar typ. konceptuell bild av testlänktype.

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 produktbackloggobjekt. 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 teamaktiviteter för att stödja användbara rapporter.

Testfall-gemensamma steg
konceptbild av Testad av länktyp. konceptbild av testlänktypen.

Microsoft.VSTS.TestCase.
DeladStegRefereradAv
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änkräknaren spårar antalet hyperlänkar till ett arbetsobjekt.

konceptbild av en hyperlänk.

Länknamn

Stödjda verktyg

Artefakttyp

Användning

Hyperlänk

Spårning av arbetsobjekt

Hyperlänk

Används för att länka ett arbetsobjekt till en URL. Work item Hyperlänk ä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 typ av extern länk.

Anmärkning

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 någon av dessa länktyper för att begränsa en länkkontroll med hjälp av ExternalLinksFilter XML-elementet.

Länknamn

Stödjda verktyg

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

Ändringsuppsättning (eller åtgärdat i ändringsuppsättning)

Versionshantering

Ändringsset

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

Commit (eller fixad i commit)

Git

Utföra

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

Finns i kompilering

Pipelines/Build

Skapa

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

Integrerad i bygge

Skapa

Byggkedja

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

Integrerad i versionsmiljön

Lansering

Lanseringspipeline

Används för att länka en version till en arbetsuppgift. Systemet skapar en länk av denna typ när en användare aktiverar alternativet Rapportera distributionsstatus till Work för en release-definition.

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<

Versionshantering

SenasteArtikelversion

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

Bildmanus

Krav

Bildmanus

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.

Tag

Git

Tag

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.

Versionerat objekt

Versionshantering

SenasteArtikelversion

Används för att länka ett arbetsobjekt till en fil eller ändringsuppsättning som definierats i en TFVC-lagringsplats. Källkodsfil ä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.

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-commit

GitHub-repositoriumskommitt

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

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-repositorium

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 fjärrarbete.

Namn

Referensnamn

Användning

förbrukar From-Produced för
(Beroendetopologi) konceptbild av Consumes From-topologi.konceptbild av Producerad för topologi.

System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Beroende-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ärrrelaterade
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 arbetsobjektrelation listtyp

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 Kom 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 hjälp av 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 om länktyperna Producerar för och Konsumerar från listas 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 kommandoradsverktyget witadmin listlinktypes eller relationstyper för arbetsobjekt – lista REST API-kommando.

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 vänliga namnet som tilldelats länktyperna. Riktningslänkar definieras i par och innehåller därför ett framåt- och bakåtnamn.

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 referensen för LinkTypes-element.

directional

Anger om länktypen är riktningsbaserad (true) eller inte (false). Riktningslänktyper definieras i par med en framåt- och bakåtkomponent. Mer information finns i referensen 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 hjälp av witadmin Hantera länktyp kommandoradsverktyg. Systemlänktyper har alltid editable=false.

Ä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 hjälp av witadmin Hantera länktyp kommandoradsverktyget.

isForward

Anger om länktypen specificerar framåt-länken (true) eller inte (False) inom ett par av länktyper.

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ätverk, , and träd. 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.