Dela via


Länka arbetsobjekt till objekt

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

Länkar till arbetsobjekt är associationer mellan två arbetsobjekt eller ett arbetsobjekt och ett annat objekt. Länkar beskriver relationen mellan objekt. Du kan använda länkar till arbetsobjekt för att spåra beroenden och relaterat arbete för spårbarhet, dela information, hantera komplexa projekt som omfattar flera team eller produkter, spåra kodändringar, tester med mera.

I den här artikeln får du lära dig hur du utför följande uppgifter:

Förutsättningar

Förutsättning beskrivning
Projektadministratör eller deltagarmedlem Du måste läggas till i ett projekt som medlem i säkerhetsgruppen Deltagare eller Projektadministratörer .
Intressentåtkomst Om du vill lägga till eller ändra arbetsobjekt måste du beviljas intressentåtkomst eller högre. Användare med intressentåtkomst för offentliga projekt har fullständig åtkomst till kvarvarande uppgifter och styrelsefunktioner, till exempel användare med grundläggande åtkomst. Mer information finns i Snabbreferens för intressentåtkomst.
Deltagarmedlem eller Tillåt perms på – Om du vill visa eller ändra arbetsobjekt måste du ha behörigheten Visa arbetsobjekt i den här noden och Redigera arbetsobjekt i den här noden inställd på Tillåt. Som standard har gruppen Deltagare den här behörigheten inställd på Tillåt. Mer information finns i Ange behörigheter och åtkomst för arbetsspårning.
– Om du vill konfigurera integreringsalternativen för en klassisk versionspipeline måste du ha behörighet att redigera versionen.
– Om du vill länka arbetsobjekt till incheckningar och pull-begäranden måste du ha behörigheten Redigera arbetsobjekt i den här noden inställd på Tillåt för den områdessökväg som tilldelats till arbetsobjektet. Som standard har gruppen Deltagare den här behörighetsuppsättningen.
– Om du vill visa arbetsobjekt måste du ha behörigheten Visa arbetsobjekt i den här noden inställd på Tillåt för den områdessökväg som tilldelats arbetsobjektet.
Definierade iterationer Om du vill använda planeringsfönstret måste teamadministratören definiera iterationssökvägar (sprint) och konfigurera team-iterationer.
Förutsättning beskrivning
Projektadministratör eller deltagarmedlem Du måste läggas till i ett projekt som medlem i säkerhetsgruppen Deltagare eller Projektadministratörer .
Intressentåtkomst Om du vill lägga till eller ändra arbetsobjekt måste du beviljas intressentåtkomst eller högre.
Deltagarmedlem eller Tillåt perms på – Om du vill visa eller ändra arbetsobjekt måste du ha behörigheten Visa arbetsobjekt i den här noden och Redigera arbetsobjekt i den här noden inställd på Tillåt. Som standard har gruppen Deltagare den här behörigheten inställd på Tillåt. Mer information finns i Ange behörigheter och åtkomst för arbetsspårning.
– Om du vill konfigurera integreringsalternativen för en klassisk versionspipeline måste du ha behörighet att redigera versionen.
– Om du vill länka arbetsobjekt till incheckningar och pull-begäranden måste du ha behörigheten Redigera arbetsobjekt i den här noden inställd på Tillåt för den områdessökväg som tilldelats till arbetsobjektet. Som standard har gruppen Deltagare den här behörighetsuppsättningen.
– Om du vill visa arbetsobjekt måste du ha behörigheten Visa arbetsobjekt i den här noden inställd på Tillåt för den områdessökväg som tilldelats arbetsobjektet.
Definierade iterationer Om du vill använda planeringsfönstret måste teamadministratören definiera iterationssökvägar (sprint) och konfigurera team-iterationer.
Förutsättning beskrivning
Projektadministratör eller deltagarmedlem Du måste läggas till i ett projekt som medlem i säkerhetsgruppen Deltagare eller Projektadministratörer .
Intressentåtkomst Om du vill lägga till eller ändra arbetsobjekt måste du beviljas intressentåtkomst eller högre.
Deltagarmedlem eller Tillåt perms på Om du vill visa eller ändra arbetsobjekt måste du ha behörigheten Visa arbetsobjekt i den här noden och Redigera arbetsobjekt i den här nodbehörigheten inställd på Tillåt. Som standard har gruppen Deltagare den här behörigheten inställd på Tillåt. Mer information finns i Ange behörigheter och åtkomst för arbetsspårning.
Definierade iterationer Om du vill använda planeringsfönstret måste teamadministratören definiera iterationssökvägar (sprint) och konfigurera team-iterationer.

Följande typer av länkar hjälper dig att hantera de olika relationerna mellan arbetsobjekt och andra objekt.

Länktyp beskrivning
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 GitHub-lagringsplats för incheckning, problem eller pull-begäran
Typ av arbetslänk Ansluter arbetsobjekt, inklusive välj arbetsobjekt för testfallshantering

Mer information om länktyper, inklusive överordnad/underordnad, relaterad och föregående efterföljande, finns i Typer av arbetslänkar.

Gör följande för att länka arbetsobjekt till olika objekt.

  1. Öppna det arbetsobjekt som du vill länka från från webbportalen eller skapa ett nytt.

  2. Välj fliken Länkar och välj sedan Länka till.

  3. I listrutan Länktyp väljer du den typ av länk som du vill skapa.

  4. I fältet Länk till anger eller väljer du det objekt som du vill länka till. Beroende på länktypen kan du ange eller välja följande objekt.

  5. (Valfritt) Ange en kommentar för att beskriva länken.

  6. Skapa länken genom att välja OK.

Dricks

Det finns andra funktioner som du kan använda för att länka eller ändra länkar som använder länktypen Överordnad/Underordnad. Vissa funktioner är versionsberoende. Mer information finns i de länkade artiklarna.

Gör följande för att lägga till en länk till en annan användarberättelse, epos, funktion, bugg, problem eller uppgift från webbportalen.

  1. Öppna arbetsobjektet som du vill länka till ett annat arbetsobjekt.

  2. I arbetsobjektsformuläret väljer du avsnittet Relaterat arbete .

  3. Välj Lägg till länk och sedan Befintligt objekt.

  4. I listrutan Länktyp väljer du den typ av länk som du vill skapa, till exempel Överordnad, Underordnad eller Relaterad.

  5. I fältet Arbetsobjekt anger du ID för det arbetsobjekt som du vill länka till och väljer sedan OK.

    I följande exempel används länktypen Relaterad för att länka tre objekt till felet med ID :t 400.

    Skärmbild av dialogrutan Lägg till länk, webbportalen, till ett befintligt arbetsobjekt.

    Du kan bara lägga till länkar en i taget. Du kan inte ange deras ID:n avgränsade med kommatecken eller blanksteg.

    Om du vill länka till flera arbetsobjekt anger du deras ID:n avgränsade med kommatecken eller blanksteg. Om du inte känner till ID:na eller om du vill länka till ett objekt i ett annat projekt väljer du Fler åtgärder.

  6. (Valfritt) Om du arbetar från sidan Frågeresultat kan du massspara de arbetsobjekt som du har ändrat. När du arbetar från en kvarvarande post sparas arbetsobjekt automatiskt.

    Skärmbild av sidan Frågeresultat och spara massmodifierade objekt.

  1. Från webbportalen öppnar du en sida med kvarvarande uppgifter eller frågeresultat och väljer de arbetsobjekt som du vill lägga till en länk till.

  2. Öppna snabbmenyn ... för ett av de markerade arbetsobjekten, välj Lägg till länk och välj sedan Befintligt objekt... eller Nytt objekt....

    I följande exempel väljer du flerval från produkteftersläpningen och väljer Befintligt objekt....

    Skärmbild av snabbmenyn för kvarvarande uppgifter, Flervalsobjekt i kvarvarande uppgifter, öppna snabbmenyn, välj Lägg till länk till ett befintligt arbetsobjekt.

  3. I listrutan Länktyp väljer du den typ av länk som du vill skapa, till exempel Överordnad, Underordnad eller Relaterad.

  4. I fältet Arbetsobjekt anger du ID för det arbetsobjekt som du vill länka till och väljer sedan OK.

  1. Öppna arbetsobjektet i webbportalen och välj Länkar.

  2. Välj Länken Redigera fler åtgärder>.

    Skärmbild av fliken Länkar, öppna Fler åtgärder, välj alternativet Redigera länk.

  3. Välj den länktyp som du vill ändra till och välj sedan Spara.

    Skärmbild av dialogrutan Redigera länk.

  4. Spara arbetsobjektet.

Gör följande för att länka ett arbetsobjekt till ett nytt arbetsobjekt.

  1. Ange länktyp, arbetsobjekttyp och rubrik för det nya arbetsobjektet. Välj OK. Ett arbetsobjekt av den typ som du har valt öppnas.

    Skärmbild av dialogrutan Lägg till länk, Länk till nytt arbetsobjekt.

  2. Ange ytterligare information och Spara arbetsobjektet.

    Skärmbild av nytt arbetsobjekt Problem har lagts till.

  3. (Valfritt) Om du arbetar från sidan Frågeresultat kan du massspara de arbetsobjekt som du har ändrat.

Organisationer som använder Microsoft Entra-ID kan länka till arbetsobjekt som finns i olika projekt i organisationer. Använd följande länktyper som anges:

  • Använd länktyperna Förbruka från eller Producerar för när du vill spåra beroenden av arbetsobjekt som definieras i olika organisationer och hanteras av olika team.
  • Använd länktypen Fjärrrelaterad när de arbetsobjekt som länkas definieras i olika organisationer och hanteras av olika team, men inte har starka beroenden.

Skärmbild av formuläret Användarberättelse, fliken Länk som visar två externa länkar.

Utför följande steg för att länka arbetsobjekt till objekt som definierats i andra Azure DevOps-organisationer. Du kan bara göra det om båda organisationerna använder samma Microsoft Entra-ID för att hantera användare.

  1. Välj någon av följande fjärrlänktyper:

    • Förbrukar från eller producerar för: När du vill spåra beroenden av arbetsobjekt som definieras i olika organisationer och hanteras av olika team.
    • Fjärrrelaterad: När de arbetsobjekt som länkas definieras i olika organisationer och hanteras av olika team, men inte har starka beroenden.
  2. I dialogrutan Lägg till länk väljer du länktypen, anger URL:en för fjärrarbetsobjektet och väljer sedan OK.

    I följande exempel används länktypen Fjärrrelaterad för att länka till arbetsobjektets ID 350 som finns i remotelinkingtest2-organisationen RemoteLinking-projektet.

    Skärmbild som visar hur du tar bort en länk för arbetsobjekt.

På länkfliken finns ett antal länkar till arbetsobjektet. Fältet Antal fjärrlänkar upprätthåller antalet länkar som läggs till i ett arbetsobjekt som länkar till ett arbetsobjekt som definierats i ett annat projekt eller en annan organisation.

I följande exempel visas två fjärrlänkar, som anges av molnikonen, som lagts till i en användarberättelse.

Skärmbild av användarberättelseformuläret, fliken Länk som visar två externa länkar.

  1. I beskrivningen av pull-begäran anger du # för att utlösa väljaren för #ID arbetsobjektet. En lista visar 50 arbetsobjekt som du nyligen har ändrat eller har tilldelats till dig.

    Skärmbild av listan över arbetsobjekt som skapas när du anger symbolen # i PR-beskrivningen.

  2. Om du vill begränsa listan över föreslagna arbetsobjekt anger du upp till fem nyckelord som matchar arbetsobjektets typ, ID eller rubrik.

    Skärmbild av att ange nyckelord efter symbolen # och resulterande arbetsobjekt i sökningen.

Mer information finns i Länka till arbetsobjekt från pull-begäranden, incheckningar och kommentarer.

När du ansluter Azure Boards till GitHub-lagringsplatser kan du länka arbetsobjekt till github-incheckning, GitHub-pullbegäran, GitHub Branch och GitHub-problem. Du kan använda GitHub för programvaruutveckling medan du använder Azure Boards för att planera och spåra ditt arbete.

När du ansluter Azure Boards till GitHub-lagringsplatser kan du länka arbetsobjekt till en GitHub Commit och GitHub Pull Request. Du kan använda GitHub för programvaruutveckling medan du använder Azure Boards för att planera och spåra ditt arbete.

