Freigeben über


Linktyp-Elementverweis

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.

Topologie von Netzwerklinks

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.

Topologie von gerichteten Netzwerklinks

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.

Topologie von Abhängigkeitslinks

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.

Topologie von Strukturlinks

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>

Siehe auch

Konzepte

Auswählen von Linktypen für die effektive Nachverfolgung von Projekten

Anpassen von Projektnachverfolgungsdaten, Formularen, Workflow und anderen Objekten

Weitere Ressourcen

Verknüpfen von Arbeitsaufgaben und Objekten zur Unterstützung der Rückverfolgbarkeit

Bestimmen des Umfangs der Anpassungsanforderungen

Definieren von Kategorien für Arbeitsaufgabentypen