Share via


Query uitvoeren op numerieke velden

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

Meer informatie over het uitvoeren van query's op numerieke velden op basis van inspanning, planning, verhaalpunten of tijdtraceringsvelden in Azure Boards en Azure DevOps.

In de meest voorkomende numerieke velden wordt de hoeveelheid werk bijgehouden voor items in de categorie Vereisten of geschatte, resterende en voltooide hoeveelheid werk voor items in de categorie Taak . Met query's kunt u de gewenste werkitems vermelden en vervolgens een grafiek definiëren waarin een telling van werkitems of een som van een numeriek veld wordt weergegeven.

Operators en macro's gebruiken

Ondersteunde querycomponenten die een numeriek veld opgeven, kunnen de volgende operators gebruiken.

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

Op grafieken gebaseerde query's ontwikkelen

Met de volgende tips kunt u uw query's ontwikkelen:

  • Voeg alleen grafieken toe voor platte query's.
  • Verwijzing naar queryfilters of velden die worden weergegeven via kolomopties.
  • Sla wijzigingen op die u aanbrengt in uw query voordat u een grafiek toevoegt of wijzigt.
  • Groepeer een of meer componenten door ze te selecteren en vervolgens het Pictogram Groepsquerycomponent pictogram groepsclausules. Als u de groepering wilt opheffen, selecteert u de gegroepeerde component.

Zie De queryeditor gebruiken om query's en grafieken weer te geven en te beheren en een veld toe te voegen of te wijzigen voor meer informatie.

Filters gebruiken

De volgende tabel bevat nuttige filters voor query's.

Filteren op

Deze queryclausules opnemen

Gebruikersverhalen of fouten

Work Item Type In User Story,Bug

Taken of bugs

Work Item Type In Task,Bug

Items die actief of gesloten zijn

State In Active,Closed

Items in de categorie Vereisten

Work Item Type In Group Microsoft.RequirementCategory

Niet-geschatte gebruikersverhalen

Story Points <> (leave Value field blank)


Query uitvoeren op het aantal werkitems

Alle query's geven een aantal items weer wanneer u de query uitvoert. Hier definiëren we een platte query die filtert op bugs in elke status.

Schermopname van queryfouten in elke status, het aantal werkitemsoverzicht.

Alle grafieken bevatten ook een selectie Waarden die is ontworpen om het aantal werkitems in de grafiek weer te geven.

Query uitvoeren op het aantal bugs per ontwikkelaar

Als u Toegewezen aan en status wilt weergeven, maakt u een actieve bugsquery en wijzigt u de kolomopties. Voeg vervolgens een draaigrafiek toe waarin de toewijzingen en status worden weergegeven.

Schermopname van het dialoogvenster Grafiek configureren, draaitabel door toegewezen aan en de status.

Query's uitvoeren voor het aantal bugs per status en gebied

Met dezelfde platte-lijstquery die filtert op fouten die in de vorige sectie worden weergegeven, kunt u een telling weergeven op basis van het gebied. Wijzig de kolomopties om het gebiedspad weer te geven. Voeg vervolgens een draaigrafiek toe waarmee het status- en gebiedspad wordt weergegeven.

Schermopname van het dialoogvenster Grafiek configureren, draait op status en gebied.

Query uitvoeren op niet-gedefinieerde veldwaarden

U kunt werkitems vinden die een niet-gedefinieerde veldwaarde hebben met behulp van de operator is gelijk aan , =en de waarde voor het veld leeg laten. Met de volgende filters worden bijvoorbeeld alle werkitems van het type Gebruikersverhalen weergegeven waarvan het veld Verhaalpunten leeg is.

Schermopname van Filteren op basis van lege vermeldingen.

Als u werkitems wilt weergeven op basis van een veld dat niet leeg is, gebruikt u de operator <>not en laat u de waarde leeg.

Query uitvoeren op inspannings- of verhaalpunten

U kunt Story Points toewijzen aan gebruikersverhalen of bugs wanneer u in een Agile-proces werkt. Of werk aan productachterstanditems en bugs wanneer u in een Scrum-proces werkt. Zie Basis-, Agile-, Scrum- of CMMI-werkitemtypen en werkstroomartikelen voor meer informatie.

Query's uitvoeren op som van verhaalpunten en hun status

Maak een query die filtert op User Story als het type werkitem en wijzig de kolomopties om Verhaalpunten en Status weer te geven.

Schermopname van query-editor, platte lijst, open verhalen.

Voeg vervolgens een gestapeld staafdiagram toe waarmee de verhaalpunten worden opgeteld.

Schermopname van het dialoogvenster Grafiek configureren, gestapelde staaf, som van verhaalpunten.

