Definieren von Linksteuerelementen zum Einschränken der Linkbeziehungen

Sie können steuern, welche Arbeitsaufgaben miteinander verknüpft sind, indem Sie das Arbeitsformular anpassen. Sie können insbesondere die Link- und Arbeitsaufgabentypen steuern, die den Benutzern angezeigt werden und die diese einem Linksteuerelement hinzufügen können. Sie können Sie z. B. Ihrem Formular eine Registerkarte hinzufügen, mit dem Sie abhängige Funktionen verwalten können. Auf dieser Registerkarte können Sie das Linksteuerelement hinzufügen und die Linkbeziehungen, die von den Teammitgliedern für dieses Steuerelement angezeigt und erstellt werden können, so einschränken, dass diese lediglich Links zu anderen Funktionen umfassen.

Verwenden Sie das Control-Element und LinksControlType-Attribut, um es den Benutzern zu ermöglichen, Linkbeziehungen zwischen Arbeitsaufgaben und anderen Objekten in der Datenbank Team Foundation zu erstellen. Anschließend können Sie die untergeordneten LinksControlOptions-Elemente verwenden, um die Optionen zu definieren, mit denen gesteuert wird, welche Links Teammitglieder einer Arbeitsaufgabe hinzufügen können und mit welchen Arbeitsaufgabentypen oder Objekten verknüpft werden darf. Außerdem können Sie die Standardspalten definieren, die für die Liste der Links des Steuerelements angezeigt werden sollen.

Eine Zusammenfassung der Linkeinschränkungen, die für TFS-Prozessvorlagen definiert sind, finden Sie unter Link-Steuerelemente, Einschränkungen und Feldverweis. Weitere Informationen zu Linktypen finden Sie unter Linktyp-Elementverweis.

In diesem Thema

• Festlegen des Linksteuerelements

• Steuern von Linkbeziehungen

• Einschränken von Linkbeziehungen zu Arbeitsaufgaben

• Einschränken von Linkbeziehungen zu Changesets, Links und anderen Nicht-Arbeitsaufgaben

• Einschränken von Linkbeziehungen zu Arbeitsaufgabentypen

• Festlegen der anzuzeigenden Standardspalten

Festlegen des Linksteuerelements

Mithilfe der Option LinksControl können Sie Benutzern ermöglichen, Linkbeziehungen in einem Arbeitsaufgabenformular hinzuzufügen, anzuzeigen und zu verwalten. Sie können mit diesem Steuerelement Links öffnen, bearbeiten, hinzufügen und entfernen.

Sie können ein Formular anpassen, damit in einer Registerkarte nur übergeordnete und untergeordnete Links und in einer anderen Registerkarte alle anderen Linktypen angezeigt werden. Im folgenden Beispiel wird eine als "Alle Links" bezeichnete Registerkarte erstellt, mit der Teammitglieder alle Linktypen hinzufügen können. Die Standardspalten, die für die Linkanzeige angezeigt werden, lauten folgendermaßen: ID, Arbeitsaufgabentyp, Titel, Zugewiesen an, Zustand und das Linkkommentarfeld:

Linksteuerelement

<Tab Label="All Links">
   <Control Type="LinksControl" Name="All" >
      <LinksControlOptions>
         <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>
</Tab>

Zurück nach oben

Steuern von Linkbeziehungen

Wenn Sie einem Arbeitsaufgabenformular das Linksteuerelement hinzufügen, können Sie Filter angeben, mit denen die Linktypen sowie die Arbeitsaufgabentypen eingeschränkt werden, die von den Teammitgliedern beim Verwenden des Steuerelements hinzugefügt werden können. In der folgenden Tabelle werden die optionalen untergeordneten Elemente beschrieben, die Linkbeziehungen steuern.

Zurück nach oben

Einschränken von Linkbeziehungen zu Arbeitsaufgaben

Verwenden Sie die untergeordneten WorkItemLinkFilters- und Filter-Elemente, um zu definieren, welche Linktypen das Linksteuerelement ein- oder ausschließen soll. Verwenden Sie dieses Element, um die Linktypen einzuschränken, die über das Linksteuerelement ausgewählt werden können, um Beziehungen zu im selben Projekt definierten Arbeitsaufgaben zu erstellen. Die Syntax für diese Elemente lautet folgendermaßen.

<WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
</WorkItemLinkFilters>

Beispiel: Ausschließen zweier Arbeitsaufgabenlinktypen

