Collegare elementi di lavoro a oggetti

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

I collegamenti agli elementi di lavoro sono associazioni tra due elementi di lavoro o un elemento di lavoro e un altro oggetto. I collegamenti descrivono la relazione tra oggetti. È possibile usare i collegamenti degli elementi di lavoro per tenere traccia delle dipendenze e il lavoro correlato per la tracciabilità, condividere informazioni, gestire progetti complessi che coinvolgono più team o prodotti, tenere traccia delle modifiche del codice, dei test e altro ancora.

• Collegare elementi di lavoro a vari oggetti
• Collegare elementi di lavoro ad altri elementi di lavoro
• Collegare diversi elementi di lavoro
• Modificare il tipo di collegamento di un collegamento esistente
• Collegare elementi di lavoro a nuovi elementi di lavoro
• Collegare elementi di lavoro a elementi di lavoro in progetti diversi (tra organizzazioni)
• Collegare elementi di lavoro alle richieste pull
• Collegare elementi di lavoro a oggetti GitHub
• Collegare diversi elementi ai nuovi rami Git
• Collegare elementi di lavoro alle compilazioni
• Collegare gli elementi di lavoro alle distribuzioni
• Collegare elementi di lavoro allo sviluppo di codice TFVC
• Collegare elementi di lavoro ai test
• Collegare elementi di lavoro a un sito Web, a una condivisione di rete, a uno storyboard o a un documento
• Visualizzare le dipendenze e tenere traccia del lavoro correlato
• Query per gli elementi di lavoro collegati
• Usare l'interfaccia della riga di comando di Azure per aggiungere, rimuovere o visualizzare i collegamenti
• Eliminare i collegamenti all'elemento di lavoro

Prerequisiti

Prerequisito	Descrizione
Membro amministratore o collaboratore del progetto	È necessario essere aggiunti a un progetto come membro del gruppo di sicurezza Collaboratori o Amministratori progetti.
Accesso degli stakeholder	Per aggiungere o modificare elementi di lavoro, è necessario concedere l'accesso agli stakeholder o versione successiva. Gli utenti con accesso stakeholder per i progetti pubblici hanno accesso completo alle funzionalità di backlog e bacheca, ad esempio gli utenti con accesso di base . Per altre informazioni, vedere Informazioni di riferimento rapido sull'accesso di tipo Stakeholder.
Membro collaboratore o Consenti perms in	- Per visualizzare o modificare gli elementi di lavoro, è necessario disporre degli elementi di lavoro Visualizza in questo nodo e Modificare gli elementi di lavoro in questo nodo autorizzazioni impostate su Consenti. Per impostazione predefinita, il gruppo Collaboratori ha questa autorizzazione impostata su Consenti. Per altre informazioni, vedere Impostare le autorizzazioni e l'accesso per il rilevamento del lavoro. - Per configurare le opzioni di integrazione per una pipeline di versione classica, è necessario disporre delle autorizzazioni per modificare la versione. - Per collegare elementi di lavoro a commit e richieste pull, è necessario che le autorizzazioni Modifica elementi di lavoro in questo nodo siano impostate su Consenti per il percorso area assegnato all'elemento di lavoro. Per impostazione predefinita, il gruppo Collaboratori dispone di questo set di autorizzazioni. - Per visualizzare gli elementi di lavoro, è necessario che le autorizzazioni Visualizza elementi di lavoro in questo nodo siano impostate su Consenti per il percorso area assegnato all'elemento di lavoro.
Iterazioni definite	Per usare il riquadro Pianificazione, l'amministratore del team deve definire percorsi di iterazione (sprint) e configurare le iterazioni del team.

Quali tipi di collegamenti sono presenti?

I tipi di collegamenti seguenti consentono di gestire le varie relazioni tra elementi di lavoro e altri oggetti.

Tipo di collegamento	Descrizione
Hyperlink	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 di lavoro remoto	Connette elementi di lavoro definiti in organizzazioni diverse
Tipo di collegamento di GitHub	Connette un elemento di lavoro a un commit, un problema o una richiesta pull del repository GitHub
Tipo di collegamento di lavoro	Connette elementi di lavoro, tra cui selezionare gli elementi di lavoro di gestione dei test case

Per altre informazioni sui tipi di collegamento, inclusi i tipi padre/figlio, correlati e predecessori, vedere Tipi di collegamento di lavoro.

Collegare elementi di lavoro a vari oggetti

Per collegare elementi di lavoro a vari oggetti, seguire questa procedura.

1. Dal portale Web aprire l'elemento di lavoro da cui si vuole collegare o crearne uno nuovo.

2. Selezionare la scheda Collegamenti e quindi selezionare Collega a.

3. Nell'elenco a discesa Tipo di collegamento selezionare il tipo di collegamento da creare.

4. Nel campo Collega a immettere o selezionare l'oggetto a cui si desidera collegarsi. A seconda del tipo di collegamento, è possibile immettere o selezionare gli oggetti seguenti.

   • Un altro ID o titolo dell'elemento di lavoro
   • URL di un elemento di lavoro remoto
   • URL di richiesta pull Git esterna
   • Un numero di build o un nome di definizione
   • Nome o nome dell'ambiente della fase di distribuzione
   • URL di una pagina Web o di un documento

5. (Facoltativo) Immettere un commento per descrivere il collegamento.

6. Seleziona OK per creare il collegamento.

Suggerimento

Sono disponibili altre funzionalità che è possibile usare per collegare o modificare i collegamenti che usano il tipo di collegamento Padre/Figlio . Alcune funzionalità sono dipendenti dalla versione. Per informazioni dettagliate, vedere gli articoli collegati.

• Per collegare gli elementi backlog agli elementi backlog del portfolio o per modificare la struttura dei collegamenti tra questi elementi, usare il riquadro di mapping per organizzare il backlog. In alternativa, è possibile scegliere Mostra elementi padre e trascinamento della selezione all'interno della gerarchia dell'albero.
• Per creare e collegare attività agli elementi backlog, usare la pagina di backlog sprint. Dal portale Web è anche possibile trascinare gli elementi per modificare la struttura dei collegamenti.
• Per impostare il rientro ( ), impostare il rientro ( ) e modificare la struttura di collegamento di una gerarchia ad albero, aggiornare e riordinare gli elementi da un backlog nel portale Web o usare una query albero in Team Explorer.
• Per aggiungere o eliminare elementi di lavoro o modificare la struttura del collegamento, è possibile utilizzare Excel. Vedere Aggiungere o modificare elementi di lavoro in blocco con Excel.

Collegare elementi di lavoro ad altri elementi di lavoro

Seguire questa procedura per aggiungere un collegamento a un'altra storia utente, epica, funzionalità, bug, problema o attività dal portale Web.

1. Aprire l'elemento di lavoro da collegare a un altro elemento di lavoro.

2. Nel modulo dell'elemento di lavoro selezionare la sezione Lavoro correlato.

3. Selezionare Aggiungi collegamento e quindi Elemento esistente.

4. Nell'elenco a discesa Tipo di collegamento selezionare il tipo di collegamento che si vuole creare, ad esempio Padre, Figlio o Correlato.

5. Nel campo Elemento di lavoro immettere l'ID dell'elemento di lavoro a cui si vuole collegare, quindi selezionare OK.

   Nell'esempio seguente viene usato il tipo di collegamento Correlato per collegare tre elementi al bug con ID 400.

   

   È possibile aggiungere collegamenti solo uno alla volta. Non è possibile immettere gli ID separati da virgole o spazi.

6. (Facoltativo) Se si lavora dalla pagina Risultati query, salvare in blocco gli elementi di lavoro modificati. Quando si lavora da un backlog, gli elementi di lavoro vengono salvati automaticamente.

   

Collegare diversi elementi di lavoro

1. Dal portale Web aprire una pagina backlog o risultati di query e selezionare più elementi di lavoro a cui si vuole aggiungere un collegamento.

2. Aprire il menu di scelta rapida ... di uno degli elementi di lavoro selezionati, scegliere Aggiungi collegamento e quindi scegliere Elemento esistente... o Nuovo elemento....

   Nell'esempio seguente, selezionare più selezioni dal backlog del prodotto e scegliere Elemento esistente....

   

3. Nell'elenco a discesa Tipo di collegamento selezionare il tipo di collegamento da creare, ad esempio Padre, Figlio o Correlato.

4. Nel campo Elemento di lavoro immettere l'ID dell'elemento di lavoro a cui si vuole collegare, quindi selezionare OK.

Modificare il tipo di collegamento di un collegamento esistente

1. Dal portale Web aprire l'elemento di lavoro e selezionare Collegamenti.

2. Selezionare Altre azioni>Collegamento Modifica.

   

3. Scegliere il tipo di collegamento in cui passare e quindi selezionare Salva.

   

4. Salvare l'elemento di lavoro.

Collegare elementi di lavoro a nuovi elementi di lavoro

Seguire questa procedura per collegare un elemento di lavoro a un nuovo elemento di lavoro.

1. Specificare il tipo di collegamento, il tipo di elemento di lavoro e il titolo del nuovo elemento di lavoro. Seleziona OK. Verrà aperto un elemento di lavoro del tipo selezionato.

   

2. Immettere informazioni aggiuntive e Salvare l'elemento di lavoro.

   

3. (Facoltativo) Se si lavora dalla pagina Risultati query, salvare in blocco gli elementi di lavoro modificati.

Collegare elementi di lavoro a elementi di lavoro remoti (tra organizzazioni)

Le organizzazioni che usano Microsoft Entra ID possono collegarsi a elementi di lavoro presenti in progetti diversi nelle organizzazioni. Usare i tipi di collegamento seguenti come indicato:

• Usare il collegamento Utilizza da o Produce per i tipi di collegamento quando si desidera tenere traccia delle dipendenze degli elementi di lavoro definiti in organizzazioni diverse e gestite da team diversi.
• Usare il tipo di collegamento Correlato remoto quando gli elementi di lavoro collegati sono definiti in organizzazioni diverse e gestite da team diversi, ma non hanno dipendenze complesse.

Seguire questa procedura per collegare elementi di lavoro a oggetti definiti in altre organizzazioni di Azure DevOps. È possibile farlo solo se entrambe le organizzazioni usano lo stesso ID Microsoft Entra per gestire gli utenti.

1. Scegliere uno dei tipi di collegamento remoto seguenti:

   • Utilizza da o produce per: quando si desidera tenere traccia delle dipendenze degli elementi di lavoro definiti in organizzazioni diverse e gestite da team diversi.
   • Correlato remoto: quando gli elementi di lavoro collegati sono definiti in organizzazioni diverse e gestite da team diversi, ma non hanno relazioni inter-dipendenze complesse.

2. Nella finestra di dialogo Aggiungi collegamento selezionare il tipo di collegamento, immettere l'URL dell'elemento di lavoro remoto e quindi selezionare OK.

   Nell'esempio seguente viene usato il tipo di collegamento Correlato remoto per collegare l'ID elemento di lavoro 350 esistente nell'organizzazione remotelinkingtest2 , progetto RemoteLinking .

   

La scheda collegamento mantiene un conteggio di tutti i collegamenti all'elemento di lavoro. Il campo Remote Link Count mantiene un conteggio del numero di collegamenti aggiunti a un elemento di lavoro che si collega a un elemento di lavoro definito in un altro progetto o organizzazione.

L'esempio seguente mostra due collegamenti remoti, indicati dall'icona del cloud, aggiunti a una storia utente.

Collegare elementi di lavoro alle richieste pull

1. Nella descrizione della richiesta pull immettere # per attivare la selezione dell'elemento #ID di lavoro. Un elenco visualizza 50 elementi di lavoro modificati di recente o assegnati all'utente.

   

2. Per restringere l'elenco degli elementi di lavoro suggeriti, immettere fino a cinque parole chiave corrispondenti al tipo di elemento di lavoro, all'ID o al titolo.

   

Per altre informazioni, vedere Collegare elementi di lavoro da richieste pull, commit e commenti.

Collegare elementi di lavoro a oggetti GitHub

Quando si connette Azure Boards ai repository GitHub, è possibile collegare gli elementi di lavoro a un commit gitHub, a una richiesta pull GitHub, a gitHub Branch e a un problema di GitHub. È possibile usare GitHub per lo sviluppo di software mentre si usa Azure Boards per pianificare e tenere traccia del lavoro.

Importante

È possibile collegare elementi di lavoro solo a oggetti GitHub che dispongono di repository connessi ad Azure Boards. Per altre informazioni, vedere Connettere Azure Boards a GitHub e Collegare elementi di lavoro da richieste pull, commit e commenti.

Per altre informazioni, vedere Collegare commit GitHub, richieste pull, rami e problemi agli elementi di lavoro e Completare automaticamente gli elementi di lavoro con le richieste pull.

