Definire una query di un elemento di lavoro

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Le query sugli elementi di lavoro in Azure Boards generano elenchi di elementi di lavoro in base ai criteri di filtro specificati. È possibile salvare queste query gestite e condividerle con altri utenti.

Vedere le procedure consigliate più avanti in questo articolo.

Prerequisiti

Scegliere un filtro di query

Nella Query Editor selezionare il filtro per passare a un articolo con query di esempio. Oltre ai filtri di query, è possibile applicare in modo interattivo filtri ai risultati delle query.

È possibile usare la funzione Filter per filtrare in modo interattivo una query.

Query aperte

Definire una query flat-list

Avviare una nuova query dalla scheda Query nel portale Web o nella scheda Elementi di lavoro in Team Explorer.

Eseguire query tra progetti o all'interno di progetti

Per impostazione predefinita, l'ambito delle nuove query è il progetto attuale. È tuttavia possibile creare query per trovare gli elementi di lavoro definiti all'interno dell'organizzazione o della raccolta di progetti. Tutte le query salvate, tuttavia, vengono eseguite in un progetto specifico.

Definire una clausola

Per creare una query, definire una o più clausole. Ogni clausola definisce un criterio di filtro per un singolo campo.

Clausola di query di esempio

Per un elenco degli operatori disponibili in base al tipo di dati del campo, vedere il Riferimento rapido all'indice di query.

Aggiungere tutte le clausole come istruzione And . Selezionare Oppure per modificare il raggruppamento. Raggruppa le clausole in modo da garantire che le istruzioni della clausola vengano eseguite nella sequenza richiesta.

Elenco di controllo per la definizione di una clausola di query

1. Nella prima riga vuota, sotto l'intestazione di colonna Campo , scegliere la freccia giù per visualizzare l'elenco dei campi disponibili e scegliere un elemento nell'elenco. Per ulteriori informazioni, vedere Campi e valori della query.

2. Nella stessa riga, sotto l'intestazione di colonna Operatore , selezionare la freccia giù per visualizzare l'elenco degli operatori disponibili e quindi scegliere un elemento nell'elenco. Per altre informazioni, vedere Operatori.

3. Nella stessa riga, sotto l'intestazione di colonna Valore immettere un valore oppure selezionare la freccia giù e quindi scegliere un elemento nell'elenco. Per altre informazioni su come usare una macro o una variabile per specificare il progetto, l'utente, la data o un'altra selezione corrente, vedere Variabili.

4. Per aggiungere una clausola, scegliere Aggiungi nuova clausola.

   È possibile aggiungere una clausola alla fine della query oppure eseguire le attività seguenti usando le icone corrispondenti:

   • Inserisci nuova riga di filtro
   • Rimuovere questa riga di filtro
   • Raggruppare le clausole selezionate
   • Clausole ungroup

Usare un albero degli elementi di lavoro per visualizzare le gerarchie

Usare la query Albero degli elementi di lavoro per visualizzare un elenco annidato a più livelli di elementi di lavoro. Ad esempio, è possibile visualizzare tutti gli elementi del backlog e le relative attività collegate. Per concentrarsi su parti diverse dell'albero, scegliere Espandi tutto o Comprimi tutto.

Usare collegamenti diretti per visualizzare le dipendenze

Usare la query Elementi di lavoro e Collegamenti diretti per tenere traccia degli elementi di lavoro che dipendono da altre attività rilevate, ad esempio attività, bug, problemi o funzionalità. Ad esempio, è possibile visualizzare gli elementi backlog che dipendono da altri elementi implementati o da un bug risolto.

Usare la query dei collegamenti diretti per tenere traccia delle dipendenze tra i team. La query consente anche di gestire gli impegni che il vostro team prende. Scegliere i criteri di filtro per gli elementi di lavoro principali e collegati. Selezionare i tipi di collegamenti per filtrare le dipendenze.

Per altre informazioni su ogni tipo di collegamento, vedere Informazioni di riferimento sul tipo di collegamento.

Usare e/o un'espressione logica

Specificare And o Or per creare espressioni logiche delle clausole di query. Utilizzare And per trovare elementi di lavoro che soddisfano i criteri nella clausola corrente e nella clausola precedente. Utilizzare Or per trovare elementi di lavoro che soddisfano il criterio nella clausola corrente o nella clausola precedente.

