LinksControlOptions – elementy

Článek
06/09/2015

Můžete použít element LinksControlOptions k definování možností pro ovládání, jaké odkazy lze přidat do pracovní položky a výchozí sloupce, které chcete přidat do seznamu odkazů u pracovní položky.Pokud přidáte odkazy ovládacího prvku formuláře pracovní položky, můžete určit filtry, které omezují typy odkazů, které uživatelé mohou zobrazit a vytvořit typy pracovních položek, kterým uživatelé mohou vytvořit propojení.Konkrétně můžete používat následující prvky, jak je uvedeno:

WorkItemLinkFilters: Slouží k omezení typů propojení mezi pracovní položkou v aktuálním týmovém projektu.
ExternalLinkFilters: Slouží k omezení typů odkazů, které lze vytvořit mezi pracovními položkami a dalšími objekty, jako jsou sady změn, hypertextové odkazy nebo soubory kontrolované verze.
WorkItemTypeFilters: Slouží k omezení propojení vztahů, které mohou uživatelé vytvářet na základě typu pracovní položky a je-li je definována pracovní položka v aktuálním týmovém projektu.

V každém z těchto prvků můžete určit prvky Filter pro určení typů vazeb nebo typů pracovních položek, které chcete zahrnout nebo vyloučit.Další informace o použití těchto prvků naleznete v tématu Definice řízení propojení s cílem omezit vztahy určené propojeními.

Element LinksControlOptions je podřízeným prvkem elementu CONTROL.

Hierarchie schémat

<xs:element name="LinksControlOptions" type="LinksControlOptionsType" minOccurs="0"/>
<xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
<xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
<xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="WorkItemTypeFilters"   type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
<xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="reference name" | LinkAttribute="link attribute name"/>
   </LinkColumns>
</LinksControlOptions>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Podřízené prvky a atributy

Element	Atribut	Description
LinksControlOptions		Volitelný element typu Control v případě type="LinksControl". Poskytuje kontejner pro prvky, které definují, jaké odkazy lze přidat do pracovní položky a výchozí sloupce, které chcete zobrazit v seznamu vztahů propojení u pracovní položky. Typ prvku je komplexní typ: LinksControlOptionsType.
WorkItemLinkFilters		Volitelný element LinksControlOptions. Poskytuje kontejner pro jeden nebo více prvků Filter, které popisují kritéria filtru odkazu na typy vazeb, které jsou definovány pro kolekci týmových projektů, a které tvoří vztahy mezi pracovními položkami. Typ prvku je komplexní typ: WorkItemLinkFiltersType.
	FilterType	Požadovaný atribut WorkItemLinkFilters. Definuje metodu, která slouží k filtrování množiny typů odkazů, které jsou k dispozici v sadě prvků Filter.Typ prvku je jednoduchý typ: LinksControlFilterKind. Platné hodnoty, které lze použít, jsou: exclude: Můžete zakázat odkazy vytvářené z typů odkazů uvedených 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í.
Filter		Požadovaný prvek WorkItemLinkFilters, když FilterType je exclude nebo include. Když FilterType je excludeAll nebo includeAll, žádné elementy Filter by neměly být určeny. Určuje typy odkazů, které budou zahrnuty nebo vyloučeny ze sady odkazů, které lze vytvořit pro potřeby pracovní položky.Typ prvku je jednoduchý typ: WorkItemLinkFilterElementType.
	LinkType	Požadovaný atribut Filter. Určuje název typu odkazu.Platné typy zahrnují následující definované typy propojení systému: Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related Kromě toho můžete zadat název odkazu pro vlastní typy odkazů definované pro kolekci týmového projektu.Další informace naleznete v tématu Referenční dokumentace elementů typů propojení.
	FilterOn	Nepovinný atribut Filter. Určuje typ filtru, který chcete aplikovat v typu odkazu.Typ prvku je jednoduchý typ: LinksControlFilterOnKind. Platné hodnoty jsou: 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í. [!POZNÁMKA] Je-li topologie typu propojení síť, dopředný a zpětný název jsou stejné.Další informace naleznete v tématu Referenční dokumentace elementů typů propojení.