Collegare diversi elementi di lavoro a nuovi rami Git

Da una pagina dei risultati di backlog o query, selezionare più elementi di lavoro da collegare a un nuovo ramo Git, scegliere l'icona delle azioni e quindi Nuovo ramo.... Per altre informazioni, vedere Collegare elementi di lavoro a oggetti di sviluppo Git.

Collegare elementi di lavoro alle compilazioni

Seguire questa procedura per collegare elementi di lavoro a compilazioni esistenti. Queste compilazioni possono trovarsi nel progetto o in altri progetti nell'organizzazione o nella raccolta.

1. Nella scheda Collegamenti di un elemento di lavoro selezionare Aggiungi collegamento>Elemento esistente.

2. Nella finestra di dialogo Aggiungi collegamento scegliere uno dei tipi di collegamento di compilazione: Compilazione, Trovato nella compilazione Integrato nella compilazione. Specificare il numero di build.

   Il numero di build è una combinazione della pipeline e del nome della compilazione. Se non si conosce il numero di build, cercarlo scegliendo l'icona .

   

3. Nella finestra di dialogo Collega compilazioni scegliere i parametri per filtrare la ricerca delle compilazioni.

   Per collegare una compilazione in un progetto diverso, scegliere prima di tutto il progetto a cui si vuole collegare la compilazione.

   Ad esempio, è possibile specificare un numero di build, selezionare una pipeline di compilazione o un risultato di compilazione, ad esempio All, succeeded, parzialmente completato, non riuscito o annullato. In alternativa, con l'opzione Tutti selezionata per Risultato scegliere Trova per elencare le build disponibili a cui collegarsi.

   

4. Scegliere la compilazione dall'elenco a cui si vuole collegare e quindi selezionare OK.

5. Nella finestra di dialogo Aggiungi collegamento selezionare OK per completare l'operazione.

   

Collegare gli elementi di lavoro alle distribuzioni

Durante lo sviluppo del software, è possibile acquisire le modifiche e le compilazioni del codice che supportano il completamento di un elemento di lavoro. Il team può comprendere il lavoro svolto o come è stato risolto un bug tramite il audit trail delle modifiche apportate alla codebase.

I tipi di collegamento usati per costruire questi collegamenti sono: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item e Integrated in release environment.The link types used to construct these links are: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item, and Integrated in release environment. Questi tipi vengono visualizzati nell'immagine seguente.

Suggerimento

È consigliabile eseguire lo sviluppo dall'elemento di lavoro al momento della creazione. È anche possibile aggiungere l'ID elemento di lavoro quando si creano rami, commit e richieste pull. Git consente di collegare gli elementi di lavoro ai commit usando il tipo di collegamento Commit . È possibile farlo nei modi seguenti.

• Prima di eseguire il commit delle modifiche, aggiungere gli ID elemento di lavoro in Modifiche Git per Visual Studio 2022 o Team Explorer per le versioni precedenti di Visual Studio:

  

• Usare il comando git-commit e includere l'ID dell'elemento di lavoro nel commento. Ad esempio, applicare questo commento #35 Catch null exception al commit. Quando si esegue il push del commit, il sistema crea un collegamento Commit tra il commit e l'elemento di lavoro #35.

• Usare il controllo Sviluppo per lo sviluppo Git dall'elemento di lavoro. Per altre informazioni, vedere Gestire lo sviluppo Git da un elemento di lavoro in Azure Boards.

Come illustrato nell'immagine seguente, il controllo Distribuzione visualizza le informazioni sulla versione per due fasi di rilascio. Include elementi di lavoro collegati a un commit Git o a una richiesta pull per una pipeline di versione configurata per l'integrazione con Azure Boards.

Controllo della distribuzione

I moduli degli elementi di lavoro forniscono due controlli da visualizzare e passare agli oggetti di sviluppo. Questo articolo descrive il controllo Distribuzione. Per informazioni sul controllo Sviluppo, vedere Guidare lo sviluppo Git da un elemento di lavoro.

Per impostazione predefinita, il controllo Distribuzione viene visualizzato nei moduli dell'elemento di lavoro per i tipi di elemento di lavoro User Story (Agile), Product Backlog Item (Scrum), Issue (Basic), Requirement (CMMI), Feature, Epic, Bug, Task e Test Case.

