LinksControlOptions – elementy

Článek
09/11/2015

Můžete použít LinksControlOptions elementu, který chcete definovat možnosti pro ovládání, co odkazy mohou být přidány do pracovní položkou a výchozí sloupce, které chcete zobrazit seznam odkazů v pracovní položku. Když přidáte ovládací prvek odkazy do formuláře pracovních položek, můžete určit filtry, které omezit typy odkazů, zda uživatelé mohou být zobrazení a vytvořit, a typy pracovních položek, které uživatelům můžete vytvořit vazbu. Jak je uvedeno se konkrétně, použijte následující prvky:

WorkItemLinkFilters: Slouží k omezení typy odkazů mezi pracovními položkami v aktuální týmový projekt.
ExternalLinkFilters: Slouží k omezení typy odkazů, které lze vytvořit mezi pracovními položkami a ostatní objekty, například sad změn, hypertextové odkazy nebo souborů s verzemi, které řídí.
WorkItemTypeFilters: Slouží k omezení odkaz vztahy, které mohou uživatelé vytvářet na základě typ pracovní položky a zda je definována pracovní položku v aktuální týmový projekt.

V každé z těchto elementů, můžete určit Filter prvky určit typy odkazů nebo pracovní položky typy, které chcete zahrnout nebo vyloučit. Další informace o tom, jak používat tyto prvky naleznete v tématu Definice řízení propojení s cílem omezit vztahy určené propojeními.

LinksControlOptions Element je podřízený element elementu CONTROL elementu.

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 elementy

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

Podřízené prvky a atributy

Element	Atribut	Popis
LinksControlOptions		Volitelný Control element při type="LinksControl". Poskytuje kontejner pro elementy, které definují, jaké odkazy mohou být přidány do pracovní položkou a výchozí sloupce, které chcete-li zobrazit seznam vztahů odkaz v pracovní položku. Typ elementu je komplexní typ: LinksControlOptionsType.
WorkItemLinkFilters		Volitelný LinksControlOptions elementu. Poskytuje kontejner pro jednu nebo více Filter elementy, které určují odkaz filtrovat kritéria, která má být použit pro typy odkazů, které jsou definovány pro kolekce týmových projektů a která vytvořit relace mezi pracovními položkami. Typ elementu je komplexní typ: WorkItemLinkFiltersType.
	FilterType	Požadované WorkItemLinkFilters atributu. Definuje metodu použitou k filtrování sady typů odkazu poskytovaných v sadě Filter elementy. Typ elementu je jednoduchý typ: LinksControlFilterKind. Platné hodnoty, které můžete použít jsou: exclude: Používat tak, aby nepovoloval odkazy, které má být vytvořen z těchto typy odkazů, které jsou uvedeny v Filter elementy. excludeAll: Pomocí tak, aby nepovoloval všechny typy odkazů. include: Pomocí můžete povolit pouze tyto typy odkazů, které jsou uvedeny v Filter elementy. includeAll: Slouží k povolení odkazů, které má být vytvořen ze všech typů odkazu.
Filter		Požadované WorkItemLinkFilters element při FilterType je exclude nebo include. Pokud FilterType je excludeAll nebo includeAll, ne Filter elementy musí být zadán. Určuje typy odkazů, které se mají být zahrnuty nebo vyloučeny ze sady odkazů, které lze vytvořit pro pracovní položku. Typ elementu je jednoduchý typ: WorkItemLinkFilterElementType.
	LinkType	Požadované Filter atributu. Určuje název odkazu pro typ vazby. Platné typy zahrnují následující typy systému definované odkaz: Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related Kromě toho můžete určit název odkazu pro typy vlastních odkazů definované pro kolekce týmových projektů. Další informace naleznete v tématu Link type element reference.
	FilterOn	Volitelný Filter atributu. Určuje typ filtru, který se použije k tomuto typu odkaz. Typ elementu je jednoduchý typ: LinksControlFilterOnKind. Platné hodnoty jsou: forwardname: Použijte k filtrování vpřed název definovaný pro typ vazby. reversename: Slouží k filtrování na reverzní název definovaný pro typ vazby. Je-li tento parametr zadán, dopředná a zpětná názvy jsou použity k filtrování typ propojení. Poznámka Je-li odkaz typu topologie sítě, dopředná a zpětná názvy jsou stejné.Další informace naleznete v tématu Link type element reference.
