Condividi tramite

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

  • Articolo

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. Li definisci per un progetto:percorsi di area e percorsi di iterazione, quindi selezioni quelli che si desidera associare a un team.

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

Prerequisiti

  • Livelli di accesso:
    • Per visualizzare ed eseguire query condivise: membro del progetto.
    • Per aggiungere e salvare una query condivisa: almeno il livello di accesso Basic.
  • autorizzazioni : di collaborazione impostata su Consenti per la cartella a cui si vuole aggiungere una query. Per impostazione predefinita, il gruppo Collaboratori non dispone di questa autorizzazione.

Nota

Gli utenti con accesso Stakeholder per un progetto pubblico hanno pieno accesso alle funzioni di interrogazione, proprio come gli utenti con accesso Basic. Per ulteriori informazioni, vedere riferimento rapido sull'accesso degli stakeholder.

  • Livelli di accesso:
    • Per visualizzare ed eseguire query condivise: Membro del progetto.
    • Per aggiungere e salvare una query condivisa: almeno accesso Basic.
  • autorizzazioni : di collaborazione impostata su Consenti per la cartella a cui si vuole aggiungere la query. Per impostazione predefinita, il gruppo Collaboratori non dispone di questa autorizzazione.

Nota

Le macro seguenti sono supportate solo dal portale web: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivitye @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
<> Eliminare uno, area specifica oppure percorso di iterazione.
In Filtrare per un set di percorsi di area o di iterazione.
Not In Escludere gli elementi assegnati a un set di percorsi di area o iterazione.
Under Specificare tutti i percorsi sotto un'area selezionata 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 Query per data o iterazione corrente.

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

Nota

Le macro @CurrentIteration +/- n 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 sui percorsi delle aree

È 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 nodo specifica l'ultimo nodo di un'area del percorso , 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 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 =. L'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.

Query sui percorsi di area assegnati a un team

Informazioni di riferimento sul campo di classificazione

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

Per ogni campo, percorso dati=TreePath, tipo segnalabile=Dimension, attributo indice=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 nomi di percorsi che non superino i 10 caratteri e non annidare nodi più di 14 livelli di profondità.

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 di riferimento Tipo di dati
Area ID ID univoco dell'area a cui è assegnato questo elemento di lavoro. System.AreaId Numero intero
ID iterazione ID univoco dell'iterazione a cui è assegnato questo elemento di lavoro. System.IterationId Numero 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 Corda

Il tipo segnalabile predefinito è nessuno. L'ID area e l'ID di iterazione sono indicizzati, il nome del nodo non lo è. Per ulteriori informazioni sui campi e attributi degli elementi di lavoro, vedere campi e attributi degli elementi di lavoro.

REST API

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