Dela via


Länka arbetsobjekt till objekt

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

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.

Förutsättningar

Kategori Krav
Åtkomst till projekt Projektmedlem.
behörigheter - Medlem i Deltagare eller Projektadministratörer säkerhetsgrupp.
- Om du vill visa eller ändra arbetsobjekt: Visa arbetsobjekt i den här noden och Redigera arbetsobjekt i den här noden behörigheter inställda 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.
– För att konfigurera integreringsalternativen för en klassisk releasepipeline: Redigera behörigheter för releasen.
– För att länka arbetsobjekt till commits och pull-begäranden: Redigera arbetsobjekt i denna nod med behörigheterna inställda på Tillåt för den områdessökväg som tilldelats arbetsobjektet. Som standardinställning har gruppen Deltagare den här behörigheten.
– Visa arbetsobjekt: Visa arbetsobjekt i den här noden behörigheter inställda på Tillåt för den områdessökväg som tilldelats arbetsobjektet.
Åtkomstnivåer Så här lägger du till eller ändrar arbetsobjekt: Minst Intressentåtkomst. Användare med Intressent åtkomst för offentliga projekt har fullständig åtkomst till backlog och tavelfunktioner, likt användare med Grundläggande åtkomst. Mer information finns i Snabbreferens för intressentåtkomst.
Definierade iterationer Om du vill använda fönstret Planning, måste din teamadministratör definiera iterationssökvägar (sprint) och konfigurera team-iterationer.
Kategori Krav
Åtkomst till projekt Projektmedlem.
behörigheter - Medlem i Deltagare eller Projektadministratörer säkerhetsgrupp.
- Om du vill visa eller ändra arbetsobjekt: Visa arbetsobjekt i den här noden och Redigera arbetsobjekt i den här noden behörigheter inställda 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.
– För att konfigurera integreringsalternativen för en klassisk releasepipeline: Redigera behörigheter för releasen.
– För att länka arbetsobjekt till commits och pull-begäranden: Redigera arbetsobjekt i denna nod med behörigheterna inställda på Tillåt för den områdessökväg som tilldelats arbetsobjektet. Som standardinställning har gruppen Deltagare den här behörigheten.
– Visa arbetsobjekt: Visa arbetsobjekt i den här noden behörigheter inställda på Tillåt för den områdessökväg som tilldelats arbetsobjektet.
Åtkomstnivåer Så här lägger du till eller ändrar arbetsobjekt: Minst Intressentåtkomst. Användare med Intressent åtkomst för offentliga projekt har fullständig åtkomst till backlog och tavelfunktioner, likt användare med Grundläggande åtkomst. Mer information finns i Snabbreferens för intressentåtkomst.
Definierade iterationer Om du vill använda fönstret Planning, måste din teamadministratör definiera iterationssökvägar (sprint) och konfigurera team-iterationer.

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

Kategori för länktyp beskrivning
Avancerad säkerhet Ansluter ett arbetsobjekt till en avisering om avancerad säkerhet.
Version Ansluter ett arbetsobjekt till ett byggnummer, som finns i build eller integrerat i build.
Kod Kopplar ett arbetsobjekt till en gren, ändringsuppsättning, incheckning, pull-begäran, tagg eller versionsobjekt.
GitHub Kopplar ett arbetsobjekt till en GitHub repository-gren, commit, ärende eller pull request.
Fjärrarbete Kopplar ett arbetsobjekt som har definierats i en annan organisation och som antingen konsumerar från, producerar för eller är relaterat på distans via URL.
Krav Ansluter ett arbetsobjekt till en storyboard via URL.
Test Ansluter ett arbetsobjekt till en testbilaga eller ett resultat.
Wiki Ansluter ett arbetsobjekt till en wiki-sida.
Arbetsobjekt Ansluter ett arbetsobjekt till aspekter av ditt arbete, inklusive:
- Påverkas av
-Påverkar
-Barn
- Duplicera
- Dubblett av
-Hyperlänk
- Integrerad i lanseringsfasen
-Förälder
-Föregångare
- Refererad av
-Referenser
- Besläktad
– Delade steg
-Efterträdare
- Testfall
- Testad av
-Tester

Mer information om typer av arbetslänkar, inklusive fjärrlänktyper, hyperlänkar, bifogade filer, överordnad/underordnad, relaterade och föregående efterföljare finns i Typer av arbetslänkar. Om du vill ha en lista över alla länktyper som du kan ange med hjälp av Azure DevOps SLI kör du kommandot az boards work-item relation list-type .

Du kan använda olika funktioner för att länka eller ändra länkar som använder länktypen Överordnad/Underordnad . Vissa funktioner beror på vilken version av Azure DevOps du använder. Se följande alternativ för att hantera dessa länkar:

De här verktygen ger flexibilitet för att hantera överordnade/underordnade länkar baserat på ditt arbetsflöde och dina inställningar.

