Query's uitvoeren op datum of huidige iteratie in Azure Boards

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

In dit artikel leert u hoe u werkitems weergeeft op basis van wanneer ze zijn gemaakt, gesloten, opgelost of gewijzigd. U kunt een datum opgeven of een ondersteunde macro gebruiken. Gebruik de @Today macro en geef een plus- of min aantal dagen op voor relatieve datums. Gebruik voor query's die werkitems weergeven op basis van hun toewijzing aan de huidige sprint @CurrentIterationvan een team.

Zoek bijvoorbeeld werkitems die in de afgelopen drie dagen zijn gewijzigd met de volgende query.

Schermopname van Power Query-editor met het veld Gewijzigde datum ingesteld op >= 3.

U kunt de CurrentIteration +/- _n_ macro ook gebruiken om query's te maken op basis van een glijdend venster met teamiteraties.

Ondersteunde operators en macro's

Querycomponenten die een datum/tijd-veld of het veld Iteratiepad opgeven, kunnen gebruikmaken van de operators en macro's die in de volgende tabel worden vermeld.

Gegevenstype

Ondersteunde operators en macro's

Datum en tijd

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

Macro's: , , , en @Today@StartOfYear. @StartOfMonth@StartOfWeek@StartOfDay U kunt elk van de ondersteunde macro's gebruiken +/- _n_ .

TreePath

= , <> onder, niet onder
Macro's:@CurrentIteration 1 en @CurrentIteration +/- n2 geldig met het veld Iteratiepad.

Opmerkingen:

  1. De @StartOfDay, @StartOfWeeken @StartOfMonth@StartOfYear macro's worden ondersteund voor Azure DevOps Server 2019.1 en nieuwere versies, en alleen wanneer ze worden uitgevoerd vanuit de webportal.
  2. De @CurrentIteration +/- n macro wordt ondersteund voor Azure DevOps Server 2019 en latere versies, en alleen wanneer deze wordt uitgevoerd vanuit de webportal.

Tip

De WasEver operator kan worden gebruikt met het veld Iteratiepad , maar alleen wanneer deze is gedefinieerd via de WIQL-syntaxis. Zie de syntaxisreferentie van Work Item Query Language (WIQL) voor een voorbeeld.

Datum- en tijdpatroon

Het datum- en tijdpatroon dat u invoert voor datum/tijd-velden , moet overeenkomen met het patroon dat u selecteert via uw profiel. Zie Gebruikersvoorkeuren instellen voor tijd en landinstellingen om uw selectie weer te geven of te wijzigen.

Schermopname van de vervolgkeuzelijst Datumpatroon in het deelvenster Tijd en Landinstellingen.Schermopname van de vervolgkeuzelijst Opties voor tijdpatroon in het deelvenster Tijd en Landinstellingen.

Schermopname van het deelvenster Tijd en landinstellingen met de velden Datumpatroon en Tijdpatroon.

Clientbeperkingen voor het gebruik van de @CurrentIteration macro's

U kunt de @CurrentIteration macro in een query van de volgende clients gebruiken:

  • Webportal die verbinding maakt met Azure Boards
  • Visual Studio 2019 of nieuwere versies die zijn verbonden met Azure Boards
  • De REST API

U kunt de @CurrentIteration +/- n macro gebruiken in een query op Azure Boards, Azure DevOps Server 2019 en latere versies, en met een REST API die het team als parameter bevat. Een voorbeeld is @CurrentIteration('[Project]/Team').

Er treedt een fout op als u een query opent die de @CurrentIteration macro bevat in eerdere versies van Visual Studio, of vanuit Microsoft Excel of Microsoft Project. U kunt de macro ook niet gebruiken bij het kopiëren of klonen van testsuites en testcases, het definiëren van waarschuwingen of met REST API's.

Op datum gebaseerde query's

Filter op werkitems op de datum waarop ze zijn gewijzigd of voor een specifieke periode. Beperk het bereik van uw query, wat kan helpen bij prestaties door alleen resultaten te retourneren die passen bij het datumbereik dat u opneemt. Als u geen toegang hebt tot het maken van query's, raadpleegt u De queryeditor gebruiken om query's weer te geven en te beheren.

Niet alle velden zijn geldig voor alle typen werkitems. Ga naar datumvelden voor de set velden die u kunt opnemen in query's en de typen werkitems waarop ze van toepassing zijn.

