Share via

Metadatareferens för Azure Boards Analytics

  • Artikel

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:

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, Teameller 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, TestResultsDailyTestSuite 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.
Datum 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 Kanban-styrelsens cellplatser, som identifieras av brädkolumn, simbana och delning, innehåller historiska styrelseinställningar. En beskrivning av varje Kanban-brädfält finns i fälten Arbetsflöde och Kanban-anslagstavlan.
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.
Team 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 Kanban-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.

Visningsnamn
Property name		 Datatyp Beskrivning
Reference name
Accepterad av
Microsoft_VSTS_CodeReview_AcceptedBy		 UserSK Namnet på den person som svarade på en kodgranskning. (CMMI-process)
Microsoft.VSTS.CodeReview.AcceptedBy
Godkänt datum
AcceptedDate		 Datum/tid Datum och tid då personen svarade på kodgranskningen. (CMMI-process)
Microsoft.VSTS.CodeReview.AcceptedDate
Aktiverad av
ActivatedBy
ActivatedByUserSK		 UserSK Namnet på den gruppmedlem som aktiverade eller återaktiverade arbetsobjektet.
Microsoft.VSTS.Common.ActivatedBy
Aktiverat datum
ActivatedDate		 Datum/tid Datum och tid då en gruppmedlem aktiverade eller återaktiverade en bugg eller ett arbetsobjekt.
Microsoft.VSTS.CodeReview.ActivatedDate
Aktivitet
Activity		 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äg
AreaPath
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 testlagring
AutomatedTestStorage		 String Sammansättningen som innehåller testet som automatiserar testfallet.
Microsoft.VSTS.TCM.AutomatedTestStorage
Automatiserad testtyp
AutomatedTestType		 String Den typ av test som automatiserar testfallet.
Microsoft.VSTS.TCM.AutomatedTestType
Automationsstatus
AutomatedStatus		 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 uppgifter
BacklogPriority		 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ärrad
Blocked		 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ärde
BusinessValue		 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 av
ChangedBy
ChangedByUserSK		 UserSK Namnet på den person som senast ändrade arbetsobjektet.
System.ChangedBy
Ändrat datum
ChangedDate		 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 av
ClosedBy
ClosedByUserSK		 UserSK Namnet på den person som stängde ett arbetsobjekt.
Microsoft.VSTS.Common.ClosedBy
Stängt datum
ClosedDate
ClosedDateSK
ClosedOn		 Datum/tid Datum och tid då ett arbetsobjekt stängdes.
Microsoft.VSTS.Common.ClosedDate
Antal kommentarer
CommentCount		 Int32 Antalet kommentarer som har lagts till i avsnittet Diskussion i arbetsobjektet.
System.CommentCount
Begått
Committed		 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åndsom ä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 arbete
CompletedWork		 Dubbel Ett mått på hur mycket arbete som lagts ned på en aktivitet.
Microsoft.VSTS.Scheduling.CompletedWork
Skapad av
CreatedBy
CreatedByUserSK		 UserSK Namnet på den person som skapade arbetsobjektet.
Microsoft.VSTS.Common.CreatedBy
Skapat datum
CreatedDate
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 cykeltid
CycleTimeDays		 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.
Disciplin
Discipline		 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örfallodatum
DueDate		 Datum/tid Det prognostiserade förfallodatumet då ett problem eller arbetsobjekt kommer att lösas. (Agil process)
Microsoft.VSTS.Scheduling.DueDate
Ansträngning
Effort		 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
Avslutsdatum
FinishDate		 Datum/tid Datum och tid när schemat anger att ett arbetsobjekt ska slutföras.
Microsoft.VSTS.Scheduling.FinishDate
Hittades i
FoundIn		 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 Build
IntegrationBuild		 String Det produktversionsnummer som innehåller koden eller åtgärdar ett fel.
Microsoft.VSTS.Build.IntegrationBuild
Är aktuell
IsCurrent		 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, WorkItemBoardSnapshotoch BoardLocation.
Är sista revisionen av dagen
IsLastRevisionOfDay		 Booleskt Anger att ögonblicksbilden representerar den sista revisionen av dagen när den är inställd på True.
Är den senaste revisionen av perioden
IsLastRevisionOfPeriod		 Booleskt Anger att ögonblicksbilden representerar den sista revisionen av perioden när den är inställd på True.
Problem
Issue		 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
Ledtidsdagar
LeadTimeDays		 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 uppskattning
OriginalEstimate		 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
Prioritet
Priority		 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
Projektnamn
ProjectName		 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.
Betyg
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 orsak
ResolvedReason		 String Anledningen till att felet löstes (till exempel åtgärdades det).
Microsoft.VSTS.Common.ResolvedReason
Översyn
Revision		 Int32 Ett tal som har tilldelats den historiska revisionen av ett arbetsobjekt.
System.Rev
Reviderat datum
RevisedDate		 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
Allvarlighetsgrad
Severity		 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
Startdatum
StartDate		 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
Taggar
TagNames		 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ämpel
Watermark		 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-ID
WorkItemId		 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 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
Team 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
Ättlingar 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 Kanban-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).

