Eseguire query in base all'area o al percorso di iterazione

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

Il percorso area e il percorso di iterazione sono due campi visualizzati nel modulo di rilevamento del lavoro per tutti i tipi di elemento di lavoro. Le definisci per un progetto, ovvero percorsi di area e percorsi di iterazione, quindi seleziona quelle che vuoi associare a un team.

Per comprendere meglio come usare i percorsi di area e iterazione, vedere Informazioni sui team e sugli strumenti Agile.

Nota

Le macro seguenti sono supportate solo dal portale Web: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity e @TeamAreas. Le query che contengono queste macro non funzioneranno quando vengono aperte in Visual Studio/Team Explorer, Microsoft Excel o Microsoft Project.

Operatori e macro supportati

Quando si creano query e si specificano i campi Percorso area e Percorso iterazione, è possibile usare gli operatori seguenti:

Operatore	Usa quando vuoi...
=	Specificare un'area o un percorso di iterazione specifico
<>	Filtrarne uno, un'area specifica o un percorso di iterazione.
In	Filtrare per un set di percorsi di area o iterazione.
Not In	Escludere gli elementi assegnati a un set di percorsi di area o iterazione.
Under	Specificare tutti i percorsi in un'area di selezione o in un percorso di iterazione.
Not Under	Escludere gli elementi assegnati in un'area o in un percorso di iterazione specifico.

Insieme a questi operatori, è possibile usare le macro seguenti quando si seleziona il percorso di iterazione. Per esempi, vedere Eseguire query in base alla data o all'iterazione corrente.

Macro	Usa quando vuoi...
@CurrentIteration	Specificare l'iterazione corrente associata al contesto del team selezionato.
@CurrentIteration +/- n	Filtrare gli elementi in base all'assegnazione a una finestra scorrevole di sprint associati al contesto del team selezionato.
@TeamAreas	Filtra gli elementi in base ai percorsi dell'area assegnati a un team specifico.

Nota

Le @CurrentIteration +/- n macro e @TeamAreas sono supportate per Azure DevOps Server 2019 e versioni successive. Queste macro sono supportate solo dal portale Web. Le query che contengono queste macro non funzioneranno quando vengono aperte in Visual Studio/Team Explorer, Microsoft Excel o Microsoft Project.

Query sul percorso dell'area

È possibile specificare di filtrare gli elementi di lavoro assegnati a diversi percorsi di area usando l'operatore In , come illustrato nell'esempio seguente.

Nome del nodo e query basate su parole chiave

Usare il campo Nome nodo per filtrare gli elementi di lavoro assegnati ai percorsi di area in base a una parola chiave usando l'operatore Contains . Il nome del nodo specifica l'ultimo nodo di un percorso area, che corrisponde all'ultimo nodo nella gerarchia dell'albero.

La query seguente restituisce lo stesso risultato dell'esempio precedente.

In questo esempio, il filtro restituisce tutti gli elementi di lavoro assegnati a un percorso di area il cui ultimo nodo contiene la parola "Azure".

Ecco un altro esempio che usa il nome del nodo e l'operatore In .

Query sul percorso dell'area del team

Usare la macro @TeamAreas per trovare rapidamente gli elementi assegnati ai percorsi di area assegnati a un team specifico. Specificare l'operatore = . Il Editor di query richiede automaticamente di immettere il nome del team. È possibile aggiungerlo immettendo il nome del team e scegliendo il valore del team visualizzato nei criteri di filtro di ricerca.

Informazioni di riferimento sul campo di classificazione

Nome campo	Descrizione	Nome riferimento
Percorso area	Raggruppa gli elementi di lavoro nelle aree del prodotto o del team. L'area deve essere un nodo valido nella gerarchia del progetto.	System.AreaPath
Percorso iterazione	Raggruppa gli elementi di lavoro denominati sprint o periodi di tempo. L'iterazione deve essere un nodo valido nella gerarchia del progetto.	System.IterationPath

Per ogni campo, data path=TreePath, reportable type=Dimension, index attribute=True.

Se si definisce un nome di percorso con una lunghezza superiore a 256 caratteri, non è possibile specificarlo in Microsoft Project. Per evitare questo problema, definire i nomi dei percorsi di non più di 10 caratteri e non annidare nodi più di 14 livelli profondi.

Non è possibile applicare la maggior parte delle regole di campo ai campi di sistema, ad esempio i campi System.AreaPath e System.IterationPath. Per altre informazioni, vedere Regole e valutazione delle regole.

I campi seguenti non vengono visualizzati nei moduli degli elementi di lavoro, ma vengono rilevati per ogni tipo di elemento di lavoro. Questi campi forniscono un valore numerico per ogni valore di classificazione definito per un progetto. È possibile usare questi campi per filtrare le query e creare report.

Nome campo	Descrizione	Nome riferimento	Tipo di dati
ID area	ID univoco dell'area a cui è assegnato questo elemento di lavoro.	System.AreaId	Intero
ID iterazione	ID univoco dell'iterazione a cui è assegnato questo elemento di lavoro.	System.IterationId	Intero
Nome nodo	Nome dell'ultimo nodo di un percorso di area. Ad esempio, se il percorso dell'area è Project\A1\B2\C3, il nome del nodo è C3.	System.NodeName	String

Il tipo segnalabile predefinito non è nessuno. L'ID area e l'ID di iterazione sono indicizzati, il nome del nodo non è. Per altre informazioni sugli attributi dei campi, vedere Campi e attributi dell'elemento di lavoro.

Articoli correlati

• Riferimento rapido alle query
• Definire i percorsi area e assegnarli a un team
• Definire i percorsi di iterazione (sprint) e configurare le iterazioni del team
• Impostare autorizzazioni e accesso per il rilevamento del lavoro

REST API

Per interagire a livello di codice con le query, vedere una delle risorse dell'API REST seguenti:

• Informazioni di riferimento sulle API REST di Azure DevOps Services
• Query
• Linguaggio di query dell'elemento di lavoro
• Recuperare elementi di lavoro con query a livello di codice