Query per data specifica o iterazione corrente

servizi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Questo articolo illustra come elencare gli elementi di lavoro per creazione, modifica, risoluzione o date chiuse. Illustra anche come usare macro di data, ad esempio @Today, e le macro di iterazione per gli sprint del team. Per informazioni fondamentali sul percorso di iterazione e restrizioni relative a client o macro, vedere Eseguire query in base all'area o al percorso di iterazione.

Tip

È possibile usare l'intelligenza artificiale per facilitare questa attività più avanti in questo articolo, oppure vedere Abilitare l'assistenza AI con Azure DevOps MCP Server per iniziare.

Prerequisites

Category Requirements
Appartenenza al progetto È necessario essere stato aggiunto come membro del progetto.
Livelli di accesso - Per visualizzare ed eseguire query condivise: è necessario essere un membro Project.
- Per aggiungere e salvare una query condivisa: è necessario avere almeno l'accesso di base.
Permissions Verificare che l'autorizzazione Di collaborazione sia impostata su Consenti per la cartella in cui si vuole aggiungere una query. L'organizzazione potrebbe dover configurare manualmente il gruppo Collaboratori per concedere questa autorizzazione.

Note

È necessaria sia un livello di accesso sufficiente che l'autorizzazione Collaborazione per salvare le query condivise. L'accesso di base non è sufficiente.

Category Requirements
Appartenenza al progetto È necessario che tu venga aggiunto come membro del progetto.
Livelli di accesso - Per visualizzare ed eseguire query condivise: è necessario essere un membro Project.
- Per aggiungere e salvare una query condivisa: è necessario avere almeno l'accesso di base.
Permissions Verificare che l'autorizzazione Di collaborazione sia impostata su Consenti per la cartella in cui si vuole aggiungere una query. L'organizzazione potrebbe dover configurare manualmente il gruppo Collaboratori per concedere questa autorizzazione.

Note

È necessaria sia un livello di accesso sufficiente che l'autorizzazione Collaborazione per salvare le query condivise. L'accesso di base non è sufficiente.

Operatori supportati e macro relative alla data

Utilizzare gli operatori e le macro seguenti per i campi DateTime e Iteration Path in Editor di query.

  • Operatori DateTime: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
  • Macro di data: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear, @Today
    È possibile combinare +/- n con queste macro. Ad esempio, usare @Today - 7.
  • Macro di iterazione: @CurrentIteration e @CurrentIteration +/- n. Per le restrizioni del client e il comportamento dei parametri di gruppo, vedere la nota e collegamento seguenti.

Note

La pagina di iterazione Query per area o percorso di iterazione illustra in dettaglio le macro di iterazione e le restrizioni client. Se sono necessarie query da eseguire in client non Web o tramite REST o WIQL all'esterno dell'interfaccia utente Web, verificare il supporto delle macro nell'ambiente. È consigliabile espandere le macro in percorsi espliciti.

Esempi di data rapida (query comuni)

  • Elementi creati negli ultimi 30 giorni: Screenshot che mostra la clausola Editor di query per trovare gli elementi creati negli ultimi 30 giorni.

  • Elementi modificati in una data specifica: Screenshot che mostra la clausola Editor di query per trovare elementi modificati in una data specifica.

  • Elementi risolti oggi: Screenshot che mostra la clausola Editor di query per trovare gli elementi risolti oggi.

  • Elementi chiusi entro un periodo di tempo specificato: Screenshot che mostra la clausola Editor di query per trovare elementi chiusi entro un periodo di tempo specificato.

  • Elementi la cui data chiusa è null (non chiusa): Screenshot che mostra la clausola Editor di query per la ricerca di elementi la cui data chiusa è vuota o null.

  • Elementi il cui stato è cambiato nell'ultima settimana: Screenshot che mostra la clausola Editor di query per gli elementi il cui stato è stato aggiornato nell'ultima settimana.

Uso delle @CurrentIteration macro (breve guida)

Usare @CurrentIteration per impostare come destinazione lo sprint corrente del team e @CurrentIteration +/- n per creare una finestra temporale scorrevole degli sprint (ad esempio, gli ultimi due, quello corrente e i due sprint successivi). Punti importanti:

  • @CurrentIteration restituisce gli elementi assegnati allo sprint corrente per il contesto del team usato durante l'esecuzione della query.
  • @CurrentIteration +/- n sposta quella finestra degli sprint per n; utile per le analisi di tendenza o di trascinamento.
  • Poiché il comportamento delle macro e il supporto client variano, consultare Query per area o percorso di iterazione per informazioni dettagliate sui parametri del team, sui client che valutano le macro e su come vengono archiviate ed espanse le macro durante il salvataggio delle query.

