Metadatareferens för Azure Boards Analytics
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Analytics-tjänsten samlar in all aktivitet för arbetsspårning som definierats och uppdaterats via Azure Boards. Analytics lagrar som egenskaper alla arbetsspårningsfält, förutom html-/rtf-fält och historikfält. Anpassade egenskaper för anpassade fält läggs automatiskt till i Analytics.
Den här artikeln beskriver de flesta egenskaper som du kan använda för att generera en analysrapport för arbetsspårning. Du använder en kombination av egenskaper för att filtrera en fråga, aggregera data eller skapa en rapport. Du kan köra dessa frågor direkt i webbläsaren. Mer information finns i Definiera grundläggande frågor med OData Analytics. Om du är nybörjare på arbetsspårning och Azure Boards rekommenderar vi att du läser följande artiklar:
- Vad är Azure Boards?
- Spåra användarberättelser, problem, buggar och andra arbetsobjekt i Azure Boards
Kommentar
Beskrivningar av entiteter, egenskaper och uppräknade typer som stöds av analysdatamodellen tillhandahålls. Det här är ett tidigt utkast. Ge feedback om områden som du vill ha mer information om. Information om hur du kör frågor mot datamodellen finns i Skapa OData-frågor för analys.
Översikt över entitetsuppsättningar
När du frågar Analytics om arbetsspårningsdata använder du någon av följande entitetstyper eller entitetsuppsättningar.
- Fråga
WorkItems
för att generera status- och sammanslagningsrapporter - Fråga
WorkItemSnapshot
för att generera trend-, burndown- och burnup-rapporter
Använd andra entitetstyper, till exempel Area
, Iteration
, Project
, Team
eller andra entiteter för att filtrera data eller välja egenskaper att rapportera om. En sammanfattning av exempelrapporter finns i Exempelrapporter och snabbreferensindex.
Kommentar
Om du vill generera status- och trendrapporter för testspecifika arbetsobjekttyper frågar du entitetstyperna WorkItems
och WorkItemSnapshot
filtrerar baserat på arbetsobjekttypen. Om du vill ha information om testkörningar, testresultat eller andra testdata frågar du entitetstyperna TestRuns
, TestPoints
, TestResultsDaily
TestSuite
eller TestPointHistorySnapshot
. Mer information finns i Testa metadatareferens för Azure DevOps.
EntitySet |
EntityType |
beskrivning |
---|---|---|
Områden | Ytdiagram | Arbetsobjektets områdessökvägar med egenskaper för gruppering och filtrering efter områdeshierarki. |
Dadlar | CalendarDate | Datumen som används för att filtrera och gruppera andra entiteter med hjälp av relationer. |
Iterationer | Iteration | Iterationssökvägar för arbetsobjekt med egenskaper för gruppering och filtrering efter iterationshierarki. |
BoardLocations | BoardLocation | Brädcellsplatserna, som identifieras av brädkolumn, simbana och delning, innehåller historiska styrelseinställningar. En beskrivning av varje brädfält finns i Fält för arbetsflöde och tavla. |
Processer | Bearbeta | Information om kvarvarande uppgifter som används för att expandera eller filtrera arbetsobjekt och typer av arbetsobjekt. Ett exempel som använder Processer för att filtrera en rapport finns i Exempelrapport för kravspårning. Stöds för Analytics v2.0-version och senare. |
Projekt | Projekt | Alla projekt som definierats för en organisation (moln) eller projektsamling (lokalt). |
Taggar | Tag | Alla arbetsobjekttaggar för varje projekt. Ett exempel som använder taggar för att filtrera en rapport finns i Avsnittet om exempelrapport för lansering av nedbrändhet. |
Teams | Lag | Alla team som definierats för projektet. Ett exempel som använder Teams för att filtrera en rapport finns i Lägga till ett team-utsnitt i en Power BI-rapport. |
Användare | Användare | Användarinformation som används för att expandera eller filtrera olika egenskaper för arbetsobjekt, till exempel Tilldelad till, Skapad av. |
WorkItemBoardSnapshot | WorkItemBoardSnapshot | (Sammansatt) Tillståndet för varje arbetsobjekt på varje kalenderdatum, inklusive styrelseplats, som används för att generera trendrapporter. En exempelrapport finns i Exempelrapport för kumulativt flödesdiagram (CFD). |
WorkItemLinks | WorkItemLink | Länkarna mellan arbetsobjekt, till exempel Underordnad, Överordnad och Relaterad. Innehåller endast den senaste versionen av länkar, ingen historik. Hyperlänkar ingår inte. |
WorkItemRevisions | WorkItemRevision | Alla historiska arbetsobjektsrevisioner, inklusive den aktuella revisionen. Innehåller inte borttagna arbetsobjekt. |
WorkItemSnapshot | WorkItemSnapshot | (Sammansatt) Tillståndet för varje arbetsobjekt på varje kalenderdatum, som används för att stödja trendrapportering. En exempelrapport finns i Exempelrapport för buggtrender. |
WorkItems | WorkItem | Arbetsobjektens aktuella tillstånd. Används för att stödja statusrapporter. En exempelrapport finns i Samla in underordnade arbetsobjektvärden till en överordnad exempelrapport. |
WorkItemTypeFields | WorkItemTypeField | Egenskaperna för arbetsobjekt för varje typ och process av arbetsobjekt. Används för att skapa rapporter. |
Om ögonblicksbilder
Det finns två entitetsuppsättningar för arbetsspårning av ögonblicksbilder: WorkItemSnapshot
och WorkItemBoardSnapshot
.
En ögonblicksbild innehåller en post med de värden som definierats för ett arbetsobjekt varje dag. Posten skrivs till Analytics en gång om dagen samtidigt varje dag. Du använder ögonblicksbilder när du vill generera en trendrapport. Som standard modelleras alla tabeller för ögonblicksbilder som dagliga faktatabeller för ögonblicksbilder. Om du frågar efter ett tidsintervall får det ett värde för varje dag. Långa tidsintervall resulterar i ett stort antal poster. Om du inte behöver så hög precision kan du använda ögonblicksbilder varje vecka eller till och med varje månad.
Mer information finns i OData-frågeriktlinjer, Använd ögonblicksbilder varje vecka eller månad för trendfrågor som sträcker sig över en lång tidsperiod.
Om arbetsobjektsrevisioner
Varje gång du uppdaterar ett arbetsobjekt skapar systemet en ny revision och registrerar den här åtgärden i System.RevisedDate
fältet, vilket gör det användbart för att ange ett historikfilter. Det ändrade datumet representeras av RevisedDate
egenskaperna (DateTime) och RevisedDateSK
(Int32). Använd surrogatnyckeln för senare datum för bästa prestanda. Den representerar det datum då en revision skapades eller har null för aktiva eller ofullständiga revisioner.
Om du vill ha alla datum sedan inkluderingen {startDate}
lägger du till följande filter i din fråga.
RevisedDateSK eq null or RevisedDateSK gt {startDateSK}
Du använder entitetsuppsättningen WorkItemRevisions
för att läsa in alla revisioner för ett visst arbetsobjekt. Frågan returnerar alla historiska arbetsobjektsrevisioner, inklusive den aktuella revisionen, för de arbetsobjekt som du filtrerar på. Den innehåller inte borttagna arbetsobjekt.
Delade egenskaper för flera entitetstyper
De egenskaper som du kan välja i en analysvy motsvarar vanliga arbetsspårningsfält och väljer Analysegenskaper, till exempel Cykeltidsdagar och Ledtidsdagar. Dessa egenskaper, varav de flesta visas och beskrivs i följande tabell, definieras för följande entitetstyper, om inget annat anges.
WorkItem
WorkItemRevision
WorkItemSnapshot
WorkItemBoardSnapshot
Kommentar
Analytics-tjänsten lagrar inga data för långa textfält som tilldelats HTML- eller RTF-datatypen. Detta inkluderar fälten Beskrivning och Historik . Analytics lagrar inte heller länk- eller bifogade filantal. En fullständig lista över fält som definieras i standardprocessmallarna finns i Index för arbetsobjektfält. Beskrivningar av varje datatyp finns i Frågefält, operatorer och makron.
Alla egenskaper som är associerade med Scrum- och CMMI-processspecifika fält ingår inte i följande tabell. En lista över dessa fält finns i Fältbeskrivningar för standard- och arbetsobjektfält som används i processmallar, Fält som används för att spåra CMMI-arbetsobjekt.
Många egenskaper är datumbaserade eller användarbaserade. De här egenskaperna är associerade med entitetsuppsättningarna CalendarDate och User som beskrivs i Referens för kalenderdatum, Projekt och Användarmetadata.
VisningsnamnProperty name |
Datatyp | BeskrivningReference name |
---|---|---|
Accepterad avMicrosoft_VSTS_CodeReview_AcceptedBy |
UserSK | Namnet på den person som svarade på en kodgranskning. (CMMI-process)Microsoft.VSTS.CodeReview.AcceptedBy |
Godkänt datumAcceptedDate |
Datum/tid | Datum och tid då personen svarade på kodgranskningen. (CMMI-process)Microsoft.VSTS.CodeReview.AcceptedDate |
Aktiverad avActivatedBy ActivatedByUserSK |
UserSK | Namnet på den gruppmedlem som aktiverade eller återaktiverade arbetsobjektet.Microsoft.VSTS.Common.ActivatedBy |
Aktiverat datumActivatedDate |
Datum/tid | Datum och tid då en gruppmedlem aktiverade eller återaktiverade en bugg eller ett arbetsobjekt.Microsoft.VSTS.CodeReview.ActivatedDate |
AktivitetActivity |
String | Den typ av aktivitet som krävs för att utföra en uppgift.Microsoft.VSTS.Common.Activity Den typ av aktivitet eller disciplin som har tilldelats till en aktivitet. Tillåtna värden är: Distribution, Design, Utveckling, Dokumentation, Krav och Testning. (Agile, Scrum och Basic process) Microsoft.VSTS.Common.Activity |
AnalyticsUpdatedDate |
DateTimeOffset | Data och tid då entiteten senast uppdaterades. |
Programtyp | String | Vilken typ av program som intressenterna ska ge feedback om. Standardvärdena är webbprogram, fjärrdator och klientprogram. De giltiga typerna anges i processkonfigurationsfilen för projekt som använder en lokal XML-process. Microsoft_VSTS_Feedback_ApplicationType |
OmrådessökvägAreaPath AreaSK |
String | Grupperar arbetsobjekten i produkt- eller teamområden. Området måste vara en giltig nod i projekthierarkin.System.AreaPath |
Tilldelad till AssignedTo AssignedToUserSK |
UserSK | Namnet på den gruppmedlem som för närvarande äger arbetsobjektet.System.AssignedTo |
Automatiserat test-ID AutomatedTestId |
String | ID:t för testet som automatiserar testfallet.Microsoft.VSTS.TCM.AutomatedTestId |
Automatiserat testnamn AutomatedTestName |
String | Namnet på den gruppmedlem som aktiverade eller återaktiverade arbetsobjektet.Microsoft.VSTS.TCM.AutomatedTestName |
Automatiserad testlagringAutomatedTestStorage |
String | Sammansättningen som innehåller testet som automatiserar testfallet.Microsoft.VSTS.TCM.AutomatedTestStorage |
Automatiserad testtypAutomatedTestType |
String | Den typ av test som automatiserar testfallet.Microsoft.VSTS.TCM.AutomatedTestType |
AutomationsstatusAutomatedStatus |
String | Status för ett testfall med följande godkända värden: Automatiserad, Inte automatiserad eller Planerad. Microsoft.VSTS.TCM.AutomationStatus |
Prioritet för kvarvarande uppgifterBacklogPriority |
Dubbel | Ett nummer som tilldelats av en systembakgrundsprocess som används för att stapla rangordning eller spåra sekvensen av objekt på en kvarvarande eller tavla. (Scrum-process) Microsoft.VSTS.Common.BacklogPriority |
SpärradBlocked |
String | Anger att inget ytterligare arbete kan utföras på arbetsobjektet. Giltiga värden är Ja eller Nej. (CMMI-process)Microsoft.VSTS.CMMI.Blocked |
AffärsvärdeBusinessValue |
Dubbel | En subjektiv måttenhet som samlar in det relativa affärsvärdet för ett produktpost eller en funktion för kvarvarande uppgifter jämfört med andra objekt av samma typ. Ett objekt som tilldelas ett högre tal bör anses ha mer affärsvärde än ett objekt som har tilldelats ett lägre tal. Microsoft.VSTS.Common.BusinessValue |
Ändrad avChangedBy ChangedByUserSK |
UserSK | Namnet på den person som senast ändrade arbetsobjektet.System.ChangedBy |
Ändrat datumChangedDate |
Datum/tid | Datum och tid då arbetsobjektet ändrades.System.ChangedDate |
ChangedDateSK |
Int32 | Det datum då arbetsobjektet ändrades, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen. Används av externa verktyg för att ansluta relaterade entiteter. |
ChangedOn |
Navigering | Navigeringsegenskap till entiteten Date för det datum då arbetsobjektet ändrades i den tidszon som definierats för organisationen. Används ofta för att referera till egenskaper från entiteten Date i groupby -instruktioner. |
Stängd avClosedBy ClosedByUserSK |
UserSK | Namnet på den person som stängde ett arbetsobjekt. Microsoft.VSTS.Common.ClosedBy |
Stängt datumClosedDate ClosedDateSK ClosedOn |
Datum/tid | Datum och tid då ett arbetsobjekt stängdes.Microsoft.VSTS.Common.ClosedDate |
Antal kommentarerCommentCount |
Int32 | Antalet kommentarer som har lagts till i avsnittet Diskussion i arbetsobjektet.System.CommentCount |
EngageradCommitted |
String | Anger om kravet har bekräftats i projektet. Giltiga värden är Ja eller Nej. (CMMI-process)Microsoft.VSTS.CMMI.Committed |
CompletedDateSK |
Int32 | Navigeringsegenskapsdatum som registrerats av Analytics och som lagrar när arbetsobjektet har angett ett arbetsflödestillstånd som är associerat med kategorin Status för slutfört arbetsflöde. |
CompletedOn |
Navigering | Navigeringsegenskap till entiteten Date för det datum då arbetsobjektet angav ett arbetsflödestillstånd som är associerat med kategorin Slutfört arbetsflödestillstånd i den tidszon som definierats för organisationen. Används ofta för att referera till egenskaper från entiteten Date i groupby -instruktioner. |
Slutfört arbeteCompletedWork |
Dubbel | Ett mått på hur mycket arbete som lagts ned på en aktivitet.Microsoft.VSTS.Scheduling.CompletedWork |
Skapad avCreatedBy CreatedByUserSK |
UserSK | Namnet på den person som skapade arbetsobjektet. Microsoft.VSTS.Common.CreatedBy |
Skapat datumCreatedDate CreatedDateSK |
Datum/tid | Det datum då arbetsobjektet skapades, uttryckt i den tidszon som definierats för organisationen. Används ofta för filtrering och för visning. Microsoft.VSTS.Common.CreatedDate |
CreatedDateSK |
Int32 | Det datum då arbetsobjektet skapades, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen. Används av externa verktyg för att ansluta relaterade entiteter. |
CreatedOn |
Navigering | Navigeringsegenskapen till entiteten Date för det datum då arbetsobjektet skapades i den tidszon som definierats för organisationen. Används ofta för att referera till egenskaper från entiteten Date i groupby -instruktioner. |
Dagar för cykeltidCycleTimeDays |
Dubbel | Cykeltiden beräknas från att först ange en statuskategori för Pågående eller Löst till att ange en slutförd tillståndskategori . Mer information finns i widgetar för ledtid och cykeltid. |
DisciplinDiscipline |
String | Den typ av aktivitet eller disciplin som har tilldelats till en aktivitet. Tillåtna värden är: Analys*, Utveckling, Test, Användarutbildning och Användarupplevelse. (CMMI-process) Microsoft.VSTS.Common.Activity |
FörfallodatumDueDate |
Datum/tid | Det prognostiserade förfallodatumet då ett problem eller arbetsobjekt kommer att lösas. (Agil process)Microsoft.VSTS.Scheduling.DueDate |
AnsträngningEffort |
Dubbel | En uppskattning av mängden arbete som ett produktpost för kvarvarande uppgifter (Scrum-process) eller problem (grundläggande process) kräver för att implementera. Microsoft.VSTS.Scheduling.Effort |
AvslutsdatumFinishDate |
Datum/tid | Datum och tid när schemat anger att ett arbetsobjekt ska slutföras.Microsoft.VSTS.Scheduling.FinishDate |
Hittades iFoundIn |
String | Produktversionsnumret, även kallat en revision, där en bugg hittades.Microsoft.VSTS.Build.FoundIn |
InProgress-datum InProgressDate |
Datum/tid | Analys lagrat datum som registrerar datum-tid när ett arbetsobjekt flyttades till ett tillstånd som tillhör kategorin Pågår tillstånd. |
InProgressDateSK |
Int32 | Det datum då arbetsobjektet flyttades till ett tillstånd som tillhör kategorin Pågår tillstånd, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen. Används av externa verktyg för att ansluta relaterade entiteter. |
Integration BuildIntegrationBuild |
String | Det produktversionsnummer som innehåller koden eller åtgärdar ett fel.Microsoft.VSTS.Build.IntegrationBuild |
Är aktuellIsCurrent |
Booleskt | Stöder filtrering av data för att visa den senaste ögonblicksbilden av den filtrerade uppsättningen med arbetsobjekt genom att ange värdet till True .Giltigt för dessa entitetstyper: WorkItemRevision , WorkItemBoardSnapshot och BoardLocation . |
Är sista revisionen av dagenIsLastRevisionOfDay |
Booleskt | Anger att ögonblicksbilden representerar den sista revisionen av dagen när den är inställd på True . |
Är den senaste revisionen av periodenIsLastRevisionOfPeriod |
Booleskt | Anger att ögonblicksbilden representerar den sista revisionen av perioden när den är inställd på True . |
ProblemIssue |
String | Anger att det delade steget är associerat med ett förväntat resultat. Tillåtna värden är Ja och Nej. Microsoft.VSTS.Common.Issue |
LedtidsdagarLeadTimeDays |
Dubbel | Ledtiden beräknas från skapande av arbetsobjekt eller inmatning av en föreslagen tillståndskategori till en slutförd tillståndskategori . Mer information finns i widgetar för ledtid och cykeltid. |
Ursprunglig uppskattningOriginalEstimate |
Dubbel | Ett mått på hur mycket arbete som krävs för att slutföra en uppgift. Microsoft.VSTS.Scheduling.OriginalEstimate |
Överordnat arbetsobjekt-ID ParentWorkItemId |
Int32 | Det unika ID som identifierar arbetsobjektet som är länkat till som överordnat. Användbart för att generera sammanslagningsrapporter. Fältet Överordnad är tillgängligt från Azure DevOps Server 2020 och senare versioner. Giltigt för dessa entitetstyper: WorkItemRevision och WorkItem . System.Parent |
PrioritetPriority |
Int32 | Ett ämnesvärde för felet, problemet, uppgiften eller testfallet när det gäller verksamheten. Värdena är: - 1, 2 eller 3. Microsoft.VSTS.Common.Priority |
ProjektnamnProjectName |
Navigering | Namnet på det projekt som arbetsobjektet tillhör. Mer information finns i Referens för kalenderdatum, Projekt och Användarmetadata, Projektegenskaper.System.TeamProject |
ProjectSK |
GUID | GUID som tilldelats det projekt som arbetsobjektet tillhör. |
Klassificering Reason |
String | Antalet stjärnor som ett objekt får från en granskare i ett stjärnbaserat rankningssystem. (Feedbacksvar) Talet lagras i systemet och skrivs enligt följande:- 0 - Not Rated, 1 - Poor, 2 - Fair, 3 - Good, 4 - Very Good, and 5 - Excellent. Giltigt för dessa entitetstyper: WorkItemRevision och WorkItem .Microsoft.VSTS.Common.Rating |
Anledning Reason |
String | Anledningen till att arbetsobjektet är i aktuellt tillstånd. Varje övergång från ett arbetsflödestillstånd till ett annat associeras med en motsvarande orsak. System.Reason |
Återstående arbete RemainingWork |
Dubbel | Ett mått på mängden arbete som återstår för att slutföra en uppgift.Microsoft.VSTS.Scheduling.RemainingWork |
Löst av ResolvedBy ResolvedByUserSK |
UserSK | Namnet på den gruppmedlem som löste buggen eller användarberättelsen.Microsoft.VSTS.Common.ResolvedBy |
Löst datum ResolvedDate |
Datum/tid | Datum och tid då felet eller användarberättelsen löstes. Microsoft.VSTS.Common.ResolvedDate |
ResolvedDateSK |
Int32 | Det datum då arbetsobjektet löstes, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen. Används av externa verktyg för att ansluta relaterade entiteter. |
ResolvedOn |
Navigering | Navigeringsegenskapen till entiteten Date för det datum då arbetsobjektet löstes i den tidszon som definierats för organisationen. Används ofta för att referera till egenskaper från entiteten Date i groupby -instruktioner. |
Löst orsakResolvedReason |
String | Anledningen till att felet löstes (till exempel åtgärdades det).Microsoft.VSTS.Common.ResolvedReason |
RevisionRevision |
Int32 | Ett tal som har tilldelats den historiska revisionen av ett arbetsobjekt.System.Rev |
Reviderat datumRevisedDate |
Datum/tid | Datum och tid då ett arbetsobjekt ändrades eller uppdaterades. |
RevisedDateSK |
Int32 | Det datum då arbetsobjektet ändrades, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen. Används av externa verktyg för att ansluta relaterade entiteter. |
RevisedOn |
Navigering | Navigeringsegenskapen till entiteten Date för det datum då arbetsobjektet ändrades i den tidszon som definierats för organisationen. Används ofta för att referera till egenskaper från entiteten Date i groupby -instruktioner. |
Risk Risk |
Dubbel | Ett subjektivt omdöme av den relativa osäkerheten om att användarberättelsen har slutförts. Giltiga värden är: 1 – Hög, 2 – Medel och 3 – Låg. Microsoft.VSTS.Common.Risk |
AllvarlighetsgradSeverity |
Dubbel | Ett subjektivt omdöme om effekten av en bugg, ett problem eller en risk för projektet. Giltiga värden är: 1 – Kritisk, 2 – Hög, 3 – Medel och 4 – Låg. Microsoft.VSTS.Common.Severity |
Storlek Size |
Dubbel | En uppskattning för den mängd arbete som ett krav (CMMI-process) kräver för att implementera. Microsoft.VSTS.Scheduling.Size |
Stackrankning StackRank |
Dubbel | Ett nummer som tilldelats av en systembakgrundsprocess som används för att stapla rangordning eller spåra sekvensen av objekt på en kvarvarande eller tavla. (Agile-, Scrum- och Basic-processer) Microsoft.VSTS.Common.StackRank |
StartdatumStartDate |
Datum/tid | Datum och tid som tilldelats till ett arbetsobjekt för arbete som ska startas. Microsoft.VSTS.Scheduling.StartDate |
Status State |
String | Arbetsobjektets aktuella tillstånd. Giltiga värden för tillstånd är specifika för varje typ av arbetsobjekt och anpassningar som görs i det.System.State |
Tillståndskategori StateCategory |
String | Tillståndskategorier avgör hur Azure Boards och välj instrumentpanelswidgetar hanterar varje arbetsflödestillstånd. De tillståndskategorier som används är: Föreslagen, Pågår, Löst, Borttagen och Slutförd. Mer information finns i Använda arbetsflödestillstånd och tillståndskategorier. Gäller endast för entitetstypen WorkItemRevision . |
Tillståndsändringsdatum StateChangeDate |
Datum/tid | Datum och tid då värdet för fältet Tillstånd ändrades. Microsoft.VSTS.Common.StateChangeDate |
StateChangeSK |
Int32 | Det datum då tillståndet för ett arbetsobjekt ändrades, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen. Används av externa verktyg för att ansluta relaterade entiteter. |
StateChangeOn |
Navigering | Navigeringsegenskapen till entiteten Date för det datum då tillståndet för ett arbetsobjekt ändrades i den tidszon som definierats för organisationen. Används ofta för att referera till egenskaper från entiteten Date i groupby -instruktioner. |
Berättelsepunkter StoryPoints |
Dubbel | En uppskattning av mängden arbete som en användarberättelse (agil process) kräver för att implementera, vanligtvis aggregerad som en summa. Microsoft.VSTS.Scheduling.StoryPoints |
TaggarTagNames |
String | Semikolonavgränsad lista över taggar som tilldelats till ett eller flera arbetsobjekt i syfte att filtrera eller fråga.System.Tags |
Måldatum TargetDate |
Datum/tid | Det prognostiserade förfallodatumet då ett problem eller annat arbetsobjekt ska lösas eller slutföras.Microsoft.VSTS.Scheduling.TargetDate |
Typ av testsvit | String | Anger typ av testpaket. Giltiga värden är: Frågebaserad, Kravbaserad och Statisk.Microsoft_VSTS_TCM_TestSuiteType |
Typ-ID för Test Suite | Int64 | Ett systemtilldelat nummer som motsvarar kategorin testpaket och som endast gäller för testsviter. Tilldelade värden är: 1 (statisk), 2 (frågebaserad) och 3 (kravbaserad).Microsoft_VSTS_TCM_TestSuiteTypeId |
Tidskritiskhet TimeCriticality |
Dubbel | En subjektiv måttenhet som fångar upp hur affärsvärdet minskar med tiden. Högre värden anger att eposet eller funktionen är mer tidskritisk än objekt med lägre värden. Microsoft.VSTS.Common.TimeCriticality |
Rubrik Title |
String | En kort beskrivning som sammanfattar vad arbetsobjektet är och hjälper teammedlemmar att skilja det från andra arbetsobjekt i en lista. System.Title |
Värdeområde ValueArea |
String | Området med kundvärde som hanteras av det episka objektet, funktionen eller kvarvarande uppgifter. Värden är: Arkitektur eller Företag.Microsoft.VSTS.Common.ValueArea |
VattenstämpelWatermark |
String | Ett systemhanterat fält som ökar med ändringar som gjorts i ett arbetsobjekt. Giltigt för dessa entitetstyper: WorkItemRevision och WorkItem .System.Watermark |
Arbetsobjekt-IDWorkItemId |
Int32 | Den unika identifierare som är tilldelad till ett arbetsobjekt. Arbetsobjekts-ID:t är unika för alla projekt och inom en organisation eller projektsamling.System.Id |
WorkItemRevisionSK |
Int32 | Den unika analyticsnyckeln för arbetsobjektsrevisionen som används av externa verktyg för att ansluta relaterade entiteter. |
Typ av arbetsobjekt WorkItemType |
String | Namnet på arbetsobjekttypen. Typer av arbetsobjekt definieras baserat på den process som användes när du skapade projektet. Mer information finns i Om processer och processmallar. System.WorkItemType |
Navigeringsegenskaper
Navigeringsegenskaper i OData är referensattributen för en entitet som pekar på en annan entitet. Följande tabell innehåller en sammanfattning av navigeringsegenskaperna, deras referensbegränsningar och de entitetstyper som de är giltiga för.
Visningsnamn | Namn Referensbegränsning och -egenskap |
Giltigt för entitetstyper |
---|---|---|
ChangedOn ChangedDateSK , DateSK |
WorkItemRevision , , WorkItemSnapshot WorkItemBoardSnapshot |
|
ClosedOn ClosedDateSK , DateSK |
WorkItemRevision , , WorkItemSnapshot WorkItemBoardSnapshot |
|
CreatedOn CreatedDateSK , DateSK |
WorkItemRevision , , WorkItemSnapshot WorkItemBoardSnapshot |
|
ResolvedOn ResolvedDateSK , DateSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
|
StateChangeOn StateChangeDateSK , DateSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
|
InProgressOn InProgressDateSK , DateSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
|
CompletedOn CompletedDateSK , DateSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
|
ChangedOn ChangedDateSK , DateSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
|
RevisedOn RevisedDateSK , DateSK |
WorkItemRevision , WorkItemSnapshot |
|
Date DateSK , DateSK |
WorkItemRevision , , WorkItemSnapshot WorkItemBoardSnapshot |
|
Områden | Area AreaSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
BoardLocation | WorkItemRevision , , WorkItem WorkItemBoardSnapshot |
|
Iterationer | Iteration IterationSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
Tilldelad till | AssignedTo AssignedToUserSK , UserSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
Ändrad av | ChangedBy ChangedByUserSK , UserSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
Skapad av | CreatedBy CreatedByUserSK , UserSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
Aktiverad av | ActivatedBy ActivatedByUserSK , UserSK |
WorkItemRevision ,WorkItem , WorkItemSnapshot , WorkItemBoardSnapshot |
Stängd av | ClosedBy ClosedBySK , UserSK |
WorkItemRevision , WorkItem , , WorkItemSnapshot WorkItemBoardSnapshot |
ResolvedBy | ResolvedBy ResolvedByUserSK , UserSK |
WorkItemRevision , , WorkItemSnapshot WorkItemBoardSnapshot |
Teams | Area , BoardLocation , Iteration , WorkItemRevision , , , WorkItemSnapshot WorkItemBoardSnapshot |
|
Taggar | WorkItem , , WorkItemRevision WorkItemBoardSnapshot |
|
Projekt | Project ProjectSK , ProjectSK |
Tag , WorkItemBoardSnapshot , WorkItemLink , WorkItemRevision , WorkItemSnapshot , , , WorkItemTypeField |
Processer | WorkItemRevision , , WorkItem WorkItemSnapshot |
|
Revideringar | WorkItem |
|
Länkar | WorkItem |
|
Barn | WorkItem |
|
Överordnad | WorkItem |
|
Efterkommande | WorkItem |
|
WorkItem | WorkItemId |
WorkItemRevision |
Förutsäga funktioner
Följande två funktioner stöds för Entiteten WorkItem . Dessa funktioner används för att stödja prediktiva trender i utvalda inbyggda rapporter och widgetar i Analytics.
PredictTags
Predict
BoardLocation och WorkItemBoardSnapshot
Egenskaper som anges och beskrivs i följande tabell definieras för följande entitetstyper, såvida inte specifikt anges. Med de här fälten kan du filtrera arbetsobjektsdata baserat på statusen för ett arbetsobjekt i ett teams brädkolumn, simbana eller kvarvarande uppgifter.
BoardLocation
WorkItemBoardSnapshot
Ett exempel som frågar entitetsuppsättningen WorkItemBoardSnapshot
finns i Exempelrapporten för kumulativt flödesdiagram (CFD).
VisningsnamnProperty name |
Datatyp | BeskrivningReference name |
---|---|---|
Styrelse-ID BoardId |
GUID | Det unika GUID som tilldelats en tavla. Varje team är associerat med en eller flera tavlor. |
Referensnamn för brädkategoriBoardCategoryReferenceName |
String | Namnet som tilldelats kategorin för arbetsobjekttyper som används för att fylla i en tavla. Till exempel är produktloggkortet associerat med kategorin Krav. Mer information finns i Anpassa dina kvarvarande uppgifter eller tavlor (arvsprocess). |
Brädnamn BoardName |
String | Namnet som tilldelats styrelsen. Till exempel Stories, Backlog Items, Features och Epics. |
BrädnivåBoardLevel |
Int32 | Numret som tilldelats till tavlan baserat på var det finns i hierarkin för tavlor. |
Typ av kvarvarande uppgifter BacklogType |
String | Namnet på typen av kvarvarande uppgifter. Till exempel Iteration, Krav eller Portfölj. |
KolumnnamnColumnName |
String | Namnet på den brädkolumn som ett arbetsobjekt för närvarande har tilldelats, till exempel Aktiv, Stängd, Bekräftad, Klar eller annan anpassad kolumnetikett. System.BoardColumn |
KolumnordningColumnOrder |
Int32 | Det nummer som tilldelats till brädkolumnen när det gäller dess sekvens inom brädet. |
Färdig Done |
Enumerated | Anger platsen för delad kolumn. Giltiga värden visas nedan för BoardColumnSplit. |
Gräns för kolumnobjektColumnItemLimit |
Int32 | Numret som tilldelats till brädkolumnen när det gäller dess sekvens. |
Är bräde synligt IsBoardVisible |
Booleskt | Anger om teamet har valt att göra en styrelse synlig eller inte. |
Är kolumndelningIsColumnSplit |
Booleskt | Anger om en kolumn har delats upp i kolumnerna Doing and Done enligt beskrivningen i Dela kolumner på tavlan för att visa pågående arbete. |
Är aktuell IsCurrent |
Booleskt | Egenskap som stöder filtrering av data för att visa den senaste ögonblicksbilden av den filtrerade uppsättningen med arbetsobjekt genom att ange värdet till True . |
Är standardfil IsDefaultLane |
Booleskt | Egenskap som anger att arbetsobjektet har tilldelats standardsimbana (True) eller inte (False). |
Är klar IsDone |
Booleskt | Den aktuella tilldelningen av arbetsobjektet till Doing (False) eller Done (True) i en kolumn. Tilldelas endast när delade kolumner är aktiverade för en brädkolumn. System.BoardColumnDone |
Fil-ID LaneId |
GUID | Det unika GUID som tilldelats en bräda simbana. Varje lag kan lägga till en eller flera simbanor på en bräda. Mer information om simbanor finns i Påskynda teamets arbete med hjälp av simbanor i din styrelse. |
FilnamnLaneName |
String | Namnet som tilldelats brädans simbana.System.BoardLane |
Lane OrderLaneOrder |
Int32 | Numret som tilldelats till brädans simbana när det gäller dess sekvens. |
BoardColumnSplit uppräknade medlemmar
I följande tabell visas medlemsnamnen för den BoardColumnSplit
uppräknade typen, som kan användas för att filtrera på arbetsobjekt i kolumnen Doing or Done board (Gör eller Klar ).
Medlemsnamn | Värde | Visningsnamn |
---|---|---|
Doing |
0 | Gör |
Done |
1 | Klart |
Unknown |
2 | Okänd (inte delad) |
Mer information om styrelsekolumner för ett team finns i följande artiklar:
- Lägga till kolumner i ditt bräde för att hantera arbetsflödet
- Dela upp kolumner på tavlan för att visa pågående arbete
Områden
Följande egenskaper är giltiga för entitetsuppsättningen Områden , som är associerad med fältet Områdessökväg . Surrogatnycklar som är associerade med Område inkluderar AreaSK
och ProjectSK
. Du kan använda dessa egenskaper för att filtrera eller rapportera arbetsspårningsdata baserat på tilldelningar av områdessökväg.
Visningsnamn | Namn | Datatyp | Beskrivning |
---|---|---|---|
AnalyticsUpdatedDate |
Datum/tid | Vattenstämpel som anger den senaste gången Analytics-data uppdaterades. | |
Number |
Int32 | Ett heltalsvärde som tilldelats en nod för områdessökväg när den skapas. | |
Djup | Depth |
Int32 | Nivån där områdessökvägen definieras baserat på dess djup från rotnivån. |
Områdes-ID | AreaId |
GUID | Unik identifierare tilldelad till en områdessökväg när den skapas. |
Områdesnivå 1 till och med Områdesnivå 14 |
AreaLevel1 genomAreaLevel14 |
String | Namnet som är associerat med nodnivån för en områdessökväg. Upp till 14 kapslade nivåer stöds. Till exempel motsvarar områdesnivå 1 alltid rotnoden och projektnamnet. |
Områdesnamn | AreaName |
String | Namn som definierats för områdessökvägen när den skapas. |
Områdessökväg | AreaPath |
String | Fullständig sökväg för områdessökvägen som börjar med rotnoden. |
Viktigt!
- Om du tar bort områdessökvägar eller konfigurerar om iterationssökvägar kan du förlora oåterkalleliga data. Till exempel visar widgetdiagram för bränning och bränning, sprintbrännskada och hastighetsdiagram för team med ändrade områdessökvägar inte korrekta data. Historiska trenddiagram refererar till områdessökvägen och iterationssökvägen som de definierades vid tidpunkten för varje arbetsobjekt. När du har tagit bort kan du inte hämta historiska data för dessa sökvägar.
- Du kan bara ta bort områdes- och iterationssökvägar som inte längre används av några arbetsobjekt.
Navigeringsegenskaper för entitetstypen Område och Entitetsuppsättningen Områden inkluderar Project
och Teams
.
Mer information om områdessökvägar finns i följande artiklar:
- Om områdessökvägar och iterationssökvägar (sprint)
- Definiera områdessökvägar och tilldela till ett team
Iterationer
Följande egenskaper är giltiga för iterationsentitetsuppsättningen , som är associerad med fältet Iterationssökväg. Surrogatnycklar som är associerade med Iteration inkluderar IterationSK
och ProjectSK
. Du kan använda dessa egenskaper för att filtrera eller rapportera arbetsspårningsdata baserat på tilldelningar av iterationssökväg.
Visningsnamn | Namn | Datatyp | Beskrivning |
---|---|---|---|
AnalyticsUpdatedDate |
Datum/tid | Vattenstämpel som anger den senaste gången Analytics-data uppdaterades. | |
Number |
Int32 | Ett heltalsvärde som tilldelats en iterationssökvägsnod när den skapas. | |
Djup | Depth |
Int32 | Den nivå där iterationssökvägen definieras baserat på dess djup från rotnivån. |
Slutdatum | EndDate |
Datum/tid | Slutdatum som definierats för iterationssökvägen. |
IsEnded | IsEnded |
Booleskt | När värdet är True anger det att slutdatumet för iterationssökvägen är tidigare. |
Iterations-ID | IterationId |
GUID | Unik identifierare tilldelad till en iterationssökväg när den skapas. |
Iterationsnivå 1 till och med Iterationsnivå 14 |
IterationLevel1 genomIterationLevel14 |
String | Namnet som är associerat med nodnivån för en iterationssökväg. Upp till 14 kapslade nivåer stöds. Iterationsnivå 1 motsvarar till exempel alltid rotnoden och projektnamnet. |
Iterationsnamn | IterationName |
String | Namn som definierats för en iterationssökväg när den skapas. |
Iterationssökväg | IterationPath |
String | Fullständig sökväg för iterationssökvägen som börjar med rotnoden. Iterationen måste vara en giltig nod i projekthierarkin. System.IterationPath |
Startdatum | StartDate |
Datum/tid | Startdatum som definierats för iterationssökvägen. |
Viktigt!
- Om du tar bort områdessökvägar eller konfigurerar om iterationssökvägar kan du förlora oåterkalleliga data. Till exempel visar widgetdiagram för bränning och bränning, sprintbrännskada och hastighetsdiagram för team med ändrade områdessökvägar inte korrekta data. Historiska trenddiagram refererar till områdessökvägen och iterationssökvägen som de definierades vid tidpunkten för varje arbetsobjekt. När du har tagit bort kan du inte hämta historiska data för dessa sökvägar.
- Du kan bara ta bort områdes- och iterationssökvägar som inte längre används av några arbetsobjekt.
Navigeringsegenskaper för iterationsentitetstypen och iterationsentitetsuppsättningen inkluderar Project
och Teams
.
Mer information om iterationssökvägar finns i följande artiklar:
- Om områdessökvägar och iterationssökvägar (sprint)
- Definiera iterationssökvägar (sprintar) och konfigurera teamiterationer
Processer
Följande egenskaper är giltiga för entitetstypen Process och entitetsuppsättningen Processer . Surrogatnycklar som är associerade med Process inkluderar ProcessSK
, ProjectSK
och TeamSK
. Du kan använda dessa egenskaper för att filtrera eller rapportera arbetsspårningsdata baserat på arbetsobjekttyper som används av ett projekt eller ett team.
Kommentar
Entitetsuppsättningen Processentitetstyp och Processer stöds med versionerna v-2.0, v3.0-preview och v4.0-preview av Analytics.
Du kan använda de här egenskaperna för att filtrera på arbetsspårningsdata baserat på en kvarvarande nivå
Visningsnamn | Namn | Datatyp | Beskrivning |
---|---|---|---|
AnalyticsUpdatedDate |
Datum/tid | Vattenstämpel som anger den senaste gången Analytics-data uppdaterades. | |
ProjectSK |
GUID | Projektnyckel som är associerad med processen. | |
TeamSK |
GUID | Teamnyckel som är associerad med processen. | |
Referensnamn för kvarvarande uppgifter | BacklogCategoryReferenceName |
String | Det kategorireferensnamn som tilldelats till kvarvarande uppgifter som är associerade med arbetsobjekttypen. Exempel är Microsoft.EpicCategory , Microsoft.FeatureCategory , Microsoft.RequirementCategory , . Microsoft.TaskCategory |
Namn på kvarvarande uppgifter | BacklogName |
Booleskt | Referensnamnet som tilldelats till kvarvarande uppgifter som är associerade med arbetsobjekttypen |
Typ av kvarvarande uppgifter | BacklogType |
GUID | Unik identifierare tilldelad till en iterationssökväg när den skapas. |
Nivå för kvarvarande uppgifter | BacklogLevel |
String | Anger den kvarvarande nivån som är associerad med arbetsobjekttypen. Om arbetsobjekttypen inte är associerad med en kvarvarande nivå är null värdet som returneras . |
Typ av arbetsobjekt | WorkItemType |
String | Namn som definierats för en typ av arbetsobjekt. |
Har kvarvarande uppgifter | HasBacklog |
String | Anger om arbetsobjekttypen tillhör en kvarvarande uppgift. |
Är dold typ | IsHiddenType |
Booleskt | Anger om arbetsobjekttypen har inaktiverats. |
Är feltyp | IsBugType |
Booleskt | Anger om arbetsobjekttypen tillhör kategorin Bugg. |
Tas bort | IsDeleted |
Booleskt | Anger om arbetsobjekttypen har tagits bort. |
Mer information om kvarvarande processer och typer av arbetsobjekt finns i följande artiklar:
- Skapa och hantera ärvda processer
- Lägga till och hantera typer av arbetsobjekt
- Anpassa kvarvarande uppgifter eller tavlor (arvsprocess)
Anpassade typer av arbetsobjekt och anpassade eftersläpningskategorier
Data för anpassade typer av arbetsobjekt läggs automatiskt till i Analytics-tjänsten.
En anpassad kategori skapas när en anpassad arbetsobjekttyp och kvarvarande uppgifter definieras. Custom_
läggs till i kategorin GUID. Till exempel tilldelas ett GUID till den anpassade kategorin för portföljens anpassade arbetsobjekttyp med en portföljeftersläpning, till exempel Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000
.
Taggar
Följande egenskaper är giltiga för entitetsuppsättningen Taggar . Surrogatnycklar som är associerade med Tagg inkluderar TagSK
och ProjectSK
. Navigeringsegenskaper inkluderar Project
och dess referensvillkor ProjectSK
. Mer information om hur du använder taggar finns i Lägga till arbetsobjekttaggar för att kategorisera och filtrera listor och tavlor.
Du kan använda de här egenskaperna för att filtrera eller rapportera arbetsspårningsdata.
Visningsnamn | Namn | Datatyp | Beskrivning |
---|---|---|---|
Tagg-ID | TagId |
GUID | Det unika ID som tilldelats taggen när den skapas. |
Taggnamn | TagName |
String | Taggnamnet. |
Teams
Följande egenskaper är giltiga för teamentitetstypen och Teams-entitetsuppsättningen. Surrogatnycklar som är associerade med Team include TeamSK
och ProjectSK
. Du kan använda dessa egenskaper för att filtrera eller rapportera arbetsspårningsdata baserat på teamtilldelningar. Information om hur du använder och lägger till team finns i Om team och agila verktyg och Skapa eller lägga till ett team.
Visningsnamn | Namn | Datatyp | Beskrivning |
---|---|---|---|
AnalyticsUpdatedDate |
Datum/tid | Vattenstämpel som anger den senaste gången Analytics-data uppdaterades. | |
Team-ID | TeamId |
GUID | Det unika ID som tilldelades teamet när det skapades. |
Gruppnamn | TeamName |
String | Teamets namn. |
Navigeringsegenskaperna för Teams-entitetsuppsättningen är Projects
, Areas
och Iterations
.
WorkItemLinks
Följande egenskaper är giltiga för entitetsuppsättningen WorkItemLinks . Egenskapens referens surrogatnyckel är WorkItemLinkSK
.
Fråga WorkItemLinks om du vill rapportera överordnad/underordnad , relaterad, föregående/efterföljande eller andra länktyper.
Visningsnamn | Namn | Datatyp | Beskrivning |
---|---|---|---|
AnalyticsUpdatedDate |
Datum/tid | Vattenstämpel som anger den senaste gången Analytics-data uppdaterades. | |
WorkItemLinkSK |
Int32 | Surrogatnyckeln som tilldelats entiteten WorkItemLink . |
|
Skapat datum | CreatedDate |
GUID | Datum då länken skapades. |
Kommentar | Comment |
String | Kommentaren lades till när länken skapades. |
Borttaget datum | DeletedDate |
String | Datum då länken togs bort. |
Länktyp-ID | LinkTypeId |
Int32 | Det ID som tilldelats målarbetsobjektet som är länkat till. |
Namn på länktyp | LinkTypeName |
String | Det egna namn som tilldelats länktypen. |
Referensnamn för länktyp | LinkTypeReferenceName |
String | Referensnamnet som tilldelats länktypen. |
Länktypen är acyklisk | LinkTypeIsAcyclic |
Booleskt | Värdet för länktypsattributet som anger länktypen tillåter cirkulära relationer när värdet är inställt på Sant. Till exempel begränsar trädtypslänkar cirkulära relationer. |
Länktypen är riktning | LinkTypeIsDirectional |
Booleskt | Värdet för länktypsattributet som anger att länktypen är riktningsbaserad. Riktningslänktyper definieras i par med en framåt- och omvänd komponent. |
Källarbetsobjekt-ID | SourceWorkItemId |
Int32 | Det ID som tilldelats källarbetsobjektet som är länkat till. |
Målarbetsobjekt-ID | TargetWorkItemId |
Int32 | Det ID som tilldelats målarbetsobjektet som är länkat till. |
Navigeringsegenskaper för entitetstypen WorkItemLink är Projects
, SourceWorkItem
och TargetWorkItem
.
Mer information om länkar och länktyper finns i följande artiklar:
- Använda länkar för att visa beroenden och spåra relaterat arbete
- Referensguide för länktyper som används i Azure DevOps
WorkItemTypeFields
Följande egenskaper är giltiga för entitetsuppsättningen WorkItemTypeFields . Egenskapsreferensnycklarna är FieldName
, ProjectSK
och WorkItemType
.
Visningsnamn | Namn | Datatyp | Beskrivning |
---|---|---|---|
Fältnamn | FieldName |
String | Eget namn som tilldelats ett fält av systemet eller när det skapas. |
Fältreferensnamn | FieldReferenceName |
String | Referensnamn som tilldelats ett fält av systemet eller när ett anpassat fält skapas. |
Fälttyp | FieldType |
String | Datatyp tilldelad till ett fält. |
Typ av arbetsobjekt | WorkItemType |
String | Namn på arbetsobjekttyper som ett fält har definierats för. |
Bland navigeringsegenskaperna finns Project
.
Ett index över alla fält som definierats för ett projekt finns i Fältbeskrivningar för arbetsobjektfält. Mer information finns i följande artiklar:
Anpassade egenskaper
Anpassade fält läggs automatiskt till i Analytics-tjänsten som en anpassad egenskap. Custom_
eller Custom.
läggs till i egenskapsnamnet. Kontrollera samlingens metadata enligt beskrivningen i Skapa OData-frågor för Analys, URL-komponenter för att fråga efter metadata. I följande exempel finns metadatasyntaxen för det anpassade fältet Riskmöjlighet.
<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>