LinksControlOptions prvky

Článek
03/26/2013

Můžete použít LinksControlOptions prvek definovat možnosti pro řízení, jaké odkazy mohou být přidány 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 vazby formuláře pracovních položek, můžete určit filtry, které omezují typy odkazů, že uživatelům lze zobrazit a vytvořit, a typy pracovních položek, které uživatelům lze vytvořit propojení.Konkrétně můžete následující prvky, jak je uvedeno:

WorkItemLinkFilters: Slouží k omezení typů vazeb mezi prací v týmu projektu.
ExternalLinkFilters: Slouží k omezení typů odkazů, které lze vytvořit mezi prací a jiných objektů, jako jsou sady změn, hypertextové odkazy nebo soubory kontrolované verze.
WorkItemTypeFilters: Pomocí propojení vztahů, které mohou uživatelé vytvářet na základě položky typu práce a zda je pracovní položka definována v aktuálním projektu týmu.

V každém z těchto prvků, můžete určit Filter prvky určit typy vazby nebo pracovní položka typy, 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.

Prvek LinksControlOptions je podřízeným prvkem prvku CONTROL.

Schéma hierarchie

<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

Element	Atribut	Description
LinksControlOptions		Volitelný Control prvek při type="LinksControl". Poskytuje kontejner pro elementy, které definují, jaké odkazy mohou být přidány do pracovní položky a výchozí sloupce, které chcete zobrazit seznam odkazů vztahy pracovní položka. Typ elementu je komplexní typ: LinksControlOptionsType.
WorkItemLinkFilters		Volitelný element typu LinksControlOptions. Poskytuje kontejner pro jednu nebo více Filter elementy, které určují propojení filtrovat kritéria pro typy vazeb, které jsou definovány pro kolekce týmového projektu a který vytvářet vztahy mezi pracovní položky. Typ elementu je komplexní typ: WorkItemLinkFiltersType.
	FilterType	Požadovaný atribut typu WorkItemLinkFilters. Definuje metody, které slouží k filtrování sady typů odkazů, které jsou k dispozici v sadě Filter prvky.Typ elementu, který je jednoduchý typ: LinksControlFilterKind. Platné hodnoty, které lze použít jsou: exclude: Umožňuje zakázat odkazy na vytvořené z těchto typů odkazů, které jsou uvedeny v Filter prvky. excludeAll: Pomocí zakázat všechny typy vazeb. include: Použít pouze ty typy vazeb v Filter prvky. includeAll: Použijte odkazy na vytvořené ze všech typů propojení.
Filter		Required WorkItemLinkFilters element when the FilterType is exclude or 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 odkazů, které lze vytvořit pracovní položky.Typ elementu, který je jednoduchý typ: WorkItemLinkFilterElementType.
	LinkType	Požadovaný atribut typu Filter. Určuje název odkazu pro typ odkazu.Platné typy zahrnují následující typy propojení systému, které jsou definovány: Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related Kromě toho můžete zadat název odkazu pro vlastní odkaz typy definované pro kolekce týmového projektu.Další informace naleznete v tématu Referenční dokumentace elementu typu propojení.
	FilterOn	Nepovinný atribut Filter. Určuje typ filtru, který platí pro typ odkazu.Typ elementu, který je jednoduchý typ: LinksControlFilterOnKind. Platné hodnoty: forwardname: Slouží k filtrování názvu vpřed, určené pro typ odkazu. reversename: Slouží k filtrování na reverzní jméno určené pro typ odkazu. Pokud tento parametr nezadáte, dopředného a zpětného názvy slouží k filtrování typ propojení. Poznámka Je-li propojení typu topologie sítě, dopředného a zpětného názvy jsou stejné.Další informace naleznete v tématu Referenční dokumentace elementu typu propojení.
