Share via


Werkitems koppelen aan objecten

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Koppelingen naar werkitems zijn koppelingen tussen twee werkitems of een werkitem en een ander object. Koppelingen beschrijven de relatie tussen objecten. U kunt werkitemkoppelingen gebruiken om afhankelijkheden en gerelateerd werk voor tracering bij te houden, informatie te delen, complexe projecten te beheren die betrekking hebben op meerdere teams of producten, codewijzigingen, tests bij te houden en meer.

In dit artikel leert u hoe u de volgende taken uitvoert:

Vereisten

Vereiste Beschrijving
Projectbeheerder of Lid van inzender U moet als lid van de beveiligingsgroep Inzenders of Projectbeheerders aan een project worden toegevoegd.
Toegang tot belanghebbenden Als u werkitems wilt toevoegen of wijzigen, moet u toegang krijgen tot belanghebbenden of hoger. Gebruikers met belanghebbendentoegang voor openbare projecten hebben volledige toegang tot achterstands- en bordfuncties, zoals gebruikers met Basic-toegang . Voor meer informatie, zie Snelzoekgids toegang als belanghebbende.
Lid van inzender of perms toestaan op - Als u werkitems wilt weergeven of wijzigen, moet u de werkitems weergeven in dit knooppunt hebben en werkitems bewerken in dit knooppuntmachtigingen ingesteld op Toestaan. De groep Inzenders heeft standaard deze machtiging ingesteld op Toestaan. Zie Machtigingen en toegang instellen voor het bijhouden van werk voor meer informatie.
- Als u de integratieopties voor een klassieke release-pijplijn wilt configureren, moet u gemachtigd zijn om de release te bewerken.
- Als u werkitems wilt koppelen aan doorvoeringen en pull-aanvragen, moet u de werkitems bewerken in dit knooppunt hebben ingesteld op Toestaan voor het gebiedspad dat is toegewezen aan het werkitem. De groep Inzenders heeft standaard deze machtigingenset.
- Als u werkitems wilt weergeven, moet uw werkitems weergeven in dit knooppunt zijn ingesteld op Toestaan voor het gebiedspad dat is toegewezen aan het werkitem.
Gedefinieerde iteraties Als u het planningsvenster wilt gebruiken, moet uw teambeheerder iteratiepaden (sprint) definiëren en teamiteraties configureren.
Vereiste Beschrijving
Projectbeheerder of Lid van inzender U moet als lid van de beveiligingsgroep Inzenders of Projectbeheerders aan een project worden toegevoegd.
Toegang tot belanghebbenden Als u werkitems wilt toevoegen of wijzigen, moet u toegang krijgen tot belanghebbenden of hoger.
Lid van inzender of perms toestaan op - Als u werkitems wilt weergeven of wijzigen, moet u de werkitems weergeven in dit knooppunt hebben en werkitems bewerken in dit knooppuntmachtigingen ingesteld op Toestaan. De groep Inzenders heeft standaard deze machtiging ingesteld op Toestaan. Zie Machtigingen en toegang instellen voor het bijhouden van werk voor meer informatie.
- Als u de integratieopties voor een klassieke release-pijplijn wilt configureren, moet u gemachtigd zijn om de release te bewerken.
- Als u werkitems wilt koppelen aan doorvoeringen en pull-aanvragen, moet u de werkitems bewerken in dit knooppunt hebben ingesteld op Toestaan voor het gebiedspad dat is toegewezen aan het werkitem. De groep Inzenders heeft standaard deze machtigingenset.
- Als u werkitems wilt weergeven, moet uw werkitems weergeven in dit knooppunt zijn ingesteld op Toestaan voor het gebiedspad dat is toegewezen aan het werkitem.
Gedefinieerde iteraties Als u het planningsvenster wilt gebruiken, moet uw teambeheerder iteratiepaden (sprint) definiëren en teamiteraties configureren.
Vereiste Beschrijving
Projectbeheerder of Lid van inzender U moet als lid van de beveiligingsgroep Inzenders of Projectbeheerders aan een project worden toegevoegd.
Toegang tot belanghebbenden Als u werkitems wilt toevoegen of wijzigen, moet u toegang krijgen tot belanghebbenden of hoger.
Lid van inzender of perms toestaan op Als u werkitems wilt weergeven of wijzigen, moet u de werkitems weergeven in dit knooppunt hebben en werkitems bewerken in deze knooppuntmachtigingen ingesteld op Toestaan. De groep Inzenders heeft standaard deze machtiging ingesteld op Toestaan. Zie Machtigingen en toegang instellen voor het bijhouden van werk voor meer informatie.
Gedefinieerde iteraties Als u het planningsvenster wilt gebruiken, moet uw teambeheerder iteratiepaden (sprint) definiëren en teamiteraties configureren.

