Definice řízení propojení s cílem omezit vztahy určené propojeními

Můžete určit, které pracovní položky se navzájem propojují, přizpůsobením formuláře práce. Konkrétně lze řídit typy odkazů a pracovní položky, které uživatelé mohou zobrazit a přidat do ovládacího prvku vazby. Můžete například chtít přidat kartu do formuláře, který slouží ke správě závislých funkcí. Na této kartě můžete přidat ovládací prvky odkazů a omezit vztahy propojení, které členové týmu mohou zobrazit a provést pomocí daného ovládacího prvku tak, aby obsahovaly pouze odkazy na jiné funkce.

Element Control atributu LinksControl Type umožňuje uživatelům vytvářet vztahy propojení mezi pracovními položkami a ostatními objekty v databázi Team Foundation. Pak můžete použít podřízené prvky LinksControlOptions k definování možností k určení, jaké odkazy mohou členové týmu přidávat a na jaké typy pracovních položek nebo objektů se mohou propojit. Můžete také definovat výchozí sloupce, které chcete zobrazit pro seznam odkazů v tomto ovládacím prvku.

Souhrnné informace o propojení omezení, která jsou definována pro šablony procesů TFS, naleznete v tématu Link controls, restrictions, and field reference. Další informace o typech odkazu viz Link type element reference.

V tomto tématu

• Určení ovládacích prvků odkazů

• Řízení vztahů propojení

• Omezení propojení vztahů k pracovním položkám

• Omezení propojení vztahů se sadou změn, hypertextovými odkazy a dalšími nefunkčními položkami

• Omezení propojení vztahů k typům pracovních položek

• Určení výchozích sloupců, které chcete zobrazit

Určení ovládacích prvků odkazů

Možnost LinksControl slouží pro povolení uživatelům přidat, zobrazit a spravovat vztahy odkazu ve formuláři pracovní položky. Pomocí tohoto ovládacího prvku můžete otevřít, upravit, přidat a odebrat propojení.

Formulář můžete upravit tak, aby jedna karta zobrazovala pouze nadřazené a podřízené odkazy a druhá zobrazovala všechny ostatní typy odkazů. V následujícím příkladu je vytvořena karta s popiskem "Všechny odkazy", kterou členové týmu mohou použít k přidání všech typů propojení. Výchozí sloupce, které se zobrazují pro zobrazení odkazů, jsou také pole ID, Typ pracovní položky, Název, Přiřazeno, Stav a Komentář k propojení.

Ovládací prvek odkazů

<Tab Label="All Links">
   <Control Type="LinksControl" Name="All" >
      <LinksControlOptions>
         <LinkColumns>
            <LinkColumn RefName="System.ID" />
            <LinkColumn RefName="System.WorkItemType" />
            <LinkColumn RefName="System.Title" />
            <LinkColumn RefName="System.AssignedTo" />
            <LinkColumn RefName="System.State" />
            <LinkColumn LinkAttribute="System.Links.Comment" />
         </LinkColumns>
      </LinksControlOptions>
   </Control>
</Tab>

Zpět na začátek

Řízení vztahů propojení

Pokud přidáte ovládací prvek odkazu do formuláře pracovní položky, můžete určit filtry, které omezují typy odkazů a pracovních položek, které mohou členové týmu přidat při použití ovládacího prvku. Následující tabulka popisuje volitelné podřízené prvky, které ovládají vztahy propojení.

Element	Description
WorkItemLinkFilters	Omezí typy odkazů, které lze použít k propojení pracovních položek.
ExternalLinkFilters	Omezí typy odkazů, které lze použít k propojení k objektu, který není typem pracovní položky, jako jsou sady změn, hypertextový odkaz nebo položka pro ovládání verze.
WorkItemTypeFilters	Omezí typy pracovních položek, ke kterým se může uživatel propojit a týmové projekty, ve kterých jsou pracovní položky definovány.
Filter	Určuje typy vazby nebo typy pracovních položek, které chcete zahrnout nebo vyloučit.

Zpět na začátek

Omezení propojení vztahů k pracovním položkám

Podřízené elementy WorkItemLinkFilters a Filter se používají k definování, které typy propojení by měl ovládací prvek propojení zahrnout nebo vyloučit. Tento element slouží k omezení typů odkazů, které lze vybrat pomocí ovládacího prvku odkazů na pracovní položky, které jsou definovány ve stejném projektu. Syntax pro tyto prvky je tento.

<WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
</WorkItemLinkFilters>

Atribut	Description
FilterType	Požadovaný atribut WorkItemLinkFilters. Definuje metodu, která slouží k filtrování množiny typů odkazů, které jsou k dispozici v sadě prvků Filter. Můžete použít následující platné hodnoty: exclude: Můžete zabránit vytvoření odkazů z typů odkazů, které jsou uvedeny v elementech Filter. excludeAll: Slouží k zakázání všech typů odkazů. include: Použijte v případě, že chcete povolit pouze ty typy vazeb, které jsou uvedené v prvcích Filter. includeAll: Použijte v případě, že chcete povolit vytvoření odkazů ze všech typů propojení.
LinkType	Požadovaný atribut Filter. Určuje název typu odkazu. Další informace naleznete v tématu Link type element reference.
FilterOn	Nepovinný atribut Filter. Určuje typ filtru, který chcete aplikovat v typu odkazu. Můžete použít následující platné hodnoty: forwardname: Použijte k filtrování dopředného názvu definovaného pro typ odkazu. reversename: Použijte k filtrování zpětného názvu definovaného pro typ odkazu. Pokud tento parametr nezadáte, dopředný a zpětný název slouží k filtrování typu propojení. Je-li topologie typu propojení síť, dopředný a zpětný název jsou stejné. Další informace naleznete v tématu Link type element reference.

Příklad: Vyloučení dvou typů odkazů na pracovní položky

Můžete definovat ovládací prvek propojení, který umožňuje vztahy propojení pro všechny typy odkazů kromě typu odkazu na vlastní požadavek a typ propojení hierarchie systému propojení pomocí následujícího příklad kódu.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="exclude">
         <Filter LinkType="MyLinks.LinkTypes.Requirement" /> 
         <Filter LinkType="System.LinkTypes.Hierarchy" /> 
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
. . .
</Control>

Zpět na začátek

Omezení propojení vztahů se sadou změn, hypertextovými odkazy a dalšími nefunkčními položkami

Podřízené elementy ExternalLinkFilters a Filter se používají k definování, které typy propojení na položky jsou mimo týmový projekt, který by měl ovládací prvek odkazů zahrnout nebo vyloučit. Syntax pro tyto prvky je tento.

<ExternalLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="externalLinkName" />
</ExternalLinkFilters>

Atribut	Description
FilterType	Nepovinný atribut ExternalLinkFilters. Definuje metodu, která slouží k filtrování množiny typů odkazů, které jsou k dispozici v sadě prvků Filter. Můžete použít následující platné hodnoty: exclude: Můžete zakázat vytvoření odkazů z typů odkazů, které jsou uvedeny v prvcích Filter. excludeAll: Slouží k zakázání všech typů odkazů. include: Použijte v případě, že chcete povolit pouze ty typy vazeb, které jsou uvedené v prvcích Filter. includeAll: Použijte v případě, že chcete povolit vytvoření odkazů ze všech typů propojení. Pokud tento parametr nezadáte, všechny odkazy na externí pracovní položky jsou vyloučeny.
LinkType	Požadovaný atribut Filter. Určuje název typu odkazu, který chcete vyloučit nebo zahrnout. Lze zadat následující typy odkazu: Opraveno v sadě změn Příloha výsledku Soubor zdrojového kódu Výsledek testu Pracovní položka hypertextového odkazu

Příklad: Vyloučení všech odkazů na nepracovní položky

Následující příklad definuje ovládací prvek vazby, který zahrnuje všechny typy propojení pracovních položek, jako jsou například související a hierarchické položky, ale nezahrnuje typy vazeb na nepracovní položky, jako jsou sady změn, hypertextové odkazy a výsledky zkoušek.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="includeAll" /> 
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
</Control>

Následující příklad definuje ovládací prvek odkazu, který umožňuje uživatelům zadat pouze typ propojení sady změn a propojení pouze se sadami změn.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="excludeAll"/>
      <ExternalLinkFilters FilterType="include" /> 
         <Filter LinkType="Fixed in Changeset" />
      </ExternalLinkFilters> 
 </LinksControlOptions>
. . .
</Control>

Zpět na začátek

Omezení propojení vztahů k typům pracovních položek

Podřízené elementy WorkItemTypeFilters a Filter slouží k omezení typů pracovních položek, na které se může ovládací prvek odkazů připojit. Vztahy propojení můžete omezit na týmový projekt nebo podle typu pracovní položky. Syntax pro tyto prvky je tento.

<WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" >
   <Filter WorkItemType="workItemTypeReferenceName" />
</WorkItemTypeFilters>

Atribut	Description
Scope	Nepovinný atribut WorkItemTypeFilters. Definuje rozsah filtru, který se aplikuje na množiny typů pracovních položek, které jsou k dispozici v sadě prvků Filter. Můžete použít následující platné hodnoty: all: Můžete povolit vytvoření odkazů na všechny typy pracovní položky, které jsou uvedeny v prvcích Filter. project: Slouží k povolení tvorby odkazů pouze u typů pracovních položek, které jsou definovány pro aktuální projekt. Pokud tento parametr nezadáte, odkazy na všechny typy pracovních položek jsou povoleny.
FilterType	Požadovaný atribut WorkItemTypeFilters. Definuje metodu, která slouží k filtrování množiny typů odkazů, které jsou k dispozici v sadě prvků Filter. Můžete použít následující platné hodnoty: exclude: Použijte v případě, že chcete zakázat typy položek práce uvedené v prvcích Filter. excludeAll: Použijte v případě, že chcete zakázat všechny typy položek práce. include: Použijte v případě, že chcete povolit typy položek práce uvedené v prvcích Filter. includeAll: Použijte v případě, že chcete povolit všechny typy položek práce.
WorkItemType	Požadovaný atribut Filter. Určuje název odkazu pro typ pracovní položky.

Příklad: Omezení propojení vztahů na úkoly pracovních položek

Následující příklad definuje ovládací prvek vazby, který umožňuje vytvoření pouze hierarchických vztahů v úlohách, které jsou definovány v týmovém projektu.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="System.LinkTypes.Hierarchy" />
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll"/>
      <WorkItemTypeFilters Scope ="project" FilterType="include" />
         <Filter WorkItemType="Task" />
      </WorkItemTypeFilters> 
   </LinksControlOptions>
. . .
</Control>

Zpět na začátek

Určení výchozích sloupců, které chcete zobrazit

Podřízené prvky LinkColumns a LinkColumn se používají k určení výchozích sloupců, které chcete zobrazit v ovládacím prvku vazby. Můžete zadat referenční název libovolné pracovní položky nebo atributu propojení. Syntax pro tyto prvky je tento.

<LinkColumns>
   <LinkColumn RefName="reference name" | LinkAttribute=" link attribute name" />
</LinkColumns>

Pořadí, v jakém jsou prvky uvedeny, definuje pořadí, ve kterém jsou zobrazena pole sloupce ve formuláři položky práce. Seznam názvů odkazů a odkazy atributů naleznete v tématu Work item field reference for Visual Studio ALM. Následující syntaxe definuje zobrazení čtyři sloupců: ID, Stav, Název a atribut odkazu Poznámky.

<Control Type="LinksControl">
. . .
   <LinksControlOptions>
      <LinkColumns>
         <LinkColumn RefName="System.ID" />
         <LinkColumn RefName="System.State" />
         <LinkColumn RefName="System.Title" />
         <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

Zpět na začátek

Viz také

Referenční dokumentace

LinksControlOptions – elementy

Koncepty

Link controls, restrictions, and field reference

Link type element reference

Specify work item form controls