Aggiungere una nuova clausola per ogni campo dell'elemento di lavoro per perfezionare i criteri di ricerca. Aggiungere clausole per restituire solo il set di elementi di lavoro desiderati. Se non ricevi i risultati che ti aspetti dalla tua query, perfezionala. È possibile aggiungere, rimuovere, raggruppare o separare le clausole di query per migliorare i risultati della query.

Raggruppare le clausole di query da utilizzare come singola unità separata dal resto della query. Le clausole di raggruppamento sono simili all'inserimento di parentesi intorno a un'espressione in un'equazione matematica o in un'istruzione logica. Quando si raggruppano le clausole, l'oggetto And o Or per la prima clausola del gruppo si applica all'intero gruppo.

Clausole del gruppo

Le clausole raggruppate fungono da una singola unità separata dal resto della query. Le clausole di raggruppamento sono simili all'inserimento di parentesi intorno a un'equazione matematica o a un'espressione logica. L'operatore And o Or per la prima clausola nel gruppo si applica all'intero gruppo.

Come illustrato negli esempi seguenti, le clausole raggruppate vengono convertite nell'espressione logica corrispondente.

Richiesta	Clausole raggruppate	Espressione logica
1
2
3

Queste query restituiscono elementi di lavoro di tipo Bug e soddisfano le espressioni logiche seguenti:

• Query 1: AND State=Active OR Assigned to @Me
• Query 2: AND (State=Active OR Assigned to @Me)
• Query 3: OR (State=Active AND Assigned to @Me)

Per raggruppare una o più clausole, selezionarle e quindi selezionare l'icona delle clausole di gruppo.

È anche possibile raggruppare diverse clausole raggruppate. Selezionare le caselle di ogni clausola. Scegliere quindi l'icona delle clausole di gruppo.

Se i risultati della query non restituiscono i risultati previsti, provare i passaggi seguenti:

• Assicurarsi che ogni clausola sia definita come previsto.
• Verificare And/Or le assegnazioni a ogni clausola. Se i risultati contengono più elementi di lavoro del previsto, spesso è presente una Or clausola anziché una And clausola .
• Determinare se è necessario raggruppare o modificare il raggruppamento delle clausole di query e le And/Or assegnazioni di ogni clausola raggruppata.
• Aggiungere altre clausole di query per perfezionare i criteri di filtro delle query.
• Esaminare le opzioni disponibili per specificare campi, operatori e valori.
• Vedere le procedure consigliate più avanti in questo articolo.

Separare una clausola

Per separare una clausola, selezionare l'icona delle clausole non raggruppate per la clausola raggruppata.

Impostare la larghezza della colonna predefinita nei risultati della query

Per impostare la larghezza predefinita delle colonne nei risultati della query, seguire questa procedura:

1. Apri la query che desideri modificare.
2. Regolare manualmente le larghezze delle colonne in base alle dimensioni desiderate trascinando i bordi delle intestazioni di colonna.
3. Selezionare Salva o Salva con nome se si desidera salvarlo come una nuova query.
4. Chiudere e riaprire la query per assicurarsi che le larghezze delle colonne vengano mantenute.

Azure DevOps attualmente non supporta l'impostazione di una larghezza di colonna predefinita che persiste in tutte le sessioni. Le larghezze delle colonne vengono salvate per ogni query, quindi è necessario modificarle e salvarle singolarmente per ogni query.

Visualizzare i risultati della query in un dashboard

I due widget seguenti visualizzano i risultati della query. È possibile aprire gli elementi di lavoro direttamente da questi widget.

• Lavoro assegnato a me: elenca tutti gli elementi di lavoro proposti o attivi assegnati all'utente connesso. Elenca i campi ID, Stato e Titolo.
• Widget Risultati query: visualizza i risultati di una query flat, ad albero o di collegamenti diretti. È possibile configurare i campi visualizzati tramite il widget, ridimensionare i campi delle colonne ed espandere e comprimere la struttura ad albero e le query a collegamenti diretti.

Per altre informazioni, vedere Aggiungere widget a un dashboard.

Definire una query come collegamento ipertestuale

Un collegamento ipertestuale per una query usa WIQL (Work Item Query Language), simile a Transact-SQL. Per ulteriori informazioni, vedere Sintassi del linguaggio di interrogazione Work Item (WIQL).

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

https://{ServerName}/{CollectionName}/{ProjectName}/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%2C%20%5BSystem.State%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'%20%20

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=
SELECT [System.ID], [System.Title], [System.State] 
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug' 
   AND [System.AreaPath]='FabrikamFiber\Web'   

