Delen via

Query uitvoeren op datum of huidige iteratie

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

In dit artikel wordt beschreven hoe u werkitems kunt weergeven door datums te maken, te wijzigen, op te lossen of te sluiten en hoe u datummacro's (bijvoorbeeld @Today) en iteratiemacro's voor teamsprints gebruikt. Zie Query per gebied of iteratiepad voor basisbeginselen van iteratiepaden en client-/macrobeperkingen.

Prerequisites

Category Requirements
Toegangsniveaus - Gedeelde query's weergeven en uitvoeren: Project-lid.
- Een gedeelde query toevoegen en opslaan: minimaal Basic toegang.
Permissions Bijdragen machtiging ingesteld op toestaan voor de map waaraan u een query wilt toevoegen. Standaard heeft de inzenders groep deze machtiging niet.

Note

Gebruikers met Stakeholder toegang voor een openbaar project hebben volledige toegang tot queryfuncties, net zoals gebruikers met Basic-toegang. Zie Snelzoekgids voor toegang van belanghebbendenvoor meer informatie.

Category Requirements
Toegangsniveaus - Gedeelde query's weergeven en uitvoeren: Project-lid.
- Om een gedeelde query toe te voegen en op te slaan: minstens Basic toegang.
Permissions Bijdragen machtiging ingesteld op toestaan voor de map waaraan u een query wilt toevoegen. Standaard heeft de inzenders groep deze machtiging niet.

Ondersteunde operators en datummacro's

Gebruik de volgende operatoren en macro's voor de velden DateTime en Iteratiepad in Query-editor.

  • Datum/tijd-operators: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
  • Datummacro's: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear@Today
    U kunt +/- n combineren met deze macro's (bijvoorbeeld @Today - 7).
  • Iteratiemacro's: @CurrentIteration en @CurrentIteration +/- n (zie de volgende opmerking en koppeling voor clientbeperkingen en gedrag van teamparameters).

Note

Iteratiemacro's en clientbeperkingen worden uitgebreid besproken op de iteratiepagina: Query op gebied of iteratiepad. Als u query's wilt uitvoeren in niet-webclients of via REST/WIQL buiten de webgebruikersinterface, controleert u de ondersteuning van macro's in uw omgeving en kunt u overwegen macro's uit te breiden naar expliciete paden.

Voorbeelden van snelle datums (algemene query's)

  • Items die in de afgelopen 30 dagen zijn gemaakt: Schermopname van de component Query-editor voor het zoeken van items die in de afgelopen 30 dagen zijn gemaakt.

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

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

  • Items die binnen een opgegeven periode zijn gesloten: Schermopname van de component Query-editor voor het zoeken naar items die binnen een opgegeven periode zijn gesloten.

  • Items waarvan de Gesloten datum null is (niet gesloten): Schermopname die de Query-editor clausule laat zien voor het vinden van items waarvan de Gesloten datum leeg of null is.

  • Items waarvan de status in de afgelopen week is gewijzigd: Schermopname van de component Query-editor voor items waarvan de status in de afgelopen week is bijgewerkt.

@CurrentIteration De macro's gebruiken (korte handleiding)

Gebruik @CurrentIteration om de huidige sprint van het team te richten en @CurrentIteration +/- n om een schuifvenster van sprints te maken (bijvoorbeeld de laatste twee, huidige en volgende twee sprints). Belangrijke punten:

  • @CurrentIteration retourneert items die zijn toegewezen aan de huidige sprint voor de teamcontext die wordt gebruikt bij het uitvoeren van de query.
  • @CurrentIteration +/- n verschuift het sprintvenster met n; nuttig voor trend- en overdrachtsanalyses.
  • Omdat macrogedrag en clientondersteuning variëren, raadpleegt u Query op gebied of iteratiepad voor meer informatie over teamparameters, die clients macro's evalueren en hoe macro's worden opgeslagen/uitgebreid bij het opslaan van query's.

Voorbeeldafbeeldingen (query-editor voor webportal):

Schermopname van het filter Queryeditor met de macro CurrentIteration met een teamparameter.

Schermopname die CurrentIteration plus- en mincomponenten toont voor een schuifvenster van sprints.

Tip

Als @CurrentIteration niet de verwachte resultaten oplevert, bevestigt u de geselecteerde iteratie en de iteratiedatumbereiken van het team in de teaminstellingen.

Datummacro's: begin van dag/week/maand/jaar

Startmacro's helpen bij het bouwen van consistente relatieve datumbereiken:

  • @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear— gebruik deze macro's om +/- n bereiken te creëren, zoals 'sinds begin van de week' of 'afgelopen 3 maanden'.
  • Deze macro's worden geëvalueerd door de gebruikersinterface van de webportal; hun gedrag in niet-webscenario's kan verschillen: test in uw doelclient.

Voorbeeldvragen

Schermopname die de query-editor onderdelen laat zien voor het zoeken naar items die in de laatste 10 dagen zijn gewijzigd.

Schermopname van de Query Editor clausules voor functies die in de komende drie maanden voltooid zullen zijn.

Wanneer wiql rechtstreeks gebruiken

WIQL gebruiken wanneer:

  • U hebt geavanceerde operators nodig, zoals WAS EVER voor iteratiepadwijzigingen.
  • Query-editor blokkeert of markeert een component als niet-ondersteund (bijvoorbeeld sommige Was Ever toepassingen). Met de WIQL Editor-extensie kunt u deze query's ontwerpen en opslaan.

Zie de wiql-syntaxis (Work Item Query Language) en de MARKETPLACE-extensie WIQL Editor voor voorbeelden.

Verwante inhoud

REST API

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

  • Last updated on