LinksControlOptions-Elemente

Artikel
03/26/2013

Aktualisiert: September 2012

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 sowie untergeordnete und übergeordnete Elemente beschrieben.

Untergeordnete Elemente und Attribute

Element	Attribut	Beschreibung
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 FilterTypeexcludeAll 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.Gültige Typen enthalten die nachfolgendes System definierten Linktypen: Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related Außerdem können Sie den Verweisnamen für benutzerdefinierte Linktypen angeben, die für die Teamprojektsammlung definiert sind.Weitere Informationen finden Sie unter Linktyp-Elementverweis.
	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. reversename: 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 Linktyp-Elementverweis.
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 FilterTypeexcludeAll 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 FilterTypeexclude oder include ist. Wenn FilterTypeexcludeAll 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	Beschreibung
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>

LinksControl-Symbolleistenschaltflächen

Jedes Element Control von Type="LinksControl" enthält eine Symbolleiste, die die Schaltflächen enthält, die in der folgenden Abbildung angezeigt werden:

Arbeitsaufgabenformular - Steuerelemente der Symbolleiste für Links

Diese Schaltflächen sind erst verfügbar, nachdem Sie eine bestimmte Aktion ausführen:

Die Schaltfläche zum Erstellen einer Arbeitsaufgabe, die mit der geöffneten Arbeitsaufgabe verknüpft ist (), ist nur verfügbar, wenn Sie zuvor die geöffnete Arbeitsaufgabe gespeichert haben.
Die Schaltflächen zum Öffnen der Liste mit den Arbeitsaufgaben in einer Abfrage () und in einem Microsoft Office-Client () ist nur verfügbar, wenn mindestens eine Arbeitsaufgabe in der Registerkarte mit den Linksteuerelementen aufgeführt wird.
Die Schaltflächen zum Öffnen einer Arbeitsaufgabe (), Bearbeiten eines Links () und Löschen eines Links ( ) sind nur verfügbar, nachdem Sie auf mindestens eine der Arbeitsaufgaben geklickt haben, die in der Registerkarte mit den Linksteuerelementen aufgeführt werden.

Das Linksteuerelement, das angezeigt wird, ist das entspricht für die Team Web Access und Team Explorer, außer, wenn konfiguriert wird, um Storyboard Links nur zu rendern.In diesem Fall enthält die Symbolleiste nur die Steuerelemente, um einen neuen Link hinzuzufügen, das verknüpfte Element zu öffnen, und den Link zu löschen.Auch die Team Web Access-Version zeigt den Link Storyboarding starten innerhalb des Systemmenüs an.

Storyboard-Linksteuerung in Team Web Access

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

Linktyp-Elementverweis

Angeben von Steuerelementen für Arbeitsaufgabenformulare

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

Weitere Ressourcen

Definieren eines benutzerdefinierten Linktypen

Änderungsverlauf

Datum	Versionsgeschichte	Grund
September 2012	korrigiert die Syntaxfallstruktur.Alle Enumerationswerte wird die Groß-/Kleinschreibung beachtet.	Korrektur inhaltlicher Fehler.

September 2012

korrigiert die Syntaxfallstruktur.Alle Enumerationswerte wird die Groß-/Kleinschreibung beachtet.

Korrektur inhaltlicher Fehler.