Delen via


Referentiehandleiding voor koppelingstypen

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

U kunt verschillende koppelingstypen gebruiken om de verschillende relaties tussen werkitems en andere artefacten te beheren, zoals builds, doorvoeringen, pull-aanvragen en meer. In dit artikel beschrijven we de volgende koppelingstypen.

  • Werkkoppelingstype: Werkitems koppelen, waaronder werkitems voor testcasebeheer selecteren
  • Hyperlink: Verbinding maken een werkitem naar een URL of netwerkshare
  • Type externe koppeling: Verbinding maken een werkitem aan een extern object, zoals een codeobject, build of wikipagina
  • Koppelingstype voor extern werk: Verbinding maken s werkitems die zijn gedefinieerd in verschillende organisaties
  • GitHub-koppelingstype: Verbinding maken een werkitem doorvoering, probleem of pull-aanvraag voor een GitHub-opslagplaats.

Een specifiek veld onderhoudt een aantal koppelingen voor de eerste vier koppelingstypen, zoals Aantal gerelateerde koppelingen, Hyperlinktelling, Aantal externe koppelingen en Aantal externe koppelingen.

  • Type werkkoppeling: koppelingen naar werkitems, waaronder werkitems voor testcasebeheer
  • 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
  • GitHub-koppelingstype: verbindt een werkitem met een doorvoer- of pull-aanvraag voor een GitHub-opslagplaats.

Een specifiek veld onderhoudt een aantal koppelingen voor de eerste drie koppelingstypen, zoals Aantal gerelateerde koppelingen, Aantal hyperlinks en Aantal externe koppelingen.

Koppelingstypen zijn onderhevig aan bepaalde beperkingen op basis van hun topologie. Gebruik de richtlijnen in de volgende tabellen om te kiezen welk koppelingstype u wilt gebruiken op basis van de typen query's en rapporten die u wilt maken. Zie Koppelingstypetopologieën en -beperkingen voor meer informatie over de verschillende topologieën.

Werkkoppelingstypen zijn door het systeem gedefinieerd, procesgedefinieerde of door de gebruiker gedefinieerd (aangepast). De koppelingen in de volgende tabel zijn door het systeem gedefinieerd.

Elk type werkkoppeling definieert de koppelingslabels, het topologietype en de beperkingen die worden gebruikt wanneer koppelingen tussen werkitems worden samengesteld. Het koppelingstype bovenliggend en onderliggend element definieert bijvoorbeeld twee labels: Bovenliggend en Onderliggend. Het koppelingstype ondersteunt ook een hiërarchische of boomtopologie en voorkomt dat kringverwijzingen tussen werkitems worden gemaakt.

Conceptuele afbeelding van een koppelingstype Werkitem.

Het aantal gerelateerde koppelingen van een werkitem komt overeen met de som van alle koppelingen die zijn gedefinieerd met een werkkoppelingstype.

In de volgende tabel worden de typen werkitemkoppelingen beschreven die u kunt opgeven om een besturingselement voor koppelingen te bepalen met behulp van het XML-element WorkItemLinksFilter.

Naam

Verwijzingsnaam

Gebruik


Beïnvloed door (alleen CMMI) Conceptuele afbeelding van het koppelingstype Beïnvloedt.Conceptuele afbeelding van beïnvloed door koppelingstype.

Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Topologietype: Afhankelijkheid
Koppelingscategorie: Procesgedefinieerde

Gebruik deze directionele koppeling om koppelingen te maken tussen een set werkitems, maar niet tussen items die gesloten lussen zouden maken. Doorgaans gebruikt voor het bijhouden van wijzigingsaanvragen die zijn aangebracht in vereisten.

Beperkingen en aanbevelingen:

  • U kunt een wijzigingsaanvraag koppelen aan slechts één vereiste met behulp van Invloed. U kunt vereisten koppelen aan zo veel onderliggende wijzigingsaanvragen als nodig is met behulp van Beïnvloed door.
  • Gebruik alleen Beïnvloed door koppelingen om werkitems in hetzelfde project te koppelen. We raden u aan deze actie uit te voeren als u van plan bent Om gegevens van werkitems te wijzigen of bij te werken.