Met de volgende typen koppelingen kunt u de verschillende relaties tussen werkitems en andere objecten beheren.

Type koppeling Beschrijving
Hyperlink Een werkitem verbinden met een URL of netwerkshare
Type externe koppeling Een werkitem verbinden met een extern object, zoals een codeobject, build of wikipagina
Koppelingstype voor extern werk Hiermee worden werkitems verbonden die zijn gedefinieerd in verschillende organisaties
GitHub-koppelingstype Een werkitem verbinden met een doorvoer, probleem of pull-aanvraag voor een GitHub-opslagplaats
Type werkkoppeling Hiermee worden werkitems verbonden, waaronder het selecteren van werkitems voor testcasebeheer

Zie Koppelingstypen voor Werk voor meer informatie over koppelingstypen, waaronder bovenliggende/onderliggende typen, gerelateerde en voorafgaande taken.

Als u werkitems aan verschillende objecten wilt koppelen, voert u de volgende stappen uit.

  1. Open vanuit de webportal het werkitem waaruit u een koppeling wilt maken of maak een nieuw item.

  2. Selecteer het tabblad Koppelingen en selecteer vervolgens Koppeling naar.

  3. Selecteer in de vervolgkeuzelijst Koppelingstype het type koppeling dat u wilt maken.

  4. Typ of selecteer in het veld Koppelen aan het object waarnaar u een koppeling wilt maken. Afhankelijk van het koppelingstype kunt u de volgende objecten invoeren of selecteren.

  5. (Optioneel) Voer een opmerking in om de koppeling te beschrijven.

  6. Selecteer OK om de koppeling te maken.

Tip

Er zijn andere functies die u kunt gebruiken om koppelingen te koppelen of te wijzigen die gebruikmaken van het koppelingstype Bovenliggend/Onderliggend item. Sommige functies zijn afhankelijk van versie. Zie de gekoppelde artikelen voor meer informatie.

Voer de volgende stappen uit om een koppeling naar een ander gebruikersverhaal, episch, functie, bug, probleem of taak toe te voegen vanuit de webportal.

  1. Open het werkitem dat u wilt koppelen aan een ander werkitem.

  2. Selecteer in het werkitemformulier de sectie Gerelateerd werk .

  3. Selecteer Koppeling toevoegen en vervolgens Bestaand item.

  4. Selecteer in de vervolgkeuzelijst Koppelingstype het type koppeling dat u wilt maken, bijvoorbeeld Bovenliggend, Onderliggend, Onderliggend of Gerelateerd.

  5. Voer in het veld Werkitem de id in van het werkitem waarnaar u een koppeling wilt maken en selecteer VERVOLGENS OK.

    In het volgende voorbeeld wordt het koppelingstype Gerelateerd gebruikt om drie items te koppelen aan de bug met de id 400.

    Schermopname van het dialoogvenster Koppeling toevoegen, webportal, aan een bestaand werkitem.

    U kunt slechts één voor één koppelingen toevoegen. U kunt hun id's niet invoeren, gescheiden door komma's of spaties.

    Als u een koppeling wilt maken naar meerdere werkitems, voert u de id's in, gescheiden door komma's of spaties. Als u de id's niet weet of als u een koppeling wilt maken naar een item in een ander project, selecteert u Meer acties.

  6. (Optioneel) Als u werkt vanaf de pagina Queryresultaten , slaat u bulksgewijs de werkitems op die u hebt gewijzigd. Wanneer u vanuit een achterstand werkt, worden werkitems automatisch opgeslagen.

    Schermopname van de pagina Queryresultaten, sla bulksgewijs gewijzigde items op.

  1. Open vanuit de webportal een backlog - of queryresultatenpagina en selecteer de werkitems waaraan u een koppeling wilt toevoegen.

  2. Open het contextmenu ... van een van de geselecteerde werkitems, kies Koppeling toevoegen en kies vervolgens Bestaand item... of Nieuw item....

    In het volgende voorbeeld selecteert u meerdere opties in de productachterstand en kiest u Bestaand item....

    Schermopname van het contextmenu backlog, multiselectieitems in achterstand, contextmenu openen, koppeling toevoegen aan een bestaand werkitem kiezen.

  3. Selecteer in de vervolgkeuzelijst Koppelingstype het type koppeling dat u wilt maken, bijvoorbeeld Bovenliggend, Onderliggend of Gerelateerd.

  4. Voer in het veld Werkitem de id in van het werkitem waarnaar u een koppeling wilt maken en selecteer VERVOLGENS OK.

  1. Open uw werkitem in de webportal en selecteer Koppelingen.

  2. Selecteer De koppeling Meer acties>bewerken.

    Schermopname van het tabblad Koppelingen, open Meer acties, kies de optie Koppeling bewerken.

  3. Kies het koppelingstype dat u wilt wijzigen en selecteer Opslaan.

    Schermopname van het dialoogvenster Koppeling bewerken.

  4. Sla het werkitem op .