Viktigt!

Du kan bara länka arbetsobjekt till GitHub-objekt som har lagringsplatser anslutna till Azure Boards. Mer information finns i Ansluta Azure Boards till GitHub och Länka till arbetsobjekt från pull-begäranden, incheckningar och kommentarer.

Mer information finns i Länka GitHub-incheckningar, pull-begäranden, grenar och problem med arbetsobjekt och Slutför automatiskt arbetsobjekt med pull-begäranden.

Från en sida med kvarvarande uppgifter eller frågeresultat väljer du de arbetsobjekt som du vill länka till en ny git-gren, väljer åtgärdsikonen och sedan Ny gren.... Mer information finns i Länka arbetsobjekt till Git-utvecklingsobjekt.

Skärmbild av kvarvarande uppgifter, snabbmeny, välj Länka flera kvarvarande uppgifter till en git-gren.

Utför följande steg för att länka arbetsobjekt till befintliga versioner. Dessa versioner kan finnas i ditt projekt eller till andra projekt i din organisation eller samling.

Kommentar

Den här funktionen kräver installation av Azure DevOps Server 2020.1-uppdatering. Mer information finns i Viktig information om Azure DevOps Server 2020 Update 1 RC1, Boards.

  1. På fliken Länkar i ett arbetsobjekt väljer du Lägg till länk>Befintligt objekt.

  2. I dialogrutan Lägg till länk väljer du någon av bygglänktyperna: Build, Found in build, Integrated in build. Ange versionsnumret.

    Versionsnumret är en kombination av pipelinen och byggnamnet. Om du inte känner till versionsnumret söker du efter det genom att välja ikonen .

    Skärmbild av dialogrutan Lägg till länk med Skapa länktyp markerad.

  3. I dialogrutan Länkversioner väljer du parametrarna för att filtrera sökningen efter versioner.

    Om du vill länka till ett bygge i ett annat projekt väljer du först det projekt vars bygge du vill länka till.

    Du kan till exempel ange ett versionsnummer, välja en byggpipeline eller ett byggresultat, till exempel Alla, lyckades, delvis lyckades, misslyckades eller avbröts. Eller med Alla markerade för Resultat väljer du Sök för att visa en lista över tillgängliga versioner att länka till.

    Skärmbild av dialogrutan Hitta byggen med projektet valt och versioner som visas.

  4. Välj versionen från listan som du vill länka till och välj sedan OK.

  5. I dialogrutan Lägg till länk väljer du OK för att slutföra åtgärden.

    Skärmbild av dialogrutan Lägg till länk med build-nummer angivet.

Du kan länka arbetsobjekt till befintliga versioner från dialogrutan Lägg till länk .

  1. På fliken Länkar i ett arbetsobjekt väljer du Lägg till länk>Befintligt objekt.

  2. I dialogrutan Lägg till länk väljer du någon av bygglänktyperna: Build, Found in build, Integrated in build. Ange versionsnumret.

    Versionsnumret är en kombination av pipelinen och byggnamnet. Om du inte känner till versionsnumret söker du efter det genom att välja ikonen .

    Skärmbild av dialogrutan Lägg till länk med Skapa länktyp markerad.

  3. I dialogrutan Länkversioner väljer du parametrarna för att filtrera sökningen efter versioner.

    Du kan till exempel ange ett versionsnummer, välja en byggpipeline eller ett byggresultat, till exempel Alla, lyckades, delvis lyckades, misslyckades eller avbröts. Eller med Alla markerade för Resultat väljer du Sök för att visa en lista över tillgängliga versioner att länka till.

    Skärmbild av dialogrutan Hitta byggen, länk till ett bygge i projektet.

  4. Välj versionen från listan som du vill länka till och välj sedan OK.

  5. I dialogrutan Lägg till länk väljer du OK för att slutföra åtgärden.

    Skärmbild av dialogrutan Lägg till länk med build-nummer angivet.

När du utvecklar din programvara kan du samla in vilka kodändringar och byggen som stöder slutförandet av ett arbetsobjekt. Ditt team kan förstå vilket arbete som har utförts eller hur ett fel har åtgärdats via spårningsloggen för ändringar i kodbasen.