Zie Cumulatieve stroom voor meer informatie over door het systeem gedefinieerde cumulatieve stroomdiagrammen.

Query uitvoeren op burn-upgrafiek van gebruikersverhalen voor een iteratie

Maak een query die filtert op User Story als het type werkitem en de status Actief of Gesloten heeft. Als u Verhaalpunten wilt weergeven, wijzigt u de kolomopties.

Schermopname van query-editor, platte lijst, gebruikersverhalen - actief of gesloten.

Voeg vervolgens een gestapeld vlaktrenddiagram toe waarmee de verhaalpunten worden opgeteld.

Schermopname van het dialoogvenster Grafiek configureren, trend, som van verhaalpunten.

Query uitvoeren op resterende en voltooide werkzaamheden

Op basis van het proces waarnaar uw projectverwijzingen verwijzen, kunt u de volgende velden toewijzen aan taken of bugs.

Proces Beschikbare velden
Flexibel Oorspronkelijke schatting, resterende hoeveelheid werk, voltooid werk
Scrum Resterend werk
CMMI Oorspronkelijke schatting, resterende hoeveelheid werk, voltooid werk

Som van resterend werk per ontwikkelaar

Als u Scrum-procedures volgt en resterende hoeveelheid werk voor uw taken en bugs inschatten, kunt u een samenteling van resterend werk krijgen met de volgende query en grafiek. Gebruik de operator In en neem zowel Taak als Bug op om eventuele bugs op te nemen die als taken worden bijgehouden.

Schermopname van query van taken en bugs voor sprint.

Voeg resterende hoeveelheid werk toe als kolomoptie aan de query en sla deze op. Als u een som van het resterende werk wilt weergeven, voegt u een draaigrafiek toe, zoals wordt weergegeven in het volgende voorbeeld.

Schermopname van het dialoogvenster Grafiek configureren, draaitabel, som van resterende hoeveelheid werk per ontwikkelaar.

Zie Sprint burndown voor informatie over door het systeem gedefinieerde burndowngrafieken voor sprints.

Velden die worden gebruikt om werk te schatten en bij te houden

In de volgende tabel worden de op activiteiten gebaseerde en numerieke velden beschreven die u kunt gebruiken om werk bij te houden. Zie Query op datum of huidige iteratie voor informatie over datumgerelateerde velden, zoals Begindatum, Einddatum en Doeldatum.

Veldnaam

Beschrijving

Type werkitem


Activiteit 1, 2

Het type activiteit dat nodig is om een taak te voltooien. Zie Capaciteitsplanning voor meer informatie over hoe dit veld wordt gebruikt. Toegestane waarden zijn:

  • Implementatie
  • Ontwerpen
  • Ontwikkeling
  • Documentatie
  • Vereisten
  • Testen

Het veld Activiteit wordt toegewezen aan Activity het ProcessConfiguration-bestand.3

Verwijzingsnaam=Microsoft.VSTS.Common.Activity, gegevenstype=Tekenreeks

Taak, Bug4 (Agile en Scrum)

Bedrijfswaarde

Een subjectieve maateenheid die de relatieve bedrijfswaarde van een productachterstanditem of -functie vastlegt in vergelijking met andere items van hetzelfde type. Een item waaraan een hoger getal is toegewezen, moet worden beschouwd als een hogere bedrijfswaarde dan een item waaraan een lager getal is toegewezen.

Verwijzingsnaam=Microsoft.VSTS.Common.BusinessValue, gegevenstype=Geheel getal

Epic, Feature

Voltooid werk

De hoeveelheid werk die is besteed aan het implementeren van een taak. U kunt werk opgeven in uren of in dagen. Er zijn geen inherente tijdseenheden gekoppeld aan dit veld.

Referentienaam=Microsoft.VSTS.Scheduling.CompletedWork, gegevenstype=Double

Taak, Bug4

Discipline 1, 2

Het type activiteit of discipline dat is toegewezen aan een taak. Zie Capaciteitsplanning voor meer informatie over hoe dit veld wordt gebruikt. Toegestane waarden zijn:

  • Analyse
  • Ontwikkeling
  • Testen
  • Gebruikersonderwijs
  • Gebruikerservaring

Het veld Discipline wordt toegewezen aan Activity het ProcessConfiguration-bestand.3

Verwijzingsnaam=Microsoft.VSTS.Common.Discipline, gegevenstype=Tekenreeks

Taak, Bug 4 (CMMI)

Effort

Een subjectieve maateenheid die de grootte van een bug of productachterstand vastlegt. Als u meer inspanning toewijst aan een item, geeft u aan dat er meer werk nodig is om het te implementeren.

Dit veld 3 wordt ook gebruikt om de snelheid en prognoses van het team te berekenen. Het wordt toegewezen aan Effort in het ProcessConfiguration-bestand.

