LinksControlOptions-Elemente

Artikel
05/16/2015

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 ein 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 Linksteuerelementen zum Einschränken der Linkbeziehungen.

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 von Linktypen zu filtern, die im Satz von Filter-Elementen bereitgestellt werden. Der Elementtyp ist der einfache Typ LinksControlFilterKind. Folgende Werte sind hier gültig: exclude: Verwenden Sie dieses Element, um keine Links zuzulassen, die aus den in den Filter-Elementen aufgeführten Linktypen erstellt wurden. excludeAll: Wird verwendet, um alle Linktypen zu untersagen. include: Verwenden Sie dieses Element, um nur die in den Filter-Elementen aufgeführten Linktypen zuzulassen. includeAll: Verwenden Sie dieses Element, damit Links aus allen Linktypen erstellt werden können.
Filter		Erforderliches WorkItemLinkFilters-Element, wenn das FilterType-Element auf exclude oder include festgelegt ist. Wenn das FilterType-Element auf excludeAll oder includeAll festgelegt 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 umfassen die folgenden vom System definierten Linktypen: Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related Darüber hinaus können Sie den Verweisnamen für benutzerdefinierte Linktypen angeben, die für die Teamprojektauflistung 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 dieses Element, um nach dem für einen Linktyp definierten Forwardnamen zu filtern. reversename: Verwenden Sie dieses Element, um nach dem für einen Linktyp definierten Reversenamen zu filtern. Sofern nicht angegeben, werden sowohl die Forward- als auch die 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 werden. Der Elementtyp ist einfach: LinksControlFilterKind. Sie können folgende Werte verwenden: exclude: Verwenden Sie dieses Element, um keine Links zuzulassen, die aus den in den Filter-Elementen aufgeführten Linktypen erstellt wurden. excludeAll: Wird verwendet, um alle Linktypen zu untersagen. include: Verwenden Sie dieses Element, um nur die in den Filter-Elementen aufgeführten Linktypen zuzulassen. includeAll: Verwenden Sie dieses 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 auf exclude oder include festgelegt ist. Wenn das FilterType-Element auf excludeAll oder includeAll festgelegt 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 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 dieses Element, damit Links zu allen Arbeitsaufgabentypen erstellt werden können, die in den Filter-Tags angegeben sind. project: Verwenden Sie dieses Element, damit nur Links zu den Arbeitsaufgabentypen erstellt werden dürfen, die für das aktuelle Projekt definiert sind. Falls nicht angegeben, sind Links zu allen Arbeitsaufgabentypen zulässig.
	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 Sie dieses Element, 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 zulässig.
Filter		Optionales WorkItemTypeFilters-Element, wenn das FilterType-Element auf exclude oder include festgelegt ist. Wenn das FilterType-Element auf excludeAll oder includeAll festgelegt ist, 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 ein oder mehrere LinkColumn-Elemente bereit. Der Elementtyp ist der komplexe Typ LinkColumnsType.
LinkColumn		Erforderliches LinkColumns-Element. Gibt die Arbeitsaufgabenfelder und Linktypattribute an, die für die Liste der Links angezeigt werden sollen, die für eine Arbeitsaufgabe definiert sind. 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 Teamprojektauflistung 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 Teamprojektauflistung 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, ermöglicht wird und wie der Forward Name für diesen Linktyp anzeigt 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 zu, Zustand und das für den Link definierte Kommentarfeld. Weitere Beispiele finden Sie unter Definieren von Linksteuerelementen zum Einschränken der Linkbeziehungen.

<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 Control-Element 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 nur verfügbar, wenn Sie zuvor eine bestimmte Aktion ausgeführt haben:

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 angezeigte Linksteuerelement ist für Team Web Access und Team Explorer identisch, außer wenn es so konfiguriert ist, dass nur Storyboard-Links gerendert werden. In diesem Fall enthält die Symbolleiste nur die Steuerelemente zum Hinzufügen eines neuen Links, zum Öffnen des verknüpften Elements und zum Löschen des Links. Darüber hinaus zeigt die Team Web Access-Version den Link Storyboarding starten im Systemmenü 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	Definition des Arbeitsaufgabentyps
Validierungsdatei	WorkItemTypeDefinition.xsd
Elementtyp	LinksControlOptionsType
Kann leer sein	Nicht zutreffend

Siehe auch

Konzepte

Linktyp-Elementverweis

Angeben von Steuerelementen für Arbeitsaufgabenformulare

Definieren von Linksteuerelementen zum Einschränken der Linkbeziehungen

Weitere Ressourcen

Definieren eines benutzerdefinierten Linktypen

Share via