Gör följande för att lägga till en länk till ett annat arbetsobjekt i webbportalen:

  1. Öppna arbetsobjektet som du vill länka från.

  2. I arbetsobjektsformuläret kan du välja mellan två sätt att utföra den här uppgiften:

    • Gå till avsnittet Relaterat arbete och välj Lägg till länk>Befintligt objekt.
    • Välj Länkar>Lägg till länk>Befintligt objekt.

    Skärmbild som visar en sekvens med markerade knappar för att lägga till en länk till ett befintligt arbetsobjekt från fliken Länkar.

  3. I listrutan Länktyp väljer du den länktyp som du vill skapa, till exempel Underordnad, Överordnadeller Relaterad.

  4. I fältet Arbetsobjekt för att länka anger du ID:t för det arbetsobjekt som du vill länka till eller väljer från listrutan och väljer sedan Lägg till länk.

    I följande exempel används länktypen Relaterade till ett testfall med ID:t 280.

    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:n eller \för att länka till ett objekt i ett annat projekt väljer du Fler åtgärder.

  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.

  1. Från webbportalen öppnar du en kvarvarande eller frågeresultatsida.

  2. Om du vill lägga till en länk, markera flera arbetsobjekt.

  3. Välj Fler åtgärder för de markerade arbetsobjekten, välj Lägg till länkoch välj sedan Länka till ett befintligt objekt... eller Länka till ett nytt arbetsobjekt....

    I följande exempel markerar vi flera val i produktbacklogen och väljer Länka till ett 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.

  4. Välj i listrutan Länktyp, till exempel Förälder, Barneller Relaterad.

  5. I fältet Arbetsobjekt anger du ID:t för det arbetsobjekt som du vill länka till och väljer sedan Lägg till länk.

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

  2. Välj fler åtgärder>Redigera länk.

    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.

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

  1. I arbetsobjektet väljer du Länkar>Lägg till länk>Nytt objekt.

    Skärmbildssekvens för att lägga till en ny eller befintlig objektlänk till arbetsobjektet.

  2. Ange Länktyp och arbetsobjekttypoch ange en rubrik för det nya arbetsobjektet och valfri kommentar. Välj Lägg till länk.

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

    Det nya arbetsobjektet öppnas.

  3. Ange ytterligare information och Spara arbetsobjektet.

    Skärmbild av nytt arbetsärende som har lagts till.

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. I arbetsobjektet väljer du Länkar>Lägg till länk>Befintligt objekt.

    Skärmbild som visar sekvens för att lägga till en länk till ett nyligen skapat arbetsobjekt.

  2. Välj någon av följande fjärrlänktyper i listrutan Länktyp:

    • 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.
  3. Ange URL:en för fjärrarbetsobjektet och välj sedan Lägg till länk.

    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ältetAntal fjärrlänkar behå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, angivna av molnikon, tillagda i en användarhistoria.

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

När du ansluter Azure Boards med GitHub-lagringsplatser kan du länka arbetsobjekt till en GitHub Branch, GitHub Commit, GitHub Issueoch 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.

Avancerade säkerhetsaviseringar kan länkas till arbetsobjekt från ett arbetsobjekt eller från själva aviseringen Avancerad säkerhet.

  1. I arbetsobjektet väljer du Länkar>Lägg till länk>Befintligt objekt.

  2. Välj en lagringsplats som måste ha Advanced Security aktiverat och välj en säkerhetsavisering i listrutan. Du måste också ha behörigheten Advanced Security: visa aviseringar för den här lagringsplatsen.

Skärmbild av val av arbetsobjekt med länktyp för säkerhetsaviseringar.

Alternativt kan du också länka till ett arbetsobjekt från en avisering om avancerad säkerhet. Gå till en specifik avisering om avancerad säkerhet och välj Lägg till i avsnittet Relaterat arbete.

Skärmbild av avisering om avancerad säkerhet för att länka relaterade arbetsuppgifter.

Viktigt!

Du kan bara länka arbetsobjekt till lagringsplatser som har Advanced Security aktiverat och möjlighet att visa säkerhetsaviseringar. Mer information finns i Konfigurera behörigheter för avancerad säkerhet och avancerad säkerhet.

  1. Från en backlog eller frågeresultatsida, markera arbetsobjekt som du vill länka till en ny git-gren .

  2. Välj ikonen åtgärder 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 i andra projekt i din organisation eller din samling.

Anteckning