ExternalLinkFilters		Volitelný element typu LinksControlOptions. Poskytuje kontejner pro jednu nebo více Filter prvky, které určují typy vazeb, které mohou uživatelé vytvářet vztahy k objektům, které jsou nefunguje položek, jako jsou sady změn, hypertextové odkazy a soubory pod správu verzí.Typ elementu, který je složitý: ExternalLinkFiltersType.
	FilterType	Nepovinný atribut ExternalLinkFilters. Definuje metody, které slouží k filtrování seznamu typů odkazů, které jsou k dispozici v sadě Filter prvky.Typ elementu, který je jednoduchý: LinksControlFilterKind. Můžete použít následující hodnoty: exclude: Umožňuje zakázat odkazy na vytvořené z těchto typů propojení, které se zobrazují v Filter prvky. excludeAll: Pomocí zakázat všechny typy vazeb. include: Použít pouze ty typy vazeb v Filter prvky. includeAll: Použijte odkazy na vytvořené ze všech typů propojení. Je-li tento parametr zadán, jsou vyloučeny všechny odkazy na externí pracovní položky.
Filter		Required ExternalLinkFilters element when the FilterType is exclude or include. Když FilterType je excludeAll nebo includeAll, ne Filter stanovit prvky. Typ elementu, který je složitý: ExternalLinkFilterElementType. Určuje název typy odkazů, které budou zahrnuty nebo vyloučeny ze sady odkazů, které mohou uživatelé vytvářet pracovní položky.
	LinkType	Požadovaný atribut typu Filter. Určuje název odkazu pro typ vazby k vyloučení nebo zahrnutí.Atribut type je jednoduchá: ExternalLinkTypeName.Můžete zadat následující typy propojení: V sady změn Výsledek přílohy Soubor zdrojového kódu Výsledek zkoušky Pracovní položku hypertextového odkazu
WorkItemTypeFilters		Volitelný element typu LinksControlOptions. Poskytuje kontejner pro jednu nebo více Filter elementy, které určují kritéria filtru vyrovnat pracovní položka typy. Typ elementu, který je složitý: LinksControlWorkItemTypeFiltersElementType.
	Scope	Nepovinný atribut WorkItemTypeFilters. Určuje rozsah filtr pro nastavení typů položek práce k dispozici v sadě Filter prvky.Typ elementu, který je jednoduchý typ: LinksControlWorkItemTypeFilterScopeKind. Platné hodnoty, které lze použít jsou: all: Pomocí odkazů, které mají být vytvořeny pro všechny typy položek práce uvedené v povolení Filter značky. project: Slouží k povolení odkazů, které mají být vytvořeny pouze pro ty položky typy práce, které jsou definovány pro aktuální projekt. Je-li tento parametr zadán, jsou povoleny odkazy na všechny typy pracovních položek.
	FilterType	Požadovaný atribut typu WorkItemTypeFilters. Definuje metody, které slouží k filtrování sady typů položek práce k dispozici v sadě Filter prvky.Typ elementu, který je jednoduchý: LinksControlWorkItemTypeFilterKind. Můžete použít následující hodnoty: exclude: Slouží k zakázání položky typy práce v Filter prvky. excludeAll: Pomocí zakázat všechny typy pracovních položek. include: Slouží k povolení práce typy položek v Filter prvky. includeAll: Použijte všechny typy pracovních položek. Pokud nezadáte žádný z těchto hodnot, jsou povoleny odkazy na všechny typy pracovních položek.