Mithilfe des folgenden Codebeispiels können Sie ein Linksteuerelement definieren, das Linkbeziehungen für alle Linktypen mit Ausnahme eines benutzerdefinierten Anforderungs- und dem Systemhierarchielinktyp zulässt.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="exclude">
         <Filter LinkType="MyLinks.LinkTypes.Requirement" /> 
         <Filter LinkType="System.LinkTypes.Hierarchy" /> 
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
. . .
</Control>

Zurück nach oben

Einschränken von Linkbeziehungen zu Changesets, Links und anderen Nicht-Arbeitsaufgaben

Verwenden Sie die untergeordneten ExternalLinkFilters- und Filter-Elemente, um zu definieren, welche Linktypen zu Elementen außerhalb des Teamprojekts das Linksteuerelement ein- oder ausschließen sollte. Die Syntax für diese Elemente lautet folgendermaßen.

<ExternalLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="externalLinkName" />
</ExternalLinkFilters>

Beispiel: Ausschließen aller Nicht-Arbeitsaufgabenlinks

Im folgenden Beispiel wird ein Linksteuerelement definiert, das alle Linktypen zu Arbeitsaufgaben einschließt (z. B. verknüpft und über- und untergeordnet), jedoch alle Linktypen zu Nicht-Arbeitsaufgaben ausschließt (z. B. Changesets, Links und Testergebnissen).

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="includeAll" /> 
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
</Control>

Im folgenden Beispiel wird ein Linksteuerelement definiert, mit dem Benutzer nur den Changesetlinktyp angeben und somit nur mit Changesets verknüpfen können.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="excludeAll"/>
      <ExternalLinkFilters FilterType="include" /> 
         <Filter LinkType="Fixed in Changeset" />
      </ExternalLinkFilters> 
 </LinksControlOptions>
. . .
</Control>

Zurück nach oben

Einschränken von Linkbeziehungen zu Arbeitsaufgabentypen

Verwenden Sie die untergeordneten WorkItemTypeFilters- und Filter-Elemente, um die Arbeitsaufgabentypen einzuschränken, zu denen ein Linksteuerelement verknüpfen kann. Sie können die Linkbeziehungen für das Teamprojekt oder anhand des Arbeitsaufgabentyps einschränken. Die Syntax für diese Elemente lautet folgendermaßen.

<WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" >
   <Filter WorkItemType="workItemTypeReferenceName" />
</WorkItemTypeFilters>

Beispiel: Einschränken der Linkbeziehungen zu Arbeitsaufgaben für eine Aufgabe

Im folgenden Beispiel wird ein Linksteuerelement definiert, das nur hierarchische Beziehungen zu Aufgaben zulässt, die im Teamprojekt definiert wurden.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="System.LinkTypes.Hierarchy" />
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll"/>
      <WorkItemTypeFilters Scope ="project" FilterType="include" />
         <Filter WorkItemType="Task" />
      </WorkItemTypeFilters> 
   </LinksControlOptions>
. . .
</Control>

Zurück nach oben

Festlegen der anzuzeigenden Standardspalten

Verwenden Sie die untergeordneten LinkColumns- und LinkColumn-Elemente, um die Standardspalten anzugeben, die im Linksteuerelement angezeigt werden sollen. Sie können entweder den Verweisnamen eines Arbeitsaufgabenfelds oder ein Linkattribut angeben. Die Syntax für diese Elemente lautet folgendermaßen.

<LinkColumns>
   <LinkColumn RefName="reference name" | LinkAttribute=" link attribute name" />
</LinkColumns>

Die Reihenfolge, in der die Elemente aufgeführt sind, definiert die Reihenfolge, in der die Spaltenfelder im Arbeitsaufgabenformular angezeigt werden. Eine Liste von Verweisnamen und Linkattributen finden Sie unter Arbeitsaufgabenfeld-Verweis für Visual Studio ALM. Die folgende Syntax definiert die Anzeige von vier Spalten: die ID, der Zustand, der Titel und der Linkattributkommentar.

<Control Type="LinksControl">
. . .
   <LinksControlOptions>
      <LinkColumns>
         <LinkColumn RefName="System.ID" />
         <LinkColumn RefName="System.State" />
         <LinkColumn RefName="System.Title" />
         <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

Zurück nach oben

Siehe auch

Referenz

LinksControlOptions-Elemente

Konzepte

Link-Steuerelemente, Einschränkungen und Feldverweis

Linktyp-Elementverweis

Angeben von Steuerelementen für Arbeitsaufgabenformulare