Bovenliggend item
Conceptuele afbeelding van een onderliggend koppelingstype.
Conceptuele afbeelding van een bovenliggend koppelingstype.

System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Topologietype: Structuur
Koppelingscategorie: Door het systeem gedefinieerd

Gebruik deze directionele koppeling om een-op-veel-relaties te maken tussen één bovenliggend item en een of meer onderliggende items. Hiermee kunt u werkitems in een hiërarchie ordenen. U kunt deze hiërarchie snel maken tussen achterstallige items met behulp van de toewijzingsfunctie of tussen achterstallige items en taken met behulp van de sprintachterstand of Taskboard.

Typische toepassingen zijn onder andere:

  • Overzichtsrelaties voor taken onderhouden. Bovenliggende en onderliggende koppelingen worden gemaakt voor overzichtstaken en hun onderliggende taken.
  • Taken koppelen aan PBI's, gebruikersverhalen of vereisten. Biedt ondersteuning voor overzichtsoverzichten, verhalenoverzicht en overzichtsrapporten met vereisten.

Beperkingen en aanbevelingen:

  • Gebruik Excel om zowel werkitems als koppelingen tussen bovenliggende items bulksgewijs te bewerken. Zie Werkitems bulksgewijs toevoegen of wijzigen met Excel.
  • Een werkitem kan slechts één bovenliggend item hebben. Een bovenliggend werkitem kan veel onderliggende items hebben.
  • Gebruik alleen koppelingen tussen bovenliggende en onderliggende items om werkitems in hetzelfde project te koppelen. Deze actie wordt aanbevolen als u van plan bent Excel te gebruiken om werkitemgegevens te wijzigen of bij te werken.

Duplicaat vanConceptuele afbeelding van duplicaat van structuur voorwaarts.Conceptuele afbeelding van duplicaat van structuur omgekeerd.

System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Topologietype: Structuur
Koppelingscategorie: Door het systeem gedefinieerd

Gebruik deze directionele koppeling om een-op-veel-relaties te maken tussen één bovenliggend item en een of meer onderliggende items. Hiermee kunt u taken, bugs of andere werkitems bijhouden die duplicaten van elkaar zijn.

Beperkingen en aanbevelingen:

  • Een werkitem kan slechts één duplicaat hebben.
  • Gebruik alleen Dubbele of Dubbele koppelingen om werkitems in hetzelfde project te koppelen. Deze actie wordt aanbevolen als u van plan bent Excel te gebruiken om werkitemgegevens te wijzigen of bij te werken.

Waarnaar wordt verwezen door verwijzingen
Conceptuele afbeelding van Getest op koppelingstype.Conceptuele afbeelding van het koppelingstype Tests.

Microsoft.VSTS.TestCase.
SharedParameterReferencedBy
Topologietype: Afhankelijkheid
Koppelingscategorie: Procesgedefinieerde

Hiermee koppelt u testcases aan gedeelde parameters. Gebruik deze optie om testcases te koppelen aan gedeelde parameters ter ondersteuning van de mogelijkheid om een test met verschillende gegevens te herhalen. Over het algemeen zou u dit koppelingstype niet toevoegen aan een besturingselement voor bereikkoppelingen.

Gerelateerde
Conceptuele afbeelding van gerelateerd koppelingstype.

System.LinkTypes.Related
Topologietype: Netwerk
Koppelingscategorie: Door het systeem gedefinieerd

Gebruik deze niet-gerichte koppeling om koppelingen te maken tussen een set werkitems. Gebruik dit om werkitems te koppelen die zich op hetzelfde niveau bevinden, zoals twee gebruikersverhalen die functies definiëren die elkaar overlappen. Het koppelingstype Gerelateerd maakt eenvoudige relaties met enkele beperkingen.

  • Koppel werkitems die zich op hetzelfde niveau bevinden, zoals twee gebruikersverhalen die functies definiëren die elkaar overlappen.
  • Werkitems koppelen die zijn gedefinieerd in verschillende projecten en worden beheerd door verschillende teams.
  • Werkitems en de bijbehorende werkitems zoeken en weergeven in een weergave met twee lagen.
  • Maak eenvoudige relaties met enkele beperkingen.