ExternalLinkFilters		Volitelný element LinksControlOptions. Poskytuje kontejner pro jeden nebo více prvků Filter, které určují typy vazeb, které mohou uživatelé použít pro tvorbu vztahů k objektům, které nejsou pracovní položky, jako sady změn, hypertextové odkazy a soubory pod správu verze.Typ prvku je komplexní: ExternalLinkFiltersType.
	FilterType	Nepovinný atribut ExternalLinkFilters. Definuje metodu, která slouží k filtrování seznamu typů odkazů, které jsou k dispozici v sadě prvků Filter.Typ prvku je jednoduchý: LinksControlFilterKind. Můžete použít následující hodnoty: exclude: Můžete zakázat odkazy vytvářené z typů odkazů, které se objevují 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.
Filter		Požadovaný prvek ExternalLinkFilters, když FilterType je exclude nebo include. Když FilterType je excludeAll nebo includeAll, žádné elementy Filter by neměly být určeny. Typ prvku je komplexní: ExternalLinkFilterElementType. Určuje název typů odkazů, které budou zahrnuty nebo vyloučeny ze sady odkazů, které uživatelé mohou vytvářet pro potřeby pracovní položky.
	LinkType	Požadovaný atribut Filter. Určuje název typu odkazu, který chcete vyloučit nebo zahrnout.Typ atributu je jednoduchý: ExternalLinkTypeName.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
WorkItemTypeFilters		Volitelný element LinksControlOptions. Poskytuje kontejner pro jeden nebo více prvků Filter, které určují kritéria filtru použitý pro typy pracovní položky. Typ prvku je komplexní: LinksControlWorkItemTypeFiltersElementType.
	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.Typ prvku je jednoduchý typ: LinksControlWorkItemTypeFilterScopeKind. Platné hodnoty, které lze použít, jsou: all: Slouží k povolení vytváření odkazů na všechny typy pracovních položek určených mezi tagy 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, všechny typy pracovních položek jsou povoleny.
	FilterType	Požadovaný atribut WorkItemTypeFilters. Definuje metodu, která slouží k filtrování množiny typů pracovních položek, které jsou k dispozici v sadě prvků Filter.Typ prvku je jednoduchý typ: LinksControlWorkItemTypeFilterKind. Můžete použít následující hodnoty: exclude: Použijte v případě, že chcete zakázat typy položek práce 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 v prvcích Filter. includeAll: Použijte v případě, že chcete povolit všechny typy položek práce. Pokud nezadáte žádnou z těchto hodnot, jsou povoleny odkazy na všechny typy pracovních položek.
Filter		Volitelný prvek WorkItemTypeFilters, v případě, že FilterType je exclude nebo include. Když FilterType je excludeAll nebo includeAll, žádné elementy Filter byste neměli určovat. Určuje typy pracovních položek, které budou zahrnuty nebo vyloučeny ze sady typů pracovních položek, na které lze odkazovat.Typ prvku je komplexní typ: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Požadovaný atribut Filter. Určuje název odkazu na typ pracovní položky, který chcete filtrovat.Typ atributu je: typelib:NonEmptyPlainConstant. Minimální délka: 1; maximální délka: 255. Hodnota vzorku: ^[^\\]*$ Příklad hodnoty vzorku: Úkol
LinkColumns		Volitelný element LinksControlOptions. Poskytuje kontejner pro jeden nebo více prvků LinkColumn.Typ prvku je komplexní typ: LinkColumnsType.
LinkColumn		Požadovaný prvek LinkColumns. Určuje atributy polí pracovních položek a typu odkazu uvedené v seznamu odkazů definovaných pro pracovní položku.Typ prvku je komplexní typ: LinkColumnType. Tento seznam sloupců je výchozí zobrazení.Uživatel může přidat a odebrat sloupce v seznamu odkazů. Pořadí, v jakém jsou prvky LinkColumn uvedeny, definuje pořadí, ve kterém jsou zobrazena pole sloupce ve formuláři položky práce.
	RefName	Nepovinný atribut LinkColumn.Zadejte RefName nebo LinkAttribute, ale ne obojí. Určuje název odkazu odpovídající poli s platnou pracovní položkou pro kolekci týmového projektu.Typ atributu je typelib:ReferenceFieldName.
	LinkAttribute	Nepovinný atribut LinkColumn.Zadejte RefName nebo LinkAttribute, ale ne obojí. Určuje název odkazu odpovídající libovolnému atributu platného typu odkazu pro kolekci týmového projektu.Typ atributu je typelib:ReferenceFieldName.