ExternalLinkFilters		Volitelný LinksControlOptions elementu. Poskytuje kontejner pro jednu nebo více Filter elementy, které určují typy odkazů, které mohou uživatelé zadat k vytvoření relací na objekty, které není pracovních položek, například sady změn, hypertextové odkazy a soubory pod správu verzí. Typ elementu je komplexní: ExternalLinkFiltersType.
	FilterType	Volitelný ExternalLinkFilters atributu. Definuje metodu, která se používá k filtrování seznamu typů odkazu poskytnuté v sadě Filter elementy. Typ elementu je jednoduchá: LinksControlFilterKind. Můžete použít následující hodnoty: exclude: Používat tak, aby nepovoloval odkazy, které má být vytvořen z těchto typů odkazů, které se zobrazují v Filter elementy. excludeAll: Pomocí tak, aby nepovoloval všechny typy odkazů. include: Pomocí můžete povolit pouze tyto typy odkazů, které jsou uvedeny v Filter elementy. includeAll: Slouží k povolení odkazů, které má být vytvořen ze všech typů odkazu. Je-li tento parametr zadán, jsou vyloučeny všechny odkazy na externí pracovní položky.
Filter		Požadované ExternalLinkFilters element při FilterType je exclude nebo include. Pokud FilterType je excludeAll nebo includeAll, ne Filter elementy musí být zadán. Typ elementu je komplexní: ExternalLinkFilterElementType. Určuje název typy odkazů, které budou zahrnuty nebo vyloučeny ze sady odkazů, které mohou uživatelé vytvářet pro pracovní položku.
	LinkType	Požadované Filter atributu. Určuje název odkazu pro typ vazby, které chcete vyloučit nebo zahrnout. Typ atributu je jednoduchý: ExternalLinkTypeName. Můžete 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ý odkaz
WorkItemTypeFilters		Volitelný LinksControlOptions elementu. Poskytuje kontejner pro jednu nebo více Filter elementy, které určují kritéria filtru, který má být použita pro pracovní položky typy. Typ elementu je komplexní: LinksControlWorkItemTypeFiltersElementType.
	Scope	Volitelný WorkItemTypeFilters atributu. Definuje rozsah je použit k sadě pracovní položka typů poskytovaných v sadě filtr Filter elementy. Typ elementu je jednoduchý typ: LinksControlWorkItemTypeFilterScopeKind. Platné hodnoty, které můžete použít jsou: all: Slouží k povolení odkazů, které má být vytvořen pro všechny typy pracovních položek zadané v Filter klíčová slova. project: Slouží k povolení odkazů, které má být vytvořen pouze pro tyto typy pracovní položky, 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é WorkItemTypeFilters atributu. Definuje metodu, která se používá k filtrování sadu typů pracovní položku v sadě Filter elementy. Typ elementu je jednoduchá: LinksControlWorkItemTypeFilterKind. Můžete použít následující hodnoty: exclude: Používat tak, aby nepovoloval typy pracovních položek v Filter elementy. excludeAll: Pomocí tak, aby nepovoloval všechny typy pracovních položek. include: Slouží k povolení typy pracovních položek v Filter elementy. includeAll: Pomocí chcete, aby všechny typy pracovních položek. Pokud nezadáte některé z těchto hodnot, jsou povoleny odkazy na všechny typy pracovních položek.