Opvolgende voorafgaande taak
Conceptuele afbeelding van opvolgende afhankelijkheid, doorsturen.Conceptuele afbeelding van voorafgaande afhankelijkheid, omgekeerd.

System.LinkTypes.Dependency

Topologietype: Afhankelijkheid
Koppelingscategorie: Door het systeem gedefinieerd
Kies het koppelingstype Voorafgaande taak bij het koppelen aan een werkitem dat moet worden voltooid voordat het werkitem waaruit u een koppeling maakt. Kies het type opvolgende koppeling wanneer u een koppeling maakt naar een werkitem dat moet worden voltooid na het werkitem waaruit u een koppeling maakt.

Gebruik deze directionele koppeling om koppelingen te maken tussen een set werkitems, maar niet tussen items die gesloten lussen zouden maken. Gebruik dit om taken bij te houden die moeten worden voltooid voordat anderen kunnen worden gestart. Gekoppelde taken worden weergegeven als voorafgaande opvolgende koppelingen in Azure Boards.

  • Taken bijhouden die moeten worden voltooid voordat anderen kunnen worden gestart.
  • Ondersteunt een-op-veel-relaties.
  • Zoek en bekijk voorafgaande werkitems en de bijbehorende opvolgende werkitems in een queryweergave met twee lagen, directe koppelingen.

Beperkingen en aanbevelingen:

  • Er wordt een fout weergegeven wanneer u koppelingen probeert te maken die kringrelaties definiëren.
  • Maak voorafgaande opvolgende koppelingen alleen naar werkitems die zich binnen hetzelfde project bevinden. U kunt voorafgaande-opvolgende koppelingen maken tussen werkitems die in verschillende projecten zijn gedefinieerd. Maar als u een query naar Excel exporteert, worden alleen de werkitems die zijn gedefinieerd voor het project waarvoor de query is gedefinieerd, geïmporteerd.

Getest door tests
Conceptuele afbeelding van Getest op koppelingstype.Conceptuele afbeelding van het koppelingstype Tests.

Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Topologietype: Afhankelijkheid
Koppelingscategorie: Procesgedefinieerde

Koppel testcases aan werkitems, zoals bugs, gebruikersverhalen, vereisten en productachterstanditems. Gebruik dit om testcases bij te houden die gebruikersverhalen (Agile), productachterstanditems (Scrum) of vereisten (CMMI) testen. Kan ook een koppeling maken naar andere typen werkitems, zoals bugs, problemen of taken. Voor on-premises Azure DevOps zijn er verschillende SQL-rapporten die afhankelijk zijn van deze koppelingen. Zie Teamactiviteiten beoordelen ter ondersteuning van nuttige rapporten.

Gedeelde stappen voor testcases
Conceptuele afbeelding van Getest op koppelingstype.Conceptuele afbeelding van het koppelingstype Tests.

Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Topologietype: Afhankelijkheid
Koppelingscategorie: Procesgedefinieerde

Gebruik dit om testcases te koppelen aan gedeelde stappen. Deel stappen tussen testcases om te voorkomen dat er meerdere vermeldingen van dezelfde reeks stappen moeten worden gemaakt.

Een hyperlink kan een werkitem koppelen aan elke URL. Met het aantal hyperlinks wordt het aantal hyperlinks naar een werkitem bijgehouden.

Conceptuele afbeelding van een hyperlink.

Koppelingsnaam

Ondersteund hulpprogramma

Type artefact

Gebruik


Hyperlink

Werkitems bijhouden

Hyperlink

Wordt gebruikt om een werkitem te koppelen aan een URL. Hyperlink werkitem is de naam van dit koppelingstype in de API Voor artefactkoppelingen.

Externe koppelingstypen zijn door het systeem gedefinieerde koppelingstypen die ondersteuning bieden voor het koppelen van werkitems aan andere objecten die zijn opgeslagen in Azure DevOps, zoals wordt weergegeven in de volgende afbeelding. Het aantal externe koppelingen van een werkitem komt overeen met de som van alle koppelingen die zijn gedefinieerd met een extern koppelingstype.

Conceptuele afbeelding van het type externe koppeling.

Notitie

U kunt alleen een extern koppelingstype gebruiken om een koppeling te maken naar een Azure DevOps-object. Gebruik een hyperlink om werkitems te koppelen aan andere objecten buiten Azure DevOps.

In de volgende tabel worden de typen externe koppelingen beschreven die u kunt kiezen wanneer u een koppelingstype toevoegt vanuit een werkitem of testcase.

In de volgende tabel worden de typen externe koppelingen beschreven die u kunt kiezen bij het toevoegen van een koppelingstype uit een werkitem of testcase. U kunt ook een van deze koppelingstypen opgeven om een besturingselement voor koppelingen te bepalen met behulp van het XML-element ExternalLinksFilter.

Koppelingsnaam

Ondersteund hulpprogramma

Type artefact

Gebruik


Vertakking

Git

Vertakking

Wordt gebruikt om een werkitem te koppelen aan een vertakking.

Pijplijnen/bouwen

Compilatie

Compilatie

Wordt gebruikt om een werkitem te koppelen aan een build.

Wijzigingenset (of opgelost in de wijzigingenset)

Versioncontrol

Changeset

Wordt gebruikt om een werkitem te koppelen aan een wijzigingenset.

Doorvoeren (of opgelost in doorvoer)

Git

Doorvoeren

Wordt gebruikt om een werkitem te koppelen aan een doorvoering.

Gevonden in build

Pijplijnen/bouwen

Compilatie

Wordt gebruikt om een werkitem te koppelen aan een build.

Geïntegreerd in build

Compilatie

Build-pipeline

Wordt gebruikt om een werkitem te koppelen aan een build.

Geïntegreerd in releaseomgeving

Vrijgeven

Release-pijplijn

Wordt gebruikt om een release te koppelen aan een werkitem. Het systeem maakt een koppeling van dit type wanneer een gebruiker de optie Rapportimplementatie inschakelt voor een releasedefinitie.

Pull-aanvraag

Git

PullRequestId

Wordt gebruikt om een werkitem te koppelen aan een pull-aanvraag.

Resultaatbijlage

Testbeheer

TcmResultAttachment

Wordt gebruikt om een werkitem te koppelen aan een bijlage die is gekoppeld aan een testresultaat. Deze koppelingen worden weergegeven wanneer u een werkitem koppelt aan een testresultaat van Test of Microsoft Test Manager.

Broncodebestand<

Versioncontrol

LatestItemVersion

Wordt gebruikt om een werkitem te koppelen aan een bestand onder Team Foundation-versiebeheer (TFVC).

Storyboard

Vereisten

Storyboard

Wordt gebruikt om een werkitem te koppelen aan een PowerPoint-bestand of een ander bestand dat informatie over verhaalinvoer op een netwerk bevat.

Tag

Git

Tag

Wordt gebruikt om een werkitem te koppelen aan een tag die is gedefinieerd voor een Git-doorvoer of git-opslagplaats. Zie Work van de Git-opdrachtprompt voor meer informatie.

Testresultaat

Testbeheer

TcmResult

Wordt gebruikt om een werkitem te koppelen aan een testresultaat. Deze koppelingen worden weergegeven wanneer u een werkitem koppelt aan een testresultaat van Test of Microsoft Test Manager.

Versie-item

Versioncontrol

LatestItemVersion

Wordt gebruikt om een werkitem te koppelen aan een bestand of wijzigingenset die is gedefinieerd in een TFVC-opslagplaats. Broncodebestand is de naam van dit koppelingstype in de API Voor artefactkoppelingen.

Wiki

Wiki

Wiki

Wordt gebruikt om een werkitem te koppelen aan een wikipagina. Ondersteund voor TFS 2018.2 en nieuwere versies.

GitHub-koppelingstypen zijn door het systeem gedefinieerd en ondersteunen het koppelen van werkitems aan GitHub-objecten, zoals wordt weergegeven in de volgende afbeelding.

Conceptuele afbeelding van het type GitHub-koppeling.

Conceptuele afbeelding van het type GitHub-koppeling.

Belangrijk

U kunt alleen een koppeling maken naar GitHub-artefacten met opslagplaatsen die zijn verbonden met Azure Boards.

In de volgende tabel worden de GitHub-koppelingstypen beschreven die u kunt kiezen bij het toevoegen van een koppelingstype uit een werkitem.

Koppelingsnaam

Type artefact

Gebruik