Länktyperna som används för att skapa dessa länkar är: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item och Integrated in release environment. Dessa typer visas i följande bild.

Konceptbild av länktyper för devops.

Dricks

Vi rekommenderar att du skapar utveckling från arbetsobjektet när du skapar det. Du kan också lägga till arbetsobjektets ID när du skapar grenar, incheckningar och pull-begäranden. Med Git kan du länka arbetsobjekt till incheckningar med hjälp av länktypen Checka in . Du kan göra det på följande sätt.

Som du ser i följande bild visar distributionskontrollen versionsinformation för två versionssteg. Den innehåller arbetsobjekt som är länkade till en Git-incheckning eller pull-begäran för en versionspipeline som konfigurerats för integrering med Azure Boards.

Skärmbild av flera miljöer som versionen är riktad mot.

Distributionskontroll

Arbetsobjektformulär innehåller två kontroller för att visa och gå till utvecklingsobjekt. I den här artikeln beskrivs distributionskontrollen. Mer information om utvecklingskontrollen finns i Drive Git development from a work item (Driva Git-utveckling från ett arbetsobjekt).

Som standard visas distributionskontrollen i arbetsobjektsformulären för användarberättelse (agil), produktpost (Scrum), problem (grundläggande), krav (CMMI), funktion, epos, bugg, uppgift och testfall.

Anpassade arbetsobjekttyper som använder den ärvda processen aktiveras automatiskt. Distributionskontrollen visar versionsinformationen för två steg i versionspipelinen som är integrerad med Azure Boards.

Den här kontrollen visar bara de arbetsobjekt som är länkade till en Git-incheckning eller pull-begäran för den här pipelinen. Du kan också få visuell insikt i statusen för ett arbetsobjekt när det distribueras till olika versionsmiljöer. Du kan gå till varje versionssteg och köra.

Skärmbild av arbetsobjektsformulär, distributionskontroll.

Arbetsobjekt som är associerade med incheckningar i bygget visar versionens status. Endast arbetsobjekt i samma projekt länkas till där versionspipelinen har definierats.

Skärmbild som visar flera miljöer som versionen är riktad mot.

När du öppnar ett arbetsobjekt kan du se stegen i realtid.

Skärmbild av scenarier för versionsinställningar, inklusive testning, mellanlagring, produktion och utveckling.

Utför följande steg för att fylla i distributionskontrollen :

Kommentar

Distributionskontrollen kräver konfiguration av en klassisk versionspipeline. Den stöder inte länkning till lanseringssteg som definierats för en YAML-pipeline.

  1. Definiera en klassisk versionspipeline och konfigurera versionsstegen. Mer information finns i Definiera din cd-pipeline (multi-stage continuous deployment).

  2. Konfigurera pipelinen. Mer information finns i Konfigurera pipelines för att stödja arbetsspårning, Rapportera distributionsstatus till Boards.

  3. Länka arbetsobjekt till en inchecknings- eller pull-begäran i Git-lagringsplatsen för Azure Repos. Mer information finns i:

  4. Köra pipelinen.

Med Team Foundation-versionskontroll (TFVC) kan du länka arbetsobjekt till versionskontrolländringar eller versionsbaserade källkodsfiler med hjälp av länktyperna Changeset och Versioned Item . När du checkar in väntande ändringar eller använder Mitt arbete för att checka in ändringar länkas arbetsobjekt automatiskt till dina ändringar. Mer information finns i Checka in ditt arbete.

Skärmbild av Team Explorer, Mitt arbete, Väntande ändringar, checka in.

Testrelaterade länktyper länkar arbetsobjekt för testfallshantering till varandra eller till andra arbetsobjekt. Från webbportalen eller Microsoft Test Manager kan du visa vilka testfall som har definierats för en testsvit och vilka testpaket som har definierats för en testplan. Dessa objekt är inte länkade till varandra via länktyper.

Du kan länka arbetsobjekt till testfall med hjälp av länktyperna Testad/Testad av . Använd samma länkkontroller som du använder för att länka arbetsobjekt till andra arbetsobjekt. Se Länka arbetsobjekt.