Den här funktionen kräver installation av Azure DevOps Server 2020.1-uppdatering. För mer information, se Versionsinformation för Azure DevOps Server 2020 Update 1 RC1, Boards.

  1. I arbetsobjektet väljer du Länkar>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 pipelinenamnet och byggnamnet. Om du inte känner till versionsnumret väljer du Hitta versioner.

    Skärmbild som visar den markerade knappen Sök efter versioner.

  3. Välj parametrarna för att filtrera sökningen efter byggen.

    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 när Lyckades valts för Resultatväljer du Sök efter versioner för att visa en lista över tillgängliga versioner som du kan länka till.

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

  4. Välj den version i listan som du vill länka till och tryck sedan på Bekräfta.

  5. Välj Lägg till länk 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.

Tips

Driv utvecklingen från arbetsuppgiften när du skapar den. Du kan också lägga till arbetsobjektets ID när du skapar grenar, commits och pull-requests. Med Git kan du länka arbetsobjekt till commits med länktypen Commit. Här är sätten att göra det:

Som du ser i följande bild visar distributionskontrollen versionsinformation för två versionssteg. Den innehåller arbetsuppgifter som är länkade till en Git-commit eller pull request i en versionspipeline konfigurerad för att integreras med Azure Boards.

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

Distributionskontroll

Distributionskontrollen innehåller flera funktioner som hjälper dig att hantera och spåra versionsstatusen för arbetsobjekt. Följande lista beskriver dessa funktioner:

  • Standardutseende: Distributionskontrollen visas i arbetsobjektsformulären för användarberättelse (agil), produktpost (Scrum), problem (grundläggande), krav (CMMI), funktion, episk, bugg, uppgift och testfall som standard.

  • Anpassade arbetsobjekttyper: Anpassade arbetsobjekttyper som använder den ärvda processen aktiveras automatiskt.

  • Versionsinformation: Distribueringskontrollen visar versionsinformationen för två steg i versionspipelinen som är integrerad med Azure Boards.

  • Länkade arbetsobjekt: 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.

  • Visual insight: Få visuell insikt i statusen för ett arbetsobjekt när det distribueras i olika release-miljöer och snabbt navigera till varje release-steg och körning.

    Skärmbild av arbetsobjektsformulär, distributionskontroll.

  • Incheckningsassociationer: Arbetsobjekt som är associerade med incheckningar i bygget visar status för releasen.

  • Projektomfång: Endast arbetsobjekt i samma projekt länkas till den plats där versionspipelinen definieras.

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

  • Scensynlighet: När du öppnar ett arbetsobjekt kan du se faserna 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:

Anteckning

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

  1. Definiera en klassisk versionspipeline och konfigurera versionsstegen enligt beskrivningen i Definiera pipelinen för kontinuerlig distribution i flera steg (CD).

  2. Konfigurera datakedjan.

  3. Länka arbetsobjekt till en commit eller pull request i Azure Repos Git-lagringsplats. Mer information finns i:

  4. Kör pipeline.

Med Team Foundation Version Control (TFVC) kan du länka arbetsobjekt till versionskontrolländringar eller versionsbaserade källkodsfiler med hjälp av Changeset och Versionshanterat objekt länktyper. 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 definieras för en testsvit och vilka testpaket som definieras 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.

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.

I avsnittet Test kan du lägga till testplaner, testpaket och testfall som länkas automatiskt. Du kan inte lägga till dessa objekt via en specifik länktyp. Testsystemet skapar och hanterar kopplingarna av testresultat till testfall 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 på en nätverksresurs. Båda länktyperna är enkelriktade länkar. Om du vill lägga till dessa länktyper använder du samma kontroller som beskrevs tidigare.

När du använder länktypen storyboard anger du en storyboard eller ett dokument som innehåller specifikationer för arbetsobjekt. Med den här länktypen kan ditt team komma åt den delade filen och 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:

  • Frågeredigeraren: Du kan använda frågeredigeraren för att skapa anpassade frågor som visar alla arbetsobjekt som är länkade till ett specifikt arbetsobjekt.
  • Arbetsförteckningar och tavlor: Arbetsförteckningarnas och tavlornas vyer visar relationerna mellan föräldra- och barnarbetsobjekt så att du snabbt kan se beroenden.
  • Dependency Tracker: 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 efter sin länktyp och varje grupp innehåller ett antal objekt.

    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.
  • Den sekundära uppsättningen är länkad till den primära uppsättningen.

Du kan inte söka efter arbetsobjekt i versioner, men du kan söka efter arbetsobjekt med externa länkar. Om du vill förfina sökningen lägger du till fler frågefilter.

För mer information, se Fråga arbetsobjekt efter länkar eller bilageantal.

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 förälder/barn eller någon annan länktyp. Du kan bara visa hierarkin på sidan Test>Testplaner. Mer information finns i Skapa testplaner och testpaket.

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

  1. Öppna arbetsobjektet.
  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 uppfyllde testkriterierna kanske du vill ta bort det från kompileringarna och versionerna.

För att ta bort arbetsobjektet från att delta i framtida byggen och versioner, ta bort länken till den senaste commit och pull-begäran.