Procedure consigliate

Le procedure consigliate seguenti si applicano alle query che è possibile creare:

Creare query mirate e selettive

Definire una query altamente selettiva applicando tutti i filtri necessari. Più selettiva è la query, più piccolo è il set di risultati. Un set di risultati più piccolo indica che la query è più mirata e selettiva.

Usare i tag per classificare gli elementi di lavoro

Usare i tag degli elementi di lavoro per classificare gli elementi di lavoro anziché usare un campo personalizzato. Le query che filtrano in base ai tag in genere eseguono prestazioni più veloci rispetto a quelle che filtrano le corrispondenze di stringa.

Diversamente dalle corrispondenze di campi personalizzati o parziali, una query con un'operazione Tags Contains non richiede un'analisi completa di tutte le tabelle degli elementi di lavoro.

Usare Contains words per le corrispondenze di stringhe

Per filtrare in base a una corrispondenza di stringa, usare l'operatore Contains Words anziché l'operatore Contains . L'operatore Contains Words esegue una ricerca full-text sul campo specificato, che tende a completare più rapidamente.

L'operatore Contains esegue un'analisi di tabella, che è un'operazione più lenta rispetto all'operatore Contains Words . Usa anche più cicli di CPU. Questi cicli della CPU possono causare limitazioni di velocità. Per altre informazioni, vedere Limiti di frequenza e utilizzo.

Specificare gruppi di piccole dimensioni con l'operatore In Group

L'operatore In Group filtra gli elementi di lavoro in base alle corrispondenze all'interno di un gruppo di valori. Il gruppo di valori corrisponde ai valori contenuti all'interno di un team, di un gruppo di sicurezza o di una categoria di rilevamento del lavoro. Ad esempio, è possibile creare una query per trovare tutti gli elementi di lavoro assegnati a qualsiasi membro di un team. In alternativa, trovare tutti gli elementi di lavoro che appartengono alla categoria dei requisiti (Microsoft.RequirementCategory).

Quando si filtra un gruppo che contiene un numero elevato di membri, il set di risultati tende a essere più grande e non selettivo. Inoltre, se un gruppo corrisponde a un gruppo di Microsoft Entra di grandi dimensioni, la query genera un costo piuttosto elevato per risolvere quel gruppo da Microsoft Entra ID.

Evitare l'uso di operatori negati

Gli operatori negati, ad esempio <>, Not In, Not Under, Not In Group, tendono a generare query non selettive e set di risultati di grandi dimensioni.

Usare solo operatori negati quando necessario. Cercare sempre di trovare le alternative per prime. Ad esempio, se Field1 ha valori A, B, C, D; specificare la Field1 In A, B, C clausola anziché la clausola negata Field1 <> D .

Evitare confronti tra stringhe

Le query che contengono confronti tra stringhe generano analisi di tabella intrinsecamente inefficienti. Usare invece tag o un campo personalizzato specifico come alternative, in particolare quando una query ha prestazioni scarse.

Limita operatori Or

Limitare il numero di Or operatori definiti nella query. Le query vengono eseguite meglio quando vengono usati meno Or operatori. Troppi Or operatori possono rendere la query non selettiva. Se la query viene eseguita lentamente, riordinare la clausola operatore Or verso l'inizio delle clausole della query.

Salva la query

A causa delle ottimizzazioni interne, le query salvate tendono a ottenere prestazioni migliori rispetto alle query non salvate. Salva sempre la query quando prevedi di riutilizzarla. Anche per le query WIQL eseguite tramite un'API REST, salvare WIQL tramite il portale web per effettuare chiamate all'API REST, in modo che siano meno soggette a regressioni delle prestazioni in futuro.

Esegui la query

A volte è necessario eseguire la query alcune volte per raggiungere il piano di ottimizzazione corretto. Salva la query e eseguila fino a 10 volte in un periodo di 30 minuti. In questo modo, il sistema può esaminare e cercare il piano di ottimizzazione più appropriato per la query.

Usare l'intelligenza artificiale per definire query sugli elementi di lavoro

Se si configura il Azure DevOps MCP Server, è possibile descrivere la query necessaria in linguaggio naturale anziché compilare manualmente le clausole nel Query Editor.

Contenuti correlati

• Riferimento rapido alle query.
• Domande frequenti
• Tracciare una query di elenco piatto
• Modificare le opzioni di colonna
• Indice del campo dell'elemento di lavoro
• Tasti di scelta rapida