Referenční příručka pro typy odkazů

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

Pomocí různých typů propojení můžete spravovat vztahy mezi pracovními položkami a dalšími artefakty, jako jsou sestavení, potvrzení a žádosti o přijetí změn. Tento článek popisuje následující typy odkazů.

• typ pracovního propojení: Propojení pracovních položek, včetně výběrových pracovních položek správy testovacích případů
• hypertextový odkaz: Připojí pracovní položku k libovolné adrese URL nebo sdílené síťové složce.
• typ externího odkazu: Připojí pracovní položku k externímu objektu, jako je objekt kódu, sestavení nebo stránka wikiwebu.
• typ propojení práce na dálku: Umožňuje připojit pracovní položky definované v různých organizacích.
• odkaz typu GitHub: Připojí pracovní položku k potvrzení, problému nebo pull requestu v úložišti GitHub.

Konkrétní pole udržuje počet odkazů pro první čtyři typy propojení, například Související počet odkazů, Počet hypertextových odkazů, Počet externích propojenía Počet vzdálenýchpropojení .

Typy propojení mají topologické omezení. Pokyny v následujících tabulkách vám pomůžou zvolit typ odkazu na základě dotazů a sestav, které chcete vytvořit. Další informace o topologiích naleznete v Link type topologies and restrictions.

Typ propojení práce

Typy pracovních propojení jsou definované systémem, definované procesem nebo uživatelem definované (vlastní). Odkazy uvedené v následující tabulce jsou definované systémem.

Každý typ pracovního propojení definuje popisky, topologii a omezení použitá při vytváření propojení mezi pracovními položkami. Například typ odkazu Nadřazený-Podřízený definuje dva popisky: Nadřazený a Podřízený. Typ vazby používá topologii stromu a zabraňuje cyklickým odkazům mezi pracovními položkami.

Počet souvisejících odkazů pracovní položky se rovná součtu všech odkazů definovaných typem pracovního propojení.

název

název reference

Využití

---

Affects-Ovlivněno (jen pro CMMI)

Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Typ topologie: Závislost
Kategorie propojení: Definovaný proces

Pomocí tohoto navigačního odkazu můžete vytvářet propojení mezi pracovními položkami bez vytváření uzavřených smyček. Lidé ho obvykle používají ke sledování žádostí o změnu propojených s požadavky.

Omezení a doporučení:

• Propojte žádost o změnu pouze s jedním požadavkem pomocí funkce Vliv. Propojte požadavky na libovolný počet podřízených žádostí o změnu podle potřeby pomocí funkce Ovlivněno.
• Používejte pouze Affects-Affected k propojení pracovních položek ve stejném projektu. Doporučujeme, když plánujete používat Excel k úpravě nebo aktualizaci dat pracovních položek.

Rodič-Dítě
Snímek obrazovky znázorňující koncepční diagram typu "Child link"

System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Typ topologie: Strom
Kategorie propojení: Definovaná systémem

Pomocí tohoto směrového odkazu můžete vytvořit relace 1:N mezi jedním nadřazeným objektem a jednou nebo více podřízenými položkami. Slouží k uspořádání pracovních položek v hierarchii. Tuto hierarchii můžete vytvořit mezi položkami backlogu pomocí funkce mapování nebo mezi položkami backlogu a úkoly pomocí backlogu sprintu nebo panelu úkolů.

Mezi typická použití patří:

• Udržujte vztahy se souhrnem úkolů. Vztahy nadřazený-podřízený představují souhrnné úkoly a jejich podřízené úkoly.
• Propojte úkoly s PBI, uživatelskými příběhy nebo požadavky. Podporuje sestavy Přehled backlogu, Přehled uživatelských příběhů a Přehled požadavků.

Omezení a doporučení:

• Pomocí Excelu můžete hromadně upravovat pracovní položky i odkazy mezi nadřazenými a podřízenými položkami. Viz Hromadné přidávání nebo úpravy pracovních položek v Excelu.
• Pracovní položka může mít pouze jednu nadřazenou položku. Nadřazená pracovní položka může mít mnoho podřízených položek.
• Používejte pouze odkazy nadřazenosti a podřízenosti k propojení pracovních položek ve stejném projektu. Doporučujeme, když plánujete používat Excel k úpravě nebo aktualizaci dat pracovních položek.

Duplicate-Duplicate of

System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Typ topologie: Strom
Kategorie propojení: Definovaná systémem

Pomocí tohoto směrového odkazu můžete vytvořit vztahy jeden-k-více pro sledování úkolů, chyb nebo jiných pracovních položek, které se vzájemně duplikují.

Omezení a doporučení:

• Pracovní položka může mít pouze jeden duplikát.
• Používejte odkazy typu Duplicate nebo Duplicate Of pouze k propojení pracovních položek ve stejném projektu. Doporučujeme, když plánujete používat Excel k úpravě nebo aktualizaci dat pracovních položek.

Odkazované odkazy

Microsoft.VSTS.TestCase.
SdílenýParametrOdkazujeNa
Typ topologie: Závislost
Kategorie propojení: Definovaný proces

Tento postup slouží k propojení testovacích případů se sdílenými parametry a k podpoře opakování testu s různými daty. Obecně platí, že tento typ odkazu nepřidáte do ovládacího prvku odkazy s vymezeným oborem.

Týkající se

System.TypyOdkazů.Příbuzné
Typ topologie: Síť
Kategorie propojení: Definovaná systémem

Pomocí tohoto nesměrového odkazu můžete vytvářet vztahy mezi pracovními položkami. Slouží k propojení pracovních položek na stejné úrovni (například dva uživatelské scénáře, které se překrývají). Typ souvisejícího odkazu vytvoří jednoduché relace s několika omezeními.

• Propojit pracovní položky, které jsou na stejné úrovni.
• Propojte pracovní položky definované v různých projektech a spravujte je různými týmy.
• Vyhledejte a zobrazte pracovní položky a související pracovní položky v dvouvrstvém zobrazení.
• Vytvořte jednoduché relace s několika omezeními.

následník-předchůdce

System.LinkTypes.Závislost
Typ topologie: Závislost
Kategorie propojení: Definovaná systémem
Zvolte předchůdce při propojení s pracovní položkou, která by se měla dokončit před aktuální položkou. Při propojení s pracovní položkou, která by měla být dokončena po aktuální položce, zvolte následníka .

Pomocí tohoto navigačního odkazu můžete sledovat úkoly, které musí být dokončeny před zahájením ostatních. Propojené úkoly se v Azure Boards zobrazují jako odkazy předchůdců a následníků.

• Sledujte úkoly, které je potřeba dokončit, aby mohli začít ostatní.
• Podpora relací typu jeden k mnoha (1:N)
• Vyhledání předchůdců a následníků pracovních položek v zobrazení dotazu se dvěma vrstvami přímých odkazů

Omezení a doporučení:

• Při pokusu o vytvoření cyklických relací se zobrazí chyba.
• Pokud plánujete exportovat do Excelu, vytvořte propojení předchůdců a následníků pouze pro pracovní položky ve stejném projektu. Můžete vytvořit propojení předchůdců a následníků napříč projekty, ale export a import Aplikace Excel bude obsahovat pouze položky pro projekt, který definuje dotaz.

Testováno pomocí testů

Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Typ topologie: Závislost
Kategorie propojení: Definovaný proces

Propojte testovací případy s pracovními položkami, jako jsou chyby, uživatelské scénáře, požadavky a PBI. Tato možnost slouží ke sledování testovacích případů, které ověřují uživatelské scénáře (Agilní), PBI (Scrum) nebo požadavky (CMMI). Pro lokální Azure DevOps závisí několik SQL sestav na těchto odkazech. Podívejte se na Zkontrolujte týmové aktivity, které podporují užitečné sestavy.

testovací Case-Shared kroky

Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Typ topologie: Závislost
Kategorie propojení: Definovaný proces

Tento postup slouží k propojení testovacích případů se sdílenými kroky. Sdílejte kroky mezi testovacími případy , abyste zabránili duplikování stejné posloupnosti kroků.

Hypertextový odkaz

Hypertextový odkaz odkazuje pracovní položku na libovolnou adresu URL. Počet hypertextových odkazů sleduje počet hypertextových odkazů v pracovní položce.

Název odkazu

nástroj podporuje

typ artefaktu

Využití

---

Hypertextový odkaz

Sledování pracovních položek

Hypertextový odkaz

Slouží k propojení pracovní položky s adresou URL. Hypertextový odkaz na pracovní položku je název tohoto typu odkazu v API pro typy odkazů artefaktů .

Typ externího propojení

Externí typy propojení jsou systémem definované a propojují pracovní položky s jinými objekty uloženými v Azure DevOps. Počet externích propojení pracovní položky se rovná součtu všech propojení definovaných s typy externích propojení.

Poznámka:

K propojení s objektem Azure DevOps použijte externí typ odkazu. Pokud chcete propojit pracovní položky s objekty mimo Azure DevOps, použijte hypertextový odkaz.

Následující tabulka popisuje typy externích propojení, které můžete zvolit, když přidáte odkaz z pracovní položky nebo testovacího případu.

Název odkazu

nástroj podporuje

typ artefaktu

Využití

---

Výstraha zabezpečení

Pokročilé zabezpečení

Pokročilé zabezpečení

Slouží k propojení pracovní položky s výstrahou Pokročilé zabezpečení.

Pobočka

Git

Pobočka

Slouží k propojení pracovní položky s větví.

Pipeliny/sestavení

Stavět

Stavět

Slouží k propojení pracovní položky se sestavením.

Sada změn (nebo opraveno v sadě změn)

Správa verzí

Sada změn

Slouží k propojení pracovní položky se sadou změn.

Commit (nebo opraveno v commitu)

Git

Závazek

Slouží k propojení pracovní položky s potvrzením.

Nalezeno v buildu

Pipeliny/sestavení

Stavět

Slouží k propojení pracovní položky se sestavením.

Integrováno do sestavení

Stavět

Sestavovací kanál

Slouží k propojení pracovní položky se sestavením.

Integrované ve vývojovém prostředí

Vydání

Nasazovací kanál

Slouží k propojení verze s pracovní položkou. Systém vytvoří tento typ, když uživatel povolí zprávu o stavu nasazení do Work pro definici uvolnění.

Žádost o přijetí změn

Git

ID žádosti o stažení

Slouží k propojení pracovní položky s žádostí o přijetí změn.

Příloha výsledku

Správa testů

TcmResultAttachment

Slouží k propojení pracovní položky s přílohou přidruženou k výsledku testu. Tyto odkazy se zobrazí, když přidružíte pracovní položku k výsledku testu z Testu nebo Microsoft Test Manager.

Soubor zdrojového kódu

Správa verzí

NejnovějšíVerzePoložky

Slouží k propojení pracovní položky se souborem ve správě verzí Team Foundation (TFVC).

Storyboard

Požadavky

Storyboard

Slouží k propojení pracovní položky s powerpointovým souborem nebo jiným souborem, který obsahuje informace o scénářích v síti.

Štítek

Git

Štítek

Slouží k propojení pracovní položky se značkou definovanou pro commit v gitu nebo úložišti. Další informace najdete v části Práce z příkazového řádku Gitu.

Výsledek testu

Správa testů

TcmResult

Slouží k propojení pracovní položky s výsledkem testu. Tyto odkazy se zobrazí, když přidružíte pracovní položku k výsledku testu z Testu nebo Microsoft Test Manager.

Položka s verzováním

Správa verzí

NejnovějšíVerzePoložky

Slouží k propojení pracovní položky se souborem nebo sadou změn definovanými v úložišti TFVC. soubor zdrojového kódu je název tohoto typu odkazu v rozhraní API typů odkazů artefaktů.

Wiki

Wiki

Wiki

Slouží k propojení pracovní položky na stránku wikiwebu. Podporováno pro TFS 2018.2 a novější verze.

Typ odkazu GitHubu

Typy odkazů GitHubu jsou systémem definované a propojují pracovní položky s objekty GitHubu, jak je znázorněno tady.

Důležité

Artefakty GitHubu můžete propojit jenom s úložišti připojenými k Azure Boards.

Následující tabulka popisuje typy odkazů GitHubu, které můžete zvolit při přidávání odkazu z pracovní položky.

Název odkazu

typ artefaktu

Využití

---

Potvrzení GitHubu

Potvrzení úložiště GitHub

Slouží k propojení pracovní položky s potvrzením GitHubu.

Problém s GitHubem

Problém s úložištěm GitHub

Slouží k propojení pracovní položky s problémem GitHubu.

Žádost o přijetí na GitHubu

Pull request v úložišti GitHub

Slouží k propojení pracovní položky s pull requestem na GitHubu.

Typ propojení práce na dálku

Typy propojení vzdálené práce podporují propojení pracovních položek definovaných v různých organizacích, pokud stejné ID Microsoft Entra spravuje tyto organizace (viz Připojení organizace k Microsoft Entra ID).

Počet vzdálených propojení pracovní položky se rovná součtu všech propojení definovaných typem propojení vzdálené práce.

název

název reference

Využití

---

využívá From-Produced pro
(Topologie závislostí)

System.LinkTypes.Remote.Závislost-Dopředu
System.LinkTypes.Remote.Dependency-Reverse
Typ topologie: Závislost
Kategorie propojení: Definovaná systémem

Pomocí tohoto směrového odkazu můžete vytvářet závislosti mezi pracovními položkami definovanými v různých organizacích, pokud je spravuje stejné ID Microsoft Entra. Lidé ho obvykle používají ke sledování žádostí o změnu propojených s požadavky napříč hranicemi organizace.

Dálkově související

System.LinkTypes.Remote.Related
Typ topologie: Síť
Kategorie propojení: Definovaná systémem

Pomocí tohoto nesměrového odkazu můžete propojit pracovní položky definované v různých organizacích, pokud je spravuje stejné Microsoft Entra ID.

Seznam typů odkazů

Typy propojení můžete vypsat pomocí podporovaných nástrojů příkazového řádku.

az boards položka práce vztah typ seznamu

Výpis typů propojení podporovaných vaší organizací pomocí příkazu az boards work-item relation list-type nebo typů relací pracovních položek – Výpis rozhraní REST API. Podrobnosti najdete v tématu Začínáme s Azure DevOps CLI.

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

Volitelné parametry

• org: Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí .az devops configure -d organization=ORG_URL Požadováno, pokud není nakonfigurováno jako výchozí nebo získáno pomocí git config. Příklad: --org https://dev.azure.com/MyOrganizationName/.

Příklad

Následující příkaz uvádí typy propojení pracovních položek ve formátu tabulky definovaném pro organizaci fabrikam.

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

Výchozí formát JSON poskytuje další informace o atributech definovaných pro typy odkazů. Například informace o typech propojení Vytváří pro a Spotřebovává z jsou uvedeny následovně.

  {
    "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

Typy propojení, které jsou podporovány pro vaši kolekci projektů, můžete zobrazit pomocí nástroje příkazového řádku witadmin listlinktypes nebo příkazu REST API pro výpis relačních typů pracovních položek .

Tady je seznam typů propojení pro výchozí kolekci 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

Atributy typu propojení

Následující tabulka obsahuje popisy pro jednotlivé atributy typu odkazu, které jsou vráceny rozhraním příkazového řádku nebo rozhraním REST API pro Azure Boards.

Atribut

popis

---

Názvy, name

Určuje přátelský název přiřazený typům propojení. Směrové odkazy jsou definovány ve dvojicích a obsahují dopředný a zpětný název.

Referenční název, referenceName

Určuje název přiřazený typu propojení nebo dvojici typu propojení.

acyclic

Určuje, zda typ propojení povoluje, nebo (true) nebo omezuje (false) cyklické relace. Například propojení typu stromu omezují cyklický vztah. Další informace naleznete v části referenční příručka k prvkům LinkTypes.

directional

Určuje, zda je typ propojení směrový (true) nebo ne (false). Směrové typy propojení se definují ve dvojicích s přední a zpětnou složkou. Další informace naleznete v části referenční příručka k prvkům LinkTypes.

editable

Určuje, zda je typ propojení upravitelný (true) nebo ne (false). Vlastní typy propojení pro místní nasazení můžete přidávat a upravovat jen pomocí nástroje příkazového řádku witadmin Spravovat typ odkazu. Typy systémových propojení vždy mají editable=false.

Je aktivní, enabled

Určuje, zda je typ propojení aktivní (true) nebo ne (false). Pro místní nasazení můžete použít pouze vlastní typy propojení pomocí nástroje příkazového řádku witadmin Spravovat typ propojení.

isForward

Určuje, zda typ propojení určuje přesměrovací propojení (true) nebo ne (False) v rámci dvojice typů propojení.

oppositeEndReferenceName

Určuje referenční název typu vazby, který určuje vazbu v opačném směru dvojice typů vazby.

remote

Určuje, zda typ propojení podporuje propojení se vzdálenou pracovní položkou (true) nebo ne (False). Typy propojení s remote=false vyžadují, aby cílová pracovní položka byla umístěna ve stejné organizaci nebo kolekci jako původní pracovní položka.

singleTarget

Určuje, zda typ propojení umožňuje více než jeden cíl (false) nebo je omezen na jeden cíl (true).

topology

Určuje typ topologie: dependency, networka tree. Popisy najdete v tématu Topologie typů odkazů a omezení.

usage

Určuje typ použití: resourceLink or hodnota workItemLink. The workItemLink označuje typ propojení, který propojí dvě pracovní položky. Hodnota resourceLink označuje typ odkazu, který slouží k propojení pracovní položky s prostředkem, jako je adresa URL nebo příloha.

url

Vypíše atributy typu odkazu ve formátu JSON.

Související obsah

• Propojení pracovních položek s jinými objekty
• Sledování závislostí pomocí plánů doručení
• Použití mapování k propojení položek backlogu s funkcemi a náměty
• Hromadné úpravy odkazů pomocí Excelu
• Rozhraní API pro Typy Odkazů Artefaktu