GitHub Commit

Doorvoeren van GitHub-opslagplaats

Wordt gebruikt om een werkitem te koppelen aan een GitHub-doorvoering.

GitHub-probleem

Probleem met GitHub-opslagplaats

Wordt gebruikt om een werkitem te koppelen aan een GitHub-probleem.

GitHub-pull-aanvraag

Pull-aanvraag voor GitHub-opslagplaats

Wordt gebruikt om een werkitem te koppelen aan een GitHub-pull-aanvraag.

Koppelingstypen voor extern werk zijn door het systeem gedefinieerde koppelingstypen die ondersteuning bieden voor het koppelen van werkitems die in verschillende organisaties zijn gedefinieerd, zolang dezelfde Microsoft Entra-id deze beheert zoals beschreven in Verbinding maken uw organisatie aan Microsoft Entra-id.

Het aantal externe koppelingen van een werkitem komt overeen met de som van alle koppelingen die zijn gedefinieerd met een koppelingstype voor extern werk.

Naam

Verwijzingsnaam

Gebruik


Verbruikt van geproduceerd voor
(Topologie van afhankelijkheden) Conceptuele afbeelding van Consumes From topology.Conceptuele afbeelding van Geproduceerd voor topologie.

System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Topologietype: Afhankelijkheid
Koppelingscategorie: Door het systeem gedefinieerd

Gebruik deze directionele koppeling om koppelingen te maken tussen werkitems met afhankelijkheden en zijn gedefinieerd in verschillende organisaties, zolang dezelfde Microsoft Entra-id deze beheert. Doorgaans gebruikt voor het bijhouden van wijzigingsaanvragen die zijn aangebracht in vereisten.

Externe gerelateerde
Conceptuele afbeelding van externe gerelateerde topologie.

System.LinkTypes.Remote.Related
Topologietype: Netwerk
Koppelingscategorie: Door het systeem gedefinieerd

Gebruik deze niet-gerichte koppeling om koppelingen te maken tussen werkitems die in verschillende organisaties zijn gedefinieerd, mits dezelfde Microsoft Entra-id deze beheert.

U kunt een aangepast koppelingstype maken; definities van koppelingstypen exporteren en importeren; en verwijder, activeer, deactiveer en activeer de typen koppelingen opnieuw. Zie de volgende artikelen:

Als u een lijst met koppelingstypen wilt ophalen, kunt u een van de ondersteunde opdrachtregelprogramma's gebruiken.

az boards work-item relation list-type

U kunt koppelingstypen weergeven die door uw organisatie worden ondersteund met de opdracht az boards work-item relation list-type of de opdracht Work Item Relation Types - List REST API. Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

az boards work-item relation list-type [--org]

Optionele parameters

  • organisatie: URL van Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=ORG_URL. Vereist als deze niet is geconfigureerd als standaard of wordt opgehaald met behulp van git config. Voorbeeld: --org https://dev.azure.com/MyOrganizationName/.

Opmerking

De volgende opdracht bevat de koppelingstypen voor werkitems in tabelindeling die zijn gedefinieerd voor de fabrikam-organisatie.

az boards work-item relation list-type --org fabrikam --output table
Name                  ReferenceName                                                Enabled    Usage
--------------------  -----------------------------------------------------------  ---------  ------------
Produces For          System.LinkTypes.Remote.Dependency-Forward                   True       workItemLink
Consumes From         System.LinkTypes.Remote.Dependency-Reverse                   True       workItemLink
Duplicate             System.LinkTypes.Duplicate-Forward                           True       workItemLink
Duplicate Of          System.LinkTypes.Duplicate-Reverse                           True       workItemLink
Referenced By         Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward  True       workItemLink
References            Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse  True       workItemLink
Tested By             Microsoft.VSTS.Common.TestedBy-Forward                       True       workItemLink
Tests                 Microsoft.VSTS.Common.TestedBy-Reverse                       True       workItemLink
Test Case             Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward       True       workItemLink
Shared Steps          Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse       True       workItemLink
Successor             System.LinkTypes.Dependency-Forward                          True       workItemLink
Predecessor           System.LinkTypes.Dependency-Reverse                          True       workItemLink
Child                 System.LinkTypes.Hierarchy-Forward                           True       workItemLink
Parent                System.LinkTypes.Hierarchy-Reverse                           True       workItemLink
Related               System.LinkTypes.Related                                     True       workItemLink
Remote Related        System.LinkTypes.Remote.Related                              True       workItemLink
Attached File         AttachedFile                                                 True       resourceLink
Hyperlink             Hyperlink                                                    True       resourceLink
Artifact Link         ArtifactLink                                                 True       resourceLink

