Referens för kalenderdatum, projekt- och användarmetadata för Azure DevOps Analytics

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Entitetstyperna och entitetsuppsättningarna som anges i följande tabell kan användas för att filtrera och skapa rapporter baserat på Analysdata.

EntitySet EntityType beskrivning
Datum CalendarDate Datumen som används för att filtrera och gruppera andra entiteter med hjälp av relationer.
Projekt Projekt Projekt som definierats för en organisation (moln) eller projektsamling (lokalt).
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.

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.

Datum

Följande egenskaper är giltiga för entitetstypen CalendarDate . Surrogatnyckeln som är associerad med CalendarDate är DateSK. Du kan ange datumegenskaper för kalendern för att filtrera och strukturera rapporter.

Visningsnamn Namn Datatyp Beskrivning
IsLastDayOfPeriod Enumerated Använd för att filtrera data för att avgöra om en dag slutar i olika perioder, till exempel dagar, veckor, månader eller år. Giltiga värden visas nedan för Period.
Datum Date Datum/tid Ett specifikt kalenderdatum.
Dagnamn DayName String Namnet på en dag, till exempel måndag, tisdag, onsdag och så vidare.
Kort namn på dag DayShortName String Det korta namn som tilldelats en dag, till exempel mon, tis, ons och så vidare.
Veckodag DayOfWeek Int32 Talet som är associerat med dagen inom en vecka.
Dag i månaden DayOfMonth Int32 Talet som är associerat med dagen inom en månad.
Dag på året DayOfYear Int32 Talet som är associerat med dagen för ett år.
Veckans startdatum WeekStartingDate Datum/tid Datumet som är associerat med början av en vecka.
Slutdatum för vecka WeekEndingDate Datum/tid Datumet som är associerat med slutet av en vecka.
Month Month String Det förkortade namnet på en månad och ett år, till exempel Jan 2022, Feb 2022, Mar 2022 och så vidare.
Månadsnamn MonthName String Namnet på en månad, till exempel januari, februari, mars och så vidare.
Kort namn för månad MonthShortName String Det förkortade namnet på en månad, till exempel Jan, Feb, Mar och så vidare.
Månad på året MonthOfYear Int32 Numret som tilldelats till en månad. Till exempel 1, 2 och 3 som motsvarar januari, februari och mars.
YearMonth YearMonth Int32 Ett tal som motsvarar det sammanlänkade året och månaden. Till exempel motsvarar 202201, 202202 och 202203 januari, februari och mars 2022.
Year Year Int32 Året, till exempel 2019, 2020, 2021 och så vidare.

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.

När du aggregerar data för en ögonblicksbildentitet bör du inkludera DateSK eller en DateValue kolumn i en groupby sats enligt beskrivningen i OData-frågeriktlinjerna. Exempel på rapporter som anger ett datumfilter finns i följande artiklar:

Perioduppräknade typmedlemmar

Följande medlemmar definieras för den Period uppräknade typ som du kan använda med andra filteruttryck för att ta bort dagar som inte slutför en viss vecka eller månad. Referera till en av dessa medlemmar för att ange en vecko- eller månadsperiod för trendfrågor som sträcker sig över en lång tidsperiod. Den Period uppräknade typen har ett enda attribut, IsFlags, som är inställt på True.

Medlemsnamn Värde Visningsnamn
None 0 Ingen
Day 1 dag
WeekEndingOnSunday 2 Veckan slutar på söndag
WeekEndingOnMonday 4 Veckan slutar på måndag
WeekEndingOnTuesday 8 Veckan slutar på tisdag
WeekEndingOnWednesday 16 Veckan slutar på onsdag
WeekEndingOnThursday 32 Veckan som slutar på torsdag
WeekEndingOnFriday 64 Veckan slutar på fredag
WeekEndingOnSaturday 128 Veckan slutar på lördag
Month 256 Månad
Quarter 512 Kvartal
Year 1024 Year
All 2047 Alla

Projekt

Följande egenskaper är giltiga för entitetsuppsättningen Projects och dess surrogatnyckel ProjectSK. När du genererar en organisationsomfattande fråga kan du fokusera på ett eller flera projekt genom att ange ett eller flera projektnamn. Mer information finns i Projekt- och organisationsomfattande frågor.

Visningsnamn Namn Datatyp Beskrivning
AnalyticsUpdatedDate Datum/tid Vattenstämpel som anger den senaste gången Analytics-data uppdaterades.
Projekt-ID ProjectId GUID Unik identifierare som tilldelats ett projekt när det skapas.
Projektnamn ProjectName String Namn som tilldelats ett projekt när det skapas.
Projektsynlighet ProjectVisibility Enumerated Anger om projektet är offentligt eller privat. Giltiga värden visas nedan för ProjectVisibility.

Följande navigeringsegenskaper är giltiga för projektentitetstypen.

ProjectVisibility-uppräknade typmedlemmar

Följande medlemmar definieras för den ProjectVisibility uppräknade typen. Referera till en av dessa medlemmar för att filtrera på specifika projekt.

Medlemsnamn Värde Visningsnamn
Private 0 Privat
Organization 1 Organisation
Public 2 Publikt

Användare

Följande egenskaper är giltiga för entitetsuppsättningen Användare och Entitetstypen Användare med surrogatnyckel UserSK.

Visningsnamn Namn Datatyp Beskrivning
AnalyticsUpdatedDate Datum/tid Vattenstämpel som anger den senaste gången Analytics-data uppdaterades.
E-post för användare UserEmail String E-post som är associerad med en användarkontoidentitet.
Användar-ID UserId GUID Unik identifierare som tilldelats en användarkontoidentitet.
Användarnamn UserName String Namn som tilldelas en användare när användarkontoidentiteten skapas.
GitHub-användar-ID GitHubUserId String GitHub-användar-ID som är associerat med användarkontot.
Användartyp UserType Egen Typ av användare. Giltiga värden visas nedan för UserType.

UserType-uppräknade typmedlemmar

Följande medlemmar definieras för den UserType uppräknade typen.

Medlemsnamn Värde Visningsnamn
Unknown 0 Okänd
Unrecognized 1 Okänd
User 2 User
Organization 3 Organisation
Bot 4 Robot