Query uitvoeren op numerieke velden in Azure Boards en Azure DevOps

  • Artikel

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

Hoe kan ik bepalen hoeveel werk elke ontwikkelaar in mijn team heeft voltooid? Is er een manier om de inspanning of verhaalpunten voor een iteratie samen te vatten?

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.

Ondersteunde operators en macro's

Queryclausules die een numeriek veld opgeven, kunnen de onderstaande operators gebruiken.

  • = , <> , > , < , >= <
  • =[Veld]; <>[Veld]; >[Veld]; <[Veld]; >=[Veld]; <=[Veld]
  • In, niet in
  • Was ooit

Tips voor het ontwikkelen van query's op basis van grafieken

  • U kunt alleen grafieken toevoegen voor platte query's
  • Grafiekopties verwijzen 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.
  • Als u een of meer componenten wilt groeperen, selecteert u deze en kiest u 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 voor meer informatie over het maken van query's en op grafieken gebaseerde query's. Als u een aangepast veld wilt toevoegen om de som van andere numerieke waarden bij te houden en te genereren, raadpleegt u Een veld toevoegen of wijzigen.

Nuttige filters

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's en grafieken voor het tellen van 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.

Query's uitvoeren op elke status, aantal werkitemsoverzicht

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

Aantal bugs per ontwikkelaar

Maak een actieve bugsquery en wijzig de kolomopties om Toegewezen aan en Status weer te geven. Voeg vervolgens een draaigrafiek toe waarin de toewijzingen en status worden weergegeven.

Dialoogvenster Grafiek configureren, draaitabel door toegewezen aan en status

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.

Dialoogvenster Grafiek configureren, draaien op status en gebied

Niet-gedefinieerde veldwaardequery's

U kunt werkitems met een niet-gedefinieerde veldwaarde vinden met behulp van de operator equals (=) 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.

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's en grafieken voor werk- 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.

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.

Query-editor, platte lijst, verhalen openen

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

Dialoogvenster Grafiek, gestapelde staaf, som van verhaalpunten configureren

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

Grafiek met gebruikersverhalen voor een iteratie branden

Maak een query die filtert op User Story als het type werkitem en de status Actief of Gesloten heeft. Wijzig de kolomopties om Verhaalpunten weer te geven.

Queryeditor, platte lijst, gebruikersverhalen - actief of gesloten

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

Grafiekdialoogvenster, trend, som van verhaalpunten configureren

Resterende en voltooide werkquery's en grafieken

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 krijgen van de hoeveelheid werk die voor elke ontwikkelaar resteren met de volgende query en grafiek. Door de Operator In te gebruiken en zowel Taak als Bug op te nemen, neemt u eventuele bugs op die als taken worden bijgehouden.

Query uitvoeren op 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.

Grafiekdialoogvenster, draai, som van resterend werk per ontwikkelaar configureren

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. Deze is toegewezen Effort aan 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. Deze is toegewezen Effort aan 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. Deze is toegewezen Effort aan het ProcessConfiguration-bestand.

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

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. Deze wordt toegewezen aan type="RemainingWork" 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.

Zie Uw ervaring voor het bijhouden van werk aanpassen voor meer informatie over het toevoegen van aangepaste velden.

De belangrijkste hulpprogramma's die u gebruikt om werk te plannen en bij te houden, worden hier beschreven:

Zie voor meer informatie over het gebruik van werkitems en query's:

Numerieke waarden samenvouwen voor werkitemstypen

Samenvouwen biedt opgetelde waarden van geselecteerde velden voor alle onderliggende werkitems van een bovenliggend item. Azure Boards biedt standaard het samenvouwen van resterend werk voor taken op het taskboard. Zie de volgende artikelen voor andere samengetelde vereisten:

Welke items worden weergegeven in de categorieën Vereiste of Taak?

De standaardtoewijzingen van werkitemtypen voor elke categorie worden hieronder weergegeven voor elk proces.

Proces Vereistecategorie Taakcategorie
Flexibel Gebruikersverhaal Opdracht
Scrum Productachterstanditem Opdracht
CMMI Vereiste Opdracht

Elk team kan echter bepalen of het werkitemtype Bug wordt weergegeven in de categorie Vereiste of Taak. Zie Fouten weergeven in achterstanden en borden.

U kunt aangepaste typen werkitems toevoegen aan een achterstand. Zie Een werkitemtype toevoegen of wijzigen voor meer informatie, een aangepast WIT toevoegen aan een achterstand of bord.

REST-API

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