Filter		Optional WorkItemTypeFilters element when the FilterType is exclude or include. Když FilterType je excludeAll nebo includeAll, byste neměli zadávat žádné Filter prvky. Určuje typy pracovních položek, které mají být zahrnuty nebo vyloučeny ze sady položky typy prací, které lze propojit.Typ elementu je komplexní typ: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Požadovaný atribut typu Filter. Určuje název odkazu typu pracovní položky mají být filtrovány.Atribut type je: typelib:NonEmptyPlainConstant. Minimální délka: 1; Maximální délka: 255. Vzorek hodnota: ^ [^ \\] *$ Příklad hodnoty vzorek: úkol
LinkColumns		Volitelný element typu LinksControlOptions. Poskytuje kontejner pro jednu nebo více LinkColumn prvky.Typ elementu je komplexní typ: LinkColumnsType.
LinkColumn		Požadované LinkColumns prvku. Určuje pracovní položky pole a zobrazí seznam odkazů, které jsou definovány pro pracovní položku atributy typu odkaz.Typ elementu je komplexní typ: LinkColumnType. Tento seznam sloupců je výchozí zobrazení.Uživatele můžete přidat a odebrat sloupce ze seznamu odkazů. Pořadí, v němž LinkColumn prvky jsou uvedeny definuje pořadí, ve kterém jsou zobrazena pole sloupce v formulář pracovní položka.
	RefName	Nepovinný atribut LinkColumn.Zadejte RefName nebo LinkAttribute, ale nikoli oba současně. Určuje název odkazu odpovídající pole položky platné práce pro kolekce týmového projektu.Atribut type je typelib:ReferenceFieldName.
	LinkAttribute	Nepovinný atribut LinkColumn.Zadejte RefName nebo LinkAttribute, ale nikoli oba současně. Určuje název odkazu, který odpovídá libovolný atribut typu platný odkaz pro kolekce týmového projektu.Atribut type je typelib:ReferenceFieldName.

Rodičovské elementy

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

Poznámky

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

Zadejte omezení, která řídí vytváření vztahů k jiné pracovní položky na základě typu propojení a v případě potřeby dopředného a zpětného názvy typů propojení.
Zadejte omezení, které řídí vytváření vztahů s objekty jiné než práce položek, jako jsou například sady změn, hypertextový odkaz a tak dále, v závislosti na typech externí odkaz.
Zadejte omezení, které řídí vytváření vztahů k jiné pracovní položky na základě položky typu práce a v případě potřeby jsou definovány týmového 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ů, jejíž typ je Microsoft.VSTS.Common.TestedBy a zobrazit Forward Name pro tento typ propojení.Možnosti filtrování zakázat vytváření odkazů na všechny typy externího odkazu.Kromě toho zobrazí výchozí sloupec pole uvedené odkazy odpovídají následujícím popisné názvy: ID položky typu práce, titul, přiřazeno, stát a pole Poznámka, které jsou definovány jako 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ý Control prvku Type=”LinksControl” obsahuje panel nástrojů, který obsahuje tlačítka zobrazená v následující ilustraci:

Pracovní položka ovládací prvky panelu nástrojů formuláře odkaz

Tato tlačítka k dispozici pouze po provedení určité akce:

Tlačítko Vytvořit pracovní položku, která je propojena na otevřené pracovní položka () je k dispozici pouze po uložení otevřít pracovní položku.
Tlačítka pro otevření seznamu pracovních položek v dotazu () a v klientovi aplikace Microsoft Office () jsou k dispozici pouze při alespoň jeden pracovní položky uvedené na kartě odkazy ovládacího prvku.
Tlačítka otevřete pracovní položka (), Úprava odkazu () a odstranit odkaz () k dispozici teprve poté, co klepnete na jeden nebo více pracovních položek seznamu na kartě odkazy ovládacího prvku.

Propojení ovládacího prvku, který je zobrazen je stejný pro obě Team Web Access a Průzkumník týmových projektů, s výjimkou toho, když je nakonfigurován tak, aby pouze vykreslení Storyboard odkazy.V takovém případě panel nástrojů obsahuje pouze tyto ovládací prvky přidat nový odkaz, otevřete propojené položky a odstranit odkaz.Také Team Web Access verze, zobrazí Start Storyboarding odkaz v nabídce ovládání.

Prvek odkazy scénáře v Team 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
Ověřovací soubor	WorkItemTypeDefinition.xsd
Typ elementu	LinksControlOptionsType
Může být prázdný.	Nelze použít

Viz také

Koncepty

Referenční dokumentace elementu typu 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í

Historie změn

Datum	Historie	Důvod
Září 2012	Opravena velká struktury syntaxe.Všechny výčtové hodnoty jsou malá a velká písmena.	Oprava chyby obsahu

Září 2012

Opravena velká struktury syntaxe.Všechny výčtové hodnoty jsou malá a velká písmena.

Oprava chyby obsahu

Sdílet prostřednictvím