Volg de volgende stappen om een werkitem te koppelen aan een nieuw werkitem.

  1. Geef het koppelingstype, het type werkitem en de titel van het nieuwe werkitem op. Selecteer OK. Er wordt een werkitem geopend van het type dat u hebt geselecteerd.

    Schermopname van het dialoogvenster Koppeling toevoegen, Koppeling naar nieuw werkitem.

  2. Voer aanvullende informatie in en sla het werkitem op .

    Schermopname van het probleem met het nieuwe werkitem toegevoegd.

  3. (Optioneel) Als u werkt vanaf de pagina Queryresultaten, slaat u bulksgewijs de werkitems op die u hebt gewijzigd.

Organisaties die gebruikmaken van Microsoft Entra ID kunnen een koppeling maken naar werkitems die in verschillende projecten in verschillende organisaties bestaan. Gebruik de volgende koppelingstypen zoals aangegeven:

  • Gebruik de koppelingstypen Verbruiken van of Produceert voor wanneer u afhankelijkheden wilt bijhouden van werkitems die zijn gedefinieerd in verschillende organisaties en worden beheerd door verschillende teams.
  • Gebruik het koppelingstype Externe gerelateerde gegevens wanneer de werkitems die worden gekoppeld, worden gedefinieerd in verschillende organisaties en worden beheerd door verschillende teams, maar geen sterke onderlinge afhankelijkheden hebben.

Schermopname van het formulier Gebruikersverhaal, tabblad Koppeling, met twee externe koppelingen.

Voer de volgende stappen uit om werkitems te koppelen aan objecten die zijn gedefinieerd in andere Azure DevOps-organisaties. U kunt dit alleen doen als beide organisaties dezelfde Microsoft Entra-id gebruiken om gebruikers te beheren.

  1. Kies een van de volgende typen externe koppelingen:

    • Verbruikt van of produceert voor: wanneer u afhankelijkheden wilt bijhouden van werkitems die zijn gedefinieerd in verschillende organisaties en worden beheerd door verschillende teams.
    • Extern gerelateerd: wanneer de werkitems die worden gekoppeld, worden gedefinieerd in verschillende organisaties en worden beheerd door verschillende teams, maar geen sterke onderlinge afhankelijkheden hebben.
  2. Selecteer in het dialoogvenster Koppeling toevoegen het koppelingstype, voer de URL van het externe werkitem in en selecteer VERVOLGENS OK.

    In het volgende voorbeeld wordt het koppelingstype Externe gerelateerde koppeling gebruikt om te koppelen aan werkitem-id 350 die bestaat in de remotelinkingtest2-organisatie , RemoteLinking-project .

    Schermopname van het verwijderen van een koppeling naar een werkitem.

Op het koppelingstabblad wordt het aantal koppelingen naar het werkitem bijgehouden. Het veld Aantal externe koppelingen houdt een telling bij van het aantal koppelingen dat is toegevoegd aan een werkitem dat is gekoppeld aan een werkitem dat is gedefinieerd in een ander project of een andere organisatie.

In het volgende voorbeeld ziet u twee externe koppelingen, aangegeven door het cloudpictogram, toegevoegd aan een gebruikersverhaal.

Schermopname van het formulier Gebruikersverhaal, tabblad Koppeling, met twee externe koppelingen.

  1. Voer in de beschrijving van uw pull-aanvraag in # om de #ID werkitemkiezer te activeren. In een lijst worden 50 werkitems weergegeven die u onlangs hebt gewijzigd of aan u zijn toegewezen.

    Schermopname van de lijst met werkitems die wordt geproduceerd bij het invoeren van het symbool # in de beschrijving van de pull-aanvraag.

  2. Als u de lijst met voorgestelde werkitems wilt beperken, voert u maximaal vijf trefwoorden in die overeenkomen met het type, id of titel van het werkitem.

    Schermopname van het invoeren van trefwoord na het symbool # en het resulterende werkitem in de zoekopdracht.

Zie Koppeling naar werkitems uit pull-aanvragen, doorvoeringen en opmerkingen voor meer informatie.

Wanneer u Azure Boards verbindt met GitHub-opslagplaatsen, kunt u werkitems koppelen aan een GitHub Commit-, GitHub-pull-aanvraag, GitHub-vertakking en GitHub-probleem. U kunt GitHub gebruiken voor softwareontwikkeling terwijl u Azure Boards gebruikt om uw werk te plannen en bij te houden.

Wanneer u Azure Boards verbindt met GitHub-opslagplaatsen, kunt u werkitems koppelen aan een GitHub Commit - en GitHub Pull-aanvraag. U kunt GitHub gebruiken voor softwareontwikkeling terwijl u Azure Boards gebruikt om uw werk te plannen en bij te houden.

Belangrijk

U kunt werkitems alleen koppelen aan GitHub-objecten met opslagplaatsen die zijn verbonden met Azure Boards. Zie Azure Boards verbinden met GitHub en koppelen aan werkitems vanuit pull-aanvragen, doorvoeringen en opmerkingen voor meer informatie.

Zie GitHub-doorvoeringen, pull-aanvragen, vertakkingen en problemen met werkitems koppelen en werkitems automatisch voltooien met pull-aanvragen voor meer informatie.

Selecteer op een pagina met backlog- of queryresultaten de werkitems die u wilt koppelen aan een nieuwe Git-vertakking, kies het actiepictogram en vervolgens Nieuwe vertakking.... Zie Werkitems koppelen aan Git-ontwikkelobjecten voor meer informatie.

Schermopname van achterstand, contextmenu, kies Meerdere backlogitems koppelen aan een Git-vertakking.

Volg de volgende stappen om werkitems te koppelen aan bestaande builds. Deze builds kunnen zich in uw project of in andere projecten in uw organisatie of verzameling bevinden.

Notitie

Voor deze functie is installatie van azure DevOps Server 2020.1-update vereist. Zie Azure DevOps Server 2020 Update 1 RC1 Release Notes, Boards voor meer informatie.

  1. Selecteer Op het tabblad Koppelingen van een werkitem de optie Bestaand item toevoegen>.

  2. Kies in het dialoogvenster Koppeling toevoegen een van de buildkoppelingstypen: Build, Gevonden in build, Geïntegreerd in build. Geef het buildnummer op.

    Het buildnummer is een combinatie van de pijplijn en buildnaam. Als u het buildnummer niet weet, zoekt u het door het pictogram te kiezen.

    Schermopname van het dialoogvenster Koppeling toevoegen met het type Koppeling maken geselecteerd.

  3. Kies in het dialoogvenster Koppelings builds de parameters om uw zoekopdracht naar builds te filteren.

    Als u een koppeling wilt maken naar een build in een ander project, kiest u eerst het project waarvan u een koppeling wilt maken.

    U kunt bijvoorbeeld een buildnummer opgeven, een build-pijplijn of een buildresultaat selecteren, zoals Alles, Geslaagd, Gedeeltelijk geslaagd, Mislukt of Geannuleerd. Of kies met Alles geselecteerd voor Resultaat de optie Zoeken om de beschikbare builds weer te geven waaraan u een koppeling wilt maken.

    Schermopname van het dialoogvenster Builds zoeken met project geselecteerd en builds weergegeven.

  4. Kies de build in de lijst waaraan u een koppeling wilt maken en selecteer vervolgens OK.

  5. Selecteer OK in het dialoogvenster Koppeling toevoegen om de bewerking te voltooien.

    Schermopname van het dialoogvenster Koppeling toevoegen met buildnummer ingevoerd.

U kunt werkitems koppelen aan bestaande builds vanuit het dialoogvenster Koppeling toevoegen.

  1. Kies Op het tabblad Koppelingen van een werkitem de optie Bestaand item toevoegen>.

  2. Kies in het dialoogvenster Koppeling toevoegen een van de buildkoppelingstypen: Build, Gevonden in build, Geïntegreerd in build. Geef het buildnummer op.

    Het buildnummer is een combinatie van de pijplijn en buildnaam. Als u het buildnummer niet weet, zoekt u het door het pictogram te kiezen.

    Schermopname van het dialoogvenster Koppeling toevoegen met het type Koppeling maken geselecteerd.

  3. Kies in het dialoogvenster Koppelings builds de parameters om uw zoekopdracht naar builds te filteren.

    U kunt bijvoorbeeld een buildnummer opgeven, een build-pijplijn of een buildresultaat selecteren, zoals Alles, Geslaagd, Gedeeltelijk geslaagd, Mislukt of Geannuleerd. Of kies met Alles geselecteerd voor Resultaat de optie Zoeken om de beschikbare builds weer te geven waaraan u een koppeling wilt maken.

    Schermopname van het dialoogvenster Builds zoeken, koppeling naar een build binnen uw project.

  4. Kies de build in de lijst waaraan u een koppeling wilt maken en selecteer vervolgens OK.

  5. Kies OK in het dialoogvenster Koppeling toevoegen om de bewerking te voltooien.

    Schermopname van het dialoogvenster Koppeling toevoegen met buildnummer ingevoerd.

Tijdens het ontwikkelen van uw software kunt u vastleggen welke codewijzigingen en builds de voltooiing van een werkitem ondersteunen. Uw team kan begrijpen wat er is gedaan of hoe een bug is opgelost via het audittrail met wijzigingen in de codebasis.

De koppelingstypen die worden gebruikt om deze koppelingen samen te stellen zijn: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item en Integrated in release environment. Deze typen worden weergegeven in de volgende afbeelding.

Conceptuele afbeelding van devops-koppelingstypen.

Tip

U wordt aangeraden de ontwikkeling van het werkitem te stimuleren op het moment dat u het maakt. U kunt ook de werkitem-id toevoegen wanneer u vertakkingen, doorvoeringen en pull-aanvragen maakt. Met Git kunt u werkitems koppelen aan doorvoeringen met behulp van het koppelingstype Doorvoeren . U kunt dit op de volgende manieren doen.

  • Voordat u uw wijzigingen doorvoert, voegt u werkitem-id's toe in Git Changes for Visual Studio 2022 of Team Explorer voor eerdere versies van Visual Studio:

    Schermopname van De id van het werkitem toevoegen of items slepen voordat u uw wijzigingen doorvoert.

  • Gebruik de opdracht git-commit en neem de werkitem-id op in uw opmerking. Pas deze opmerking #35 Catch null exception bijvoorbeeld toe op uw doorvoer. Wanneer u de doorvoer pusht, maakt het systeem een commit-koppeling tussen de doorvoer en het werkitem #35.

  • Gebruik het besturingselement Ontwikkeling voor Git-ontwikkeling vanuit het werkitem. Zie Drive Git-ontwikkeling vanuit een werkitem in Azure Boards voor meer informatie.

Zoals wordt weergegeven in de volgende afbeelding, geeft het besturingselement Implementatie release-informatie weer voor twee releasefasen. Het bevat werkitems die zijn gekoppeld aan een Git-doorvoer- of pull-aanvraag voor een release-pijplijn die is geconfigureerd voor integratie met Azure Boards.

Schermopname van meerdere omgevingen waarop de release is gericht.

Implementatiebeheer

Werkitemformulieren bieden twee besturingselementen om objecten weer te geven en naar ontwikkelobjecten te gaan. In dit artikel wordt het besturingselement Implementatie beschreven. Zie Git-ontwikkeling stimuleren vanuit een werkitem voor informatie over het besturingselement Ontwikkeling.