Följande bild visar den fullständiga uppsättningen länktyper som du kan använda med arbetsobjekttyper för testhantering. De flesta länkar mellan testhanteringsobjekt sker genom att köra en uppgift från testsidorna eller Microsoft Test Manager.

Skärmbild av länktyper som används för att länka testobjekt.

När du till exempel lägger till delade steg i ett testfall länkas de automatiskt med hjälp av länktyperna Testfall/Delade steg . Mer information finns i Dela steg mellan testfall.

Skärmbild av testformuläret för arbetsobjekt som visar steg.

Skärmbild av dialogrutan Infoga delade steg.

Från Test kan du lägga till testplaner, testpaket och testfall som är länkade. Du kan inte lägga till dem via en viss länktyp. Testsystemet skapar och hanterar associationerna för testresultat för att testa fall och testplaner.

Du kan använda en hyperlänk eller en Storyboard-länktyp för att länka ett arbetsobjekt till en webbplats, nätverksresurs eller ett dokument som finns på en nätverksresurs. Båda dessa länktyper är enkelriktade länkar. Om du vill lägga till dessa länktyper använder du samma kontroller som beskrevs tidigare. Se Länka arbetsobjekt.

När du använder länktypen storyboard särskiljer du länken för att ange en storyboard eller ett dokument som innehåller specifikationer för arbetsobjekt. Använd den här länktypen för att ge ditt team åtkomst till den delade filen där de kan lägga till sina kommentarer.

Skärmbild av länktypen Hyperlänk eller Storyboard för att länka ett arbetsobjekt till en URL.

Azure DevOps innehåller flera sätt att visa beroenden och spåra relaterat arbete:

  • Power Query-redigeraren: Du kan använda Power Query-redigeraren för att skapa anpassade frågor som visar alla arbetsobjekt som är länkade till ett specifikt arbetsobjekt.
  • Kvarvarande uppgifter och tavlor: Vyerna Kvarvarande uppgifter och tavlor visar överordnade och underordnade relationer mellan arbetsobjekt, så att du snabbt kan se beroenden.
  • Beroendespårare: Dependency Tracker är en Power BI-rapport som ger en visuell representation av beroenden mellan arbetsobjekt.

Gör följande för att visa listan över alla objekt som är länkade till ett arbetsobjekt.

  1. Öppna arbetsobjektet och välj Länkar. Fliken Länkar anger antalet länkade objekt. Länkade objekt grupperas under länktypen med ett antal i varje grupp.

    Skärmbild av fliken Länkar med antalet länkade objekt.

  2. (Valfritt) Expandera eller dölj varje grupp och sortera inom varje grupp efter Delstat, Senaste uppdatering eller Kommentar genom att välja motsvarande kolumnrubrik.

På följande fliken Länkar visas till exempel en del av de 64 länkade objekten för ett arbetsobjekt.

Skärmbild av fliken Länkar med många länkade objekt.

Länkar som föregås av utropstecknet anger att bygge, version eller annat objekt tas bort. På grund av kvarhållningsprinciper tas dessa objekt automatiskt bort efter en viss tidsperiod.

Fråga efter länkade arbetsobjekt

Om du vill filtrera objekt baserat på hierarkiska länkar använder du frågetypen Träd för arbetsobjekt . Om du vill filtrera objekt baserat på alla länktyper använder du Arbetsobjekt och direktlänkar.

Om du vill hitta arbetsobjekt som är länkade till andra arbetsobjekt med specifika länktyper använder du en fråga som visar en primär och en sekundär uppsättning arbetsobjekt. Den primära uppsättningen uppfyller fältvillkoren och den sekundära uppsättningen är länkad till den primära uppsättningen. Du kan inte fråga efter arbetsobjekt i versioner. Du kan fråga efter arbetsobjekt med externa länkar. Om du vill förfina sökningen lägger du till fler frågefilter.

Frågeexempel finns i Fråga efter arbetsobjekt efter länk eller antal bifogade filer.

Du kan inte skapa en fråga som visar en hierarkisk vy över testplaner, testsviter och testfall. De här objekten länkas inte ihop med överordnad/underordnad eller någon annan länktyp. Du kan bara visa hierarkin via sidan Testtestplaner>. Mer information finns i Skapa testplaner och testpaket.