De standaard json-indeling bevat aanvullende informatie over de kenmerken die zijn gedefinieerd voor de koppelingstypen. De informatie voor de koppelingstypen Produceert voor en Verbruikt van wordt bijvoorbeeld als volgt weergegeven.

  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": true,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Produces For",
    "referenceName": "System.LinkTypes.Remote.Dependency-Forward",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
  },
  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": false,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Consumes From",
    "referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
  },

witadmin listlinktypes

U kunt koppelingstypen weergeven die worden ondersteund voor uw projectverzameling met behulp van het witadmin listlinktypes opdrachtregelprogramma of de werkitemrelatietypen - Rest API-opdracht vermelden.

Hier vermelden we de koppelingstypen voor de standaardverzameling fabrikam-sever:

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection

Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True

De volgende tabel bevat beschrijvingen voor elk van de kenmerken van het koppelingstype die worden geretourneerd door Azure Boards CLI of de REST API.

Kenmerk

Beschrijving


Names name

Hiermee geeft u de beschrijvende naam die is toegewezen aan de koppelingstypen. Directionele koppelingen worden in paren gedefinieerd en bevatten daarom een naam voor doorsturen en omgekeerd.

Verwijzingsnaam, referenceName

Hiermee geeft u de naam die is toegewezen aan het koppelingstype of koppelingstypepaar.

acyclic

Hiermee wordt aangegeven of het koppelingstypefalse kringrelaties toestaat of (true) beperkt of beperkt. Koppelingen van het structuurtype beperken bijvoorbeeld cirkelrelaties. Zie LinkTypes-elementen voor meer informatie.

directional

Geeft aan of het koppelingstype directioneel (true) of niet (false) is. Typen directionele koppelingen worden gedefinieerd in combinaties met een voorwaartse en omgekeerde component. Zie LinkTypes-elementen voor meer informatie.

editable

Geeft aan of het koppelingstype bewerkbaar is (true) of niet (false). U kunt alleen aangepaste koppelingstypen toevoegen en bewerken voor on-premises implementaties met het witadmin opdrachtregelprogramma Koppelingstype beheren. Systeemkoppelingstypen hebben editable=falsealtijd .

Is actief, enabled

Geeft aan of het koppelingstype actief (true) of niet (false) is. U kunt alleen aangepaste koppelingstypen gebruiken voor on-premises implementaties met het witadmin opdrachtregelprogramma Koppelingstype beheren.

isForward

Geeft aan of het koppelingstype de doorstuurkoppeling () of niet (trueFalse) binnen een koppelingstypepaar specificeert.

oppositeEndReferenceName

Hiermee geeft u de verwijzingsnaam op van het koppelingstype dat de koppeling in de tegenovergestelde richting van een koppelingstypepaar definieert.

remote

Hiermee wordt aangegeven of het koppelingstype ondersteuning biedt voor het koppelen van een extern werkitem (true) of niet (False). Voor koppelingstypen is remote=false vereist dat het doelwerkitem zich in dezelfde organisatie of verzameling bevindt als het oorspronkelijke werkitem.

singleTarget

Hiermee wordt aangegeven of het koppelingstype meer dan één doel (false) toestaat of beperkt is tot één doel (true).

topology

Hiermee geeft u het topologietype , afhankelijkheidsnetwerkstructuur, , and '. Zie Topologieën en beperkingen voor koppelingstypen voor beschrijvingen.

usage

Hiermee geeft u het gebruikstype op: resourceLink of workItemLink. De waarde van de workItemLink resourceLinkvalue indicates a link type that links two work items. Thegeeft een koppelingstype aan dat wordt gebruikt om een werkitem te koppelen aan een resource, zoals een URL of bijlage.

url

Geeft een lijst van de kenmerken van het koppelingstype in json-indeling.