Standaard wordt het besturingselement Implementatie weergegeven op de werkitemformulieren voor werkitemformulieren voor werkitemtypen User Story (Agile), Productachterstanditem (Scrum), Probleem (Basic), Vereiste (CMMI), Functie, Epic, Bug, Taak en TestCase-werkitemtypen.

Aangepaste typen werkitems die gebruikmaken van het overgenomen proces, worden automatisch ingeschakeld. Het besturingselement Implementatie geeft de release-informatie weer voor twee fasen van de release-pijplijn die is geïntegreerd met Azure Boards.

Dit besturingselement toont alleen de werkitems die zijn gekoppeld aan een Git-doorvoer- of pull-aanvraag voor deze pijplijn. U kunt ook visueel inzicht krijgen in de status van een werkitem wanneer het wordt geïmplementeerd in verschillende releaseomgevingen. U kunt naar elke releasefase gaan en uitvoeren.

Schermopname van het werkitemformulier, het besturingselement Implementatie.

Werkitems die zijn gekoppeld aan doorvoeringen in de build, geven de status van de release weer. Alleen werkitems binnen hetzelfde project worden gekoppeld aan de locatie waar de release-pijplijn is gedefinieerd.

Schermopname van meerdere omgevingen waarop de release is gericht.

Wanneer u een werkitem opent, ziet u de fasen in realtime.

Schermopname van fasen voor release-instellingen, waaronder testen, fasering, productie en ontwikkeling.

Als u het besturingselement Implementatie wilt vullen, voert u de volgende stappen uit:

Notitie

Voor het implementatiebeheer is de configuratie van een klassieke release-pijplijn vereist. Het biedt geen ondersteuning voor het koppelen naar releasefasen die zijn gedefinieerd voor een YAML-pijplijn.

  1. Definieer een klassieke release-pijplijn en stel de releasefasen in. Zie De pijplijn voor continue implementatie (CD) met meerdere fasen definiëren voor meer informatie.

  2. Configureer de pijplijn. Zie Pijplijnen configureren ter ondersteuning van werktracking, de implementatiestatus rapporteren aan borden voor meer informatie.

  3. Koppel werkitems aan een doorvoer- of pull-aanvraag in de Git-opslagplaats van Azure-opslagplaatsen. Zie voor meer informatie:

  4. Voer de pijplijn uit.

Met Versiebeheer van Team Foundation (TFVC) kunt u werkitems koppelen aan wijzigingensets voor versiebeheer of versiebeheerbestanden met behulp van de koppelingstypen Wijzigingenset en Versiebeheeritem . Wanneer u in behandeling zijnde wijzigingen incheckt of Mijn werk gebruikt om wijzigingen in te checken, worden werkitems automatisch gekoppeld aan uw wijzigingen. Zie Uw werk inchecken voor meer informatie.

Schermopname van Team Explorer, Mijn werk, Wijzigingen in behandeling, inchecken.

Testgerelateerde koppelingstypen koppelen werkitems voor testcasebeheer aan elkaar of aan andere werkitems. Vanuit de webportal of Microsoft Test Manager kunt u bekijken welke testcases zijn gedefinieerd voor een testpakket en welke testsuites zijn gedefinieerd voor een testplan. Deze objecten zijn niet aan elkaar gekoppeld via koppelingstypen.

U kunt werkitems koppelen aan testcases met behulp van de koppelingstypen Getest/Getest door . Gebruik dezelfde besturingselementen voor koppelingen die u gebruikt om werkitems te koppelen aan andere werkitems. Zie Werkitems koppelen.

In de volgende afbeelding ziet u de volledige set koppelingstypen die u kunt gebruiken met werkitemtypen voor testbeheer. De meeste koppelingen tussen testbeheerobjecten vinden plaats door een taak uit te voeren vanaf de testpagina's of Microsoft Test Manager.

Schermopname van koppelingstypen die worden gebruikt om testobjecten te koppelen.

Wanneer u bijvoorbeeld gedeelde stappen toevoegt aan een testcase, worden deze automatisch gekoppeld met behulp van de koppelingstypen Testcase/Gedeelde stappen . Zie Stappen voor delen tussen testcases voor meer informatie.

Schermopname van het formulier testwerkitem met stappen.

Schermopname van het dialoogvenster Gedeelde stappen invoegen.

Vanuit Test kunt u testplannen, testsuites en testcases toevoegen die zijn gekoppeld. U kunt ze niet toevoegen via een specifiek koppelingstype. Het testsysteem maakt en beheert de koppelingen van testresultaten om cases en testplannen te testen.

U kunt een hyperlink- of Storyboard-koppelingstype gebruiken om een werkitem te koppelen aan een website, netwerkshare of document op een netwerkshare. Beide koppelingstypen zijn koppelingen in één richting. Als u deze koppelingstypen wilt toevoegen, gebruikt u dezelfde besturingselementen die eerder zijn beschreven. Zie Werkitems koppelen.

Wanneer u het koppelingstype storyboard gebruikt, moet u de koppeling onderscheiden om een storyboard of document op te geven dat specificaties voor werkitems biedt. Gebruik dit koppelingstype om uw team toegang te geven tot het gedeelde bestand, waar ze hun opmerkingen kunnen toevoegen.

Schermopname van het koppelingstype Hyperlink of Storyboard om een werkitem te koppelen aan een URL.

Azure DevOps biedt verschillende manieren om afhankelijkheden weer te geven en gerelateerd werk bij te houden:

  • Power Query-editor: U kunt de Power Query-editor gebruiken om aangepaste query's te maken waarmee alle werkitems worden weergegeven die zijn gekoppeld aan een specifiek werkitem.
  • Achterstanden en borden: in de weergaven Backlogs en Boards worden relaties tussen werkitems tussen werkitems weergegeven, zodat u in één oogopslag afhankelijkheden kunt zien.
  • Dependency Tracker: De Dependency Tracker is een Power BI-rapport dat een visuele weergave van afhankelijkheden tussen werkitems biedt.

Als u de lijst met alle objecten wilt weergeven die zijn gekoppeld aan een werkitem, voert u de volgende stappen uit.

  1. Open het werkitem en selecteer Koppelingen. Het tabblad Koppelingen geeft het aantal gekoppelde objecten aan. Gekoppelde objecten worden gegroepeerd onder het koppelingstype, met een telling binnen elke groep.

    Schermopname van het tabblad Koppelingen met het aantal gekoppelde objecten.

  2. (Optioneel) Vouw elke groep uit of samen en sorteer binnen elke groep op Status, Laatste update of Opmerking door de bijbehorende kolomtitel te kiezen.

Op het volgende tabblad Koppelingen ziet u bijvoorbeeld een gedeelte van de 64 gekoppelde objecten voor een werkitem.

Schermopname van het tabblad Koppelingen met veel gekoppelde objecten.

Koppelingen met het uitroepteken geven aan dat het build-, release- of ander object wordt verwijderd. Vanwege bewaarbeleid worden deze objecten na een bepaalde periode automatisch verwijderd.

Query uitvoeren op gekoppelde werkitems

Als u items wilt filteren op basis van hiërarchische koppelingen, gebruikt u het querytype Structuur van werkitems . Als u items wilt filteren op basis van alle koppelingstypen, gebruikt u Werkitems en directe koppelingen.

Als u werkitems wilt zoeken die zijn gekoppeld aan andere werkitems met specifieke koppelingstypen, gebruikt u een query met een primaire en een secundaire set werkitems. De primaire set voldoet aan de veldcriteria en de secundaire set is gekoppeld aan de primaire set. U kunt geen query's uitvoeren op werkitems in releases. U kunt query's uitvoeren op werkitems met externe koppelingen. Als u uw zoekopdracht wilt verfijnen, voegt u meer queryfilters toe.

Zie Voor queryvoorbeelden querywerkitems op koppeling of aantal bijlagen.

U kunt geen query maken waarin een hiërarchische weergave van testplannen, testsuites en testcases wordt weergegeven. Deze items worden niet aan elkaar gekoppeld met behulp van bovenliggend/onderliggend/onderliggend item of een ander koppelingstype. U kunt de hiërarchie alleen bekijken via de pagina Testplannen>. Zie Testplannen en testsuites maken voor meer informatie.

U kunt details van koppelingen naar een werkitem toevoegen, verwijderen en weergeven met de opdracht az boards work-item relation . Zie Aan de slag met Azure DevOps CLI voor meer informatie.

Koppelingstypen zijn werkkoppelingstypen, typen externe koppelingen, hyperlinks en bijgevoegde bestanden. Voer de opdracht az boards work-item relation list-type uit voor een lijst met alle koppelingstypen die u kunt opgeven.

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

