LinksControlOptions-Elemente

Artikel
07/20/2011

Mithilfe des LinksControlOptions-Elements definieren Sie die Optionen, mit denen festgelegt wird, welche Links einer Arbeitsaufgabe hinzugefügt werden können, sowie die Standardspalten, die für die Liste der Links in einer Arbeitsaufgabe angezeigt werden sollen. Wenn Sie einem Arbeitsaufgabenformular das Linksteuerelement hinzufügen, können Sie Filter angeben, mit denen die von Benutzern angezeigten und erstellten Linktypen sowie die Arbeitsaufgabentypen eingeschränkt werden, zwischen denen Benutzer Links erstellen können. Insbesondere verwenden Sie die folgenden Elemente wie angegeben:

WorkItemLinkFilters: Hiermit können Sie die Typen von Links zwischen Arbeitsaufgaben im aktuellen Teamprojekt einschränken.
ExternalLinkFilters: Verwenden Sie dies, um die Typen von Links, die zwischen Arbeitsaufgaben und anderen Objekten erstellt werden können, einzuschränken, z. B. Changesets, Hyperlinks oder der Versionskontrolle unterliegende Dateien.
WorkItemTypeFilters: Hiermit können Sie die Linkbeziehungen, die Benutzer erstellen können, auf Grundlage des Arbeitsaufgabentyps und ausgehend davon einschränken, ob die Arbeitsaufgabe im aktuellen Teamprojekt definiert ist oder nicht.

In jedem dieser Elemente können Sie Filter-Elemente angeben, um die Linktypen oder die Arbeitsaufgabentypen anzugeben, die eingeschlossen oder ausgeschlossen werden sollen. Weitere Informationen zum Verwenden dieser Elemente finden Sie unter Definieren von Link-Steuerelementen zum Einschränken der Link-Beziehungen.

Das LinksControlOptions-Element ist ein untergeordnetes Element des CONTROL-Elements.

Schemahierarchie

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Untergeordnete Elemente und Attribute

Element	Attribute	Beschreibungen
LinksControlOptions		Optionales Control-Element, wenn type="LinksControl". Stellt einen Container für Elemente bereit, die definieren, welche Links einer Arbeitsaufgabe sowie den Standardspalten hinzugefügt werden können, die für die Liste der Linkbeziehungen in einer Arbeitsaufgabe angezeigt werden sollen. Der Elementtyp ist der komplexe Typ LinksControlOptionsType.
WorkItemLinkFilters		Optionales LinksControlOptions-Element. Stellt einen Container für ein oder mehrere Filter-Elemente bereit, die die Kriterien zum Filtern von Links angeben, die auf Linktypen angewendet werden sollen, die für die Teamprojektauflistung definiert sind und mit denen Beziehungen zwischen Arbeitsaufgaben erstellt werden. Der Elementtyp ist der komplexe Typ WorkItemLinkFiltersType.
	FilterType	Erforderliches WorkItemLinkFilters-Attribut. Definiert die Methode, die verwendet wird, um den Satz der Linktypen zu filtern, die im Satz von Filter-Elementen bereitgestellt wird. Der Elementtyp ist der einfache Typ LinksControlFilterKind. Folgende Werte sind hier gültig: exclude: Verwenden Sie dieses Element, um keine Links zuzulassen, die aus jenen in den Filter-Elementen aufgeführten Linktypen erstellt wurden. excludeAll: Wird verwendet, um alle Linktypen zu untersagen. include: Verwenden Sie das Element, um nur jene in den Filter-Elementen aufgeführten Linktypen zuzulassen. includeAll: Verwenden Sie das Element, damit Links aus allen Linktypen erstellt werden können.
Filter		Erforderliches WorkItemLinkFilters-Element, wenn das FilterType-Element exclude oder include ist. Wenn FilterType excludeAll oder includeAll ist, sollten keine Filter-Elemente angegeben werden. Gibt die Typen von Links an, die in die Gruppe der Links eingeschlossen bzw. von dieser ausgeschlossen werden sollen, die für die Arbeitsaufgabe erstellt werden können. Der Elementtyp ist der einfache Typ WorkItemLinkFilterElementType.
	LinkType	Erforderliches Filter-Attribut. Gibt den Verweisnamen für einen Linktyp an. Der Attributtyp ist typelib:ReferenceFieldName. Weitere Informationen finden Sie unter Arbeiten mit Linktypen.
	FilterOn	Optionales Filter-Attribut. Gibt den Filtertyp an, der auf den Linktyp anzuwenden ist. Der Elementtyp ist der einfache Typ LinksControlFilterOnKind. Gültige Werte sind: forwardName: Verwenden Sie das Element, um nach dem für einen Typ des Links definierten Forwardnamen zu filtern. revserseName: Verwenden Sie das Element, um nach dem für einen Typ des Links definierten Reversenamen zu filtern. Falls nicht angegeben, werden beide Forward- und Reversenamen zum Filtern des Linktyps verwendet. Hinweis Wenn die Linktyptopologie "Netzwerk" ist, sind die Forward- und Reversenamen identisch.Weitere Informationen finden Sie unter Arbeiten mit Linktypen.
ExternalLinkFilters		Optionales LinksControlOptions-Element. Stellt einen Container für ein oder mehrere Filter-Elemente bereit, die die Linktypen angeben, die Benutzer angeben können, um Beziehungen zu Objekten zu erstellen, die keine Arbeitsaufgaben sind, z. B. Changesets, Links und Dateien unter Versionskontrolle. Der Elementtyp ist komplex: ExternalLinkFiltersType.
	FilterType	Optionales ExternalLinkFilters-Attribut. Definiert die Methode, die verwendet wird, um die Liste der Linktypen zu filtern, die im Satz von Filter-Elementen bereitgestellt wird. Der Elementtyp ist einfach: LinksControlFilterKind. Sie können folgende Werte verwenden: exclude: Verwenden Sie dieses Element, um keine Links zuzulassen, die aus jenen in den Filter-Elementen aufgeführten Linktypen erstellt wurden. excludeAll: Wird verwendet, um alle Linktypen zu untersagen. include: Verwenden Sie das Element, um nur jene in den Filter-Elementen aufgeführten Linktypen zuzulassen. includeAll: Verwenden Sie das Element, damit Links aus allen Linktypen erstellt werden können. Sofern nicht angegeben, werden alle Links zu externen Arbeitsaufgaben ausgeschlossen.
Filter		Erforderliches ExternalLinkFilters-Element, wenn das FilterType-Element exclude oder include ist. Wenn FilterType excludeAll oder includeAll ist, sollten keine Filter-Elemente angegeben werden. Der Elementtyp ist komplex: ExternalLinkFilterElementType. Gibt den Namen der Linktypen an, die in die Gruppe der Links eingeschlossen bzw. von dieser ausgeschlossen werden sollen, die Benutzer für die Arbeitsaufgabe erstellen können.
	LinkType	Erforderliches Filter-Attribut. Gibt den Verweisnamen für einen Linktyp an, der aus- oder eingeschlossen werden soll. Der Attributtyp ist ein einfach: ExternalLinkTypeName. Sie können die folgenden Linktypen angeben: Behoben in Changeset Ergebnisanlage Quellcodedatei Testergebnis Arbeitsaufgabenlink
WorkItemTypeFilters		Optionales LinksControlOptions-Element. Stellt einen Container für ein oder mehrere Filter-Elemente bereit, die die Filterkriterien angeben, die auf Arbeitsaufgabentypen angewendet werden sollen. Der Elementtyp ist komplex: LinksControlWorkItemTypeFiltersElementType.
	Scope	Optionales WorkItemTypeFilters-Attribut. Definiert den Umfang des Filters, der auf den Satz von Arbeitsaufgabentypen angewendet wird, die im Satz von Filter-Elementen bereitgestellt werden. Der Elementtyp ist der einfache Typ LinksControlWorkItemTypeFilterScopeKind. Folgende Werte sind hier gültig: all: Verwenden Sie das Element, damit Links auf alle Arbeitsaufgabentypen erstellt werden können, die in den Filter-Tags angegeben sind. project: Verwenden Sie das Element, damit Links nur für die Arbeitsaufgabentypen erstellt werden dürfen, die für das aktuelle Projekt definiert sind. Falls nicht angegeben, werden Links zu allen Arbeitsaufgabentypen erlaubt.
	FilterType	Erforderliches WorkItemTypeFilters-Attribut. Definiert die Methode, die verwendet wird, um den Satz von Arbeitsaufgabentypen zu filtern, die im Satz von Filter-Elementen bereitgestellt werden. Der Elementtyp ist einfach: LinksControlWorkItemTypeFilterKind. Sie können folgende Werte verwenden: exclude: Verwenden Sie dieses Element, um die Arbeitsaufgabentypen in den Filter-Elementen nicht zuzulassen. excludeAll: Wird verwendet, um alle Arbeitsaufgabentypen zu untersagen. include: Verwenden, um die Arbeitsaufgabentypen in den Filter-Elementen zuzulassen. includeAll: Wird verwendet, um alle Arbeitsaufgabentypen zuzulassen. Wenn Sie keinen dieser Werte angeben, sind Links zu allen Arbeitsaufgabentypen zugelassen.
