Dela via

Fråga efter datum eller aktuell iteration i Azure Boards

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

I den här artikeln får du lära dig hur du listar arbetsobjekt baserat på när de skapades, stängdes, löstes eller ändrades. Du kan ange ett datum eller använda ett makro som stöds. Använd makrot @Today och ange ett plus eller minus antal dagar för relativa datum. För frågor som listar arbetsobjekt baserat på deras tilldelning till ett teams aktuella sprint använder du @CurrentIteration.

Du kan till exempel hitta arbetsobjekt som har ändrats under de senaste tre dagarna med följande fråga.

Skärmbild som visar Power Query-redigeraren som visar fältet Ändrat datum inställt på >= 3.

Du kan också använda makrot CurrentIteration +/- _n_ för att skapa frågor baserat på ett skjutfönster med team-iterationer.

Operatorer och makron som stöds

Frågesatser som anger ett DateTime-fält eller fältet Iteration Path kan använda operatorer och makron som anges i följande tabell.

Datatyp

Operatorer och makron som stöds

Datum/tid

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Makron: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYearoch @Today. Du kan använda +/- _n_ med vart och ett av makrona som stöds.

TreePath

=, <>, under, inte under
Makron: @CurrentIteration1 och @CurrentIteration +/- n2 giltiga med fältet Iterationssökväg .

Anteckningar:

  1. Makrona @StartOfDay, @StartOfWeek, @StartOfMonthoch @StartOfYear stöds för Azure DevOps Server 2019.1 och senare versioner. De stöds bara när de körs från webbportalen.
  2. Makrot @CurrentIteration +/- n stöds för Azure DevOps Server 2019 och senare versioner. Den stöds bara när den körs från webbportalen.

Dricks

Operatorn WasEver kan användas med fältet Iteration Path men endast när den definieras via WIQL-syntaxen. Ett exempel finns i Referens för WIQL-syntax (Work Item Query Language).

Datum- och tidsmönster

Datum- och tidsmönstret som du anger för DateTime-fälten ska matcha det som du väljer via din profil. Information om hur du visar eller ändrar ditt val finns i Ange användarinställningar.

Skärmbild som visar listrutealternativen Datummönster i fönstret Tid och Nationella inställningar.Skärmbild som visar listrutan Tidsmönster i fönstret Tid och Nationella inställningar.

Skärmbild som visar fönstret Tid och nationella inställningar med fälten Datummönster och Tidsmönster.

Klientbegränsningar för användning av makron @CurrentIteration

Du kan använda makrot @CurrentIteration i en fråga från följande klienter:

  • Webbportal som ansluter till Azure Boards
  • Visual Studio 2019 eller senare versioner som är anslutna till Azure Boards
  • REST-API:et

Du kan använda makrot @CurrentIteration +/- n i en fråga mot Azure Boards, Azure DevOps Server 2019 och senare versioner och med ett REST-API som innehåller teamet som en parameter. Ett exempel är @CurrentIteration('[Project]\Team').

Ett fel uppstår om du öppnar en fråga som innehåller makrot @CurrentIteration i tidigare versioner av Visual Studio, eller från Microsoft Excel eller Microsoft Project. Du kan inte heller använda makrot när du kopierar eller klonar testpaket och testfall, definierar aviseringar eller med REST-API:er.

Datumbaserade frågor

Filtrera efter arbetsobjekt efter det datum då de ändrades eller under en viss tidsperiod. Begränsa frågans omfattning. Den här metoden kan hjälpa dig med prestanda genom att endast returnera resultat som passar det datumintervall som du inkluderar. Om du är nybörjare på att skapa frågor kan du läsa Definiera en arbetsobjektfråga.

Alla fält är inte giltiga för alla typer av arbetsobjekt. Hoppa till datumfält för den uppsättning fält som du kan inkludera i frågor och de arbetsobjekttyper som de gäller för.

Dricks

  • Kom ihåg att ange datum i fältet Datummönster som du har angett för din personliga profil.
  • Information om hur AND/OR satser grupperas finns i Gruppsatser. Om du vill visa WIQL-syntaxen för en fråga installerar du WIQL-redigerartillägget, som gör att du kan se WIQL-versionen av alla Power Query-redigeraren post.

Filtrera efter

Inkludera dessa frågesatser

Objekt som skapats under de senaste 30 dagarna.

Skärmbild som visar Power Query-redigeraren-satsen för att hitta objekt som skapats under de senaste 30 dagarna.

Objekt som ändrats på ett visst datum.

Skärmbild som visar Power Query-redigeraren-satsen för att hitta objekt som ändrats vid ett visst datum.

Objekt som har lösts idag.

Skärmbild som visar Power Query-redigeraren-satsen för att hitta objekt som har lösts idag.

Objekt som stängts inom en angiven tidsperiod.

Skärmbild som visar Power Query-redigeraren-satsen för att hitta objekt som stängts inom en angiven tidsperiod.

Objekt som inte är stängda. Stängt datum är null.

Skärmbild som visar Power Query-redigeraren-satsen för att hitta objekt vars stängda datum är tomt eller null.

Objekt vars status uppdaterades under den senaste veckan.

Skärmbild som visar Power Query-redigeraren-satsen för objekt vars status uppdaterades under den senaste veckan.

Föremål stängdes under den aktuella sprinten. Makrot <xref href="CurrentIteration" data-throw-if-not-resolved="False" data-raw-source="@CurrentIteration"></xref> refererar till den sprint som definierats för den aktuella teamkontexten.

Skärmbild som visar Power Query-redigeraren-satsen för objekt som stängdes under den aktuella sprinten.

Skapa datumbaserade frågor baserade på dag, vecka, månad eller år

I följande exempel visas hur du använder makrona StartOf... för att filtrera efter arbetsobjekt med olika förskjutningar. Mer information finns i WIQL-syntax (Work Item Query Language).

Kommentar

Kräver Azure DevOps Server 2019 Update 1 eller senare version.

Filtrera efter

Inkludera dessa frågesatser

Buggar har stängts under de senaste två veckorna.

Skärmbild som visar Power Query-redigeraren-satsen för att hitta buggar som har stängts under de senaste två veckorna.

Objekt som ändrats under de senaste 10 dagarna.

Skärmbild som visar Power Query-redigeraren-satserna för att hitta objekt som ändrats under de senaste 10 dagarna.

Funktioner som är schemalagda att slutföras under de kommande tre månaderna.

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

Alla fält är inte giltiga för alla typer av arbetsobjekt. Hoppa till datumfält för den uppsättning fält som du kan inkludera i frågor och de arbetsobjekttyper som de gäller för.

Skapa frågor för teamets aktuella iteration

Om ditt team följer Scrum-processer schemalägger du arbetet som ska slutföras i sprintar. Du kan spåra förloppet för krav, buggar och annat arbete som ska slutföras i den aktuella sprinten med hjälp av makrot @CurrentIteration . Mer information finns i Hantera sprinttidslinje.

Frågan hittar alla objekt som har tilldelats en sprint som motsvarar teamets aktuella iterationssökväg. Om ett team till exempel är på Sprint 5 returnerar frågan objekt som tilldelats sprint 5. Senare, när teamet arbetar i Sprint 6, returnerar samma fråga objekt som tilldelats Sprint 6.

Kommentar

För att makrot @CurrentIteration ska fungera måste teamet ha valt en iterationssökväg vars datumintervall omfattar det aktuella datumet. Mer information finns i Välj teamsprintar och ange standard-iterationssökvägen. Dessutom är frågor som innehåller det här makrot endast giltiga när de körs från webbportalen.

Se även Client restrictions on the use of the @CurrentIteration macros tidigare i den här artikeln.

Azure Boards lägger till en teamparameter när du väljer @CurrentIteration eller @CurrentIteration +/- n makron. Teamparametern härleds från din aktuella teamkontext.

Skärmbild som visar frågefiltret med hjälp av makrot CurrentIteration med teamparametern.

Dricks

Om makrot @CurrentIteration inte fungerar kontrollerar du att den förväntade iterationen har valts för ditt team och att datum har angetts för det. Mer information finns i Välj teamsprintar.

Om du vill ändra teamparametern som systemet automatiskt anger väljer du den genom att ange namnet på teamet i parameterfältet som lagts till under @CurrentIteration makro.

Skärmbild som visar hur du väljer en teamparameter.

Skapa ett skjutfönster i teamets iterationsfråga

Använd makrot @CurrentIteration +/- n när du vill spåra det arbete som ett team planerade för kommande sprintar och för att förstå arbete som inte slutfördes i tidigare sprintar.

Kommentar

För att makrot @CurrentIteration +/- n ska fungera måste teamet ha valt iterationssökvägar som uppfyller +/- n kriterierna. Datumintervall måste omfatta det aktuella datumet för @CurrentIteration. Mer information om teamval av iterationssökvägar finns i Välj teamsprintar och ange standard-iterationssökvägen.

Se även Client restrictions on the use of the @CurrentIteration macros tidigare i den här artikeln.

Följande bild visar hur du visar en lista över alla typer av användarberättelser och buggarbetsobjekt som har tilldelats skjutfönstret. Fönstret sträcker sig över de två sista, den aktuella och de kommande två sprintarna som valts för teamet Molnadministratör och Verktyg.

Skärmbild som visar CurrentIteration plus- och minus-satser.

Om du vill använda det här makrot måste det angivna teamet välja en uppsättning sprintar som sträcker sig över det +/- n angivna värdet för makrot.

Lista arbetsobjekt som flyttats från en sprint

Visa en lista över arbetsobjekt som har definierats för en sprint men senare flyttats ut med hjälp av en fråga med en -sats som innehåller operatorn Was Ever för fältet Iterationssökväg . Du kan bara skapa den här frågan med hjälp av WIQL-syntaxen. Redigera WIQL-syntaxen i Power Query-redigeraren genom att installera WIQL Editor Marketplace-tillägget.

Följande syntaxfrågor för arbetsobjekt uppfyller till exempel följande kriterier:

  • Definierat i det aktuella projektet.
  • Typ av arbetsobjekt är lika med användarberättelse eller bugg.
  • Arbetsobjekt finns under Fabrikam Fiber Web team Area Path.
  • Arbetsobjekt är inte i tillståndet Closed, Completed, Cuteller Resolved .
  • Inte i den aktuella iterationssökvägen för Fabrikam Fiber Web-teamet.
  • Tilldelades den aktuella iterationssökvägen för Fabrikam Fiber Web-teamet.
  • Tilldelas nu till den aktuella iterationen +1 för Fabrikam Fiber Web-teamet.
  • Ändrades under de senaste 30 dagarna (sprintens längd).
SELECT
    [System.Id],
    [System.WorkItemType],
    [System.AssignedTo],
    [System.Title],
    [System.State],
    [System.Tags],
    [System.IterationPath],
    [System.AreaPath]
FROM workitems
WHERE
    [System.TeamProject] = @project
    AND [System.WorkItemType] IN ('User Story', 'Bug')
    AND [System.AreaPath] UNDER 'FabrikamFiber\Web'
    AND NOT [System.State] IN ('Completed', 'Closed', 'Cut', 'Resolved')
    AND NOT [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
    AND (
        EVER (
            [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
        )
        AND [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>') + 1
        AND [System.ChangedDate] >= @today - 30
    )
ORDER BY [System.Id]

Den Power Query-redigeraren vyn av syntaxen visas som det visas.

Kommentar

Power Query-redigeraren visar en informationsikon bredvid operatorn Was Ever som anger ett problem med -satsen. Frågan körs dock fortfarande och du kan skapa frågediagram. Om du vill ändra frågan måste du använda WIQL-redigeraren.

Skärmbild som visar Power Query-redigeraren arbetsobjekt som flyttats från en sprint.

Visa en lista över arbetsobjekt som lagts till i en sprint efter startdatumet

Om du vill visa en lista över nyligen skapade arbetsobjekt som lagts till i en sprint efter startdatumet använder du en fråga som liknar den som visas i följande bild. Den här frågan fungerar genom filtrering för arbetsobjekt som tilldelats den aktuella sprinten men skapades efter sprintdatumets start. Använd -satsen created Date = @Today - 28.

Skärmbild som visar Power Query-redigeraren arbetsobjekt som nyligen skapats och lagts till i en sprint efter startdatumet.

Andra alternativ för att köra frågor mot ändringar i sprintomfånget finns i Omfångsändring för sprint.

Fält för datum- och iterationssökväg

Använd datumfält för att filtrera dina frågor. Vissa av de här fälten fylls i med information när ett arbetsobjekt går från ett tillstånd till ett annat. Flera av de här fälten visas inte i arbetsobjektsformuläret, men de spåras för de typer av arbetsobjekt som anges i följande tabell.

Fältnamn

Beskrivning

Typer av arbetsobjekt

Aktiverat datum (not 1 och 2)

Datum och tid då arbetsobjektet skapades eller när dess status ändrades från Closed, Completedeller Done till ett eller Active ett New tillstånd.

Referensnamn=Microsoft.VSTS.Common.ActivatedDate, Data type=DateTime

Bugg, Ändringsbegäran, Episk, Funktion, Problem, Produktpost för kvarvarande uppgifter, Krav, Granskning, Risk, Delat steg, Uppgift, Testfall, Användarberättelse

Ändringsdatum

Datum och tid då ett arbetsobjekt ändrades.

Referensnamn=System.ChangedDate, Datatyp=DateTime

Alla

Stängt datum (not 2)

Datum och tid då ett arbetsobjekt stängdes.

Referensnamn=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

Alla

Skapades den

Datum och tid då ett arbetsobjekt skapades.

Referensnamn=System.CreatedDate, Data type=DateTime

Alla

Förfallodatum

Det prognostiserade förfallodatumet för ett problem som ska lösas.

Referensnamn=Microsoft.VSTS.Scheduling.DueDate, Data type=DateTime

Problem (agil)

Avslutsdatum (not 3)

Datum och tid när schemat anger att aktiviteten har slutförts.

Referensnamn=Microsoft.VSTS.Scheduling.FinishDate, Data type=DateTime

Krav, uppgift, testplan, användarberättelse

Iterationssökväg

Grupperar arbetsobjekt efter namngivna sprintar eller tidsperioder. Iterationen måste vara en giltig nod i projekthierarkin. Du definierar iterationssökvägar för ett projekt och väljer iterationssökvägar för ett team.

Referensnamn=System.IterationPath, Datatyp=TreePath

Alla

Löst datum (not 1 och 2)

Datum och tid då arbetsobjektet flyttades till ett Resolved tillstånd.

Referensnamn=Microsoft.VSTS.Common.ResolvedDate, Data type=DateTime

Bugg, Ändringsbegäran, Episk, Funktion, Problem, Produktpost för kvarvarande uppgifter, Krav, Granskning, Risk, Delat steg, Uppgift, Testfall, Användarberättelse

Startdatum (not 3)

Datum och tid när schemat anger att aktiviteten startar.

Kommentar

Leveransplaner använder fälten Startdatum och Måldatum för att visa området med funktioner, epos och andra portföljposter.

Referensnamn=Microsoft.VSTS.Scheduling.StartDate, Data type=DateTime

Epic, Feature, Requirement, Task, Test Plan, User Story

Tillståndsändringsdatum

Datum och tid då värdet för fältet Tillstånd ändrades.

Referensnamn=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

Alla

Måldatum

Det datum då en funktion, ett arbetsobjekt eller ett problem ska slutföras eller lösas.

Kommentar

Leveransplaner använder fälten Startdatum och Måldatum för att visa området med funktioner, epos och andra portföljposter.

Referensnamn=Microsoft.VSTS.Scheduling.TargetDate, Data type=DateTime

Epic, Funktion

Anteckningar:

  1. Se även Fråga efter tilldelning eller arbetsflödesändringar.

  2. För att dessa fält ska definieras för en typ av arbetsobjekt måste de inkluderas i avsnittet i WORKFLOW definitionen av arbetsobjekttyp. Den här syntaxen ingår till exempel i FIELDS definitionen när du övergår till ett Resolved tillstånd.

    <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
   <SERVERDEFAULT from="clock"  />  
</FIELD >

  3. Värden för startdatum och avslutsdatum beräknas om du skapar en projektplan i Project och sedan synkroniserar planen med uppgifter som lagras i Azure Boards. De här fälten kanske inte visas i arbetsobjektsformuläret, men de beräknas för kvarvarande uppgifter och uppgifter som är länkade till kvarvarande objekt. Du kan visa deras skrivskyddade värden i resultat från en fråga eller från Excel.

    Viktigt!

    Microsoft Project-integrering och TFSFieldMapping kommandot stöds inte för:

    • Visual Studio 2019 och Azure DevOps Office Integration 2019.
    • Azure DevOps Server 2019 och senare versioner, inklusive Azure DevOps Services.

    Fullständigt stöd för Microsoft Excel-integrering bibehålls, vilket möjliggör massimport och uppdatering av arbetsobjekt. Alternativ till att använda Microsoft Project är:

REST-API

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