Dela via

Fråga efter datum eller aktuell iteration

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Den här artikeln visar hur du listar arbetsobjekt genom att skapa, ändra, matcha eller stänga datum och hur du använder datummakron (till exempel @Today) och iterationsmakron för teamsprintar. Information om grunderna för iterationssökväg och klient-/makrobegränsningar finns i Fråga efter område eller iterationssökväg.

Prerequisites

Category Requirements
Åtkomstnivåer – Så här visar och kör du delade frågor: projektmedlem.
– Så här lägger du till och sparar en delad sökfråga: Minst Grundläggande åtkomst.
Permissions Contribute behörighet inställd på Tillåt för mappen som du vill lägga till en fråga i. Som standard har gruppen Deltagare inte den här behörigheten.

Note

Användare med intressent åtkomst för ett offentligt projekt har fullständig åtkomst till frågefunktioner precis som användare med Grundläggande åtkomst. För mer information, se snabbreferens för åtkomst för intressenter .

Category Requirements
Åtkomstnivåer – Så här visar och kör du delade frågor: projektmedlem.
– Så här lägger du till och sparar en delad fråga: Minst Grundläggande åtkomst.
Permissions Contribute behörighet inställd på Tillåt för mappen som du vill lägga till en fråga i. Som standard har gruppen Deltagare inte den här behörigheten.

Operatorer och datummakron som stöds

Använd följande operatorer och makron för fälten DateTime och Iteration Path i Frågeredigeraren.

  • DateTime-operatorer: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
  • Datummakron: @StartOfDay, @StartOfWeek, @StartOfMonth, , @StartOfYear@Today
    Du kan kombinera +/- n med dessa makron (till exempel @Today - 7).
  • Iterationsmakron: @CurrentIteration och @CurrentIteration +/- n (se följande anteckning och länk för klientbegränsningar och beteende för teamparametrar).

Note

Iterationsmakron och klientbegränsningar beskrivs i detalj på iterationssidan: Fråga efter område eller iterationssökväg. Om du behöver köra frågor i icke-webbklienter, eller via REST/WIQL utanför webbgränssnittet, kontrollerar du makrostödet i din miljö och överväger att expandera makron till tydliga sökvägar.

Exempel på snabbdatum (vanliga frågor)

  • Objekt som skapats under de senaste 30 dagarna: Skärmbild som visar frågeredigerarens sats för att hitta objekt som skapats under de senaste 30 dagarna.

  • Objekt som ändrats på ett visst datum: Skärmbild som visar frågeredigerarens sats för att hitta objekt som ändrats vid ett visst datum.

  • Objekt som har lösts idag: Skärmbild som visar frågeredigerarens sats för att hitta objekt som har lösts idag.

  • Objekt som stängts inom en angiven tidsperiod: Skärmbild som visar frågeredigerarens sats för att hitta objekt som stängts inom en angiven tidsperiod.

  • Objekt vars stängda datum är null (inte stängt): Skärmbild som visar frågeredigerarens sats för att hitta objekt vars stängda datum är tomt eller null.

  • Objekt vars status har ändrats under den senaste veckan: Skärmbild som visar frågeredigerarens sats för objekt vars status uppdaterades under den senaste veckan.

Använda makron @CurrentIteration (kort guide)

Använd @CurrentIteration för att rikta in dig på teamets aktuella sprint och @CurrentIteration +/- n för att skapa ett skjutfönster med sprintar (till exempel de två sista, aktuella och kommande två sprintarna). Viktiga punkter:

  • @CurrentIteration returnerar objekt som tilldelats den aktuella sprinten för teamkontexten som användes när frågan kördes.
  • @CurrentIteration +/- n skiftar detta sprintfönster med n; användbar för trend- eller övergångsanalyser.
  • Eftersom makrobeteendet och klientsupporten varierar kan du läsa Fråga efter område eller iterationssökväg för information om teamparametrar, vilka klienter som utvärderar makron och hur makron lagras/expanderas när frågor sparas.

Exempelbilder (frågeredigeraren för webbportalen):

Skärmbild som visar frågeredigerarens filter med hjälp av makrot CurrentIteration med en teamparameter.

Skärmbild som visar CurrentIteration plus- och minusvillkor för ett rullande fönster med sprintar.

Tip

Om @CurrentIteration inte returnerar förväntade resultat bekräftar du teamets valda iteration och datumintervallen för iteration i Teaminställningar.

Datummakron: start på dag/vecka/månad/år

Start-makron hjälper till att skapa konsekventa relativa datumintervall:

  • @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear– använd dessa makron med +/- n för att skapa intervall som "sedan början av veckan" eller "senaste 3 månaderna".
  • Dessa makron utvärderas av webbportalens användargränssnitt. deras beteende i icke-webbscenarier kan skilja sig åt – testa i målklienten.

Exempelfrågor:

Skärmbild som visar frågoredigerarens satser för att hitta objekt som ändrats under de senaste 10 dagarna.

Skärmbild som visar satserna i Query-redigeraren för funktioner som är schemalagda att slutföras under de kommande tre månaderna.

När du ska använda WIQL direkt

Använd WIQL när:

  • Du behöver avancerade operatorer, till exempel WAS EVER för ändringar i iterationssökvägen.
  • Frågeredigeraren blockerar eller markerar en sats som inte stöds (till exempel vissa Was Ever användningsområden). Med WIQL-redigerartillägget kan du redigera dessa frågor och spara dem.

Se WIQL-syntax (Work Item Query Language) och WIQL Editor Marketplace-tillägget för exempel.

Relaterat innehåll

REST API

Om du vill interagera programmatiskt med frågor kan du läsa någon av dessa REST API-resurser: