Utilizzo dei tipi di collegamento

Articolo
08/11/2011

È possibile utilizzare un tipo di collegamento per definire le etichette del collegamento, il tipo di topologia e le restrizioni utilizzate quando vengono creati i collegamenti tra elementi di lavoro. I tipo di collegamento padre-figlio, ad esempio, definisce due etichette (Padre e Figlio), supporta una topologia gerarchica o di struttura ad albero e impedisce la creazione di riferimenti circolari tra elementi di lavoro.

Per personalizzare o creare un tipo di collegamento, è necessario importare un file XML nell'insieme di progetti team che contiene la definizione del tipo di collegamento. I tipi di collegamento vengono aggiunti al set di tipi di collegamento definiti per l'insieme. I tipi di collegamento esistenti vengono sovrascritti con le nuove informazioni basate sul nome di riferimento specificato.

Sommario degli argomenti

Struttura della sintassi
Requisiti per i tipi di collegamento
Tipi di collegamento definiti dal sistema
Tipi di collegamento definiti da modelli di processo MSF
Restrizioni dei collegamenti e topologie
Definizione dello schema di tipi di collegamento

Struttura della sintassi

È possibile definire ulteriori tipi di collegamento aggiungendoli ai tipi di collegamento definiti per un insieme di progetti team. È possibile definire i tipi di collegamento validi per il processo in base alla struttura fornita dallo schema di definizione dei tipi di collegamento. Un tipo di collegamento viene definito dalla sintassi XML seguente nel file XML dei tipi di collegamento:

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

Le descrizioni riportate nella seguente tabella si applicano alla sintassi precedente:

Attributo	Descrizione
ReferenceName	Nome del tipo di collegamento. Questo nome viene utilizzato internamente quando si crea un collegamento tra due elementi di lavoro.
ForwardName	Nome del collegamento nell'elemento di lavoro di origine. Questo nome viene visualizzato quando si aggiungono collegamenti all'elemento di lavoro di origine.
ReverseName	Nome del collegamento nell'elemento di lavoro di destinazione. Questo nome viene visualizzato quando viene riprodotto un elenco dei collegamenti nell'elemento di lavoro di destinazione.
TopologyType	Specifica la topologia DirectedNetwork, Network, Tree o Dependency. Le prime tre topologie sono direzionali e vengono utilizzate per definire relazioni subordinate o sequenziali. La topologia Network viene utilizzata per definire relazioni tra pari o dove non esiste alcuna subordinazione implicita.

La direzionalità del collegamento è determinata dalle assegnazioni effettuate agli attributi ForwardName e ReverseName. Se si crea un collegamento personalizzato e si assegna lo stesso nome ai nomi diretti e inversi, è necessario impostare il tipo di collegamento su Network, in quanto è l'unica topologia non direzionale.

Requisiti per i tipi di collegamento

LINKTYPES è un set di elementi LINKTYPE archiviati e utilizzati da un insieme di progetti team.

Ogni tipo di collegamento dispone di un nome di riferimento e di due nomi descrittivi facoltativi, o etichette del nome, che devono essere univoci all'interno dell'insieme di progetti. Ogni nome del tipo di collegamento deve soddisfare i requisiti seguenti:

I nomi non possono superare i 254 caratteri Unicode.
I nomi non devono essere vuoti.
I nomi non possono avere spazi vuoti iniziali o finali.
I nomi non possono contenere caratteri barra rovesciata (\).
I nomi non possono contenere due spazi vuoti consecutivi.

Tipi di collegamento definiti dal sistema

Nella tabella seguente sono riepilogati i tipi di collegamento definiti dal sistema. Questi tipi di collegamento non devono essere sovrascritti o modificati in alcun modo.

Nome diretto	Nome inverso	Nome di riferimento del tipo di collegamento	Topologia
Successore	Predecessore	System.LinkTypes.Dependency	Dependency
Elemento figlio	Padre	System.LinkTypes.Hierarchy	Tree
Correlato	Correlato	System.LinkTypes.Related	Network

Tipi di collegamento definiti da modelli di processo MSF

Nella tabella seguente sono elencati i tipi di collegamento creati quando si crea un progetto team tramite un modello di processo di Microsoft Solutions Framework (MSF). Questi tipi di collegamento vengono progettati in maniera specifica per supportare l'interazione con il rilevamento degli elementi di lavoro in Team Foundation e Microsoft Test Manager.

Nome diretto	Nome inverso	Nome di riferimento del tipo di collegamento	Topologia
Testato da	Test	Microsoft.VSTS.Common.TestedBy	Dependency
Test case	Passi condivisi	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Dependency

Ognuno dei tipi di collegamento elencati in precedenza in questo argomento viene aggiunto all'insieme di progetti team quando si utilizza un modello di processo MSF per creare un progetto team. I file di definizione dei tipi di collegamento sono definiti nella cartella WorkItem Tracking\LinkTypes del file Template.zip. La definizione seguente per il tipo di collegamento Microsoft.VSTS.Common.TestedBy è definita nel file TestedBy.xml:

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

Quando si crea il progetto team tramite il modello di processo corrispondente, la definizione del tipo di collegamento viene importata nell'insieme di progetti.

Restrizioni dei collegamenti e topologie

La topologia assegnata a un tipo di collegamento determina le restrizioni aggiunte per il relativo utilizzo. Nella tabella seguente è possibile visualizzare i diversi tipi di topologia:

Tipo di topologia	Illustrazione
Network: è possibile utilizzare collegamenti di rete per creare relazioni di base tra elementi di lavoro non restrittivi. Il collegamento è lo stesso in entrambi gli endpoint. Le relazioni circolari sono consentite. Esempio di utilizzo: utilizzare un collegamento di rete, ad esempio Correlato, per registrare una relazione tra due funzionalità che potrebbero condividere dipendenze.
Directed Network: è possibile utilizzare collegamenti di rete diretti per creare relazioni tra elementi di lavoro che indicano direzionalità. Il nome del collegamento è diverso negli endpoint. Le relazioni circolari sono consentite. Esempio di utilizzo: utilizzare un collegamento di rete diretto per registrare una relazione tra due funzionalità che potrebbero condividere dipendenze e che si desidera distinguere.
Dependency: è possibile utilizzare collegamenti di dipendenza per creare relazioni tra elementi di lavoro con direzionalità e per limitare le relazioni circolari. Il nome del collegamento è diverso negli endpoint. Nell'illustrazione non è possibile creare un collegamento dipendente a un elemento di lavoro che contiene relazioni di collegamento dipendenti agli stessi elementi di lavoro. Esempio di utilizzo: utilizzare un collegamento di dipendenza per registrare le funzionalità che devono essere completate per fornire un requisito utente.
Tree: è possibile utilizzare collegamenti di struttura ad albero per creare relazioni gerarchiche a più livelli tra elementi di lavoro. I collegamenti di struttura ad albero supportano visualizzazioni gerarchiche a più livelli, hanno direzionalità e limitano le relazioni circolari. Il nome del collegamento è diverso negli endpoint. I collegamenti di struttura ad albero sono il solo tipo di collegamento supportato dalla query Struttura ad albero elementi di lavoro. Nell'illustrazione non è possibile assegnare due elementi padre a un elemento figlio. Esempio di utilizzo: utilizzare un collegamento di struttura ad albero per registrare attività e sottoattività del team che devono essere completate per fornire una funzionalità.

Definizione dello schema di tipi di collegamento

Nel codice seguente è riportata la definizione dello schema per i tipi di collegamento:

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