I tipi di elementi di lavoro personalizzati che usano il processo ereditato vengono abilitati automaticamente. Il controllo Distribuzione visualizza le informazioni sulla versione per due fasi della pipeline di versione integrata con Azure Boards.

Questo controllo mostra solo gli elementi di lavoro collegati a un commit Git o a una richiesta pull per questa pipeline. È anche possibile ottenere informazioni visive sullo stato di un elemento di lavoro quando viene distribuito in ambienti di versione diversi. È possibile passare a ogni fase di rilascio ed eseguire.

Gli elementi di lavoro associati ai commit nella compilazione mostrano lo stato della versione. Solo gli elementi di lavoro all'interno dello stesso progetto vengono collegati alla posizione in cui è definita la pipeline di versione.

Quando si apre un elemento di lavoro, è possibile visualizzare le fasi in tempo reale.

Per popolare il controllo Distribuzione , seguire questa procedura:

Nota

Il controllo Distribuzione richiede la configurazione di una pipeline di versione classica. Non supporta il collegamento alle fasi di rilascio definite per una pipeline YAML.

1. Definire una pipeline di versione classica e configurare le fasi di rilascio. Per altre informazioni, vedere Definire la pipeline di distribuzione continua (CD) in più fasi.

2. Configurare la pipeline. Per altre informazioni, vedere Configurare le pipeline per supportare il rilevamento del lavoro, Segnalare lo stato della distribuzione alle bacheche.

3. Collegare elementi di lavoro a una richiesta di commit o pull nel repository Git di Azure Repos. Per altre informazioni, vedi:

   • Promuovere lo sviluppo Git da un elemento di lavoro
   • Collegamento a elementi di lavoro da altri oggetti

4. Esegui la pipeline.

Collegare elementi di lavoro allo sviluppo di codice TFVC

Il controllo della versione di Team Foundation (TFVC) consente di collegare elementi di lavoro ai set di modifiche del controllo della versione o ai file di codice sorgente con controllo delle versioni usando i tipi di collegamento Set di modifiche e Elemento con versione. Quando si controllano le modifiche in sospeso o si usa My Work per archiviare le modifiche, gli elementi di lavoro vengono automaticamente collegati alle modifiche. Per altre informazioni, vedere Archiviare il lavoro.

Collegare elementi di lavoro ai test

I tipi di collegamento correlati al test collegano gli elementi di lavoro di gestione dei test case l'uno all'altro o ad altri elementi di lavoro. Dal portale Web o da Microsoft Test Manager è possibile visualizzare i test case definiti per un gruppo di test e quali gruppi di test sono definiti per un piano di test. Questi oggetti non sono collegati tra loro tramite tipi di collegamento.

È possibile collegare elementi di lavoro ai test case usando i tipi di collegamento Test/Test by . Usare gli stessi controlli di collegamento usati per collegare elementi di lavoro ad altri elementi di lavoro. Vedere Collegare elementi di lavoro.

L'immagine seguente mostra il set completo di tipi di collegamento che è possibile usare con i tipi di elemento di lavoro di gestione dei test. La maggior parte dei collegamenti tra gli oggetti di gestione dei test si verifica eseguendo un'attività dalle pagine test o da Microsoft Test Manager.

Ad esempio, quando si aggiungono passaggi condivisi a un test case, questi vengono collegati automaticamente usando i tipi di collegamento Test Case/Passaggi condivisi. Per altre informazioni, vedere Condividere i passaggi tra test case.

Da Test è possibile aggiungere piani di test, gruppi di test e test case collegati. Non è possibile aggiungerli tramite un tipo di collegamento specifico. Il sistema di test crea e gestisce le associazioni dei risultati dei test ai test case e ai piani di test.

Collegare elementi di lavoro a un sito Web, a una condivisione di rete, a uno storyboard o a un documento

È possibile utilizzare un collegamento ipertestuale o un tipo di collegamento storyboard per collegare un elemento di lavoro a un sito Web, a una condivisione di rete o a un documento che si trova in una condivisione di rete. Entrambi i tipi di collegamento sono collegamenti unidirezionale. Per aggiungere questi tipi di collegamento, usare gli stessi controlli descritti in precedenza. Vedere Collegare elementi di lavoro.

