Odwołania do elementu typów łączy

Artykuł
03/12/2013

Typ łącza umożliwia zdefiniowanie etykiety łączy typu topologii i ograniczenia, które są używane, gdy powiązania między elementów pracy są zbudowane.Na przykład nadrzędny podrzędny typ łącza definiuje dwie etykiety (nadrzędne i podrzędne), obsługuje hierarchiczna lub drzewa topologii i zapobiega odwołania cykliczne z tworzonych między elementów pracy.

Aby dostosować lub utworzyć typ łącza, zaimportować plik XML do kolekcji projektu zespołu, która zawiera definicję typu łącza.Typy łączy są dodawane do zestawu typy łączy, które są zdefiniowane w kolekcji.Istniejące typy łączy są zastępowane nowymi informacjami, na podstawie nazwy odniesienia określony.

W tym temacie

Struktura składni
Wymagania dotyczące typów łączy
System określone typy łączy
Typy łączy zdefiniowane przez Szablony procesu MSF
Ograniczenia łącze i topologie
Definicja schematu typu łącza

Struktura składni

Przez dodanie ich do typów łączy, które są zdefiniowane dla kolekcji zespołu projektu, można zdefiniować typy łączy dodatkowych.Prawidłowe typy łącza do użycia można zdefiniować w procesie oparty na strukturze, która dostarcza schematu definicji typu łącze.Typ łącza jest zdefiniowany przez następującą składnię XML w pliku XML typu łącze:

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

Opisy w poniższej tabeli, stosuje się do poprzednich składni:

Atrybut	Opis
Nazwa_odwołania	Nazwa typu łącze.Ta nazwa jest używane wewnętrznie podczas tworzenia łącza między dwoma elementami pracy.
ForwardName	Nazwa łącza u źródła elementu pracy.Nazwa ta pojawia się po dodaniu łącza do źródła elementu pracy.
ReverseName	Nazwa łącza na element docelowy.Nazwa ta pojawia się, gdy pojawi się lista łącza na element docelowy.
TopologyType	Specifies the DirectedNetwork, Network, Tree, or Dependency topology.Pierwsze trzy topologie są kierunkowe i służą do definiowania relacji podrzędny lub kolejne.Za pomocą Network do definiowania relacji między elementami równorzędnymi lub gdy istnieje nie domniemanych subordynacji.

Kierunek łącze został ustalony przez przydziały do ForwardName i ReverseName atrybuty.Jeśli tworzenie łączy niestandardowych i przypisać tę samą nazwę do przodu i odwrotne nazw, należy ustawić typ łącza Network ponieważ jest topologia tylko nie kierunkowe.

Wymagania dotyczące typów łączy

LINKTYPESjest to zbiór LINKTYPE elementów, które są przechowywane i wykorzystywane przez zespół projektu kolekcji.

Każdy typ łącza ma nazwę odwołania i dwie opcjonalne przyjazne nazwy lub etykiety nazw, które muszą być unikatowe w obrębie zbioru projektu.Każda nazwa typu łącza muszą spełniać następujące wymagania:

Nazwy mogą mieć do 254 znaków Unicode.
Nazwy nie może być pusta.
Nazwy nie może zawierać spacji wiodących i końcowych.
Nazwy nie mogą zawierać znaków kreski ułamkowej odwróconej (\).
Nazwy nie mogą zawierać dwóch kolejnych spacji.

System określone typy łączy

W poniższej tabeli zestawiono typy łączy, które są zdefiniowane przez system.Te typy łączy, nie powinny zastępowane lub zmodyfikowany w jakikolwiek sposób.

Nazwa do przodu	Nazwa odwrotna	Nazwa odwołania typu łącza	Topologia
Następca	Poprzednik	System.LinkTypes.Dependency	Zależność
Dziecko	Nadrzędny	System.LinkTypes.Hierarchy	Drzewa
Powiązane	Powiązane	System.LinkTypes.Related	Sieci

Ponadto Storyboard łączenie elementów pracy łącza typu planów lub dowolny plik znajdujący się w udziale sieciowym.Aby uzyskać więcej informacji, zobacz Elementy LinksControlOptions.

Typy łączy zdefiniowane przez Szablony procesu MSF

W następującej tabeli wymieniono typy łączy, które są tworzone podczas tworzenia projektu zespołu przy użyciu szablonu procesu Microsoft Solutions Framework (MSF).Te typy łączy są zaprojektowane specjalnie do obsługi interakcji z śledzenie elementów pracy w Team Foundation i Microsoft Test Manager.

Nazwa do przodu	Nazwa odwrotna	Nazwa odwołania typu łącza	Topologia
Przetestowane przez	Testy	Microsoft.VSTS.common.TestedBy	Zależność
Badanie sprawy	Kroki udostępnionego	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Zależność

Każdego z typów łączy wymienionych wcześniej w tym temacie są dodawane do kolekcji zespołu projektu przy użyciu szablonu procesu MSF tworzenie zespołu projektu.Pliki definicji typu łącza są zdefiniowane w folderze Tracking\LinkTypes elementu pracy w pliku Template.zip.Następującą definicję typu łącze Microsoft.VSTS.Common.TestedBy jest zdefiniowany w pliku TestedBy.xml:

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

Po utworzeniu zespołu projektu za pomocą odpowiedniego szablonu procesu definicji typu łącze jest importowana do kolekcji projektu.

Ograniczenia łącze i topologie

Topologia, przypisany do typu łącze określa ograniczenia, które są dodawane do jego użycia.W poniższej tabeli można wyświetlić typy różnych topologii:

Typ topologii	Ilustracja
Sieci: łącza sieciowego umożliwia tworzenie podstawowych relacje elementów innych niż ograniczających.Łącze jest taka sama na obu punktów końcowych.Relacje cykliczne są dozwolone. Przykład użycia: Użyj łączy sieciowych, takich jak powiązane, do rejestrowania relacji między dwie funkcje, które mogą udostępniać zależności.
Reżyseria sieci: łącza sieci ukierunkowanych można użyć do tworzenia relacji między elementów pracy, które wskazują kierunek.Łącze jest inna na punkty końcowe.Relacje cykliczne są dozwolone. Przykład użycia: Użyj łącza ukierunkowanych sieci do rejestrowania relacji między dwie funkcje, które może udostępnić zależności, które chcesz odróżnić od siebie w jakiś sposób.
Zależność: Aby utworzyć relacje elementów pracy, które mają kierunek i ograniczyć relacje cykliczne, można użyć łącza współzależności.Łącze jest inna na punkty końcowe. Na ilustracji nie można utworzyć zależnych łącze do elementu zawierającego łącze zależnych relacje te same elementy pracy. Przykład użycia: Użyj łącza zależność do rejestrowania funkcji, które muszą być wykonane do wymagań użytkownika.
Drzewa: łącza drzewa umożliwia tworzenie wielopoziomowych hierarchiczne relacje między elementów pracy.Łącza drzewa obsługuje wielopoziomowe hierarchiczne widoki, mają kierunek i ograniczyć relacje cykliczne.Łącze jest inna na punkty końcowe.Drzewo łącza są tylko typ łącza, który jest obsługiwany przez Elementów drzewa pracy kwerendy. Na ilustracji nie można przypisać dwa rodziców dziecka. Przykład użycia: Użyj łącza drzewa do rejestrowania zadań i podzadań z zespołem, które musi być wykonane do dostarczania funkcja.

Definicja schematu typy łączy

Poniższy kod zawiera listę definicji schematu dla typów łącza:

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