Linktyp-Elementverweis

Artikel
11/18/2015

Sie verwenden verschiedene Linktypen, um Linkbeziehungen zwischen unterschiedlichen Arbeitsaufgabentypen (WITs) zu bilden. Es gibt drei Kategorien von Linktypen: systemdefiniert, prozessvorlagendefiniert und benutzerdefiniert. Die in den Standardprozessvorlagen definierten Linktypen unterstützen Linkbeziehungen zwischen den Arbeitsaufgabentypen der Testverwaltung.

Jeder Linktyp definiert die Linkbezeichnungen, den Topologietyp und die Einschränkungen, die verwendet werden, wennn Links zwischen Arbeitsaufgaben erstellt werden. Beispielsweise definiert der Linktyp "über-/untergeordnet" zwei Bezeichnungen (Übergeordnet und Untergeordnet), unterstützt eine hierarchische oder Strukturtopologie und verhindert die Erstellung von Zirkelverweisen zwischen Arbeitsaufgaben.

Um einen Linktyp anzupassen oder zu erstellen, verwenden Sie witadmin importlinktype, um die Linktyp-Definitionsdatei in die Projektauflistung zu importieren, in der sich Ihr Teamprojekt befindet.

Syntaxstruktur

Sie können zusätzliche Linktypen definieren, indem Sie diese den Linktypen hinzufügen, die für eine Teamprojektauflistung definiert sind. Sie können gültige Linktypen für die Verwendung in Ihrem Prozess auf Grundlage der Struktur definieren, die vom Linktyp-Definitionsschema bereitgestellt wird. Ein Linktyp wird durch folgende XML-Syntax in der XML-Linktypendatei 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	Der Name des Linktyps. Dieser Name wird intern verwendet, wenn Sie einen Link zwischen zwei Arbeitsaufgaben erstellen.
ForwardName	Der Name des Links bei der Quellarbeitsaufgabe. Dieser Name wird angezeigt, wenn Sie der Quellarbeitsaufgabe Links hinzufügen.
ReverseName	Der Name des Links bei der Zielarbeitsaufgabe. Dieser Name wird angezeigt, wenn eine Liste der Links bei der Zielarbeitsaufgabe angezeigt wird.
TopologyType	Gibt eine der Topologien DirectedNetwork, Network, Tree und Dependency an. Die ersten drei Topologien sind direktional, und Sie verwenden sie zum Definieren untergeordneter oder sequenzieller Beziehungen. Sie verwenden Network, um Beziehungen zwischen Peers zu definieren, oder wenn keine implizite Unterordnung vorhanden ist.

Linkdirektionalität wird durch die Zuweisungen bestimmt, die in den Attributen ForwardName und ReverseName getroffen werden. Wenn Sie einen benutzerdefinierten Link erstellen und den Forward- und Reversenamen denselben Namen zuweisen, sollten Sie den Linktyp auf Network festlegen, weil dies die einzige nicht direktionale Topologie ist.

Anforderungen

LINKTYPES ist ein Satz von LINKTYPE-Elementen, die gespeichert und von einer Teamprojektauflistung verwendet werden.

Jeder Linktyp hat einen Verweisnamen und zwei optionale Anzeigenamen oder Namensbezeichnungen, die innerhalb der Projektauflisutng 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.

Systemdefinierte Linktypen

In der folgenden Tabelle werden die systemdefinierten Linktypen zusammengefasst. Sie können diese Linktypen nicht ändern.

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

Darüber hinaus gibt es zusätzliche Linktypen, mit denen Arbeitsaufgaben mit anderen Objekten im Teamprojekt oder anderen Elementen wie einer Webseite oder einem Netzwerkspeicherort verknüpft werden. Beispielsweise verknüpft der Linktyp Storyboard Arbeitsaufgaben mit Storyboards oder Dateien auf einer Netzwerkfreigabe. Weitere Informationen finden Sie unter Verwalten von Abhängigkeiten, Verknüpfen von Arbeitsaufgaben zur Unterstützung von Rückverfolgbarkeit.

Prozessvorlagendefinierte Linktypen

Wenn Sie ein Teamprojekt mithilfe einer der Standardprozessvorlagen erstellen, die von TFS bereitgestellt werden, werden die folgenden Linktypen Ihrem Teamprojekt hinzugefügt. Diese Linktypen sind speziell darauf ausgelegt, die Interaktion mit Nachverfolgungsarbeitsaufgaben in Team Foundation und Microsoft Test-Manager zu unterstützen.

Test der Verwaltung von Arbeitsaufgabentypen

Forwardname	Reversename	Linktyp-Verweisname	Topologie
Betrifft (siehe Hinweis 1)	Betroffen von	Microsoft.VSTS.Common.Affects	Abhängigkeit
Verweis durch (siehe Hinweis 2)	Verweise	Microsoft.VSTS.TestCase.SharedParameterReferencedBy	Abhängigkeit
Getestet von	Tests	Microsoft.VSTS.Common.TestedBy	Abhängigkeit
Testfall	Freigegebene Schritte	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Abhängigkeit

Hinweise

Der Linktyp "Betriff/Betroffen von" verknüpft Änderungsanforderungen mit Anforderungen. Dieser Linktyp wird nur Teamprojekten hinzugefügt, die mit einer CMMI-Prozessvorlage erstellt werden.
Der Linktyp "Verweis durch/Verweis auf" verknüpft freigegebene Parameter mit Testfällen, um die Ausführung von Tests mit unterschiedlichen Daten zu unterstützen. Dieser Linktyp wird einem Teamprojekt hinzugefügt, wenn Sie das Teamprojekt mithilfe des Assistenten zum Konfigurieren von Funktionen aktualisieren oder ein Teamprojekt auf Grundlage einer Prozessvorlage aus TFS 2013.2 oder einer neueren Version erstellen.

Linktyp-Definitionsdateien werden 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 erstellen, indem Sie die entsprechende Prozessvorlage verwenden, wird die Linktypdefinition in die Projektauflistung importiert.

Linkeinschränkungen und Topologien

Die in der folgenden Tabelle beschriebenen Topologietypen bestimmen die Einschränkungen, die für die Verwendung des jeweiligen Linktyps gelten.

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 identisch. Zirkuläre Beziehungen sind zulässig. Verwendungsbeispiel: Verwenden Sie einen Netzwerklink, z. B. "Related", um eine Beziehung zwischen zwei Funktionen aufzuzeichnen, die möglicherweise Abhängigkeiten gemeinsam nutzen.
Directed Network (Gerichtetes Netzwerk): Sie können gerichtete Netzwerklinks verwenden, um Beziehungen zwischen Arbeitsaufgaben zu erstellen, die Direktionalität anzeigen. 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 aufzueichnen, die möglicherweise Abhängigkeiten gemeinsam nutzen und die Sie auf eine Weise voneinander unterscheiden möchten.
Dependency (Abhängigkeit): Sie können Abhängigkeitslinks verwenden, um Beziehungen zwischen Arbeitsaufgaben zu erstellen, die Direktionalität besitzen, und um zirkuläre Beziehungen einzuschränken. Der Linkname unterscheidet sich an den Endpunkten. In der Darstellung können Sie keinen abhängigen Link zu einer Arbeitsaufgabe erstellen, die abhängige Linkbeziehungen zu derselben Arbeitsaufgabe enthält. Verwendungsbeispiel: Verwenden Sie einen Abhängigkeitslink, um die Funktionen aufzuzeichnen, die abgeschlossen sein müssen, um eine Benutzeranforderungen zu erfüllen.
Tree (Struktur): Sie können Strukturlinks verwenden, um hierarchische Beziehungen mit mehreren Ebenen zwischen Arbeitsaufgaben zu erstellen Strukturlinks unterstützen hierarchischen Ansichten mit mehreren Ebenen, besitzen Direktionalität und schränken zirkuläre Beziehungen ein. Der Linkname unterscheidet sich an den Endpunkten. Strukturlinks sind der einzige Typ von Link, der von der Abfrage Arbeitsaufgabenstruktur unterstützt wird. In der Darstellung können Sie einem untergeordneten Elemente keine zwei übergeordneten zuweisen. Verwendungsbeispiel: Verwenden Sie einen Strukturlink, um Aufgaben und Unteraufgaben Ihres Teams aufzuzeichnen, die abgeschlossen sein müssen, um eine Funktion bereitzustellen.

Linktypen-Schemadefinition

Der folgende Code listet die Schemadefinition für Linktypen auf:

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

Fragen und Antworten

F: Wie kann ich einen benutzerdefinierten Linktyp hinzufügen?

A: Definieren Sie eine XML-Definitionsdatei gemäß dem in diesem Thema bereitgestellten Inhalt, und verwenden Sie dann witadmin importlinktype, um die Linktyp-Definitionsdatei in die Projektauflistung zu importieren, in der sich Ihr Teamprojekt befindet.

F: Welche Linktypen werden zum Verknüpfen von Testfällen mit Testsammlungen und von Testsammlungen mit Testplänen verwendet?

A: Mithilfe von Team Web Access oder Test Manager können Sie anzeigen, welche Testfälle für eine Testsammlung definiert sind und welche Testsammlungen für einen Tesplan definiert sind. Diese Objekte sind allerdings nicht miteinander durch Linktypen verknüpft.

Siehe auch

Konzepte

Anpassen der Objekte für die Arbeitsnachverfolgung als Unterstützung der Prozesse des Teams

Weitere Ressourcen

Verwalten von Abhängigkeiten, Verknüpfen von Arbeitsaufgaben zur Unterstützung von Rückverfolgbarkeit

Freigeben über