Tip

  • Vergeet niet om datums in te voeren in het veld Datumpatroon dat u hebt ingesteld voor uw persoonlijke profiel.
  • Als u wilt weten hoe AND/OR componenten worden gegroepeerd, raadpleegt u de sectie Groepsclausules in Een werkitemquery definiëren in Azure Boards. Als u de WIQL-syntaxis voor een query wilt weergeven, installeert u de WIQL-editorextensie, waarmee u de WIQL-versie van een willekeurige Power Query-editor vermelding kunt zien.

Filteren op

Deze queryclausules opnemen

Items die in de afgelopen 30 dagen zijn gemaakt.

Schermopname van de Power Query-editor component voor het zoeken naar items die in de afgelopen 30 dagen zijn gemaakt.

Items die zijn gewijzigd op een specifieke datum.

Schermopname van de Power Query-editor component voor het zoeken naar items die zijn gewijzigd op een specifieke datum.

Items zijn vandaag opgelost.

Schermopname van de Power Query-editor component voor het vinden van items die vandaag zijn opgelost.

Items die binnen een opgegeven periode zijn gesloten.

Schermopname van de Power Query-editor component voor het zoeken naar items die binnen een bepaalde periode zijn gesloten.

Items die niet zijn gesloten (gesloten datum is null).

Schermopname van de Power Query-editor component voor het zoeken naar items waarvan de gesloten datum leeg of null is.

Items waarvan de status in de afgelopen week is bijgewerkt.

Schermopname van de Power Query-editor component voor items waarvan de status in de afgelopen week is bijgewerkt.

Items die tijdens de huidige sprint zijn gesloten. (De <xref href="CurrentIteration" data-throw-if-not-resolved="False" data-raw-source="@CurrentIteration"></xref> macro verwijst naar de sprint die is gedefinieerd voor de huidige teamcontext.)

Schermopname van de Power Query-editor component voor items die tijdens de huidige sprint zijn gesloten.

Op datum gebaseerde query's voor dag, week, maand of jaar maken

In de volgende voorbeelden ziet u hoe u de StartOf... macro's gebruikt om te filteren op werkitems met verschillende offsets. Zie de wiql-syntaxis (Work Item Query Language) voor meer informatie.

Notitie

Vereist azure DevOps Server 2019 Update 1 of nieuwere versie.

Filteren op

Deze queryclausules opnemen

Bugs zijn de afgelopen twee weken gesloten.

Schermopname van de Power Query-editor component voor het vinden van bugs die in de afgelopen twee weken zijn gesloten.

Items die in de afgelopen 10 dagen zijn gewijzigd.

Schermopname van de Power Query-editor componenten voor het zoeken naar items die in de afgelopen 10 dagen zijn gewijzigd.

Functies die in de komende drie maanden moeten worden voltooid.

Schermopname van de Power Query-editor-componenten voor functies die in de komende drie maanden zijn gepland.

Niet alle velden zijn geldig voor alle typen werkitems. Ga naar datumvelden voor de set velden die u kunt opnemen in query's en de typen werkitems waarop ze van toepassing zijn.

Query's maken voor de huidige iteratie van uw team

Als uw team Scrum-processen volgt, plant u het werk dat moet worden voltooid in sprints. U kunt de voortgang van vereisten, bugs en andere werkzaamheden bijhouden die in de huidige sprint moeten worden voltooid met behulp van de @CurrentIteration macro.

Elk item dat is toegewezen aan een sprint die overeenkomt met het huidige iteratiepad voor het team, wordt gevonden. Als een team zich bijvoorbeeld op Sprint 5 bevindt, retourneert de query items die zijn toegewezen aan Sprint 5. Wanneer het team later in Sprint 6 werkt, retourneert dezelfde query items die zijn toegewezen aan Sprint 6.

Notitie

@CurrentIteration De macro werkt alleen als het team een iteratiepad heeft geselecteerd waarvan het datumbereik de huidige datum omvat. Zie Iteratiepaden definiëren (ook wel sprints genoemd) en team iteraties configureren voor meer informatie. Query's die deze macro bevatten, zijn ook alleen geldig wanneer ze worden uitgevoerd vanuit de webportal.

Zie ook Client restrictions on the use of the @CurrentIteration macros eerder in dit artikel.

Azure Boards voegt een teamparameter toe wanneer u de macro's @CurrentIteration of @CurrentIteration +/- n selecteert. De teamparameter is afgeleid van de huidige teamcontext.

Schermopname van het queryfilter met behulp van de macro CurrentIteration met de teamparameter.

Tip

Als de @CurrentIteration macro niet werkt, controleert u of de verwachte iteratie is geselecteerd voor uw team en of er datums voor zijn ingesteld.

Als u de teamparameter wilt wijzigen die door het systeem automatisch wordt ingesteld, kiest u deze door de naam van het team in te voeren in het parameterveld dat is toegevoegd onder de @CurrentIteration macro.

Schermopname van het kiezen van een teamparameter.

Een schuifvenster maken van de iteratiequery van uw team

Gebruik de @CurrentIteration +/- <i>n</i> macro als u het werk wilt bijhouden dat een team gepland is voor toekomstige sprints en om inzicht te krijgen in het werk dat niet is voltooid in eerdere sprints.

Notitie

@CurrentIteration +/- <i>n</i> De macro werkt alleen als het team iteratiepaden heeft geselecteerd die voldoen aan de +/- _n_ criteria. Datumbereiken moeten de huidige datum voor de @CurrentIterationdatum omvatten. Zie Iteratiepaden (sprint) definiëren en team iteratiepaden configureren voor meer informatie over de teamselectie van iteratiepaden.

Zie ook Client restrictions on the use of the @CurrentIteration macros eerder in dit artikel.

In de volgende afbeelding ziet u hoe u alle typen werkitems voor gebruikersverhaal en bugitems weergeeft die zijn toegewezen aan het schuifvenster dat de laatste twee, de huidige en de volgende twee sprints omvat die zijn geselecteerd voor het team Cloud Beheer en Tools.

Schermopname van CurrentIteration plus- en min-componenten.

Als u deze macro wilt gebruiken, moet het opgegeven team een reeks sprints selecteren die de +/- _n_ waarde omvatten die is ingevoerd voor de macro.

Werkitems weergeven die zijn verplaatst uit een sprint

Lijst met werkitems die zijn gedefinieerd voor een sprint, maar later zijn verplaatst met behulp van een query met een component die de Was Ever operator voor het veld Iteratiepad bevat. Maak deze query alleen met behulp van de WIQL-syntaxis. Bewerk de WIQL-syntaxis in Power Query-editor door de WIQL Editor Marketplace-extensie te installeren.

De volgende syntaxisquery's voor werkitems voldoen bijvoorbeeld aan de volgende criteria:

  • Gedefinieerd in het huidige project.
  • Het type werkitem is gelijk aan User Story of Bug.
  • Werkitems bevinden zich onder het pad van het fabrikam Fiber-webteam.
  • Werkitems hebben geen Closedstatus Completedof CutResolved status.
  • Niet in het huidige iteratiepad voor het Fabrikam Fiber-webteam.
  • Zijn toegewezen aan het huidige iteratiepad voor het Fabrikam Fiber-webteam.
  • Zijn nu toegewezen aan de huidige iteratie +1 voor het Fabrikam Fiber-webteam.
  • Zijn gewijzigd in de afgelopen 30 dagen (de lengte van de sprint).
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]

De Power Query-editor weergave van de syntaxis wordt weergegeven zoals weergegeven.

Notitie

In de Power Query-editor wordt een informatiepictogram naast de Was Ever operator weergegeven, waarmee een probleem met de component wordt aangegeven. De query wordt echter nog steeds uitgevoerd en u kunt querygrafieken maken. Als u de query wilt wijzigen, moet u de WIQL-editor gebruiken.

Schermopname van Power Query-editor werkitems die zijn verplaatst uit een sprint.

Werkitems weergeven die zijn toegevoegd aan een sprint na de begindatum

Als u nieuw gemaakte werkitems wilt weergeven die zijn toegevoegd aan een sprint na de begindatum, gebruikt u een query die vergelijkbaar is met de query die in de volgende afbeelding wordt weergegeven. Deze query werkt door te filteren op werkitems die zijn toegewezen aan de huidige sprint, maar zijn gemaakt na het begin van de sprintdatum. Gebruik de component created Date = @Today - 28.

Schermopname van Power Query-editor zojuist gemaakte werkitems en toegevoegd aan een sprint na de begindatum.

Zie Over Sprints, Scrum en projectmanagement voor andere opties voor het uitvoeren van query's op wijzigingen in het sprintbereik.

Datum- en iteratiepadvelden

Gebruik datumvelden om uw query's te filteren. Sommige van deze velden worden gevuld met informatie als een werkitem van de ene status naar de andere gaat. Verschillende van deze velden worden niet weergegeven in het werkitemformulier, maar ze worden bijgehouden voor de typen werkitems die worden vermeld in de volgende tabel.

Veldnaam

Beschrijving

Typen werkitems

Geactiveerde datum (notities 1 en 2)

De datum en tijd waarop het werkitem is gemaakt of wanneer de status is gewijzigd van Closed, Completedof Done in een New of Active status. Verwijzingsnaam=Microsoft.VSTS.Common.ActivatedDate, gegevenstype=Datum/tijd