Filter		Volitelný WorkItemTypeFilters element při FilterType je exclude nebo include. Pokud FilterType je excludeAll nebo includeAll, neměla by být zadána jakékoli Filter elementy. Určuje typy pracovních položek, které mají být zahrnuty nebo vyloučeny ze sady typů pracovní položky, které lze propojit. Typ elementu je komplexní typ: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Požadované Filter atributu. Určuje název odkaz na typ pracovní položky, které mají být filtrovány. Typ atributu je: typelib:NonEmptyPlainConstant. Minimální délka: 1; Maximální délka: 255. Hodnota vzorku: ^ [^ \\] * $ Příklad hodnoty vzor: úloha
LinkColumns		Volitelný LinksControlOptions elementu. Poskytuje kontejner pro jednu nebo více LinkColumn elementy. Typ elementu je komplexní typ: LinkColumnsType.
LinkColumn		Požadované LinkColumns elementu. Určuje pole pracovních položek a atributy typu odkaz zobrazí seznam odkazů, které jsou definovány pro pracovní položku. Typ elementu je komplexní typ: LinkColumnType. Tento seznam sloupec 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 zobrazeny sloupcová pole ve formuláři pracovní položku.
	RefName	Volitelný LinkColumn atributu. Zadejte RefName nebo LinkAttribute, ne však obojí. Určuje název odkazu odpovídající pole platný pracovní položky pro kolekce týmových projektů. Typ atributu je typelib:ReferenceFieldName.
	LinkAttribute	Volitelný LinkColumn atributu. Zadejte RefName nebo LinkAttribute, ne však obojí. Určuje název odkazu odpovídající jakéhokoliv atributu pro typ platný odkaz pro kolekce týmových projektů. Typ atributu je typelib:ReferenceFieldName.

Nadřazené elementy

Element	Popis
Ovládací prvek	Požadováno. Definuje pole, text, hypertextový odkaz nebo jiného elementu ovládacího prvku na formulář pracovní položky.

Poznámky

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

Zadejte omezení, která řídí vytvoření relací na jiné pracovní položky, na základě typ vazby a volitelně dopředná a zpětná názvy typů odkazu.
Zadejte omezení, která řídí vytvoření relací na objekty jiné než pracovních položek, jako je například sada změn, hypertextový odkaz a tak dále, na základě typů externí odkaz.
Zadejte omezení, která řídí vytvoření relací na jiné pracovní položky založené na typ pracovní položky a volitelně týmového projektu, kde jsou pracovní položky jsou definovány.
Zadejte výchozí pole sloupců, které chcete zobrazit informace o seznamu odkaz.

Příklad

Následující příklad určuje, jak povolit vytvoření odkazů, jehož typ je Microsoft.VSTS.Common.TestedBy a zobrazit Forward Name pro tento typ odkazu. Možnosti filtrování jsou zakázány vytvoření odkazů na všechny typy externí odkaz. Kromě toho zobrazí pole sloupců výchozí uvedené odkazy, které odpovídají následující popisné názvy: ID, typ pracovní položky, název, přiřazeno, stav a pole Poznámka definován 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ý Control element Type=”LinksControl” nabízí panel nástrojů, který obsahuje tlačítka znázorněno na následujícím obrázku:

Work item form link toolbar controls

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

Tlačítko Vytvořit pracovní položku, kterou je propojen otevřít pracovní položku () je k dispozici pouze po uložení otevřít pracovní položku.
Tlačítka, chcete-li otevřít seznam pracovních položek v dotazu () a v klient aplikace Microsoft Office () k dispozici pouze, když je alespoň jeden pracovní položka uvedena v kartu odkazy ovládací prvek.
Tlačítka otevřete pracovní položka (), upravit odkaz () a odstranění odkazu () k dispozici pouze po kliknutí na tlačítko jeden nebo více pracovních položek uvedené na kartě odkazy ovládací prvek.

Ovládací prvek odkazy, které se zobrazí, je stejná pro obě Team Web Access a Průzkumník týmových projektů, s tím rozdílem, pokud je nakonfigurováno pouze vykreslení Storyboard odkazy. Panel nástrojů v takovém případě obsahuje pouze ty ovládacích prvků přidat nový odkaz, otevřete propojené položky a odstranit odkaz. Také Team Web Access verze, zobrazí Start scénářů odkaz v nabídce ovládací prvek.

Storyboard links control

Definice schématu

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

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

Viz také

Koncepty

Link type element reference

Specify work item form controls

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

Další zdroje

Define a custom link type

Sdílet prostřednictvím