Quando si usa il tipo di collegamento dello storyboard, distinguere il collegamento per specificare uno storyboard o un documento che fornisce specifiche dell'elemento di lavoro. Usare questo tipo di collegamento per fornire al team l'accesso al file condiviso in cui è possibile aggiungere i commenti.

Visualizzare le dipendenze e tenere traccia del lavoro correlato

Azure DevOps offre diversi modi per visualizzare le dipendenze e tenere traccia del lavoro correlato:

• Editor di query: è possibile usare il Editor di query per creare query personalizzate che mostrano tutti gli elementi di lavoro collegati a un elemento di lavoro specifico.
• Backlog e boards: le visualizzazioni Backlog e Boards mostrano relazioni padre-figlio tra elementi di lavoro, consentendo di visualizzare immediatamente le dipendenze.
• Rilevamento dipendenze: Lo strumento di rilevamento delle dipendenze è un report di Power BI che fornisce una rappresentazione visiva delle dipendenze tra gli elementi di lavoro.

Per visualizzare l'elenco di tutti gli oggetti collegati a un elemento di lavoro, seguire questa procedura.

1. Aprire l'elemento di lavoro e selezionare Collegamenti. La scheda Collegamenti indica il conteggio di tutti gli oggetti collegati. Gli oggetti collegati vengono raggruppati sotto il tipo di collegamento, con un conteggio all'interno di ogni gruppo.

   

2. (Facoltativo) Espandere o comprimere ogni gruppo e ordinare all'interno di ogni gruppo in base allo stato, all'aggiornamento più recente o al commento scegliendo il titolo della colonna corrispondente.

Ad esempio, la scheda Collegamenti seguente mostra una parte degli oggetti collegati 64 per un elemento di lavoro.

I collegamenti preceduti dal punto esclamativo indicano che la compilazione, il rilascio o l'altro oggetto viene eliminato. A causa dei criteri di conservazione, questi oggetti vengono eliminati automaticamente dopo un determinato periodo di tempo.

Query per gli elementi di lavoro collegati

Per filtrare gli elementi in base ai collegamenti gerarchici, usare il tipo di query Albero degli elementi di lavoro. Per filtrare gli elementi in base a tutti i tipi di collegamento, usare elementi di lavoro e collegamenti diretti.

Per trovare elementi di lavoro collegati ad altri elementi di lavoro con tipi di collegamento specifici, usare una query che mostra un set primario e secondario di elementi di lavoro. Il set primario soddisfa i criteri di campo e il set secondario è collegato al set primario. Non è possibile eseguire query per gli elementi di lavoro nelle versioni. È possibile eseguire una query per gli elementi di lavoro con collegamenti esterni. Per perfezionare la ricerca, aggiungere altri filtri di query.

Per esempi di query, vedere Eseguire query sugli elementi di lavoro per collegamento o numero di allegati.

Non è possibile costruire una query che mostra una visualizzazione gerarchica dei piani di test, dei gruppi di test e dei test case. Questi elementi non sono collegati con Parent/Child o qualsiasi altro tipo di collegamento. È possibile visualizzare la gerarchia solo tramite la pagina Piani di test di test>. Per altre informazioni, vedere Creare piani di test e gruppi di test.

Usare l'interfaccia della riga di comando di Azure per aggiungere, rimuovere o visualizzare i collegamenti

È possibile aggiungere, rimuovere e visualizzare i dettagli dei collegamenti a un elemento di lavoro con il comando az boards work-item relation . Per altre informazioni, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

I tipi di collegamento includono tipi di collegamento di lavoro, tipi di collegamento remoto, collegamenti ipertestuali e file allegati. Per un elenco di tutti i tipi di collegamento che è possibile specificare, eseguire il comando az boards work-item relation list-type .

az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show

Negli esempi seguenti l'organizzazione è fabrikam e l'ID progetto corrisponde a aaa-0000-1111-2222-bbbbbbbb. Il formato della tabella viene usato per visualizzare l'output. Per altri formati, vedere Formati di output per i comandi dell'interfaccia della riga di comando di Azure.

Collegare elementi di lavoro

Per collegare uno o più elementi di lavoro a un singolo elemento di lavoro, immettere il comando az boards work-item relation add .

I parametri obbligatori includono l'ID dell'elemento di lavoro a cui collegarsi e il tipo di collegamento. I tipi di collegamento supportati includono Parent, Child, Related e Remote Related. Per un elenco di tutti i tipi di collegamento, eseguire il comando az boards work-item relation list-type .