Bug, Wijzigingsaanvraag, Epic, Functie, Probleem, Productachterstanditem, Vereiste, Beoordeling, Risico, Gedeelde stap, Taak, Testcase, Gebruikersverhaal

Datum wijzigen

De datum en tijd waarop een werkitem is gewijzigd. Verwijzingsnaam=System.ChangedDate, gegevenstype=Datum/tijd

Alle

Gesloten datum (opmerking 2)

De datum en tijd waarop een werkitem is gesloten. Referentienaam=Microsoft.VSTS.Common.ClosedDate, gegevenstype=Datum/tijd

Alle

Aanmaakdatum

De datum en tijd waarop een werkitem is gemaakt. Verwijzingsnaam=System.CreatedDate, gegevenstype=Datum/tijd

Alle

Vervaldatum

De voorspelde einddatum voor een probleem dat moet worden opgelost. Referentienaam=Microsoft.VSTS.Scheduling.DueDate, gegevenstype=Datum/tijd

Probleem (Agile)

Einddatum (opmerking 3)

De datum en tijd waarop de planning aangeeft dat de taak is voltooid. Referentienaam=Microsoft.VSTS.Scheduling.FinishDate, gegevenstype=DateTime

Vereiste, taak, testplan, gebruikersverhaal

Iteratiepad

Hiermee worden werkitems gegroepeerd op benoemde sprints of perioden. De iteratie moet een geldig knooppunt in de projecthiërarchie zijn. U definieert iteratiepaden voor een project en selecteert iteratiepaden voor een team. Verwijzingsnaam=System.IterationPath, gegevenstype=TreePath

Alle

Opgeloste datum (notities 1 en 2)

De datum en tijd waarop het werkitem is verplaatst naar een Resolved status. Referentienaam=Microsoft.VSTS.Common.ResolvedDate, gegevenstype=DateTime

Bug, Wijzigingsaanvraag, Epic, Functie, Probleem, Productachterstanditem, Vereiste, Beoordeling, Risico, Gedeelde stap, Taak, Testcase, Gebruikersverhaal

Begindatum (opmerking 3)

De datum en tijd waarop de planning aangeeft dat de taak begint.

Notitie

Leveringsplannen maakt gebruik van de velden Begindatum en Doeldatum om de reeks functies, epics en andere portfolioachterstanditems weer te geven.

Referentienaam=Microsoft.VSTS.Scheduling.StartDate, gegevenstype=DateTime

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

Datum van statuswijziging

De datum en tijd waarop de waarde van het veld Staat is gewijzigd. Referentienaam=Microsoft.VSTS.Common.StateChangeDate, gegevenstype=DateTime

Alle

Doeldatum

De datum waarop een functie, werkitem of probleem moet worden voltooid of opgelost.

Notitie

Leveringsplannen maakt gebruik van de velden Begindatum en Doeldatum om de reeks functies, epics en andere portfolioachterstanditems weer te geven.

Referentienaam=Microsoft.VSTS.Scheduling.TargetDate, gegevenstype=DateTime

Epic, Feature

Opmerkingen:

  1. Zie ook Query op toewijzings- of werkstroomwijzigingen, datum- en identiteitsvelden.

  2. Als u deze velden wilt definiëren voor een type werkitem, moeten deze worden opgenomen in de WORKFLOW sectie van de definitie van het type werkitem. Deze syntaxis wordt bijvoorbeeld opgenomen in de FIELDS definitie bij de overgang naar een Resolved status.

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

  3. Waarden voor begin- en einddatum worden berekend als u een projectplan in Project maakt en dat plan vervolgens synchroniseert met taken die zijn opgeslagen in Azure Boards. Deze velden worden mogelijk niet weergegeven in het werkitemformulier, maar worden berekend voor de achterstandsitems en taken die zijn gekoppeld aan achterstandsitems. U kunt hun alleen-lezen waarden weergeven in resultaten van een query of excel.

    Belangrijk

    Microsoft Project Integration en de TFSFieldMapping opdracht worden niet ondersteund voor:

    • Visual Studio 2019 en Azure DevOps Office Integration 2019.
    • Azure DevOps Server 2019 en latere versies, waaronder Azure DevOps Services.

    Volledige ondersteuning voor Microsoft Excel-integratie wordt onderhouden en ondersteunt bulkimport en update van werkitems. Alternatieven voor het gebruik van Microsoft Project zijn:

REST-API

Als u programmatisch wilt communiceren met query's, raadpleegt u een van deze REST API-resources: