Riferimento all'elemento tipo di collegamento

È necessario usare tipi di collegamento diversi per creare relazioni di collegamento tra diversi tipi di elemento di lavoro. Sono disponibili tre categorie di tipi di collegamento: definiti dal sistema, definiti dai modelli di processo e definiti dall'utente. I tipi di collegamento definiti nei modelli di processo predefiniti supportano le relazioni di collegamento tra i tipi di elemento di lavoro di gestione di test.

Ogni tipo di collegamento definisce le etichette del collegamento, il tipo di topologia e le restrizioni usate durante la creazione dei collegamenti tra gli elementi di lavoro. Ad esempio, il tipo di collegamento padre-figlio definisce due etichette (Padre e Figlio), supporta una topologia gerarchica o ad albero e impedisce la creazione di riferimenti circolari tra gli elementi di lavoro.

Per personalizzare o creare un tipo di collegamento, usare witadmin importlinktype per importare il file di definizione del tipo di collegamento nella raccolta di progetti che ospita il progetto team.

Struttura della sintassi

È possibile definire altri tipi di collegamento aggiungendoli ai tipi di collegamento definiti per una raccolta di progetti team. Si possono definire tipi di collegamento validi da usare nel processo in base alla struttura fornita dallo schema della definizione del tipo di collegamento. Un tipo di collegamento è 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 nella tabella seguente sono applicabili alla sintassi precedente:

La direzionalità dei collegamenti è determinata dalle assegnazioni effettuate per gli attributi ForwardName e ReverseName. Se si crea un collegamento personalizzato e si assegna lo stesso nome al nome diretto e al nome inverso, è necessario impostare il tipo di collegamento su Network, poiché si tratta dell'unica topologia non direzionale.

Requisiti

LINKTYPES è un set di elementi LINKTYPE archiviati e usati da una raccolta di progetti team.

Ogni tipo di collegamento ha un nome di riferimento e due nomi descrittivi facoltativi, o etichette del nome, che devono essere univoci nella raccolta di progetti. Ogni nome di 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 possono essere modificati.

Sono inoltre disponibili tipi di collegamento aggiuntivi usati per collegare elementi di lavoro ad altri oggetti nel progetto team o ad altri elementi, ad esempio una pagina Web o un percorso di rete. Ad esempio, il tipo di collegamento Storyboard collega elementi di lavoro a storyboard o a qualsiasi file situato in una condivisione di rete. Per altre informazioni, vedere Collegare elementi di lavoro per supportare la tracciabilità.

Tipi di collegamento definiti dai modelli di processo

Quando si crea un progetto team usando uno dei modelli di processo predefiniti forniti da TFS, i tipi di collegamento seguenti sono aggiunti al progetto team. Questi tipi di collegamento sono stati progettati in modo specifico per supportare l'interazione con gli elementi di lavoro di verifica in Team Foundation e Microsoft Test Manager.

Note

1. Il tipo di collegamento Interessa/Interessato da collega le richieste di modifica ai requisiti. Questo tipo di collegamento è aggiunto solo ai progetti team creati con un modello di processo CMMI.

2. Il tipo di collegamento Riferimento da/Riferimenti collega il parametro condiviso con il test case, per supportare l'esecuzione di test con dati diversi. Questo tipo di collegamento è aggiunto a un progetto team quando si aggiorna il progetto team usando la Configurazione guidata delle funzionalità o quando si crea un progetto team in base a modelli di processo di TFS 2013.2 o versioni successive.

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 usando il modello di processo corrispondente, la definizione del tipo di collegamento è importata nella raccolta di progetti.

Restrizioni e topologie di collegamenti

I tipi di topologia descritti nella tabella seguente determinano le restrizioni applicate all'uso di ogni tipo di collegamento.

Tipo di topologia	Illustrazione
Rete: è possibile usare i collegamenti di rete per creare relazioni di base tra elementi di lavoro non restrittivi. Il collegamento è uguale in entrambi gli endpoint. Le relazioni circolari sono consentite. Esempio d'uso: usare un collegamento di rete, ad esempio Correlato, per registrare una relazione tra due funzionalità che potrebbero condividere dipendenze.
Di rete diretti: è possibile usare i collegamenti di rete diretti per creare relazioni tra elementi di lavoro che indicano la direzionalità. Il nome del collegamento è diverso negli endpoint. Le relazioni circolari sono consentite. Esempio d'uso: usare un collegamento di rete diretto per registrare una relazione tra due funzionalità che potrebbero condividere dipendenze e che devono essere distinte in qualche modo l'una dall'altra.
Dipendenza: è possibile usare i collegamenti di dipendenza per creare relazioni tra gli elementi di lavoro con direzionalità e per limitare le relazioni circolari. Il nome del collegamento è diverso negli endpoint. Come indicato nell'illustrazione, non è possibile creare un collegamento di dipendenza per un elemento di lavoro che include relazioni di collegamenti di dipendenza con gli stessi elementi di lavoro. Esempio d'uso: usare un collegamento di dipendenza per registrare le funzionalità da completare per offrire un requisito utente.
Albero: è possibile usare i collegamenti di struttura ad albero per creare relazioni gerarchiche a più livelli tra gli elementi di lavoro. I collegamenti di struttura ad albero supportano visualizzazioni gerarchiche a più livelli e limitano le relazioni circolari. Il nome del collegamento è diverso negli endpoint. I collegamenti di struttura ad albero sono l'unico tipo di collegamento supportato dalla query Struttura ad albero elementi di lavoro. Come indicato nell'illustrazione, non è possibile assegnare due elementi padre a un figlio. Esempio d'uso: usare un collegamento di struttura ad albero per registrare attività e sottoattività dal team che devono essere completate per offrire una funzionalità.

Definizione dello schema di tipi di collegamento

Nel codice seguente sono elencate le definizioni di 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>

Domande e risposte

D: Come si aggiunge un tipo di collegamento predefinito?

R: Definire un file di definizione XML in base ai contenuti disponibili in questo argomento, quindi usare witadmin importlinktype per importare il file di definizione del tipo di collegamento nella raccolta di progetti che ospita il progetto team.

D: Quale tipo di collegamento permette di collegare test case a gruppi di test e gruppi di test a piani di test?

R: Tramite Team Web Access o Test Manager, è possibile visualizzare i test case definiti per un gruppo di test e i gruppi di test definiti per un piano di test. Questi oggetti, tuttavia, non sono collegati reciprocamente tramite tipi di collegamento.

Vedere anche

Concetti

Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team

Altre risorse

Collegare elementi di lavoro per supportare la tracciabilità