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

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Různé typy propojení můžete použít ke správě různých vztahů mezi pracovními položkami a dalšími artefakty, jako jsou sestavení, potvrzení, žádosti o přijetí změn a další. V tomto článku popisujeme následující typy odkazů.

• Typ pracovního propojení: Propojení pracovních položek, včetně výběru pracovních položek správy testovacích případů
• Hypertextový odkaz: Připojení pracovní položku na libovolnou adresu URL nebo sdílenou síť
• Typ externího odkazu: Připojení pracovní položku k externímu objektu, jako je objekt kódu, sestavení nebo stránka wikiwebu
• Typ propojení práce na dálku: Připojení pracovní položky definované v různých organizacích
• Typ odkazu GitHubu: Připojení pracovní položku do potvrzení, problému nebo žádosti o přijetí změn v úložišti GitHub.

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

Typy propojení podléhají určitým omezením na základě jejich topologie. Pokyny uvedené v následujících tabulkách vám pomůžou vybrat typ odkazu, který se má použít na základě typů dotazů a sestav, které chcete vytvořit. Další informace o různých topologiích najdete v tématu Topologie a omezení typů propojení.

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 propojení, typ topologie a omezení, která se používají 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 propojení také podporuje hierarchickou nebo stromovou topologii a zabraňuje vytváření cyklických odkazů mezi pracovními položkami.

Související počet propojení pracovní položky odpovídá součtu všech odkazů definovaných typem pracovního propojení.

Název

Název odkazu

Využití

---