Per gli elementi di lavoro definiti all'interno della stessa organizzazione, è necessario specificare l'ID elemento di lavoro o l'URL di destinazione. Per gli elementi di lavoro definiti in un'organizzazione remota, specificare l'URL di destinazione. È possibile specificare più valori separando GLI ID o gli URL con una virgola.

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org]
                                 [--target-id]
                                 [--target-url]

Il comando seguente collega l'ID elemento di lavoro=2807 all'ID elemento di lavoro=2794 con il tipo di collegamento Figlio . Il comando restituisce un elenco di tutti i collegamenti attualmente definiti per l'elemento di lavoro.

az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2807

Per visualizzare le informazioni per gli elementi di lavoro collegati, immettere uno degli URL elencati nel browser.

Rimuovere i collegamenti all'elemento di lavoro

Per rimuovere uno o più elementi di lavoro collegati da un singolo elemento di lavoro, immettere il comando az boards work-item relation remove .

I parametri obbligatori includono l'ID dell'elemento di lavoro da cui rimuovere il collegamento e il tipo di collegamento. È possibile rimuovere solo i collegamenti agli elementi di lavoro definiti nella stessa organizzazione. È possibile specificare qualsiasi tipo di collegamento supportato, ad eccezione dei tipi di collegamento remoto.

È necessario specificare l'ID dell'elemento di lavoro di destinazione. È possibile specificare più valori separando GLI ID o gli URL con una virgola.

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org]
                                    [--yes]

Il comando seguente rimuove il collegamento all'ID elemento di lavoro=2794 dall'ID elemento di lavoro=2856 all'elemento di lavoro con il tipo di collegamento figlio . Il comando restituisce un elenco di tutti i collegamenti attualmente definiti per l'elemento di lavoro.

az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805 

Per visualizzare le informazioni per gli elementi di lavoro collegati, immettere uno degli URL elencati nel browser.

Mostra i dettagli dei collegamenti creati per un singolo elemento di lavoro

Per visualizzare gli elementi di lavoro collegati a un singolo elemento di lavoro, immettere il comando az boards work-item relation show . Per un elenco di tutti i tipi di collegamento che è possibile restituire, eseguire il comando az boards work-item relation list-type .

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org]

Il comando seguente elenca i dettagli dei collegamenti definiti per l'ID elemento di lavoro=2931 nell'organizzazione fabrikam in formato tabella.

az boards work-item relation show --id 2931 --output table
Relation Type    Url
---------------  -----------------------------------------------------------------------------------------------------------------------------------
Related          https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

Per visualizzare le informazioni per gli elementi di lavoro collegati, immettere uno degli URL elencati nel browser. Scegliere l'URL di un file allegato per scaricare l'allegato.

Eliminare i collegamenti all'elemento di lavoro

Per eliminare un collegamento a un elemento di lavoro, seguire questa procedura.

1. Aprire l'elemento di lavoro con collegamenti o selezionarlo da un risultato della query.
2. Selezionare la scheda Collegamenti per visualizzare l'elenco dei collegamenti.
3. Selezionare il collegamento da eliminare e quindi selezionare Rimuovi collegamento.
4. Confermare di voler eliminare il collegamento.

Dopo che un elemento di lavoro viene collegato a una richiesta di commit o pull, continua a essere visualizzato come parte delle fasi di rilascio. Ad esempio, se si dispone di un elemento di lavoro che non ha superato i criteri di test, è possibile rimuoverlo dalle compilazioni e dalle versioni.

Per rimuovere l'elemento di lavoro dalla partecipazione alle build e alle versioni future, eliminare il collegamento alla richiesta pull e commit più recente.

Articoli correlati

Visualizzare il lavoro correlato e altri oggetti. Scaricare l'estensione di visualizzazione elementi di lavoro, disponibile nella scheda Visual Studio Marketplace, Azure DevOps.

• Esaminare la guida di riferimento per i tipi di collegamento
• Informazioni su Azure Boards e Azure Repos
• Promuovere lo sviluppo Git da un elemento di lavoro
• Tenere traccia delle dipendenze usando i piani di recapito
• Organizzare il backlog e mappare gli elementi di lavoro figlio
• Aggiungere o modificare elementi di lavoro in blocco con Microsoft Excel