Linktyp-Elementverweis

Artikel
03/12/2013

Sie verwenden einen Linktyp zum Definieren der Linkbezeichnungen, des Topologietyps und der Einschränkungen, die beim Erstellen von Links zwischen Arbeitsaufgaben genutzt werden.Der Übergeordnet/Untergeordnet-Linktyp definiert zum Beispiel zwei Bezeichnungen ("Übergeordnet" und "Untergeordnet"), unterstützt eine hierarchische Topologie oder Strukturtopologie und verhindert, dass zwischen Arbeitsaufgaben Zirkelverweise erstellt werden.

Um einen Linktyp anzupassen oder zu erstellen, importieren Sie eine XML-Datei in die Teamprojektsammlung, die die Definition für den Linktyp enthält.Der Gruppe von Linktypen, die für die Auflistung definiert sind, werden Linktypen hinzugefügt.Vorhandene Linktypen werden basierend auf dem von Ihnen angegebenen Verweisnamen mit den neuen Informationen überschrieben.

In diesem Thema

Syntaxstruktur
Anforderungen für Linktypen
Vom System definierte Linktypen
Von MSF-Prozessvorlagen definierte Linktypen
Linkeinschränkungen und Topologien
Linktyp-Schemadefinition

Syntaxstruktur

Sie können zusätzliche Linktypen definieren, indem Sie diese den Linktypen hinzufügen, die für eine Teamprojektsammlung definiert sind.Sie können gültige Linktypen zur Verwendung in Ihrem Prozess basierend auf der Struktur definieren, die vom Linktyp-Definitionsschema bereitgestellt wird.Ein Linktyp wird von der folgenden XML-Syntax in der Linktypen-XML-Datei definiert:

<LinkTypes>
   <LinkType ReferenceName="LinkTypeName" ForwardName="ForwardName" ReverseName="ReverseName" Topology="TopologyType" />
</LinkTypes>

Die Beschreibungen in der folgenden Tabelle gelten für die vorherige Syntax:

Attribut	Beschreibung
ReferenceName	Name des Linktyps.Dieser Name wird intern verwendet, wenn Sie einen Link zwischen zwei Arbeitsaufgaben erstellen.
ForwardName	Name des Links bei der Quellarbeitsaufgabe.Dieser Name wird angezeigt, wenn Sie der Quellarbeitsaufgabe Links hinzufügen.
ReverseName	Name des Links bei der Zielarbeitsaufgabe.Dieser Name wird angezeigt, wenn eine Auflistung der Links bei der Zielarbeitsaufgabe angezeigt wird.
TopologyType	Gibt die Topologie DirectedNetwork, Network, Tree oder Dependency an.Die ersten drei Topologien sind direktional. Sie verwenden sie, um untergeordnete oder sequenzielle Beziehungen zu definieren.Sie verwenden Network, um Beziehungen zwischen Peers zu definieren, oder in Fällen, in denen keine implizite Unterordnung existiert.

Die Linkrichtung wird von den Zuweisungen bestimmt, die für die Attribute ForwardName und ReverseName vorgenommen wurden.Wenn Sie einen benutzerdefinierten Link erstellen und dem Forwardnamen und Reversenamen den gleichen Namen zuweisen, sollten Sie den Linktyp auf Network festlegen, da dies die einzige nicht direktionale Topologie ist.

Anforderungen für Linktypen

LINKTYPES ist eine Gruppe von LINKTYPE-Elementen, die von einer Teamprojektsammlung gespeichert und verwendet werden.

Jeder Linktyp hat einen Verweisnamen und zwei optionale Anzeigenamen, auch Namensbezeichnungen genannt, die innerhalb der Projektauflistung eindeutig sein müssen.Jeder Linktypname muss die folgenden Anforderungen erfüllen:

Namen dürfen maximal 254 Unicode-Zeichen umfassen.
Namen dürfen nicht leer sein.
Namen dürfen keine vorangestellten oder nachgestellten Leerzeichen enthalten.
Namen dürfen keine umgekehrten Schrägstriche (\) enthalten.
Namen dürfen nicht zwei aufeinanderfolgende Leerstellen enthalten.

Vom System definierte Linktypen

In der folgenden Tabelle sind die Linktypen zusammengefasst, die vom System definiert werden.Diese Linktypen sollten nicht überschrieben oder auf irgendeine Weise geändert werden.

Forwardname	Reversename	Linktyp-Verweisname	Topologie
Successor (Nachfolger)	Predecessor (Vorgänger)	System.LinkTypes.Dependency	Abhängigkeit
Untergeordnetes Element	Parent (Übergeordnet)	System.LinkTypes.Hierarchy	Strukturansicht
Related (Verknüpft)	Related (Verknüpft)	System.LinkTypes.Related	Network (Netzwerk)

Darüber hinaus die Storyboard Typ Links Arbeitsaufgaben verknüpfen, Storyboards oder jede Datei auf einer Netzwerkfreigabe befindet.Weitere Informationen finden Sie unter LinksControlOptions-Elemente.

Von MSF-Prozessvorlagen definierte Linktypen

In der folgenden Tabelle sind die Linktypen aufgeführt, die erstellt werden, wenn Sie mit einer Microsoft Solutions Framework (MSF)-Prozessvorlage ein Teamprojekt erstellen.Diese Linktypen sind speziell dafür konzipiert, die Interaktion mit der Nachverfolgung von Arbeitsaufgaben in Team Foundation und Microsoft Test Manager zu unterstützen.

Forwardname	Reversename	Linktyp-Verweisname	Topologie
Tested By (Getestet von)	Tests	Microsoft.VSTS.Common.TestedBy	Abhängigkeit
Test Case (Testfall)	Freigegebene Schritte	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Abhängigkeit

Alle Linktypen, die weiter oben in diesem Thema aufgelistet wurden, werden der Teamprojektsammlung hinzugefügt, wenn Sie eine MSF-Prozessvorlage zum Erstellen eines Teamprojekts verwenden.Linktyp-Definitionsdateien sind im Ordner "WorkItem Tracking\LinkTypes" der Datei "Template.zip" definiert.Die folgende Definition für den Linktyp "Microsoft.VSTS.Common.TestedBy" ist in der Datei "TestedBy.xml" definiert:

<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
   <LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>

Wenn Sie das Teamprojekt mit der entsprechenden Prozessvorlage erstellen, wird die Linktypdefinition in die Projektauflistung importiert.

Linkeinschränkungen und Topologien

Die Topologie, die einem Linktyp zugewiesen wird, bestimmt die Einschränkungen, die für seine Verwendung hinzugefügt werden.In der folgenden Tabelle können Sie die verschiedenen Topologietypen anzeigen:

Topologietyp	Darstellung
Network (Netzwerk): Sie können Netzwerklinks verwenden, um grundlegende Beziehungen zwischen Arbeitsaufgaben zu erstellen, die nicht restriktiv sind.Der Link ist an beiden Endpunkten gleich.Zirkuläre Beziehungen sind zulässig. Verwendungsbeispiel: Verwenden Sie einen Netzwerklink, z. B. "Related", um eine Beziehung zwischen zwei Funktionen aufzuzeichnen, die ggf. Abhängigkeiten gemeinsam nutzen.
Directed Network (Gerichtetes Netzwerk): Sie können gerichtete Netzwerklinks verwenden, um Beziehungen zwischen Arbeitsaufgaben zu erstellen, die die Richtung angeben.Der Linkname unterscheidet sich an den Endpunkten.Zirkuläre Beziehungen sind zulässig. Verwendungsbeispiel: Verwenden Sie einen gerichteten Netzwerklink, um eine Beziehung zwischen zwei Funktionen aufzuzeichnen, die ggf. Abhängigkeiten gemeinsam nutzen und die Sie auf eine bestimmte Weise voneinander unterscheiden möchten.
Dependency (Abhängigkeit): Sie können Abhängigkeitslinks zum Erstellen von Beziehungen zwischen Arbeitsaufgaben verwenden, die über eine Richtung verfügen, und um zirkuläre Beziehungen einzuschränken.Der Linkname unterscheidet sich an den Endpunkten. In der Abbildung ist zu sehen, dass Sie keinen abhängigen Link zu einer Arbeitsaufgabe erstellen können, die abhängige Linkbeziehungen zu den gleichen Arbeitsaufgaben enthält. Verwendungsbeispiel: Verwenden Sie einen Abhängigkeitslink, um die Funktionen aufzuzeichnen, die zum Erfüllen einer Benutzeranforderung ausgeführt werden müssen.
Tree (Struktur): Sie können Strukturlinks verwenden, um zwischen Arbeitsaufgaben hierarchische Beziehungen mit mehreren Ebenen zu erstellen.Strukturlinks unterstützen hierarchische Ansichten mit mehreren Ebenen, verfügen über eine Richtung und schränken zirkuläre Beziehungen ein.Der Linkname unterscheidet sich an den Endpunkten.Strukturlinks sind der einzige Linktyp, der von der Abfrage Arbeitsaufgabenstruktur unterstützt wird. In der Abbildung ist zu sehen, dass Sie einem untergeordneten Element nicht zwei übergeordnete Elemente zuweisen können. Verwendungsbeispiel: Verwenden Sie einen Strukturlink, um für das Team die Aufgaben und Unteraufgaben aufzuzeichnen, die für eine Funktion ausgeführt werden müssen.

Linktyp-Schemadefinition

Im folgenden Code wird die Schemadefinition für Linktypen aufgeführt:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema 
  id="WorkItemLinkTypeDefinition" 
  elementFormDefault="unqualified" 
  attributeFormDefault="unqualified" 
  xmlns:xs="http://www.w3.org/2001/XMLSchema" 
  targetNamespace="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns:mstns="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns:typelib="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib"
  version="1.0">
   <xs:import namespace="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib"/>
  <xs:simpleType name="TopologyTypes">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Network" />
      <xs:enumeration value="DirectedNetwork" />
      <xs:enumeration value="Dependency" />
      <xs:enumeration value="Tree" />
    </xs:restriction>
  </xs:simpleType>
  <xs:complexType name="LinkTypeType">
    <xs:attribute name="ReferenceName" type="typelib:ReferenceName" use="required" />
    <xs:attribute name="Topology" type="TopologyTypes" use="optional" />
    <xs:attribute name="ForwardName" type="typelib:FriendlyName" use="optional" />
    <xs:attribute name="ReverseName" type="typelib:FriendlyName" use="optional" />
  </xs:complexType>
  <xs:complexType name="LinkTypesType">
    <xs:sequence>
       <xs:element name="LinkType" type="LinkTypeType" minOccurs="1" maxOccurs="unbounded" />
      </xs:sequence>
      </xs:complexType>
   <xs:element name="LinkTypes" type="LinkTypesType" />
</xs:schema>