Guida di riferimento per i tipi di collegamento
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
È possibile usare tipi di collegamento diversi per gestire le varie relazioni tra elementi di lavoro e altri artefatti, ad esempio compilazioni, commit, richieste pull e altro ancora. In questo articolo vengono descritti i tipi di collegamento seguenti.
- Tipo di collegamento di lavoro: collega elementi di lavoro, inclusi gli elementi di lavoro di gestione dei test case
- Collegamento ipertestuale: Connessione un elemento di lavoro a qualsiasi URL o condivisione di rete
- Tipo di collegamento esterno: Connessione un elemento di lavoro a un oggetto esterno, ad esempio un oggetto di codice, una compilazione o una pagina wiki
- Tipo di collegamento di lavoro remoto: Connessione elementi di lavoro definiti in organizzazioni diverse
- Tipo di collegamento di GitHub: Connessione un elemento di lavoro a un commit, un problema o una richiesta pull del repository GitHub.
Un campo specifico mantiene un conteggio dei collegamenti per i primi quattro tipi di collegamento, ad esempio Conteggio collegamenti correlati, Conteggio collegamenti ipertestuali, Conteggio collegamenti esterni e Conteggio collegamenti remoti.
- Tipo di collegamento di lavoro: collega elementi di lavoro, tra cui selezionare gli elementi di lavoro di gestione dei test case
- Collegamento ipertestuale: connette un elemento di lavoro a qualsiasi URL o condivisione di rete
- Tipo di collegamento esterno: connette un elemento di lavoro a un oggetto esterno, ad esempio un oggetto di codice, una compilazione o una pagina wiki
- Tipo di collegamento gitHub: connette un elemento di lavoro a una richiesta pull o commit del repository GitHub.
Un campo specifico mantiene un conteggio dei collegamenti per i primi tre tipi di collegamento, ad esempio Conteggio collegamenti correlati, Conteggio collegamenti ipertestuali e Conteggio collegamenti esterni.
I tipi di collegamento sono soggetti a determinate restrizioni in base alla topologia. Usare le indicazioni fornite nelle tabelle seguenti per scegliere il tipo di collegamento da usare in base ai tipi di query e report da creare. Per altre informazioni sulle diverse topologie, vedere Collegare topologie e restrizioni dei tipi di collegamento.
Tipo di collegamento di lavoro
I tipi di collegamento di lavoro sono definiti dal sistema, definiti dal processo o definiti dall'utente (personalizzati). I collegamenti elencati nella tabella seguente sono definiti dal sistema.
Ogni tipo di collegamento di lavoro definisce le etichette di collegamento, il tipo di topologia e le restrizioni usate quando vengono costruiti i collegamenti tra gli elementi di lavoro. Ad esempio, il tipo di collegamento padre-figlio definisce due etichette: Padre e Figlio. Il tipo di collegamento supporta anche una topologia gerarchica o ad albero e impedisce la creazione di riferimenti circolari tra gli elementi di lavoro.
Il conteggio collegamenti correlati di un elemento di lavoro corrisponde alla somma di tutti i collegamenti definiti con un tipo di collegamento di lavoro.
Nella tabella seguente vengono descritti i tipi di collegamento dell'elemento di lavoro che è possibile specificare per definire l'ambito di un controllo collegamenti tramite l'elemento XML WorkItemLinksFilter.
Nome
Nome riferimento
Utilizzo
Effetti interessati da (solo CMMI)
Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Tipo di topologia: Dipendenza
Categoria di collegamento: process-defined
Usare questo collegamento direzionale per creare collegamenti tra qualsiasi set di elementi di lavoro, ma non tra quelli che creerebbero cicli chiusi. In genere usato per tenere traccia delle richieste di modifica effettuate ai requisiti.
Restrizioni e raccomandazioni:
- È possibile collegare una richiesta di modifica a un solo requisito usando Affects. È possibile collegare i requisiti a tutte le richieste di modifica figlio necessarie usando Affected by.
- Usare solo Affected-Affected by collegamenti per collegare elementi di lavoro nello stesso progetto. È consigliabile eseguire questa azione se si prevede di utilizzare Excel per modificare o aggiornare i dati degli elementi di lavoro.
Padre figlio
System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Tipo di topologia: albero
Categoria di collegamento: definita dal sistema
Usare questo collegamento direzionale per creare relazioni uno-a-molti tra un singolo padre e uno o più elementi figlio. Usare per organizzare l'elemento di lavoro all'interno di una gerarchia. È possibile creare rapidamente questa gerarchia tra gli elementi backlog usando la funzione di mapping o tra elementi e attività backlog usando il backlog sprint o Taskboard.
Gli usi tipici includono:
- Gestire le relazioni di riepilogo delle attività. I collegamenti padre-figlio vengono creati per le attività di riepilogo e le relative attività subordinate.
- Collegare attività a PBI, storie utente o requisiti. Supporta i report Panoramica del backlog, Panoramica delle storie e Panoramica dei requisiti.
Restrizioni e raccomandazioni:
- Utilizzare Excel per modificare in blocco sia gli elementi di lavoro che i collegamenti padre-figlio. Vedere Aggiungere o modificare elementi di lavoro in blocco con Excel.
- Un elemento di lavoro può avere un solo elemento padre. Un elemento di lavoro padre può avere molti elementi figlio.
- Usare solo collegamenti padre-figlio per collegare elementi di lavoro nello stesso progetto. Questa azione è consigliata se si prevede di utilizzare Excel per modificare o aggiornare i dati degli elementi di lavoro.
Duplicato di
System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Tipo di topologia: albero
Categoria di collegamento: definita dal sistema
Usare questo collegamento direzionale per creare relazioni uno-a-molti tra un singolo padre e uno o più elementi figlio. Usare per tenere traccia di attività, bug o altri elementi di lavoro duplicati l'uno dall'altro.
Restrizioni e raccomandazioni:
- Un elemento di lavoro può avere un solo duplicato.
- Usare solo collegamenti duplicati o duplicati per collegare elementi di lavoro nello stesso progetto. Questa azione è consigliata se si prevede di utilizzare Excel per modificare o aggiornare i dati degli elementi di lavoro.
Riferimenti a by-references
Microsoft.VSTS.TestCase.
SharedParameterReferencedBy
Tipo di topologia: Dipendenza
Categoria di collegamento: process-defined
Usare per collegare i test case ai parametri condivisi. Usare per collegare test case a parametri condivisi per supportare la possibilità di ripetere un test con dati diversi. In generale, questo tipo di collegamento non verrà aggiunto a un controllo collegamenti con ambito.
Correlati
System.LinkTypes.Related
Tipo di topologia: rete
Categoria di collegamento: definita dal sistema
Usare questo collegamento nondirectionale per creare collegamenti tra qualsiasi set di elementi di lavoro. Usare per collegare elementi di lavoro allo stesso livello, ad esempio due storie utente che definiscono funzionalità che si sovrappongono l'una all'altra. Il tipo di collegamento Correlato crea relazioni semplici con poche restrizioni.
- Correlare gli elementi di lavoro allo stesso livello, ad esempio due storie utente che definiscono le funzionalità che si sovrappongono tra loro.
- Collegare elementi di lavoro definiti in progetti diversi e gestiti da team diversi.
- Trovare e visualizzare gli elementi di lavoro e i relativi elementi di lavoro in una visualizzazione a due livelli.
- Creare relazioni semplici con poche restrizioni.
Predecessore successore
System.LinkTypes.Dependency
Tipo di topologia: Dipendenza
Categoria di collegamento: definita dal sistema
Scegliere Tipo di collegamento Predecessore durante il collegamento a un elemento di lavoro da completare prima dell'elemento di lavoro da cui si esegue il collegamento. Scegliere Tipo di collegamento successore durante il collegamento a un elemento di lavoro da cui deve essere completato dopo il collegamento all'elemento di lavoro da cui si esegue il collegamento.
Usare questo collegamento direzionale per creare collegamenti tra qualsiasi set di elementi di lavoro, ma non tra quelli che creerebbero cicli chiusi. Usare per tenere traccia delle attività che devono essere completate prima che altre possano essere avviate. Le attività collegate sono rappresentate come collegamenti successore predecessore in Azure Boards.
- Tenere traccia delle attività che devono essere completate prima che altre possano essere avviate.
- Supporta relazioni uno-a-molti.
- Trovare e visualizzare gli elementi di lavoro predecessori e i relativi elementi di lavoro successori in una vista query a due livelli diretti.
Restrizioni e raccomandazioni:
- Viene visualizzato un errore quando si tenta di creare collegamenti che definiscono relazioni circolari.
- Creare collegamenti predecessore successore solo a elementi di lavoro all'interno dello stesso progetto. È possibile creare collegamenti predecessor-successore tra elementi di lavoro definiti in progetti diversi. Tuttavia, se si esporta una query in Excel, vengono importati solo gli elementi di lavoro definiti per il progetto per cui viene definita la query.
Test sottoposti a test
Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Tipo di topologia: Dipendenza
Categoria di collegamento: process-defined
Collegare i test case agli elementi di lavoro, ad esempio bug, storie utente, requisiti ed elementi di backlog del prodotto. Usare per tenere traccia dei test case che testano le storie utente (Agile), gli elementi di backlog del prodotto (Scrum) o i requisiti (CMMI). Può anche collegarsi ad altri tipi di elementi di lavoro, ad esempio bug, problemi o attività. Per Azure DevOps locale, sono disponibili diversi report SQL che dipendono da questi collegamenti. Vedere Esaminare le attività del team per supportare report utili.
Passaggi condivisi del test case
Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Tipo di topologia: Dipendenza
Categoria di collegamento: process-defined
Usare per collegare i test case con i passaggi condivisi. Condividere i passaggi tra test case per evitare di dover creare più voci della stessa sequenza di passaggi.
Hyperlink
Un collegamento ipertestuale può collegare un elemento di lavoro a qualsiasi URL. Il conteggio collegamenti ipertestuali tiene traccia del numero di collegamenti ipertestuali a un elemento di lavoro.
Nome collegamento
Strumento supportato
Tipo di artefatto
Utilizzo
Hyperlink
Gestione elementi di lavoro
Hyperlink
Tipo di collegamento esterno
I tipi di collegamento esterno sono tipi di collegamento definiti dal sistema che supportano il collegamento di elementi di lavoro ad altri oggetti archiviati in Azure DevOps, come illustrato nell'immagine seguente. Il conteggio dei collegamenti esterni di un elemento di lavoro corrisponde alla somma di tutti i collegamenti definiti con un tipo di collegamento esterno.
Nota
È possibile usare solo un tipo di collegamento esterno per collegarsi a un oggetto Azure DevOps. Per collegare elementi di lavoro ad altri oggetti all'esterno di Azure DevOps, usare un collegamento ipertestuale.
Nella tabella seguente vengono descritti i tipi di collegamento esterno che è possibile scegliere quando si aggiunge un tipo di collegamento da un elemento di lavoro o un test case.
Nella tabella seguente vengono descritti i tipi di collegamento esterno che è possibile scegliere quando si aggiunge un tipo di collegamento da un elemento di lavoro o un test case. Inoltre, è possibile specificare uno di questi tipi di collegamento per definire l'ambito di un controllo collegamenti usando l'elemento XML ExternalLinksFilter.
Nome collegamento
Strumento supportato
Tipo di artefatto
Utilizzo
Ramo
Git
Ramo
Utilizzato per collegare un elemento di lavoro a un ramo.
Pipeline/Compilazione
Compilazione
Compilazione
Utilizzato per collegare un elemento di lavoro a una compilazione.
Set di modifiche (o corretto nel set di modifiche)
VersionControl
Modifiche
Utilizzato per collegare un elemento di lavoro a un insieme di modifiche.
Commit (o corretto nel commit)
Git
Commit
Utilizzato per collegare un elemento di lavoro a un commit.
Trovato nella compilazione
Pipeline/Compilazione
Compilazione
Utilizzato per collegare un elemento di lavoro a una compilazione.
Integrato nella compilazione
Compilazione
Pipeline di compilazione
Utilizzato per collegare un elemento di lavoro a una compilazione.
Integrazione nell'ambiente di rilascio
Versione
Pipeline di versione
Consente di collegare una versione a un elemento di lavoro. Il sistema crea un collegamento di questo tipo quando un utente abilita l'opzione Report deployment status to Work per una definizione di versione.
Richiesta pull
Git
PullRequestId
Consente di collegare un elemento di lavoro a una richiesta pull.
Allegato risultato
Gestione test
TcmResultAttachment
Consente di collegare un elemento di lavoro a un allegato associato a un risultato del test. Questi collegamenti vengono visualizzati quando si associa un elemento di lavoro a un risultato di test da Test o Microsoft Test Manager.
File del codice sorgente<
VersionControl
LatestItemVersion
Usato per collegare un elemento di lavoro a un file nel controllo della versione di Team Foundation (TFVC).
Storyboard
Requisiti
Storyboard
Consente di collegare un elemento di lavoro a un file di PowerPoint o a un altro file che contiene informazioni sull'onboarding della storia in una rete.
Tag
Git
Tag
Usato per collegare un elemento di lavoro a un tag definito per un repository Git Commit o Git. Per altre informazioni, vedere Lavorare dal prompt dei comandi Git.
Risultato del test
Gestione test
TcmResult
Consente di collegare un elemento di lavoro a un risultato di test. Questi collegamenti vengono visualizzati quando si associa un elemento di lavoro a un risultato di test da Test o Microsoft Test Manager.
Elemento con versione
VersionControl
LatestItemVersion
Wiki
Wiki
Wiki
Usato per collegare un elemento di lavoro a una pagina wiki. Supportato per TFS 2018.2 e versioni successive.
Tipo di collegamento di GitHub
I tipi di collegamento gitHub sono definiti dal sistema e supportano il collegamento di elementi di lavoro agli oggetti GitHub, come illustrato nell'immagine seguente.
Importante
È possibile collegarsi solo agli artefatti di GitHub con i repository connessi ad Azure Boards.
La tabella seguente descrive i tipi di collegamento di GitHub che è possibile scegliere quando si aggiunge un tipo di collegamento da un elemento di lavoro.
Nome collegamento
Tipo di artefatto
Utilizzo
GitHub Commit
Commit del repository GitHub
Usato per collegare un elemento di lavoro a un commit di GitHub.
Problema di GitHub
Problema del repository GitHub
Usato per collegare un elemento di lavoro a un problema di GitHub.
Richiesta di pull su GitHub
Richiesta pull del repository GitHub
Usato per collegare un elemento di lavoro a una richiesta pull di GitHub.
Tipo di collegamento di lavoro remoto
I tipi di collegamento di lavoro remoto sono tipi di collegamento definiti dal sistema che supportano il collegamento di elementi di lavoro definiti in organizzazioni diverse, purché lo stesso ID Microsoft Entra li gestisca come descritto in Connessione'organizzazione a Microsoft Entra ID.
Il conteggio dei collegamenti remoti di un elemento di lavoro corrisponde alla somma di tutti i collegamenti definiti con un tipo di collegamento di lavoro remoto.
Nome
Nome riferimento
Utilizzo
Utilizza da prodotto per
(topologia di dipendenza)
System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Tipo di topologia: Dipendenza
Categoria di collegamento: definita dal sistema
Usare questo collegamento direzionale per creare collegamenti tra elementi di lavoro con dipendenze e definiti in organizzazioni diverse, purché lo stesso ID Microsoft Entra li gestisca. In genere usato per tenere traccia delle richieste di modifica effettuate ai requisiti.
Remote Related
System.LinkTypes.Remote.Related
Tipo di topologia: rete
Categoria di collegamento: definita dal sistema
Usare questo collegamento non diretto per creare collegamenti tra gli elementi di lavoro definiti in organizzazioni diverse, purché gli stessi ID di Microsoft Entra li gestiscono.
Tipo di collegamento personalizzato
È possibile creare un tipo di collegamento personalizzato; esportare e importare definizioni di tipi di collegamento; e eliminare, attivare, disattivare e riattivare tipi di collegamenti. Fai riferimento ai seguenti articoli:
Elencare i tipi di collegamento
Per ottenere un elenco di tipi di collegamento, è possibile usare uno degli strumenti da riga di comando supportati.
az boards work-item relation list-type
È possibile elencare i tipi di collegamento supportati dall'organizzazione con il comando az boards work-item relation list-type o il comando dell'API REST elenco di relazioni tra elementi di lavoro. Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.
az boards work-item relation list-type [--org]
Parametri facoltativi
- org: URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando
az devops configure -d organization=ORG_URL
. Obbligatorio se non è configurato come predefinito o prelevato tramitegit config
. Esempio:--org https://dev.azure.com/MyOrganizationName/
.
Esempio
Il comando seguente elenca i tipi di collegamento dell'elemento di lavoro in formato tabella definiti per l'organizzazione fabrikam.
az boards work-item relation list-type --org fabrikam --output table
Name ReferenceName Enabled Usage
-------------------- ----------------------------------------------------------- --------- ------------
Produces For System.LinkTypes.Remote.Dependency-Forward True workItemLink
Consumes From System.LinkTypes.Remote.Dependency-Reverse True workItemLink
Duplicate System.LinkTypes.Duplicate-Forward True workItemLink
Duplicate Of System.LinkTypes.Duplicate-Reverse True workItemLink
Referenced By Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward True workItemLink
References Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse True workItemLink
Tested By Microsoft.VSTS.Common.TestedBy-Forward True workItemLink
Tests Microsoft.VSTS.Common.TestedBy-Reverse True workItemLink
Test Case Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward True workItemLink
Shared Steps Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse True workItemLink
Successor System.LinkTypes.Dependency-Forward True workItemLink
Predecessor System.LinkTypes.Dependency-Reverse True workItemLink
Child System.LinkTypes.Hierarchy-Forward True workItemLink
Parent System.LinkTypes.Hierarchy-Reverse True workItemLink
Related System.LinkTypes.Related True workItemLink
Remote Related System.LinkTypes.Remote.Related True workItemLink
Attached File AttachedFile True resourceLink
Hyperlink Hyperlink True resourceLink
Artifact Link ArtifactLink True resourceLink
Il formato JSON predefinito fornisce informazioni aggiuntive sugli attributi definiti per i tipi di collegamento. Ad esempio, le informazioni per i tipi di collegamento Produce per e Utilizza da sono elencate come indicato di seguito.
{
"attributes": {
"acyclic": true,
"directional": true,
"editable": false,
"enabled": true,
"isForward": true,
"oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
"remote": true,
"singleTarget": true,
"topology": "dependency",
"usage": "workItemLink"
},
"name": "Produces For",
"referenceName": "System.LinkTypes.Remote.Dependency-Forward",
"url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
},
{
"attributes": {
"acyclic": true,
"directional": true,
"editable": false,
"enabled": true,
"isForward": false,
"oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
"remote": true,
"singleTarget": true,
"topology": "dependency",
"usage": "workItemLink"
},
"name": "Consumes From",
"referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
"url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
},
witadmin listlinktypes
È possibile elencare i tipi di collegamento supportati per la raccolta di progetti usando lo witadmin listlinktypes
strumento da riga di comando o il comando Api REST Elenco tipi di relazione elemento di lavoro - Elenco .
Di seguito sono elencati i tipi di collegamento per la raccolta predefinita fabrikam-sever:
C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection
Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True
Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True
Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True
Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True
Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True
Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True
Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True
Attributi del tipo di collegamento
La tabella seguente fornisce descrizioni per ogni attributo del tipo di collegamento restituito dall'interfaccia della riga di comando di Azure Boards o dall'API REST.
Attributo
Descrizione
Nomi name
Specifica il nome descrittivo assegnato ai tipi di collegamento. I collegamenti direzionali sono definiti in coppie, pertanto includono un nome in avanti e inverso.
Nome riferimento, referenceName
Specifica il nome assegnato alla coppia tipo di collegamento o tipo di collegamento.
acyclic
Indica se il tipo di collegamento consente o (true
) o limita le relazioni circolari (false
). Ad esempio, i collegamenti di tipo albero limitano le relazioni circolari. Per altre informazioni, vedere Informazioni di riferimento sugli elementi LinkTypes.
directional
Indica se il tipo di collegamento è direzionale (true
) o meno (false
). I tipi di collegamento direzionale vengono definiti in coppia con un componente in avanti e inverso. Per altre informazioni, vedere Informazioni di riferimento sugli elementi LinkTypes.
editable
Indica se il tipo di collegamento è modificabile (true
) o meno (false
). È possibile aggiungere e modificare tipi di collegamento personalizzati solo per le distribuzioni locali usando witadmin
lo strumento da riga di comando Gestisci tipo di collegamento. I tipi di collegamento di sistema hanno editable=false
sempre .
È attivo, enabled
Indica se il tipo di collegamento è attivo (true
) o meno (false
). È possibile usare solo tipi di collegamento personalizzati per le distribuzioni locali usando lo strumento da witadmin
riga di comando Gestisci tipo di collegamento.
isForward
Indica se il tipo di collegamento specifica il collegamento in avanti () o meno (true
False
) all'interno di una coppia di tipi di collegamento.
oppositeEndReferenceName
Specifica il nome di riferimento del tipo di collegamento che definisce il collegamento nella direzione opposta di una coppia di tipi di collegamento.
remote
Indica se il tipo di collegamento supporta il collegamento a un elemento di lavoro remoto (true
) o meno (False
). I tipi di collegamento con remote=false
richiedono che l'elemento di lavoro di destinazione risieda nella stessa organizzazione o raccolta dell'elemento di lavoro di origine.
singleTarget
Indica se il tipo di collegamento consente più di una destinazione (false
) o se è limitato a una singola destinazione (true
).
topology
Specifica il tipo di topologia, ovvero l'albero di rete, and
delle dipendenze,
'. Per le descrizioni, vedere Topologie e restrizioni dei tipi di collegamento.
usage
Specifica il tipo di utilizzo, resourceLink o workItemLink
. Il valore della risorsa workItemLinkvalue indicates a link type that links two work items. The
indica un tipo di collegamento usato per collegare un elemento di lavoro a una risorsa, ad esempio un URL o un allegato.
url
Elenca gli attributi del tipo di collegamento in formato JSON.