In de volgende voorbeelden is de organisatie fabrikam en komt de project-id overeen met aaaaaaaa-0000-1111-2222-bbbbbbbbbb. De tabelindeling wordt gebruikt om de uitvoer weer te geven. Zie Uitvoerindelingen voor Azure CLI-opdrachten voor andere indelingen.

Als u een of meer werkitems wilt koppelen aan één werkitem, voert u de opdracht az boards work-item relation add in .

Vereiste parameters bevatten de id van het werkitem waaraan u een koppeling wilt maken en het koppelingstype. Ondersteunde koppelingstypen zijn bovenliggend, onderliggend, gerelateerd en extern gerelateerd. Voer voor een lijst met alle koppelingstypen de opdracht az boards work-item relation list-type uit.

Voor werkitems die binnen dezelfde organisatie zijn gedefinieerd, moet u de id van het werkitem of de doel-URL opgeven. Geef de doel-URL op voor werkitems die zijn gedefinieerd in een externe organisatie. U kunt meerdere waarden opgeven door id's of URL's te scheiden met een komma.

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

De volgende opdracht koppelt werkitem-id =2807 aan werkitem-id =2794 met het koppelingstype Onderliggend item. De opdracht retourneert een lijst met alle koppelingen die momenteel zijn gedefinieerd voor het werkitem.

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

Als u de informatie voor de gekoppelde werkitems wilt weergeven, voert u een van de URL's in die in uw browser worden vermeld.

Als u een of meer gekoppelde werkitems uit één werkitem wilt verwijderen, voert u de opdracht az boards work-item relation remove in.

Vereiste parameters bevatten de id van het werkitem waaruit de koppeling en het koppelingstype moeten worden verwijderd. U kunt alleen koppelingen verwijderen naar werkitems die zijn gedefinieerd in dezelfde organisatie. U kunt een van de ondersteunde koppelingstypen opgeven, behalve typen externe koppelingen.

U moet de doelwerkitem-id opgeven. U kunt meerdere waarden opgeven door id's of URL's te scheiden met een komma.

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

Met de volgende opdracht verwijdert u de koppeling naar werkitem-id =2794 uit werkitem-id =2856 om te werken met het koppelingstype Onderliggend item. De opdracht retourneert een lijst met alle koppelingen die momenteel zijn gedefinieerd voor het werkitem.

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 

Als u de informatie voor de gekoppelde werkitems wilt weergeven, voert u een van de URL's in die in uw browser worden vermeld.

Als u de werkitems wilt weergeven die aan één werkitem zijn gekoppeld, voert u de opdracht az boards work-item relation show in . Voor een lijst met alle koppelingstypen die kunnen worden geretourneerd, voert u de opdracht az boards work-item relation list-type uit.

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

De volgende opdracht bevat de details van koppelingen die zijn gedefinieerd voor werkitem-id =2931 in de fabrikam-organisatie in tabelindeling.

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

Als u de informatie voor de gekoppelde werkitems wilt weergeven, voert u een van de URL's in die in uw browser worden vermeld. Kies de URL voor een bijgevoegd bestand om de bijlage te downloaden.

Volg de volgende stappen om een koppeling naar een werkitem te verwijderen.

  1. Open het werkitem met koppelingen of selecteer het in een queryresultaat.
  2. Selecteer het tabblad Koppelingen om de lijst met koppelingen weer te geven.
  3. Selecteer de koppeling die u wilt verwijderen en selecteer vervolgens Koppeling verwijderen.
  4. Bevestig dat u de koppeling wilt verwijderen.

Nadat een werkitem is gekoppeld aan een doorvoer- of pull-aanvraag, wordt het nog steeds weergegeven als onderdeel van de releasefasen. Als u bijvoorbeeld een werkitem hebt dat niet voldoet aan testcriteria, kunt u dit verwijderen uit de builds en releases.

Als u het werkitem wilt verwijderen uit toekomstige builds en releases, verwijdert u de koppeling naar de meest recente doorvoer- en pull-aanvraag.

Gerelateerd werk en andere objecten visualiseren. Download de visualisatie-extensie voor werkitems, beschikbaar via visual Studio Marketplace, het tabblad Azure DevOps.