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

Vereisten

Categorie Eisen
projecttoegang Projectlid.
machtigingen - Lid van de Inzenders of projectbeheerders beveiligingsgroep.
- Werkitems weergeven of wijzigen: Werkitems weergeven in dit knooppunt en Werkitems bewerken in dit knooppunt machtigingen 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.
- Voor het configureren van de integratieopties voor een klassieke release-pijplijn: machtigingen voor de release bewerken.
- Om werkitems te koppelen aan commits en pull-aanvragen: Werkitems bewerken in dit knooppunt machtigingen ingesteld op Toestaan voor de Area Path die aan het werkitem is toegewezen. De groep Inzenders heeft standaard deze machtiging.
- Werkitems weergeven: Werkitems weergeven in dit knooppunt machtigingen ingesteld op toestaan voor het gebiedspad dat is toegewezen aan het werkitem.
Toegangsniveaus Werkitems toevoegen of wijzigen: ten minste belanghebbende toegang. Gebruikers met Stakeholder-toegang voor openbare projecten hebben volledige toegang tot de werkachterstand- en bordfuncties, zoals gebruikers met Basic-toegang. Voor meer informatie, zie Snelzoekgids toegang als belanghebbende.
gedefinieerde iteraties Als u het deelvenster Planning wilt gebruiken, uw teambeheerder iteratiepaden (sprint) en geconfigureerde teamiteraties.
Categorie Eisen
projecttoegang projectlid.
Machtigingen - Lid van de Inzenders of projectbeheerders beveiligingsgroep.
- Werkitems weergeven of wijzigen: Werkitems weergeven in dit knooppunt en Werkitems bewerken in dit knooppunt machtigingen 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.
- Voor het configureren van de integratieopties voor een klassieke release-pijplijn: machtigingen voor de release bewerken.
- Om werkitems aan commits en pull-aanvragen te koppelen: Bewerk werkitems in deze knoop met machtigingen ingesteld op Toestaan voor het Area Path dat aan het werkitem is toegewezen. De groep Inzenders heeft standaard deze machtiging.
- Om werkitems te bekijken: Bekijk werkitems in dit knooppunt machtigingen ingesteld op Toestaan voor het gebiedspad dat is toegewezen aan het werkitem.
Toegangsniveaus Werkitems toevoegen of wijzigen: minimaal Stakeholder toegang. Gebruikers met Stakeholder-toegang voor openbare projecten hebben volledige toegang tot backlog- en bordfuncties, zoals gebruikers met Basic-toegang. Voor meer informatie, zie Snelzoekgids toegang als belanghebbende.
gedefinieerde iteraties Als u het deelvenster Planning wilt gebruiken, uw teambeheerder iteratiepaden (sprint) en geconfigureerde teamiteraties.
Categorie Eisen
projecttoegang projectlid.
machtigingen - Lid van de Inzenders of projectbeheerders beveiligingsgroep.
- Werkitems weergeven of wijzigen: Werkitems weergeven in dit knooppunt en Werkitems bewerken in dit knooppunt machtigingen 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.
Toegangsniveaus - Werkitems toevoegen of wijzigen: ten minste belanghebbende toegang.
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.

Categorie voor koppelingstypen Beschrijving
versie Hiermee wordt een werkitem gekoppeld aan een buildnummer, gevonden in build of geïntegreerd in build.
Code Hiermee wordt een werkitem verbonden met een vertakking, wijzigingenset, doorvoer, pull-aanvraag, tag of versie-item.
GitHub Hiermee wordt een werkitem verbonden met een GitHub-opslagplaatsbranch, commit, probleem of pull request.
werken op afstand Hiermee verbindt u een werkitem dat is gedefinieerd in een andere organisatie die gebruikmaakt van, produceert voor of extern is gerelateerd via DE URL.
vereiste Verbindt een werkitem met een storyboard via URL.
Test Hiermee wordt een werkitem verbonden met een testbijlage of -resultaat.
Wiki Hiermee wordt een werkitem verbonden met een wikipagina.
Werk Verbindt een werkitem met verschillende aspecten van uw werk, waaronder:
- Beïnvloed door
-Beïnvloedt
-Kind
-Duplicaat
- Duplicaat van
-Hyperlink
- Geïntegreerd in de releasefase
- Ouder
- Voorganger
- Waarnaar wordt verwezen door
-Verwijzingen
-Aanverwant
- Gedeelde stappen
-Opvolger
- Testgeval
- Getest door:
- Tests

Zie Werkkoppelingstypenvoor meer informatie over typen werkkoppelingen, waaronder ouder-kindtypen, gerelateerde typen en voorganger-opvolger typen.

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

  1. Meld u aan bij uw organisatie (https://dev.azure.com/{Your_Organization}).

  2. Open het bestaande werkitem waaruit u een koppeling wilt maken of maak een nieuw werkitem.

  3. Selecteer Koppelingen>Koppeling toevoegenen selecteer vervolgens Bestaand item of Nieuw item.

    Schermafbeeldingsvolgorde om een koppeling naar een nieuw of bestaand item toe te voegen aan een werkitem.

  4. Selecteer in de vervolgkeuzelijst Koppelingstype het koppelingstype dat u wilt maken.

  5. Typ of selecteer in het volgende veld het object waarnaar u een koppeling wilt maken.

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

  7. Selecteer Koppeling toevoegen om de koppeling te maken.

Raadpleeg de volgende secties voor specifiekere instructies voor het koppelen van verschillende typen werkitems.

Tip

U kunt andere functies gebruiken om koppelingen te maken of te wijzigen die gebruikmaken van het bovenliggende/onderliggende koppelingstype. Sommige functies zijn afhankelijk van versie. Zie de volgende artikelen voor meer informatie:

Voer de volgende stappen uit om een koppeling naar een ander werkitem toe te voegen in de webportal:

  1. Open het werkitem waaruit u een koppeling wilt maken.

  2. In het werkitemformulier kunt u kiezen uit twee manieren om deze taak uit te voeren:

    • Ga naar de sectie Gerelateerd werk en selecteer Koppeling toevoegen>bestaand item.
    • Selecteer Koppelingen>Koppeling toevoegen>Bestaand item.

    Schermopname toont de gemarkeerde knoppenreeks om een koppeling naar een bestaand werkitem toe te voegen vanaf het tabblad Koppelingen.

  3. Selecteer in de vervolgkeuzelijst Koppelingstype het koppelingstype dat u wilt maken, bijvoorbeeld onderliggende, bovenliggendeof gerelateerde.

  4. Voer in het veld Werkitems om te koppelen de ID in van het werkitem waarnaar u een koppeling wilt maken, of selecteer een item uit de vervolgkeuzelijst, en klik daarna op Koppeling toevoegen.

    In het volgende voorbeeld wordt het koppelingstype related gebruikt voor een testcase met als id 280.

    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.

  1. Open vanuit de webportal een backlog of queryresultatenpagina.

  2. Selecteer (highlight) de werkitems om een koppeling toe te voegen.

  3. Selecteer Meer acties voor de geselecteerde werkitems, selecteer Koppeling toevoegenen kies vervolgens Koppeling naar een bestaand item... of Koppelen aan een nieuw werkitem....

    In het volgende voorbeeld selecteren we meerdere items in de productachterstandslijst en kiezen we Koppeling naar een bestaand item....

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

  4. Selecteer in de vervolgkeuzelijst Koppelingstype, bijvoorbeeld Bovenliggende, Onderliggendeof Gerelateerde.

  5. Voer in het veld Werkitem de id in van het werkitem waarnaar u een koppeling wilt maken en selecteer vervolgens Koppeling toevoegen.

  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.

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

  1. Selecteer in uw werkitem Koppelingen>Koppeling toevoegen>Nieuw item.

    Schermafbeeldingsvolgorde om een koppeling naar een nieuw of bestaand item toe te voegen aan een werkitem.

  2. Geef het koppelingstype en werkitemtypeop, en voer een titel in voor het nieuwe werkitem en optionele opmerking. Selecteer Koppeling toevoegen.

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

    Het nieuwe werkitem wordt geopend.

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

    Schermopname van het probleem met het nieuwe werkitem toegevoegd.

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. Selecteer in uw werkitem Koppelingen>Link toevoegen>Bestaand item.

    Schermopname toont een reeks om een koppeling toe te voegen aan een nieuw gemaakt werkitem.

  2. Kies een van de volgende typen externe koppelingen in de vervolgkeuzelijst Koppelingstype:

    • 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.
  3. Voer de URL van het externe werkitem in en selecteer Koppeling toevoegen.

    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 externekoppelingen 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 Branch-, GitHub Commit, GitHub Issueen GitHub Pull Request. 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.

  1. Selecteer op een pagina met backlog- of queryresultaten de werkitems die u wilt linken aan een nieuwe Git-tak.

  2. Selecteer het pictogram acties en Nieuwe vertakking.... Zie Werkitems koppelen aan Git-ontwikkelobjectenvoor 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 in uw werkitem Koppelingen>Link toevoegen>Bestaand item.

  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, klik op Vind builds.

    Schermopname toont de gemarkeerde knop Zoeken naar builds.

  3. Kies 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. Als Geslaagd geselecteerd voor Resultaat, selecteert u zoek builds om de beschikbare builds weer te geven waarnaar u een koppeling kunt maken.

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

  4. Kies de build in de lijst waarnaar u een koppeling wilt maken en selecteer vervolgens Bevestigen.

  5. Selecteer 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

De ontwikkeling van het werkitem stimuleren wanneer u het maakt. U kunt ook de werkitem-id toevoegen bij het maken van vertakkingen, commits en pull requests. Met Git kunt u werkitems koppelen aan commits met behulp van het koppelingstype Commit. Dit zijn de manieren om dit te doen:

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

    schermopname van het toevoegen van de werkitem-id of het slepen van items voordat u 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 de Development controle voor Git-ontwikkeling vanaf 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

Het implementatiebeheer biedt verschillende functies om u te helpen de releasestatus van werkitems te beheren en bij te houden. De volgende lijst bevat een overzicht van de volgende functies:

  • standaardweergave: De regelknop Implementatie wordt standaard weergegeven op de werkitemformulieren voor User Story (Agile), Productachterstanditem (Scrum), Probleemrapport (Basic), Vereisten (CMMI), Functie, Epic, Bug, Taak en Test Case.

  • Aangepaste typen werkitems: Aangepaste typen werkitems die gebruikmaken van het geërfde proces worden automatisch ingeschakeld.

  • Release-informatie: Het besturingselement Implementatie toont de releasegegevens voor twee fasen van de release-pijplijn die is geïntegreerd met Azure Boards.

  • Gekoppelde werkitems: Dit besturingselement toont alleen de werkitems die zijn gekoppeld aan een Git-doorvoer- of pull-aanvraag voor deze pijplijn.

  • nl-NL: Visueel Inzicht: Krijg visueel inzicht in de status van een werkitem terwijl het wordt uitgevoerd in verschillende releaseomgevingen en navigeer snel naar elke releasefase en uitvoering.

    Schermopname van het werkitemformulier, het besturingselement Implementatie.

  • Doorvoerkoppelingen: Werkitems die zijn gekoppeld aan doorvoeringen in de build, geven de status van de release weer.

  • projectbereik: 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.

  • Zichtbaarheid van fase: Wanneer u een werkitem opent, kunt u de fasen in realtime zien.

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

Om het controle-element Implementatie op te 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 releasepipeline en stel de releasefasen in zoals beschreven in Definieer uw multistage continuous deployment (CD) pipeline.

  2. Configureer de pijplijn.

  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 Team Foundation Version Control (TFVC) kunt u werkitems koppelen aan wijzigingensets voor versiebeheer of broncodebestanden met behulp van de Changeset en Versiebeheeritem koppelingstypen. 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 testsuite 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.

In de sectie Test kunt u testplannen, testsuites en testcases toevoegen die automatisch worden gekoppeld. U kunt deze items 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, netwerklocatie of document op een netwerklocatie. Beide koppelingstypen zijn eenrichtingskoppelingen. Als u deze koppelingstypen wilt toevoegen, gebruikt u dezelfde besturingselementen die eerder zijn beschreven. Zie Werkitems koppelen.

Wanneer u het koppelingstype storyboard gebruikt, geeft u een storyboard of document op dat specificaties voor werkitems biedt. Met dit koppelingstype kan uw team toegang krijgen tot het gedeelde bestand en hun opmerkingen 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:

  • Query-editor: u kunt de Query-editor gebruiken om aangepaste query's te maken waarmee alle werkitems worden weergegeven die zijn gekoppeld aan een specifiek werkitem.
  • Backlogs en Boards: In de weergaven Backlogs en Boards worden bovenliggende en onderliggende relaties tussen werkitems weergegeven, zodat je in één oogopslag afhankelijkheden kunt zien.
  • Dependency Tracker: De afhankelijkheidstracker 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.
  • De secundaire set is gekoppeld aan de primaire set.

U kunt geen query's uitvoeren op werkitems in releases, maar u kunt wel query's uitvoeren op werkitems met externe koppelingen. Voeg meer queryfilters toe om uw zoekopdracht te verfijnen.

Voor meer informatie, zie Query werkitems 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.
  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.