LinksControlOptions prvky

Článek
08/11/2011

Použití LinksControlOptions prvku definovat možnosti pro kontrolu odkazů, které lze přidat do pracovní položky a výchozí sloupce, které chcete zobrazit seznam odkazů v pracovní položky. Při přidání ovládacího prvku odkazy formuláře položky práce, můžete určit filtry, které omezují typy odkazů, že uživatelé lze zobrazit a vytvořit a typy pracovních položek, které uživatelům lze vytvořit propojení. Konkrétně pomocí následující prvky, jak je uvedeno:

WorkItemLinkFilters: Slouží k omezení typů vazeb mezi pracovních položek v aktuálním projektu týmu.
ExternalLinkFilters: Slouží k omezení typů odkazů, které lze vytvořit mezi pracovních položek a další objekty, jako například changesets, hypertextové odkazy nebo soubory kontrolované verze.
WorkItemTypeFilters: Pomocí propojení vztahy, které mohou uživatelé vytvářet na základě položky typu práce a zda je definován pracovní položku v aktuální tým projektu.

Každý z těchto prvků můžete určit Filter prvky určit typy vazby nebo práci typy položek, které chcete zahrnout nebo vyloučit. Další informace o použití těchto prvků naleznete Definování propojení prvků omezit propojení vztahů.

LinksControlOptions Je prvek podřízený prvek CONTROL prvku.

Hierarchii schématu

<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 rodičovské prvky.

Podřízené prvky a atributy

Prvek	Atribut	Popis
LinksControlOptions		Volitelný Control prvek při type="LinksControl". Poskytuje pracovní položky a zobrazit seznam odkazů vztahy pracovní položka výchozí sloupce lze přidat kontejner pro prvky, které definují, jaké odkazy. Komplexní typ je typ prvku: LinksControlOptionsType.
WorkItemLinkFilters		Volitelný LinksControlOptions prvku. Kontejner obsahuje jeden nebo více Filter prvky, které zadat odkaz kritéria pro typy vazeb, jsou definovány pro kolekci týmu projektu a který vytvořit vztahy mezi pracovní položky filtru. Komplexní typ je typ prvku: WorkItemLinkFiltersType.
	FilterType	Požadované WorkItemLinkFilters atributu. Definuje metodu filtrování sady typů odkazů uvedených v sadě Filter prvky. Jednoduchý typ je typ prvku: LinksControlFilterKind. Můžete použít platné hodnoty jsou: exclude: Použití zakázat odkazy vytvořené z těchto typů odkazů uvedených v Filter prvky. excludeAll: Zakázat všechny typy propojení pomocí. include: Použít pouze tyto typy vazby uvedené v povolení Filter prvky. includeAll: Použijte odkazy vytvořené ze všech typů propojení.
Filter		Požadované WorkItemLinkFilters prvek při FilterType je exclude nebo include. Když FilterType je excludeAll nebo includeAll, ne Filter stanovit prvky. Určuje typy odkazů, které mají být zahrnuty nebo vyloučeny ze sady odkazy vytvořené pro položku. Jednoduchý typ je typ prvku: WorkItemLinkFilterElementType.
	LinkType	Požadované Filter atributu. Určuje název odkazu pro typ odkazu. Typ atributu je typelib:ReferenceFieldName. Další informace naleznete v tématu Práce s typy odkazů.
	FilterOn	Volitelný Filter atributu. Určuje typ filtru použít typ propojení. Jednoduchý typ je typ prvku: LinksControlFilterOnKind. Platné hodnoty: forwardName: Pomocí filtrování předávání název definovaný typ propojení. revserseName: Použijte filtr na zpětné název definovaný typ propojení. Pokud tento parametr nezadáte, dopředného a zpětného názvy slouží k filtrování typ propojení. Poznámka Pokud je propojení typu topologie sítě, jsou názvy dopředného a zpětného stejné.Další informace naleznete v tématu Práce s typy odkazů.
ExternalLinkFilters		Volitelný LinksControlOptions prvku. Kontejner obsahuje jeden nebo více Filter prvky, které určit typy propojení zadané uživateli vytvořit vztahy k objektům, které nebudou fungovat položek, například changesets, hypertextové odkazy a soubory pod kontrolu verze. Je komplexní typ prvku: ExternalLinkFiltersType.
	FilterType	Volitelný ExternalLinkFilters atributu. Definuje metodu, která slouží k filtrování seznamu typů odkazů uvedených v sadě Filter prvky. Typ prvku je jednoduché: LinksControlFilterKind. Můžete použít následující hodnoty: exclude: Použití zakázat odkazy vytvořené z těchto typů propojení v Filter prvky. excludeAll: Zakázat všechny typy propojení pomocí. include: Použít pouze tyto typy vazby uvedené v povolení Filter prvky. includeAll: Použijte odkazy vytvořené ze všech typů propojení. Pokud tento parametr nezadáte, všechny odkazy na externí pracovní položky jsou vyloučeny.
Filter		Požadované ExternalLinkFilters prvek při FilterType je exclude nebo include. Když FilterType je excludeAll nebo includeAll, ne Filter stanovit prvky. Je komplexní typ prvku: ExternalLinkFilterElementType. Určuje název typy vazeb, které budou zahrnuty nebo vyloučeny ze sady odkazy, které mohou uživatelé vytvářet pracovní položky.
	LinkType	Požadované Filter atributu. Určuje název odkazu pro typ odkazu vyloučit nebo zahrnout. Typ atributu je jednoduché: ExternalLinkTypeName. Můžete zadat následující typy spojení: Pevné Changeset Výsledek přílohy Zdrojový kód souboru Výsledek zkoušky Pracovní položku hypertextový odkaz
WorkItemTypeFilters		Volitelný LinksControlOptions prvku. Kontejner obsahuje jeden nebo více Filter prvky, které zadat kritéria filtru pro práci typy položek. Je komplexní typ prvku: LinksControlWorkItemTypeFiltersElementType.
	Scope	Volitelný WorkItemTypeFilters atributu. Definuje rozsah filtru použít sadu typů položek práce v sadě Filter prvky. Jednoduchý typ je typ prvku: LinksControlWorkItemTypeFilterScopeKind. Můžete použít platné hodnoty jsou: all: Můžete povolit odkazy vytvořeny všech typů práce položky zadané v Filter značky. project: Použijte odkazy vytvořeny pouze pro tyto typy položek práce definované pro aktuální projekt. Pokud tento parametr nezadáte, jsou povoleny odkazy na všechny typy pracovních položek.
	FilterType	Požadované WorkItemTypeFilters atributu. Definuje metodu používanou k filtrování sady typů položek práce v sadě Filter prvky. Typ prvku je jednoduché: LinksControlWorkItemTypeFilterKind. Můžete použít následující hodnoty: exclude: Použití zakázat položky typy práce v Filter prvky. excludeAll: Použití všech typů práce položku zakázat. include: Můžete povolit práci typy položek v Filter prvky. includeAll: Použijte všechny typy položek práce. Pokud nezadáte žádný z těchto hodnot, odkazů na všechny typy položek práce jsou povoleny.
Filter		Volitelný WorkItemTypeFilters prvek při FilterType je exclude nebo include. Když FilterType je excludeAll nebo includeAll, neměli byste zadávat žádné Filter prvky. Určuje typy pracovních položek, které mají být zahrnuty nebo vyloučeny ze sady práce typy položek, které lze propojit. Komplexní typ je typ prvku: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Požadované Filter atributu. Určuje název odkazu filtrované položky typu práce. Typ atributu je: typelib:NonEmptyPlainConstant. Minimální délka: 1; Maximální délka: 255. Hodnota vzorek: ^[^\\]*$ Vzorek Příklad hodnoty: Úloha
LinkColumns		Volitelný LinksControlOptions prvku. Kontejner obsahuje jeden nebo více LinkColumn prvky. Komplexní typ je typ prvku: LinkColumnsType.
LinkColumn		Požadované LinkColumns prvku. Určuje atributy typu odkaz zobrazí seznam odkazů definované pracovní položky a položky pole práce. Komplexní typ je typ prvku: LinkColumnType. Tento seznam sloupců je výchozí zobrazení. Uživatele můžete přidat nebo odebrat sloupce v seznamu odkazů. Pořadí, v němž LinkColumn jsou uvedeny prvky definuje pořadí zobrazení sloupců polí ve formuláři položky práce.
	RefName	Volitelný LinkColumn atributu. Určit RefName nebo LinkAttribute, ale ne obojí. Určuje název odkazu odpovídající pole položka platná práce týmu projektu kolekce. Typ atributu je typelib:ReferenceFieldName.
	LinkAttribute	Volitelný LinkColumn atributu. Určit RefName nebo LinkAttribute, ale ne obojí. Určuje název odkazu odpovídající všechny atributy typu kolekce týmu projektu platný odkaz. Typ atributu je typelib:ReferenceFieldName.

Nadřazené prvky

Prvek	Popis
OVLÁDACÍ PRVEK	Povinné. Definuje pole, text, hypertextový odkaz nebo jiný prvek ovládací prvek na formuláři práce.

Poznámky

LinksControlOptionsje volitelné podřízený prvek CONTROL prvek kde ControlType="LinksControl". Můžete použít LinksControlOptions prvek podporovat následující akce:

Určete omezení, které řídí vytváření vztahů typ propojení a volitelně dopředného a zpětného názvy typů odkazů na základě jiných pracovních položek.
Určete omezení, které řídí vytváření vztahů s objekty jiné než práce položek, například changeset, hypertextový odkaz a podobně, na základě typů externích odkazů.
Určit omezení, které řídí creationg vztahy v závislosti na typu položky práce jiných pracovních položek a volitelně definované týmu projektu, kde jsou pracovní položky.
Určete výchozí sloupcová pole, které chcete zobrazit informace o propojení seznamu.

Příklad

Následující příklad určuje, jak povolit vytváření odkazů, jejichž typ je Microsoft.VSTS.Common.TestedBy a Forward Name pro tento typ odkazu. Možnosti filtru zakázat vytváření odkazů na všechny typy externí odkaz. Kromě toho sloupcová pole zobrazená výchozí odkazy uvedené odpovídají popisné názvy následující: ID položky typu práce, nadpis, přiřazeno, stát a definice propojení pole Poznámka. Další příklady naleznete v tématu Definování propojení prvků omezit propojení vztahů.

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

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	Zadejte definici pracovní položky
Ověřovací soubor	WorkItemTypeDefinition.xsd
Typ prvku	LinksControlOptionsType
Může být prázdný.	Nelze použít

Viz také

Koncepty

Práce s typy odkazů

Určení pracovní položky ovládací prvky

Další zdroje

Přizpůsobení způsobu pracovní položky související prostřednictvím typů spojení

Definování propojení prvků omezit propojení vztahů

Historie změn

Datum	Poslední dokumenty	Důvod
Leden 2011	Nahradit odkazy na témata, které byly odebrány.	Rozšíření informace
Červenec 2010	Přidán úplný seznam odkazu názvy, které lze použít ExternalLinkFilters prvku.	Oprava chyby obsahu
Červen 2010	Revidován popisů ExternalLinkFilters a WorkItemTypeFilters prvky.	Oprava chyby obsahu

Leden 2011

Nahradit odkazy na témata, které byly odebrány.

Rozšíření informace

Červenec 2010

Přidán úplný seznam odkazu názvy, které lze použít ExternalLinkFilters prvku.

Oprava chyby obsahu

Červen 2010

Revidován popisů ExternalLinkFilters a WorkItemTypeFilters prvky.