Condividi tramite


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.

Query sul percorso dell'area per diverse aree

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.

Query sul nome del nodo per diverse aree

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".

Query per diversi sprint

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

Query sul nome del nodo per diverse aree

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.

Eseguire query sui percorsi di area assegnati a un team

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.

REST API

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