Filter		Optionales WorkItemTypeFilters-Element, wenn FilterType exclude oder include ist. Wenn FilterType excludeAll oder includeAll lautet, sollten Sie keine Filter-Elemente angeben. Gibt die Typen von Arbeitsaufgaben an, die in die Gruppe der Arbeitsaufgabentypen, auf die verwiesen werden kann, eingeschlossen bzw. von dieser ausgeschlossen werden sollen. Der Elementtyp ist der komplexe Typ LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Erforderliches Filter-Attribut. Gibt den Verweisnamen eines Arbeitsaufgabentyps für die Filterung an. Der Attributtyp ist typelib:NonEmptyPlainConstant. Mindestlänge: 1; maximale Länge: 255. Musterwert: ^[^\\]*$ Musterwertbeispiel: Aufgabe
LinkColumns		Optionales LinksControlOptions-Element. Stellt einen Container für einen oder mehrere LinkColumn-Elemente bereit. Der Elementtyp ist der komplexe Typ LinkColumnsType.
LinkColumn		Erforderliches LinkColumns-Element. Gibt die Arbeitsaufgabenfelder und Linktypattribute an, die im Arbeitsaufgabenformular für die Liste der Links angezeigt werden sollen. Der Elementtyp ist der komplexe Typ LinkColumnType. Diese Spaltenliste ist die Standardanzeige. Der Benutzer kann Spalten aus der Linkliste hinzufügen und entfernen. Die Reihenfolge, in der die LinkColumn-Elemente aufgeführt sind, definiert die Reihenfolge, in der die Spaltenfelder im Arbeitsaufgabenformular angezeigt werden.
	RefName	Optionales LinkColumn-Attribut. Geben Sie RefName oder LinkAttribute an, aber nicht beides. Gibt den Verweisnamen an, der einem gültigen Arbeitsaufgabenfeld für die Teamprojektsammlung entspricht. Der Attributtyp ist typelib:ReferenceFieldName.
	LinkAttribute	Optionales LinkColumn-Attribut. Geben Sie RefName oder LinkAttribute an, aber nicht beides. Gibt den Verweisnamen an, der einem beliebigen Attribut für einen gültigen Linktyp für die Teamprojektsammlung entspricht. Der Attributtyp ist typelib:ReferenceFieldName.

Übergeordnete Elemente

Element	Beschreibungen
Steuerelement	Erforderlich. Definiert ein Feld, Text, einen Link oder ein anderes Steuerelement, das auf dem Arbeitsaufgabenformular angezeigt wird.

Hinweise

LinksControlOptions ist ein optionales untergeordnetes Element des Control-Elements, wobei ControlType="LinksControl" gilt. Mit dem LinksControlOptions-Element können die folgenden Aktionen unterstützt werden:

Geben Sie die Einschränkungen an, die die Erstellung von Beziehungen zu anderen Arbeitsaufgaben auf Grundlage des Linktyps regeln, und, optional, die Forward- und Reversenamen der Linktypen.
Geben Sie die Einschränkungen an, die die Erstellung von Beziehungen zu anderen Objekten als Arbeitsaufgaben regeln, z. B. Changesets, Links usw., die auf externen Linktypen basieren.
Geben Sie die Einschränkungen an, die die Erstellung von Beziehungen zu anderen Arbeitsaufgaben auf Grundlage des Arbeitsaufgabentyps regeln, und, optional, das Teamprojekt, in dem diese Arbeitsaufgaben definiert sind.
Geben Sie die Standardspaltenfelder an, die Informationen für die Linkliste anzeigen sollen.

