Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Collegare elementi di lavoro per tenere traccia del lavoro e delle dipendenze correlate e allegare file per condividere informazioni con il team. Eseguire query sugli elementi di lavoro usando i campi seguenti:
Suggerimento
È possibile usare l'intelligenza artificiale per facilitare questa attività più avanti in questo articolo, oppure vedere Abilitare l'assistenza AI con Azure DevOps MCP Server per iniziare.
- Conteggio file allegati
- (Discussione) Conteggio dei commenti
- Conteggio collegamenti esterni
- Conteggio collegamenti ipertestuali
- Commento al collegamento
- Conteggio collegamenti correlati
- Conteggio collegamenti remoti
- Conteggio file allegati
- (Discussione) Conteggio dei commenti
- Conteggio collegamenti esterni
- Conteggio collegamenti ipertestuali
- Commento al collegamento
- Conteggio collegamenti correlati
Per descrizioni dettagliate dei campi, vedere Campi associati a collegamenti e allegati.
Prerequisiti
| Categoria | Requisiti |
|---|---|
| Livelli di accesso | - Per visualizzare ed eseguire query condivise: membro del progetto. - Per aggiungere e salvare una query condivisa: almeno accesso di base. |
| Permissions | Permessi di Contribuisci impostati su Consenti per la cartella alla quale si desidera aggiungere una query. Per impostazione predefinita, il gruppo Collaboratori non dispone di questa autorizzazione. |
Nota
Gli utenti con accesso stakeholder per un progetto pubblico hanno accesso completo alle funzionalità di query esattamente come gli utenti con accesso di base . Per ulteriori informazioni, vedere Guida rapida all'accesso dei portatori di interesse.
| Categoria | Requisiti |
|---|---|
| Livelli di accesso | - Per visualizzare ed eseguire query condivise: membro del progetto. - Per aggiungere e salvare una query condivisa: è necessario almeno l'accesso di base. |
| Permissions | Permessi di Contribuisci impostati su Consenti per la cartella alla quale si desidera aggiungere una query. Per impostazione predefinita, il gruppo Collaboratori non dispone di questa autorizzazione. |
Operatori e macro supportati
Utilizzare gli operatori seguenti per le clausole che specificano un campo integer:
= , <> , > , < , >= , <=
=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
In, Not In
Was Ever
Elencare gli elementi gerarchici in una visualizzazione albero
Creare una query e selezionare Albero degli elementi di lavoro da iniziare. Il Query Editor mostra gli esempi seguenti:
Nota
Non è possibile costruire una query che mostra una visualizzazione gerarchica dei piani di test, dei gruppi di test e dei test case perché tali elementi non vengono collegati tra loro usando tipi di collegamento padre-figlio. Usare una query di collegamenti diretti per elencare gli elementi di lavoro correlati ai test o visualizzare la gerarchia nella pagina Piani di test.
Opzioni per filtri e clausole di query
Modificare le opzioni di filtro per gli elementi di lavoro collegati e aggiungere clausole di query usando le opzioni nella Query Editor.
Filtro per
Includi queste clausole di query
Solo gli elementi figli dell'elemento di lavoro 645
Aggiungi ai filtri per gli elementi di lavoro di primo livello:
ID = 645
Attività o bug
Aggiungi a Filtri per gli elementi di lavoro collegati:
Work Item Type In Task,Bug
Elementi assegnati alla mia squadra (Web)
Aggiungere sia ai filtri superiori che inferiori:
Assigned to In Group [Fabrikam Fiber]\Web
Elementi padre delle attività assegnate a me
Modificare le opzioni di filtro in Corrispondenza degli elementi di lavoro collegati per primo
Aggiungi a Filtri per gli elementi di lavoro collegati:
Assigned To = @Me
Elencare gli elementi in base ai dipendenti collegati
L'esempio seguente mostra una query dipendente collegata che restituisce elementi con dipendenze dal lavoro gestito da altri team e progetti.
La query seguente trova gli elementi di lavoro in tutti i progetti che si collegano agli elementi di lavoro nel percorso dell'area Fabrikam e nel progetto usando i tipi di collegamento Predecessor e Successor.
- Selezionare Query tra progetti per includere elementi di lavoro collegati dipendenti da altri progetti.
- Aggiungere la clausola Percorso area sotto Fabrikam per filtrare gli elementi di lavoro che sono collegati a elementi definiti nel progetto Fabrikam.
- Selezionare Solo gli elementi restituiti con collegamenti corrispondenti e quindi selezionare Restituisci tipi di collegamento selezionati per restituire solo gli elementi di lavoro collegati come Predecessore o Successore.
Elencare le storie utente orfane
Se si organizzano le storie utente in funzionalità, trovare rapidamente storie non corrispondenti eseguendo una delle azioni seguenti:
- Aprire il backlog del prodotto e attivare l'opzione Vista genitori attiva.
- Scorrere fino alla sezione Storie non correlate (Agile) o Elementi del backlog non correlati (Scrum).
In alternativa, trova elementi backlog senza genitore usando una query elementi di lavoro e collegamenti diretti. Ad esempio, la query seguente elenca le storie utente attive per il team Azure DevOps che non hanno un collegamento Padre.
Campi associati a collegamenti e allegati
Nella tabella seguente vengono descritti i campi associati a collegamenti e allegati. La maggior parte di questi campi non viene visualizzata nel modulo dell'elemento di lavoro, ma viene rilevata per tutti i tipi di elemento di lavoro.
Conteggio dei file allegati
Numero di file collegati all'elemento di lavoro e archiviati nel database di rilevamento degli elementi di lavoro.
Nome di riferimento=System.AttachedFileCount, Tipo di dati=Intero
Nota
Per Azure Boards (servizio cloud), è possibile aggiungere fino a 100 allegati a un elemento di lavoro. Tentare di aggiungere ulteriori elementi produce un messaggio di errore quando si salva l'elemento di lavoro.
Conteggio commenti
Numero di commenti aggiunti alla sezione Discussione dell'elemento di lavoro.
Nome di riferimento=System.CommentCount, Tipo di dati=Intero
Numero di collegamenti dall'elemento di lavoro a elementi che non sono elementi di lavoro, ad esempio richieste pull, commit, insiemi di modifiche o altri tipi di collegamento.
Nome di riferimento=System.ExternalLinkCount, Tipo di dati=Intero
Numero di collegamenti ipertestuali contenuti nell'elemento di lavoro.
Nome di riferimento=System.HyperLinkCount, Tipo di dati=Intero
Commento sul collegamento
Contiene commenti del membro del team che ha creato il collegamento. È possibile configurare questo campo in modo che venga visualizzato come colonna in un elenco di collegamenti in un modulo dell'elemento di lavoro. Il Query Editor non supporta questo campo.
Nome di riferimento=System.Links.Comment, Tipo di dati=PlainText
Descrizione collegamento
Contiene il tipo di elemento di lavoro, l'ID e il titolo dell'elemento di lavoro che rappresenta la destinazione del collegamento. È possibile configurare questo campo in modo che venga visualizzato come colonna in un elenco di collegamenti in un modulo dell'elemento di lavoro. Il Query Editor non supporta questo campo.
Nome di riferimento=System.Links.Description, Tipo di dati=PlainText
Se incluso come opzione di colonna in un elenco di risultati di backlog o query, il sistema visualizza il titolo dell'elemento di lavoro padre. Internamente, il sistema archivia l'ID dell'elemento di lavoro in un campo Integer.
Nota
È possibile aggiungere il campo Padre come colonna o specificarlo all'interno di una clausola di query specificando l'ID dell'elemento di lavoro padre.
Nome di riferimento=System.Parent, Tipo di dati=Intero
Numero di collegamenti definiti per un elemento di lavoro che utilizzano un tipo di collegamento di lavoro, ad esempio Parent-Child, Predecessor-Successor e Related. Per un elenco completo, vedere Informazioni di riferimento sul tipo di collegamento.
Nome di riferimento=System.RelatedLinkCount, Tipo di dati=Intero
Disponibile solo per i servizi di Azure DevOps. Numero di collegamenti da un elemento di lavoro agli elementi di lavoro definiti in un'altra organizzazione. La stessa Microsoft Entra ID deve gestire le organizzazioni. I tipi di collegamento supportati includono Consumes From, Produced For e Remote Related. Per altre informazioni, vedere Aggiungere un collegamento agli elementi di lavoro, Collegamento a un elemento di lavoro remoto.
Nome di riferimento=System.RemoteLinkCount, Tipo di dati=Intero
Visualizzare il lavoro correlato e altri oggetti
Visualizzare gli elementi di lavoro e gli oggetti correlati all'interno di un elemento di lavoro usando l'estensione La visualizzazione degli elementi di lavoro disponibile nella scheda Visual Studio Marketplace Azure DevOps.
Aggiungere tipi di collegamento personalizzati o personalizzare i controlli dei collegamenti
Per aggiungere tipi di collegamento, vedere Gestire i tipi di collegamento [witadmin].
Tutte le schede che supportano la creazione di collegamenti tra elementi di lavoro usano l'elemento LinksControl nel modulo dell'elemento di lavoro. Questo elemento controlla il filtro e limita i tipi di elementi di lavoro a cui è possibile collegare. Controlla anche i tipi di collegamenti che è possibile creare e se è possibile collegare elementi di lavoro in un altro progetto. Per personalizzare i controlli e le restrizioni dei collegamenti, modificare la definizione di LinksControlOptions per un tipo di elemento di lavoro. Vedere Elementi XML LinksControlOptions.
Campi dati predefiniti negli elenchi di collegamenti
È possibile aggiungere o rimuovere colonne dall'elenco di collegamenti ed è possibile personalizzare le colonne predefinite e l'ordine delle colonne. Per altre informazioni, vedere Elementi XML LinksControlOptions.
Usare l'intelligenza artificiale per eseguire query in base a collegamenti e allegati
Se si dispone del Azure Boards MCP Server connesso all'agente di intelligenza artificiale in modalità agente, è possibile usare i prompt del linguaggio naturale per trovare elementi di lavoro in base ai collegamenti e agli allegati.
| Task | Richiesta di esempio |
|---|---|
| Trovare elementi non scollegati | Find active user stories with no child task links |
| Query per gli allegati | List bugs that have attached files |
| Controllare i collegamenti di sviluppo | Show work items with no linked commits or pull requests |
| Trovare elementi fortemente collegati | Find work items with more than 3 related links |
| Tracciare le catene di dipendenze | Show all work items in <Contoso> that have predecessor links and list what they depend on |
| Trovare elementi con collegamenti esterni | List work items in <Contoso> that have hyperlinks in their links |
| Verifica l'integrità padre-figlio | Show child work items in <Contoso> whose parent is in the Closed state but the child is still Active |
| Trovare elementi collegati ai test case | List user stories in the current sprint for <Contoso> that have linked test cases and show the test outcome |
| Identificare l'ingombro eccessivo degli allegati | Show work items in <Contoso> that have more than 5 attachments |
| Trovare collegamenti tra progetti | List work items in <Contoso> that have related links to work items in other projects |
Nota
La modalità agente e il server MCP usano il linguaggio naturale, quindi è possibile modificare queste richieste o porre domande di completamento per perfezionare i risultati.