Delen via

Query uitvoeren op numerieke velden

  • Artikel

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 worden de hoeveelheid werk bijgehouden voor items in de Vereisten categorie 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.

Voorwaarden

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

Notitie

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

Categorie Eisen
Toegangsniveaus - Gedeelde query's weergeven en uitvoeren: Project-lid.
- Een gedeelde query toevoegen en opslaan: op z'n minst Basic toegang.
machtigingen Permissieset ingesteld op Toestaan voor de map waaraan u een query wilt toevoegen. Standaard heeft de inzenders groep deze machtiging niet.

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-lijstquery's.
  • Verwijs naar de queryfilters of de velden die worden weergegeven via de 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 Group Query Clause groepscomponentpictogram. Om de groepering op te heffen, selecteer de gegroepeerde clausule.

Zie De queryeditor gebruiken voor het weergeven en beheren van query's en Grafieken en Een veld toevoegen of wijzigenvoor meer informatie.

Filters gebruiken

De volgende tabel bevat nuttige filters voor query's.

Filter voor

Deze queryclausules opnemen

Gebruikersverhalen of fouten

Work Item Type In User Story,Bug

Taken of fouten

Work Item Type In Task,Bug

Items die actief of gesloten zijn

State In Active,Closed

Artikelen 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 mogelijke status, samenvatting van het aantal werkitems.

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

Om Toegewezen aan en Status weer te geven, 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 instellen, draaien op basis van toegewezen aan en status.

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

Met dezelfde platte lijst-query die filtert op bugs die in de vorige sectie worden weergegeven, kunt u een overzicht geven 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.

Schermafbeelding van het dialoogvenster Grafiekconfiguratie, met draaiing op status en gebied.

Query uitvoeren op niet-gedefinieerde veldwaarden

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

Schermopname die Filter op basis van lege vermeldingen toont.

Als u werkitems wilt weergeven op basis van een veld dat niet leeg is, gebruikt u de operator niet, <>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 Basic, Agile, Scrumof CMMI werkitems en werkstroomartikelen voor meer informatie.

Opvragen van de 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 met queryeditor, platte lijst, open verhalen.

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

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

Zie cumulatieve stroomvoor meer informatie over door het systeem gedefinieerde cumulatieve stroomdiagrammen.

Opvragen van de burn-upgrafiek van user stories voor een iteratie

Maak een query die filtert op User Story als het type werkitem en op de status Actief of Gesloten. 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 met het dialoogvenster om de grafiek te configureren, trend, som van verhaalpunten.

Vragen naar 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
Agile 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 de resterende hoeveelheid werk voor uw taken en bugs inschat, kunt u een overzicht van het resterende werk krijgen met de volgende query en bijbehorende grafiek. Gebruik de Operator In en neem zowel Taak als Bug op om eventuele bugs op te nemen die als taken worden bijgehouden.

Schermopname die de query van taken en bugs voor de sprint toont.

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 met het dialoogvenster Grafiek configureren, draaitabel, som van het resterende werk per ontwikkelaar.

Zie Sprint-burndown-voor informatie over door het systeem gedefinieerde burndown-grafieken.

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 iteratievoor informatie over datumgerelateerde velden, zoals Begindatum, Einddatum en Doeldatum.

veldnaam

beschrijving

werkitemtype

Activiteit 1, 2

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

  • Implementatie
  • Ontwerpen
  • Ontwikkeling
  • Documentatie
  • Eisen
  • Testen

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

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

Taak, Fout4 (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, gegevenstyp=Double

Taak, bug4

Discipline 1, 2

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

  • Analyse
  • Ontwikkeling
  • Test
  • Gebruikersonderwijs
  • Gebruikerservaring

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

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

Taak, Bug 4 (CMMI)

Inspanning

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)

Kenmerk, Episch

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)

Grootte

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. Plannen. Grootte, gegevenstype=dubbel

Vereiste, Fout 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=Dubbel

Taak, bug4

Controle vereist

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

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 Geen (standaard) opgeven.

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 actie
  • Beperkingsactie
  • Gepland

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

Taak, Bug4 (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) geven een combinatie weer van alle waarden die voor het veld in alle projecten binnen de projectverzamelinginstantie zijn gedefinieerd. 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 voor het veld dat is toegewezen aan type="Activity".
  3. Als u de veldtoewijzing ProcessConfiguration (alleen on-premises) wilt wijzigen, raadpleegt u XML-elementverwijzing voor procesconfiguratie.
  4. Elk team kan zijn Agile-tools configureren om te bepalen of bugs worden behandeld zoals vereisten of taken. Omdat fouten kunnen optreden bij vereisten of taken, zijn velden opgenomen om de inspanning op zowel het vereisteniveau als het taakniveau te schatten in het werkitemformulier.

Volgende stappen

Uw werkvolgsysteem aanpassen

REST API

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