Referentienaam=Microsoft.VSTS.Scheduling.Effort, gegevenstype=Double

Productachterstanditem, Bug 4 (Scrum)

Feature, Epic

Verhaalpunten

Een subjectieve maateenheid waarmee de grootte van een gebruikersverhaal wordt vastgelegd. Als u meer punten toewijst aan een gebruikersverhaal, geeft u aan dat er meer werk nodig is om het te implementeren.

Dit veld 3 wordt ook gebruikt om de snelheid en prognoses van het team te berekenen. Het wordt toegewezen aan Effort in het ProcessConfiguration-bestand.

Referentienaam=Microsoft.VSTS. Scheduling.StoryPoints, gegevenstype=Double

Gebruikersverhaal, Bug 4 (Agile)

Tekengrootte

Een subjectieve maateenheid die de grootte van een vereiste vastlegt. Hoe groter de grootte, hoe meer werk nodig is om het te implementeren.

Dit veld3 wordt ook gebruikt om de snelheid en prognoses van het team te berekenen. Het wordt toegewezen aan Effort in het ProcessConfiguration-bestand.

Referentienaam=Microsoft.VSTS. Planning. Grootte, gegevenstype=dubbel

Vereiste, Bug 4 (CMMI)

Oorspronkelijke schatting

De hoeveelheid werk die nodig is om een taak te voltooien. U kunt werk opgeven in uren of in dagen. Er zijn geen inherente tijdseenheden gekoppeld aan dit veld.

Referentienaam=Microsoft.VSTS.Scheduling.OriginalEstimate, gegevenstype=Double

Taak, Bug 4 (Agile en CMMI)

Resterend werk

De hoeveelheid werk die overblijft om een taak te voltooien. U kunt werk opgeven in uren of in dagen. Er zijn geen inherente tijdseenheden gekoppeld aan dit veld. Dit veld 3 wordt ook gebruikt om de burn down te berekenen. Het wordt toegewezen aan type="RemainingWork" in het ProcessConfiguration-bestand.

Notitie

Voor Azure Boards toont het taskboard altijd 'h' voor uren in relatie tot resterende hoeveelheid werk. Voor TFS kunt u het ProcessConfiguration-bestand voor het veld Resterende hoeveelheid werk wijzigen om 'd' voor dagen of een ander voorkeurslabel op te geven.

Referentienaam=Microsoft.VSTS.Scheduling.RemainingWork, gegevenstype=Double

Taak, Bug4

Controle vereist

Hiermee wordt aangegeven dat de taak moet worden beoordeeld. U kunt Ja of Nee opgeven (standaard).

Referentienaam=Microsoft.VSTS.CMMI.RequiresReview, Gegevenstype=Tekenreeks

Taak (CMMI)

Test vereist

Geeft aan dat voor de taak een test is vereist. U kunt Ja of Nee opgeven (standaard).

Referentienaam=Microsoft.VSTS.CMMI.RequiresTest, Gegevenstype=Tekenreeks

Taak (CMMI)

Taaktype1

Hiermee geeft u het soort taak dat moet worden geïmplementeerd. Toegestane waarden zijn:

  • Corrigerende maatregel
  • Beperkingsactie
  • Gepland

Verwijzingsnaam=Microsoft.VSTS.CMMI.TaskType, gegevenstype=tekenreeks

Taak, Fout4 (CMMI-proces)

Notitie

  1. Als u de menuselectie wilt wijzigen: voor cloudservices of een overgenomen proces, raadpleegt u Velden toevoegen en beheren; en voor een on-premises XML-proces raadpleegt u Een veld toevoegen of wijzigen, een selectielijst aanpassen.
  2. De waarden die worden weergegeven op de pagina Capaciteit voor Activiteit (Agile of Scrum) of Discipline (CMMI) weerspiegelen een samenvoeging van alle waarden die zijn gedefinieerd voor het veld in alle projecten binnen het projectverzamelingsexemplaren. Als u daarom de waarden wilt beperken die worden weergegeven voor Capaciteit op de pagina's met sprintachterstanden, moet u ervoor zorgen dat de waarden overeenkomen in alle projecten waaraan het veld is type="Activity"toegewezen.
  3. Als u de veldtoewijzing ProcessConfiguration (alleen on-premises) wilt wijzigen, raadpleegt u de verwijzing naar xml-element voor procesconfiguratie.
  4. Elk team kan hun Agile-hulpprogramma's configureren om te bepalen of bugs worden behandeld als vereisten of taken. Omdat fouten kunnen worden weergegeven met vereisten of taken, worden velden gebruikt om de inspanning op vereisteniveau te schatten en worden het taakniveau opgenomen in het werkitemformulier.

Volgende stappen

REST-API

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