Du kan lägga till, ta bort och visa information om länkar till ett arbetsobjekt med relationskommandot az boards work-item. Mer information finns i Kom igång med Azure DevOps CLI.

Länktyper inkluderar typer av arbetslänkar, fjärrlänktyper, hyperlänkar och bifogade filer. Kör kommandot az boards work-item relation list-type för en lista över alla länktyper som du kan ange.

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

I följande exempel är organisationen fabrikam och projekt-ID: t motsvarar aaaaaaaaa-0000-1111-2222-bbbbbbbbbb. Tabellformatet används för att visa utdata. Andra format finns i Utdataformat för Azure CLI-kommandon.

Om du vill länka ett eller flera arbetsobjekt till ett enda arbetsobjekt anger du kommandot az boards work-item relation add .

Obligatoriska parametrar inkluderar ID:t för arbetsobjektet som ska länkas till och länktypen. Länktyper som stöds är Överordnad, Underordnad, Relaterad och Fjärrrelaterad. Kör kommandot az boards work-item relation list-type för en lista över alla länktyper.

För arbetsobjekt som definierats i samma organisation måste du ange arbetsobjektets ID eller mål-URL. För arbetsobjekt som definierats i en fjärrorganisation anger du mål-URL:en. Du kan ange flera värden genom att separera ID:er eller URL:er med kommatecken.

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

Följande kommando länkar arbetsobjektets ID=2807 till arbetsobjektets ID=2794 med länktypen Underordnad. Kommandot returnerar en lista över alla länkar som för närvarande har definierats för arbetsobjektet.

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

Om du vill visa informationen för de länkade arbetsobjekten anger du en av url:erna som visas i webbläsaren.

Om du vill ta bort ett eller flera länkade arbetsobjekt från ett enda arbetsobjekt anger du kommandot az boards work-item relation remove .

Obligatoriska parametrar inkluderar ID för arbetsobjektet för att ta bort länken från och länktypen. Du kan bara ta bort länkar till arbetsobjekt som definierats i samma organisation. Du kan ange någon av de länktyper som stöds förutom fjärrlänktyper.

Du måste ange målarbetsobjektets ID. Du kan ange flera värden genom att separera ID:er eller URL:er med kommatecken.

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

Följande kommando tar bort länken till arbetsobjektets ID=2794 från arbetsobjektets ID=2856 till arbetsobjektet med länktypen Underordnad. Kommandot returnerar en lista över alla länkar som för närvarande har definierats för arbetsobjektet.

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 

Om du vill visa informationen för de länkade arbetsobjekten anger du en av url:erna som visas i webbläsaren.

Om du vill visa de arbetsobjekt som är länkade till ett enda arbetsobjekt anger du kommandot az boards work-item relation show . Kör kommandot az boards work-item relation list-type för en lista över alla länktyper som kan returneras.

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

Följande kommando visar information om länkar som definierats för arbetsobjektets ID=2931 i fabrikam-organisationen i tabellformat.

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

Om du vill visa informationen för de länkade arbetsobjekten anger du en av url:erna som visas i webbläsaren. Välj URL:en för en bifogad fil för att ladda ned den bifogade filen.

Gör följande för att ta bort en länk för arbetsobjekt.

  1. Öppna arbetsobjektet som har länkar eller välj det från ett frågeresultat.
  2. Välj fliken Länkar för att se listan med länkar.
  3. Välj den länk som du vill ta bort och välj sedan Ta bort länk.
  4. Bekräfta att du vill ta bort länken.

När ett arbetsobjekt länkas till en inchecknings- eller pull-begäran fortsätter det att visas som en del av lanseringsstegen. Om du till exempel har ett arbetsobjekt som inte klarade testvillkoren kanske du vill ta bort det från versionerna och versionerna.

Om du vill ta bort arbetsobjektet från att delta i framtida versioner och versioner tar du bort länken till den senaste inchecknings- och pull-begäran.

Visualisera relaterat arbete och andra objekt. Ladda ned visualiseringstillägget För arbetsobjekt som är tillgängligt från fliken Visual Studio Marketplace, Azure DevOps.