Visningsnamn
Property name		 Datatyp Beskrivning
Reference name
Styrelse-ID
BoardId		 GUID Det unika GUID som tilldelats en Kanban-styrelse. Varje team är associerat med en eller flera Kanban-tavlor.
Referensnamn för brädkategori
BoardCategoryReferenceName		 String Namnet som tilldelats kategorin för arbetsobjekttyper som används för att fylla i en Kanban-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 Kanban-tavlan. Till exempel Stories, Backlog Items, Features och Epics.
Brädnivå
BoardLevel		 Int32 Numret som tilldelats Kanban-tavlan baserat på var det finns i hierarkin för Kanban-tavlor.
Typ av kvarvarande uppgifter
BacklogType		 String Namnet på typen av kvarvarande uppgifter. Till exempel Iteration, Krav eller Portfölj.
Kolumnnamn
ColumnName		 String Namnet på den Kanban-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
Kolumnordning
ColumnOrder		 Int32 Numret som tilldelats kolumnen Kanban board i termer av dess sekvens inom Kanban-tavlan.
Gjort
Done		 Enumerated Anger platsen för delad kolumn. Giltiga värden visas nedan för BoardColumnSplit.
Gräns för kolumnobjekt
ColumnItemLimit		 Int32 Numret som tilldelats kolumnen Kanban board 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 kolumndelning
IsColumnSplit		 Booleskt Anger om en kolumn har delats upp i kolumnerna Doing and Done enligt beskrivningen i Dela kolumner på din Kanban-tavla 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 Kanban-kolumn. Tilldelas endast när delade kolumner är aktiverade för en Kanban-brädkolumn.
System.BoardColumnDone
Fil-ID
LaneId		 GUID Det unika GUID som tilldelats en Kanban board simbana. Varje lag kan lägga till en eller flera simbanor till en Kanban-bräda. Mer information om simbanor finns i Påskynda teamets arbete med hjälp av simbanor i kanbanbrädan.
Filnamn
LaneName		 String Namnet som tilldelats Kanban-styrelsens simbana.
System.BoardLane
Lane Order
LaneOrder		 Int32 Numret som tilldelats kanbanbrädet 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:

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 Name (Name) 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 Genom
AreaLevel14		 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 det orsaka dataförlust och kan inte återställas. Till exempel visar brännings- eller bränningswidgetdiagram, sprintbrännskada och hastighetsdiagram för team vars områdesvägar ändras inte rätt data. Historiska trenddiagram refererar till områdessökvägen och iterationssökvägen enligt definitionen vid en tidigare tidpunkt för varje arbetsobjekt. När en områdessökväg eller iterationssökväg tas bort kan inte historiska data hämtas.

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:

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 Name (Name) 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 Genom
IterationLevel14		 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 det orsaka dataförlust och kan inte återställas. Till exempel visar brännings- eller bränningswidgetdiagram, sprintbrännskada och hastighetsdiagram för team vars områdesvägar ändras inte rätt data. Historiska trenddiagram refererar till områdessökvägen och iterationssökvägen enligt definitionen vid en tidigare tidpunkt för varje arbetsobjekt. När en områdessökväg eller iterationssökväg tas bort kan inte historiska data hämtas.

Navigeringsegenskaper för iterationsentitetstypen och iterationsentitetsuppsättningen inkluderar Project och Teams.

Mer information om iterationssökvägar finns i följande artiklar:

Processer

Följande egenskaper är giltiga för entitetstypen Process och entitetsuppsättningen Processer . Surrogatnycklar som är associerade med Process inkluderar ProcessSK, ProjectSKoch 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 Name (Name) 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 nullvä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:

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 Name (Name) 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 Name (Name) 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, Areasoch Iterations.

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 Name (Name) 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, SourceWorkItemoch TargetWorkItem.

Mer information om länkar och länktyper finns i följande artiklar:

WorkItemTypeFields

Följande egenskaper är giltiga för entitetsuppsättningen WorkItemTypeFields . Egenskapsreferensnycklarna är FieldName, ProjectSKoch WorkItemType.

Visningsnamn Name (Name) 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>