Aggiungere tag di elementi di lavoro per categorizzare e filtrare elenchi e schede

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

L'assegnazione di tag agli elementi di lavoro consente di filtrare rapidamente il backlog prodotto o una query elemento di lavoro per le categorie definite. Un tag corrisponde a una o due frasi chiave definite e che supporta le esigenze di filtrare un backlog o una query o definire una query.

I tag sono una scelta migliore per filtrare gli elementi di lavoro rispetto all'uso di stringhe di testo, come descritto in Linee guida per creare query con prestazioni elevate.

È possibile aggiungere e modificare tag dal portale Web dal plug-in Team Explorer per Visual Studio. È anche possibile aprire una query in Excel per modificare i tag in blocco.

Nota

I tag sono una risorsa condivisa, sono associati a un progetto e non a un team. Se il progetto contiene più team, tutti i team verranno aggiunti e funzioneranno dallo stesso set di tag.

Prerequisiti

• È necessario connettersi a un progetto. Se non si ha ancora un progetto, crearne uno.
• È necessario essere aggiunti a un progetto. Per essere aggiunto, aggiungere utenti a un progetto o a un team.
• Per visualizzare o modificare gli elementi di lavoro, è necessario avere gli elementi di lavoro Visualizza in questo nodo e Modificare gli elementi di lavoro in questo nodo le autorizzazioni sono impostate su Consenti. Per impostazione predefinita, il gruppo Collaboratori dispone di questo set di autorizzazioni. Per altre informazioni, vedere Impostare le autorizzazioni e l'accesso per il rilevamento del lavoro.
• Per aggiungere nuovi tag da aggiungere agli elementi di lavoro, è necessario avere accesso di base o superiore e avere le autorizzazioni Create new tag definition (Crea nuova definizione tag ) a livello di progetto impostate su Consenti. Per impostazione predefinita, il gruppo Collaboratori dispone di questo set di autorizzazioni. Anche se l'autorizzazione è impostata in modo esplicito per uno stakeholder, non avrà l'autorizzazione per aggiungere nuovi tag, perché non sono consentiti tramite il livello di accesso. Per altre informazioni, vedere Riferimento rapido per l'accesso agli stakeholder.
• Tutti i membri del progetto, anche quelli che appartengono al gruppo Lettori , possono inviare messaggi di posta elettronica agli elementi di lavoro.

• È necessario connettersi a un progetto. Se non si ha ancora un progetto, crearne uno.
• È necessario essere aggiunti a un progetto. Per essere aggiunto, aggiungere utenti a un progetto o a un team.
• Per visualizzare o modificare gli elementi di lavoro, è necessario avere gli elementi di lavoro Visualizza in questo nodo e Modificare gli elementi di lavoro in questo nodo le autorizzazioni sono impostate su Consenti. Per impostazione predefinita, il gruppo Collaboratori dispone di questo set di autorizzazioni. Per altre informazioni, vedere Impostare le autorizzazioni e l'accesso per il rilevamento del lavoro.
• Per aggiungere nuovi tag da aggiungere agli elementi di lavoro, è necessario avere accesso di base o superiore e avere le autorizzazioni Create new tag definition (Crea nuova definizione tag ) a livello di progetto impostate su Consenti. Per impostazione predefinita, il gruppo Collaboratori dispone di questo set di autorizzazioni. Anche se l'autorizzazione è impostata in modo esplicito per uno stakeholder, non avrà l'autorizzazione per aggiungere nuovi tag, perché non sono consentiti tramite il livello di accesso. Per altre informazioni, vedere Riferimento rapido per l'accesso agli stakeholder.
• Tutti i membri del progetto, anche quelli che appartengono al gruppo Lettori , possono inviare messaggi di posta elettronica agli elementi di lavoro.

Nota

Gli utenti con accesso stakeholder per i progetti pubblici possono aggiungere nuovi tag.

Aggiungere tag a un elemento di lavoro

I tag devono contenere o meno 400 caratteri e non contengono separatori, ad esempio una , (virgola), ; (punto e virgola) o un altro carattere di formattazione.

Suggerimento

È consigliabile non usare il @ carattere in un tag. I tag che iniziano con il @ carattere non possono essere usati in una query dell'elemento di lavoro. Il @ carattere indica una macro all'interno di una query e pertanto il tag non viene riconosciuto come tag.

Dal portale Web aprire un elemento di lavoro e aggiungere un tag. Scegliere Aggiungi tag e digitare la parola chiave. In alternativa, eseguire la selezione nell'elenco di tag assegnati precedentemente.

Per aggiungere altri tag contemporaneamente, digitare una virgola tra i tag. I tag rilevano la differenza tra maiuscole e minuscole.

I tag visualizzati nella barra dei tag sono già assegnati all'elemento di lavoro. Per annullare l'assegnazione di un tag, scegliere la x nel tag, .

Nota

Per impostazione predefinita, a tutti i collaboratori e agli stakeholder dei progetti pubblici vengono concesse le autorizzazioni per aggiungere tag nuovi ed esistenti. Gli stakeholder nei progetti privati possono aggiungere tag già definiti, ma non aggiungere nuovi tag. Per concedere o limitare le autorizzazioni per creare nuovi tag, impostare l'autorizzazione Crea definizione di tag a livello di progetto. Per altre informazioni, vedere Modificare le autorizzazioni a livello di progetto.

Aggiungere o rimuovere tag in blocco

È possibile aggiornare in blocco gli elementi di lavoro per aggiungere o rimuovere tag dal portale Web. È possibile modificare in blocco i tag nello stesso modo in cui si modificano in blocco altri campi usando il portale Web. In alternativa, è possibile usare Excel per aggiungere o rimuovere tag in blocco.

Nota

La modifica bulk dei tag da Visual Studio o da altri client supportati non è supportata.

Query per gli elementi di lavoro in base ai tag

Per eseguire query sugli elementi di lavoro in base ai tag, aggiungere una clausola per ogni tag da usare per supportare la query.

Suggerimento

È possibile utilizzare gli operatori Contains o Does Not Contain . I tag che iniziano con il @ carattere non possono essere usati in una query dell'elemento di lavoro perché l'editor di query interpreta il @ carattere come macro. Per altre informazioni sulle query, vedere Creare query gestite.

Ad esempio, qui viene eseguita una query per tutti gli elementi di lavoro contrassegnati o WebService.

Suggerimento

Per informazioni sul AND/OR raggruppamento delle clausole, vedere Creare e salvare query gestite, clausole Group. Per visualizzare la sintassi WIQL per una query, installare l'estensione dell'editor di query WIQL che consente di visualizzare la versione WIQL di qualsiasi voce dell'editor di query.

Nota

La possibilità di eseguire query per gli elementi di lavoro che non dispongono di tag associati non è una funzionalità supportata. Se vuoi votare la richiesta di supporto per questa funzionalità, puoi farlo nella pagina Developer Community, puoi cercare tag vuoti.

Visualizzare i tag nel backlog o risultati della query

Scegliere Opzioni colonna per aggiungere il campo Tag al backlog del prodotto o a una query dell'elemento di lavoro. Se l'opzione non viene visualizzata, scegliere Altri comandi per selezionarla dal menu delle opzioni.

Vengono visualizzati tutti i tag aggiunti agli elementi di lavoro elencati.

Filtrare gli elenchi usando i tag

Dal portale Web è possibile filtrare i backlog, le bacheche e i risultati delle query usando tag.

Per iniziare, scegliere Filtra .

Selezionare le caselle di tali tag da filtrare. Mantenere la selezione OR per eseguire un OR logico per tutti i tag selezionati. In alternativa, scegliere l'opzione AND per eseguire un AND logico in tutti i tag selezionati.

Eliminare, rimuovere o gestire i tag

Non è possibile eliminare un tag. Tuttavia, se si elimina un tag da tutti gli elementi di lavoro a cui è attualmente assegnato, il sistema eliminerà il tag. Il sistema elimina automaticamente i tag non assegnati dopo 3 giorni non utilizzo.

Se si digita un tag senza errori, non assegnare il tag con errori di ortografia a un elemento di lavoro e il sistema lo eliminerà automaticamente entro tre giorni.

Un'altra opzione consiste nell'installare Marketplace Tags Manager, che aggiunge una pagina Tag in Boards o Work per gestire i tag.

Tag di codice colore nelle bacheche

È possibile evidenziare i tag nelle schede della scheda Kanban codificandoli a colori. Questi colori vengono visualizzati solo nella scheda Kanban configurata. Non vengono visualizzati nei backlog o nei taskboard. Per altre informazioni, vedere Personalizzare le schede, i tag color-code.

Elementi di lavoro del grafico e gruppi per tag

Nota

Non è possibile raggruppare un grafico basato su query per tag, ma è possibile raggruppare un widget Chart for Work Items in base ai tag aggiunti a un dashboard. Questa funzionalità è disponibile in anteprima pubblica. Per abilitarlo, vedere Gestire o abilitare le funzionalità e attivare Abilita gruppo per tag per il widget grafico dell'elemento di lavoro nel dashboard.

Per raggruppare un widget Chart for Work Items per tag, completare gli stessi passaggi forniti in Traccia in corso con grafici basati su query di stato e tendenza, Aggiungere un widget del grafico a un dashboard. Assicurarsi che la query flat-list contenga Tag nella clausola query o come opzione di colonna. Quindi, scegliere Tag per il gruppo selezionando. Per filtrare il grafico per visualizzare solo alcuni tag, scegliere il pulsante di opzione Tag selezionati e quindi scegliere i tag da visualizzare.

Articoli correlati

• Strumento migliore per aggiungere, aggiornare e collegare elementi di lavoro
• Use the query editor to list and manage queries (Usare l'editor di query per elencare e gestire le query)
• Mostra tag nelle schede
• Modificare in blocco gli elementi di lavoro dal portale Web
• Modificare in blocco gli elementi di lavoro da Excel

Estensione marketplace

• Gestione tag marketplace

Limiti al numero di tag

Sebbene non esista alcun limite rigido, la creazione di più di 100.000 tag per una raccolta di progetti può influire negativamente sulle prestazioni. Inoltre, il menu a discesa completamento automatico per il controllo tag visualizza un massimo di 200 tag. Quando vengono definiti più di 200 tag, iniziare a digitare per causare la visualizzazione dei tag pertinenti del controllo tag.

Non è possibile assegnare più di 100 tag a un elemento di lavoro oppure si riceverà il messaggio seguente:

TF401243: Failed to save work item because too many new tags were added to the work item.

Salvare l'elemento di lavoro con i tag (100 o meno) aggiunti e quindi è possibile aggiungere altri tag.

Limitare le query a meno di 25 tag, Più di tale importo e la query probabilmente timeout.

Aggiungere tag alla visualizzazione colonna predefinita nel backlog del prodotto

Per aggiungere il campo Tag come campo colonna per il backlog del prodotto, modificare il file ProcessConfiguration in modo da includere System.Tags. Per informazioni su come, vedere informazioni di riferimento sull'elemento XML di configurazione del processo.