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: