Fråga efter datum eller aktuell iteration i Azure Boards

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.

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: @CurrentIteration¹ och @CurrentIteration +/- n² 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, och endast när de körs från webbportalen.
2. Makrot @CurrentIteration +/- n stöds för Azure DevOps Server 2019 och senare versioner, och endast när det 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 för Tid och nationella inställningar.

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, vilket 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 Använda frågeredigeraren för att lista och hantera frågor.

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 avsnittet Gruppsatser i Definiera en arbetsobjektfråga i Azure Boards. 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.

---

Objekt som ändrats på ett visst datum.

---

Objekt som har lösts idag.

---

Objekt som stängts inom en angiven tidsperiod.

---

Objekt som inte är stängda (stängt datum är null).

---

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.)

---

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).

Filtrera efter

Inkludera dessa frågesatser

---

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

---

Objekt som ändrats under de senaste 10 dagarna.

---

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 .

Alla objekt som tilldelats en sprint som motsvarar den aktuella iterationssökvägen för teamet hittas. 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 Definiera iterationssökvägar (kallas även sprintar) och konfigurera team-iterationer. 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.

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.

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

Skapa ett skjutfönster i teamets iterationsfråga

Använd makrot @CurrentIteration +/- <i>n</i> 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 +/- <i>n</i> 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 Definiera iterationssökvägar (sprint) och konfigurera team-iterationer.

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 buggar som har tilldelats skjutfönstret som sträcker sig över de två sista, den aktuella och de kommande två sprintarna som valts för teamet molnadministratör och verktyg.

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 . Skapa endast den här frågan med 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.

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.

Andra alternativ för att fråga efter ändringar i sprintomfånget finns i Om sprintar, Scrum och projekthantering, 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 tilldelnings- eller arbetsflödesändringar, datum- och identitetsfält.

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 underhålls och stöder massimport och uppdatering av arbetsobjekt. Alternativ till att använda Microsoft Project är:

   • Leveransplaner.
   • Ett Marketplace-tillägg som Project Anslut eller GANTT-schema.

Relaterade artiklar

• Fråga efter tilldelnings- eller arbetsflödesändringar
• Definiera iterationssökvägar (sprint) och konfigurera team-iterationer
• Skapa hanterade frågor med Power Query-redigeraren
• Frågeoperatorer och makron
• Fält och attribut för arbetsobjekt
• WiQL-syntax (Work Item Query Language)

REST-API

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

• Rest API-referens för Azure DevOps Services
• Frågor
• Frågespråk för arbetsobjekt
• Hämta arbetsobjekt med frågor programmatiskt