Vliv na ovlivnění ( pouze 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 vytvořit propojení mezi libovolnou sadou pracovních položek, ale ne mezi těmi, které by vytvářely uzavřené smyčky. Obvykle se používá ke sledování žádostí o změnu provedených v požadavcích.

Omezení a doporučení:

• Žádost o změnu můžete propojit pouze s jedním požadavkem pomocí funkce Vliv. Požadavky můžete propojit s tolika podřízenými žádostmi o změnu podle potřeby pomocí ovlivněných požadavků.
• Použít pouze ovlivněné odkazy na propojení pracovních položek ve stejném projektu. Tuto akci doporučujeme, pokud plánujete používat Excel k úpravě nebo aktualizaci dat pracovních položek.

Podřízený nadřazený objekt

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 rychle 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žování souhrnných vztahů mezi úkoly Pro souhrnné úkoly a podřízené úkoly se vytvoří propojení nadřazený-podřízený.
• Propojte úkoly s PBI, uživatelskými příběhy nebo požadavky. Podporuje sestavy Přehled backlogu, Přehled scénářů a Přehled požadavků.

Omezení a doporučení:

• Pomocí Excelu můžete hromadně upravovat pracovní položky i odkazy nadřazené a podřízené položky. 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.
• K propojení pracovních položek ve stejném projektu používejte pouze odkazy nadřazené-podřízené. Tato akce se doporučuje, pokud plánujete používat Excel k úpravě nebo aktualizaci dat pracovních položek.

Duplikát duplicity

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 relace 1:N mezi jedním nadřazeným objektem a jednou nebo více podřízenými položkami. Slouží ke sledování úkolů, chyb nebo jiných pracovních položek, které jsou navzájem duplicitní.

Omezení a doporučení:

• Pracovní položka může mít pouze jeden duplikát.
• K propojení pracovních položek ve stejném projektu použijte pouze duplicitní nebo duplicitní odkazy. Tato akce se doporučuje, pokud plánujete používat Excel k úpravě nebo aktualizaci dat pracovních položek.

Odkazované odkazy podle odkazů

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

Slouží k propojení testovacích případů se sdílenými parametry. Umožňuje propojit testovací případy se sdílenými parametry, aby bylo možné test opakovat s různými daty. Obecně byste tento typ propojení nepřidáli do ovládacího prvku odkazy s vymezeným oborem.

Související

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

Pomocí tohoto neadresáře můžete vytvořit propojení mezi libovolnou sadou pracovních položek. Slouží k propojení pracovních položek na stejné úrovni, například dvou uživatelských scénářů, které definují funkce, které se vzájemně překrývají. Typ souvisejícího odkazu vytvoří jednoduché relace s několika omezeními.

• Spojovat pracovní položky, které jsou na stejné úrovni, například dva uživatelské scénáře definující funkce, které se vzájemně překrývají.
• 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.Dependency

Typ topologie: Závislost
Kategorie propojení: Definovaná systémem
Při propojení s pracovní položkou, ze které chcete vytvořit propojení, zvolte typ odkazu Předchůdci , který by se měl dokončit před pracovní položkou, ze které propojíte. Zvolte typ propojení následníka při propojení s pracovní položkou, která by měla být dokončena po pracovní položce, ze které odkazujete.

Pomocí tohoto navigačního odkazu můžete vytvořit propojení mezi libovolnou sadou pracovních položek, ale ne mezi těmi, které by vytvářely uzavřené smyčky. Slouží ke sledování úkolů, které musí být dokončeny před zahájením ostatních. Propojené úkoly jsou reprezentovány jako odkazy předchůdce-následník v Azure Boards.

• Sledujte úkoly, které je potřeba dokončit, aby ostatní mohli začít.
• Podporuje relace 1:N.
• Vyhledání a zobrazení předchozích pracovních položek a následníků pracovních položek v zobrazení dotazu se dvěma vrstvami s přímými odkazy

Omezení a doporučení:

• Při pokusu o vytvoření propojení definující cyklický vztah se zobrazí chyba.
• Vytvořit odkazy předchůdce-následník pouze na pracovní položky, které jsou v rámci stejného projektu. Můžete vytvořit propojení předchůdců následníků mezi pracovními položkami definovanými v různých projektech. Pokud ale exportujete dotaz do Excelu, importují se jenom ty pracovní položky definované pro projekt, pro který je dotaz definovaný.

Testované testy

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 položky backlogu produktů. Slouží ke sledování testovacích případů, které testuje uživatelské scénáře (Agilní), položky backlogu produktů (Scrum) nebo požadavky (CMMI). Může také propojit jiné typy pracovních položek, jako jsou chyby, problémy nebo úkoly. Pro místní Azure DevOps existuje několik sestav SQL, které závisí na těchto odkazech. Informace o podpoře užitečných sestav najdete v části Kontrola týmových aktivit.

Testovací kroky se sdílenými případy

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

Slouží k propojení testovacích případů se sdílenými kroky. Sdílejte kroky mezi testovacími případy , abyste nemuseli vytvářet více položek stejné posloupnosti kroků.

Hypertextový odkaz

Hypertextový odkaz může propojit pracovní položku s libovolnou adresou URL. Počet hypertextových odkazů sleduje počet hypertextových odkazů na pracovní položku.

Název odkazu

Podporovaný nástroj

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 pracovní položky je název tohoto typu odkazu v rozhraní API typů odkazů artefaktů.

Typ externího propojení

Typy externích propojení jsou typy propojení definované systémem, které podporují propojení pracovních položek s jinými objekty uloženými v Azure DevOps, jak je znázorněno na následujícím obrázku. Počet externích propojení pracovní položky odpovídá součtu všech propojení definovaných typem externího propojení.

Poznámka:

K propojení s objektem Azure DevOps můžete použít pouze externí typ odkazu. Pokud chcete propojit pracovní položky s jinými 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 typ odkazu z pracovní položky nebo testovacího případu.

Název odkazu

Podporovaný nástroj

Typ artefaktu

Využití

---

Pobočka

Git

Pobočka

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

Kanály/ sestavení

Sestavit

Sestavit

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

Sada změn (nebo opravená v sadě změn)

VersionControl

Changeset

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

Potvrzení (nebo opraveno v potvrzení)

Git

Potvrzení

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

Nalezeno v buildu

Kanály/ sestavení

Sestavit

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

Integrováno do sestavení

Sestavit

Kanál sestavení

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

Integrované v prostředí vydaných verzí

Verze

Kanál verze

Slouží k propojení verze s pracovní položkou. Systém vytvoří propojení tohoto typu, když uživatel povolí možnost Stav nasazení sestavy pro definici verze.

Žádost o přijetí změn

Git

PullRequestId

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 nástroje Test nebo Microsoft Test Manager.

Soubor zdrojového kódu<

VersionControl

LatestItemVersion

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

Scénáře

Požadavky

Scénáře

Slouží k propojení pracovní položky s powerpointovým souborem nebo jiným souborem, který obsahuje informace o vytváření obsahu v síti.

Značka

Git

Značka

Slouží k propojení pracovní položky se značkou definovanou pro potvrzení gitu nebo úložiště Git. Další informace najdete v tématu 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 nástroje Test nebo Microsoft Test Manager.

Položka s verzí

VersionControl

LatestItemVersion

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ů propojení 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 definované systémem a podporují propojení pracovních položek s objekty GitHubu, jak je znázorněno na následujícím obrázku.

Důležité

Artefakty GitHubu můžete propojit pouze 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í typu 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 Na GitHubu.

Žádost o přijetí změn GitHubu

Žádost o přijetí změn úložiště GitHub

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

Typ propojení práce na dálku

Typy propojení na dálku jsou typy propojení definované systémem, které podporují propojení pracovních položek definovaných v různých organizacích, pokud je spravuje stejné ID Microsoft Entra, jak je popisuje Připojení vaší organizaci s Microsoft Entra ID.

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

Název

Název odkazu

Využití

---

Spotřebovávají se z produkce pro
(Topologie závislostí)

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

Pomocí tohoto směrového odkazu můžete vytvořit propojení mezi pracovními položkami, které mají závislosti a jsou definovány v různých organizacích, pokud je spravuje stejné ID Microsoft Entra. Obvykle se používá ke sledování žádostí o změnu provedených v požadavcích.

Vzdálené související

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

Pomocí tohoto neadresáře můžete vytvářet propojení mezi pracovními položkami definovanými v různých organizacích, pokud je spravuje stejné ID Microsoft Entra.

Typy propojení seznamu

Pokud chcete získat seznam typů propojení, můžete použít některý z podporovaných nástrojů příkazového řádku.

az boards work-item relation list-type

Typy propojení podporované vaší organizací můžete vypsat příkazem az boards work-item relation list-type nebo příkazem Seznam typů relací pracovních položek – Výpis rozhraní REST API. Pokud chcete začít, přečtěte si téma 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 vyzvednuto 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 pro typy propojení Vytvoří pro a Spotřebované z jsou uvedeny následujícím způsobem.

  {
    "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í podporované pro kolekci projektů můžete vypsat pomocí nástroje příkazového witadmin listlinktypes řádku nebo pomocí příkazu Relační typy pracovních položek – Výpis rozhraní REST API.

Tady uvádíme typy 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 popis jednotlivých atributů typu propojení vrácených rozhraním příkazového řádku Azure Boards nebo rozhraním REST API.

Atribut

Popis

---

Názvy name

Určuje popisný název přiřazený typům propojení. Směrové odkazy jsou definovány ve dvojicích, proto obsahují dopředu a obrácený název.

Název odkazu, referenceName

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

acyclic

Určuje, jestli typ propojení povoluje nebo (true) nebo omezuje (false) kruhové relace. Například propojení typu stromu omezují cyklický vztah. Další informace naleznete v tématu Odkazy na elementy LinkTypes.

directional

Určuje, jestli je typ propojení směrový (true) nebo ne (false). Směrové typy propojení se definují ve dvojicích s dopředu a obrácenou komponentou. Další informace naleznete v tématu Odkazy na elementy LinkTypes.

editable

Určuje, jestli je typ odkazu upravitelný (true) nebo ne (false). Vlastní typy propojení pro místní nasazení můžete přidávat a upravovat jenom pomocí witadmin nástroje pro příkazový řádek 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í witadmin nástroje pro příkazový řádek Spravovat typ odkazu.

isForward

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

oppositeEndReferenceName

Určuje název odkazu typu propojení, který definuje propojení v opačném směru dvojice typů propojení.

remote

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

singleTarget

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

topology

Určuje typ topologie – strom sítě, and závislostí, . Popisy najdete v tématu Topologie a omezení typu propojení.

usage

Určuje typ použití – resourceLink nebo workItemLink. Hodnota workItemLink resourceLinkvalue indicates a link type that links two work items. Theoznač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í články

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