Beispiel

Das folgende Beispiel gibt an, wie die Erstellung von Links, deren Typ Microsoft.VSTS.Common.TestedBy ist und den Forward Name für diesen Linktyp anzeigen, aktiviert wird. Die Filteroptionen lassen keine Erstellung von Links zu allen externen Linktypen zu. Zusätzlich entsprechen angezeigte Standardspaltenfelder für die aufgeführten Links den folgenden Anzeigenamen: ID, Arbeitsaufgabentyp, Titel, zugewiesen, Status und das für den Link definierte Kommentarfeld. Weitere Beispiele finden Sie unter Definieren von Link-Steuerelementen zum Einschränken der Link-Beziehungen.

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

Schemadefinitionen

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>

Elementinformationen

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Schemaname	Arbeitsaufgabentypdefinition
Validierungsdatei	WorkItemTypeDefinition.xsd
Elementtyp	LinksControlOptionsType
Kann leer sein	Nicht zutreffend

Siehe auch

Konzepte

Arbeiten mit Linktypen

Angeben von Steuerelementen für Arbeitsaufgabenformulare

Weitere Ressourcen

Anpassen der Beziehungen zwischen Arbeitsaufgaben mithilfe von Linktypen

Definieren von Link-Steuerelementen zum Einschränken der Link-Beziehungen

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
Mai 2011	Der Fall mehrerer XML-Elemente wurde korrigiert. In der Schemadefinition zur Arbeitsaufgabenverfolgung werden alle untergeordneten Elemente des FORM-Elements mit Binnenversalien und alle anderen Elemente nur in Großbuchstaben definiert.	Korrektur inhaltlicher Fehler.
Januar 2011	Links zu entfernten Themen ersetzt.	Informationsergänzung.
Juli 2010	Eine vollständige Liste von Verweisnamen, die Sie mit dem ExternalLinkFilters-Element verwenden können, hinzugefügt.	Korrektur inhaltlicher Fehler.
Juni 2010	Überarbeitet die Beschreibungen für das ExternalLinkFilters-Element und das WorkItemTypeFilters-Element.	Korrektur inhaltlicher Fehler.

Mai 2011

Der Fall mehrerer XML-Elemente wurde korrigiert. In der Schemadefinition zur Arbeitsaufgabenverfolgung werden alle untergeordneten Elemente des FORM-Elements mit Binnenversalien und alle anderen Elemente nur in Großbuchstaben definiert.

Korrektur inhaltlicher Fehler.

Januar 2011

Links zu entfernten Themen ersetzt.

Informationsergänzung.

Juli 2010

Eine vollständige Liste von Verweisnamen, die Sie mit dem ExternalLinkFilters-Element verwenden können, hinzugefügt.

Korrektur inhaltlicher Fehler.

Juni 2010

Überarbeitet die Beschreibungen für das ExternalLinkFilters-Element und das WorkItemTypeFilters-Element.

Korrektur inhaltlicher Fehler.

Freigeben über

LinksControlOptions-Elemente

Attribute und Elemente

Untergeordnete Elemente und Attribute

Übergeordnete Elemente

Hinweise

Beispiel

Schemadefinitionen

LinksControlOptionsType

WorkItemLinkFiltersType

WorkItemLinkFilterElementType

ExternalLinkFiltersType

ExternalLinkFilterElementType

LinksControlFilterKind

LinksControlFilterOnKind

ExternalLinkTypeName

LinksControlWorkItemTypeFiltersElementType

LinksControlWorkItemTypeFilterElementType

LinksControlWorkItemTypeFilterScopeKind

LinksControlWorkItemTypeFilterKind

LinkColumnsType

LinkColumnType

Elementinformationen

Siehe auch

Konzepte

Weitere Ressourcen

Änderungsprotokoll

Zusätzliche Ressourcen