Immagini di esempio (portale Web Editor di query):

Screenshot che mostra il filtro Editor di query usando la macro CurrentIteration con un parametro team.

Screenshot che mostra le clausole CurrentIteration positive e negative per una finestra temporale mobile degli sprint.

Tip

Se il @CurrentIteration non restituisce i risultati previsti, conferma l'iterazione selezionata del team e gli intervalli di date delle iterazioni nelle impostazioni del team.

Macro di data: inizio del giorno, della settimana, del mese e dell'anno

Le macro di inizio consentono di creare intervalli di date relativi coerenti:

  • @StartOfDay, @StartOfWeek, @StartOfMonthe @StartOfYear: usare queste macro con +/- n per compilare intervalli come "dall'inizio della settimana" o "ultimi 3 mesi".
  • L'interfaccia utente del portale Web valuta queste macro. Il comportamento in scenari non Web potrebbe essere diverso, quindi eseguire il test nel client di destinazione.

Query di esempio:

Screenshot che mostra le clausole di Editor di query per la ricerca di elementi modificati negli ultimi 10 giorni.

Screenshot che mostra le clausole di Editor di query per le funzionalità pianificate nei prossimi tre mesi.

Campi di data

Nella tabella seguente vengono descritti i campi correlati alla data che è possibile usare per filtrare ed eseguire query sugli elementi di lavoro. Questi campi consentono di tenere traccia delle informazioni di pianificazione per gli elementi di lavoro.

Nome del campo Description Nome riferimento Tipo di dati
Data di scadenza Data di scadenza prevista per un problema o un elemento di lavoro da risolvere. (Processo Agile) Microsoft.VSTS.Scheduling.DueDate Data e ora
Data fine Data e ora in cui la pianificazione indica che un elemento di lavoro deve essere completato. Microsoft.VSTS.Scheduling.FinishDate Data e ora
Data di inizio Data e ora assegnate a un elemento di lavoro per l'avvio del lavoro. Microsoft.VSTS.Scheduling.StartDate Data e ora
Data prevista Data di scadenza prevista per un problema o un altro elemento di lavoro da risolvere o completare. Microsoft.VSTS.Scheduling.TargetDate Data e ora

Note

Usare i campi Data di inizio e Data di destinazione con Piani di recapito per visualizzare le sequenze temporali degli elementi di lavoro. Per altre informazioni, vedere Esaminare i piani di recapito del team.

Quando usare WIQL direttamente

Usare WIQL quando:

  • Sono necessari operatori avanzati, ad WAS EVER esempio per le modifiche del percorso di iterazione.
  • Editor di query blocca o contrassegna una clausola come non supportata( ad esempio, alcuni Was Ever usano). L'estensione dell'editor WIQL consente di creare tali query e salvarle.

Per esempi, vedere sintassi WIQL (Work Item Query Language) e l'estensione del marketplace dell'editor WIQL.

Usare l'intelligenza artificiale per eseguire query in base alla data o all'iterazione

Se si configura il Azure DevOps MCP Server, è possibile porre domande basate su data e iterazione in linguaggio naturale anziché compilare manualmente clausole di query.

Task Richiesta di esempio
Trovare gli elementi creati di recente Show all work items created in the last 7 days in project <Contoso>
Eseguire una query in base allo sprint corrente List all active bugs in the current sprint for team <Contoso Team>
Trovare elementi non aggiornati Show user stories that haven't been updated in the last 30 days in <Contoso>
Eseguire query sugli elementi risolti in base all'intervallo di date List bugs resolved between January 1 and January 31 in project <Contoso>
Riepilogo settimanale chiuso Show the count of work items closed each day this week in <Contoso> broken down by type
Trovare gli elementi che si avvicinano alla scadenza List work items in <Contoso> with a target date within the next 5 days that are still active
Controllo di burn-down sprint Show how many story points remain incomplete vs total planned for the current sprint in <Contoso>
Aggiunte dell’ultimo sprint List work items added to the current sprint in <Contoso> in the second half of the sprint
Confronto mensile Compare the number of bugs created this month vs last month in <Contoso>
Analisi dell'impatto delle festività Show work items in <Contoso> that had no updates between December 23 and January 2

Note

Se si usa Visual Studio Code, la modalità agent è particolarmente utile per le query complesse basate su data.

Contenuti correlati

REST API

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

  • Last updated on