Nadřazené prvky

Element	Description
Ovládací prvek	Požadováno.Definuje pole, text, hypertextový odkaz nebo jiný ovládací prvek na formuláři pracovní položky.

Poznámky

LinksControlOptions je volitelný podřízený prvek prvku Control, kde ControlType="LinksControl".Můžete použít element LinksControlOptions pro podporu následujících akcí:

Určete omezení, kterými se řídí vytváření vztahů k ostatním pracovním položkám na základě typu odkazu a volitelně dopředné a zpětné názvy typů odkazů.
Určete omezení, kterými se řídí vytváření vztahů mezi jinými objekty, než pracovní položky, jako jsou sady změn, hypertextový odkaz atd., v závislosti na typech externího odkazu.
Určete omezení, kterými se řídí vytváření vztahů k ostatním pracovním položkám na základě typu pracovní položky a volitelně týmový projekt, kde jsou tyto pracovní položky definovány.
Určete výchozí sloupcová pole, která mají zobrazit informace o seznamu propojení.

Příklad

Následující příklad určuje, jak povolit vytváření odkazů, jejichž typem je Microsoft.VSTS.Common.TestedBy, a představuje Forward Name pro tento typ odkazu.Možnosti filtrování zakazují vytváření odkazů na všechny typy externích odkazů.Kromě toho zobrazená výchozí sloupcová pole pro uvedené odkazy odpovídají následujícím popisným názvům: ID, typ pracovní položky, název, přiřazeno, stav a pole Poznámka definované pro odkaz.Další příklady naleznete v tématu Definice řízení propojení s cílem omezit vztahy určené propojeními.

<Control Type="LinksControl" Name="TestedBy" Label="&amp;Work items testing this bug:" LabelPosition="Top">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="Microsoft.VSTS.Common.TestedBy" FilterOn="forwardname" />
      </WorkItemLinkFilters>
      <WorkItemTypeFilters FilterType="include">
          <Filter WorkItemType="Test Case" />
      </WorkItemTypeFilters>
          <ExternalLinkFilters FilterType="excludeAll"/>
      <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>

Tlačítka panelu nástrojů LinksControl

Každý element ControlType=”LinksControl” obsahuje panel nástrojů, který obsahuje tlačítka, která ukazuje následující obrázek:

Pracovní položka ovládacích prvků formuláře odkaz panel nástrojů

Tato tlačítka jsou zpřístupněna pouze po provedení určité akce:

Tlačítko pro vytvoření pracovní položky, které je propojené s otevřenou pracovní položkou (), bude k dispozici pouze po uložení otevřené pracovní položky.
Tlačítka pro otevření seznamu pracovních položek v dotazu () a klienta Microsoft Office () budou k dispozici pouze pokud je alespoň jedna pracovní položka uvedena na kartě pro řízení odkazů.
Tlačítka pro otevření pracovní položky (), úpravu odkazu () a odstranění odkazu () budou k dispozici pouze po kliknutí na jednu nebo více pracovních položek uvedených na kartě pro řízení odkazů.

Ovládací prvek odkazu, který je zobrazen, je stejný pro Team Web Access i Průzkumník týmových projektů. Výjimkou je případ, kdy je nakonfigurován pouze pro vykreslení odkazů Storyboard.V tomto případě panel nástrojů obsahuje pouze tyto ovládací prvky pro přidání nového odkazu, otevření propojené položky a odstranění odkazu.Verze Team Web Access také zobrazí odkaz Spustit scénáře v nabídce ovládání.

Prvek odkazy scénáře v týmu Web Access

Definice schémat

LinksControlOptionsType
WorkItemLinkFiltersType
WorkItemLinkFilterElementType
ExternalLinkFiltersType
ExternalLinkFilterElementType
LinksControlFilterKind
LinksControlFilterOnKind
ExternalLinkTypeName
LinksControlWorkItemTypeFiltersElementType
LinksControlWorkItemTypeFilterElementType
LinksControlWorkItemTypeFilterScopeKind
LinksControlWorkItemTypeFilterKind
LinkColumnsType
LinkColumnType

LinksControlOptionsType

<xs:complexType name="LinksControlOptionsType">
   <xs:all>
      <xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
      <xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemTypeFilters" type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
   </xs:all>
</xs:complexType>

WorkItemLinkFiltersType

<xs:complexType name="WorkItemLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

WorkItemLinkFilterElementType

<xs:complexType name="WorkItemLinkFilterElementType" >
   <xs:attribute name="LinkType" type="typelib:ReferenceFieldName" use="required" />
   <xs:attribute name="FilterOn" type="LinksControlFilterOnKind" use="optional" />
</xs:complexType>

ExternalLinkFiltersType

<xs:complexType name="ExternalLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

ExternalLinkFilterElementType

<xs:complexType name="ExternalLinkFilterElementType" >
   <xs:attribute name="LinkType" type="ExternalLinkTypeName" use="required" />
</xs:complexType>

LinksControlFilterKind

<xs:simpleType name="LinksControlFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
      <xs:enumeration value="excludeAll" />
   </xs:restriction>
</xs:simpleType>

LinksControlFilterOnKind

<xs:simpleType name="LinksControlFilterOnKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="forwardname" />
      <xs:enumeration value="reversename" />
   </xs:restriction>
</xs:simpleType>

ExternalLinkTypeName

<xs:simpleType name="ExternalLinkTypeName">
   <xs:restriction base="xs:string">
      <xs:minLength value="1"/>
      <xs:maxLength value="128"/>
   </xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFiltersElementType

<xs:complexType name="LinksControlWorkItemTypeFiltersElementType" >
   <xs:sequence>
      <xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="Scope" type="LinksControlWorkItemTypeFilterScopeKind" use="optional" />
      <xs:attribute name="FilterType" type="LinksControlWorkItemTypeFilterKind" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterElementType

<xs:complexType name="LinksControlWorkItemTypeFilterElementType" >
   <xs:attribute name="WorkItemType" type="typelib:NonEmptyPlainConstant" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterScopeKind

<xs:simpleType name="LinksControlWorkItemTypeFilterScopeKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="project" />
   <xs:enumeration value="all" />
</xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFilterKind

<xs:simpleType name="LinksControlWorkItemTypeFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
   </xs:restriction>
</xs:simpleType>

LinkColumnsType

<xs:complexType name="LinkColumnsType" >
   <xs:sequence>
      <xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>
   </xs:sequence>
</xs:complexType>

LinkColumnType

<xs:complexType name="LinkColumnType" >
   <!-- Must be one or the other, but not both -->
      <xs:attribute name="LinkAttribute" type="typelib:ReferenceFieldName" use="optional" />
      <xs:attribute name="RefName" type="typelib:ReferenceFieldName" use="optional" />
</xs:complexType>

Informace prvku

Obor názvů	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Název schématu	Definice typu pracovní položky
Soubor ověření	WorkItemTypeDefinition.xsd
Typ prvku	LinksControlOptionsType
Může být prázdné	Nelze použít

Viz také

Koncepty

Referenční dokumentace elementů typů propojení

Určení ovládacích prvků ve formuláři pracovní položky

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

Další zdroje

Definice vlastního typu propojení

Sdílet prostřednictvím