Az Azure DevOps Analytics naptárdátuma, projekt- és felhasználói metaadatai

  • Cikk

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

Az alábbi táblázatban felsorolt entitástípusok és entitáskészletek az Analytics-adatokon alapuló jelentések szűrésére és összeállítására használhatók.

EntitySet Entitástípus Leírás
Dátumok CalendarDate A kapcsolatok használatával más entitások szűréséhez és csoportosításához használt dátumok.
Projektek Projekt Szervezethez (felhőhöz) vagy projektgyűjteményhez (helyszíni) definiált projektek.
Felhasználók Felhasználó A különböző munkaelem-tulajdonságok kibontására vagy szűrésére használt felhasználói adatok, például Hozzárendelve, Létrehozva.

Megjegyzés:

Az Analytics-adatmodell által támogatott entitások, tulajdonságok és számba vett típusok leírása meg van adva. Ez egy korai vázlat. Küldjön visszajelzést azokról a területekről, amelyekről további információra van szüksége. Az adatmodell lekérdezéséhez lásd : OData-lekérdezések létrehozása az Analyticshez.

Dátumok

A CalendarDate entitástípushoz az alábbi tulajdonságok érvényesek. A CalendarDate-hez társított helyettesítő kulcs a DateSKkövetkező: . A jelentések szűréséhez és strukturálásához megadhatja a naptárdátum tulajdonságait.

Megjelenített név Név Adattípus Ismertetés
IsLastDayOfPeriod Enumerated Adatok szűrése annak megállapítására, hogy egy nap különböző időszakokban fejeződik-e be, például napok, hetek, hónapok vagy évek. Az érvényes értékek az alábbiakban szerepelnek a Pont értékekkel.
Dátum Date DateTime Egy adott naptárdátum.
Nap neve DayName Sztring Egy nap neve, például hétfő, kedd, szerda stb.
Nap rövid neve DayShortName Sztring Egy naphoz rendelt rövid név, például Mon, Tue, Wed stb.
A hét napja DayOfWeek Int32 A naphoz egy héten belül társított szám.
Hónap napja DayOfMonth Int32 A naphoz egy hónapon belül társított szám.
Az év napja DayOfYear Int32 Az év napjával társított szám.
Hét kezdő dátuma WeekStartingDate DateTime A hét kezdetéhez társított dátum.
Hét záró dátuma WeekEndingDate DateTime A hét végéhez társított dátum.
Hónap Month Sztring Egy hónap és év rövidített neve, például 2022. január, 2022. február, 2022. március stb.
Hónap neve MonthName Sztring Egy hónap neve, például január, február, március stb.
Hónap rövid neve MonthShortName Sztring Egy hónap rövidített neve, például Jan, Feb, Mar stb.
Év hónapja MonthOfYear Int32 Egy hónaphoz rendelt szám. Például 1, 2 és 3, amely januárnak, februárnak és márciusnak felel meg.
YearMonth YearMonth Int32 Az összefűzött évnek és hónapnak megfelelő szám. A 202201, a 202202 és a 202203 például 2022 januárjának, februárjának és márciusának felel meg.
Év Year Int32 Az év, például 2019, 2020, 2021 és így tovább.

Alapértelmezés szerint az összes pillanatképtáblát napi pillanatkép-ténytáblákként modellezi a rendszer. Ha egy időtartományt kérdez le, az minden naphoz kap egy értéket. A hosszú időtartományok sok rekordot eredményeznek. Ha nincs szüksége ilyen nagy pontosságra, heti vagy akár havi pillanatképeket is használhat.

Pillanatkép-entitás adatainak összesítésekor az DateSK OData-lekérdezési irányelvekben ismertetett záradékba groupby kell foglalnia az oszlopot vagy DateValue az oszlopot. Ha például dátumszűrőt meghatározó jelentésekről van szó, tekintse meg a következő cikkeket:

Pont enumerált típustagok

Az enumerált típushoz a Period következő tagok vannak definiálva, amelyeket más szűrőkifejezésekkel is használhat az adott hét vagy hónap be nem fejeződő napjainak eltávolításához. Ezen tagok egyikére hivatkozva heti vagy havi időtartamot adhat meg a hosszú időtartamot felölelő trend típusú lekérdezésekhez. Az Period enumerált típus egyetlen attribútummal rendelkezik, IsFlagsamely a következőre Truevan állítva: .

Tag neve Érték Megjelenítendő név
None 0 None
Day 1 Nap
WeekEndingOnSunday 2 Vasárnap végződő hét
WeekEndingOnMonday 4 Hétfői befejezési hét
WeekEndingOnTuesday 8 Keddi befejezésű hét
WeekEndingOnWednesday 16 A hét szerdára végződik
WeekEndingOnThursday 32 Csütörtöki záró hét
WeekEndingOnFriday 64 Péntekig tartó hét
WeekEndingOnSaturday 128 A hét szombaton véget ér
Month 256 Hónap
Quarter 512 Negyed
Year 1024 Év
All 2047 Mind

Projektek

Az alábbi tulajdonságok érvényesek a Projektek entitáskészletre és annak helyettesítő kulcsára ProjectSK. Szervezeti hatókörű lekérdezés létrehozásakor egy vagy több projektre összpontosíthat egy vagy több projektnév megadásával. További információkért tekintse meg a Project és a szervezet hatókörébe tartozó lekérdezéseket.

Megjelenített név Név Adattípus Ismertetés
AnalyticsUpdatedDate DateTime Vízjel, amely az Analytics-adatok legutóbbi frissítését jelzi.
Projektazonosító ProjectId GUID A projekt létrehozásakor hozzárendelt egyedi azonosító.
Projekt neve ProjectName Sztring Projekthez rendelt név létrehozásakor.
Projekt láthatósága ProjectVisibility Enumerated Azt jelzi, hogy a projekt nyilvános vagy privát-e. Az érvényes értékek alább láthatók a ProjectVisibility esetében.

A Project entitástípusra az alábbi navigációs tulajdonságok érvényesek.

ProjectVisibility enumerated type members

Az enumerált típushoz a ProjectVisibility következő tagok vannak definiálva. Az egyes projektekre való szűréshez hivatkozzon az egyik tagra.

Tag neve Érték Megjelenítendő név
Private 0 Private
Organization 1 Organization
Public 2 Public

Felhasználók

A következő tulajdonságok érvényesek a Felhasználók entitáskészletre és a Felhasználó entitástípusra helyettesítő kulccsalUserSK.

Megjelenített név Név Adattípus Ismertetés
AnalyticsUpdatedDate DateTime Vízjel, amely az Analytics-adatok legutóbbi frissítését jelzi.
Felhasználói e-mail UserEmail Sztring Felhasználói fiók identitásához társított e-mail.
Felhasználói azonosító UserId GUID Felhasználói fiók identitásához rendelt egyedi azonosító.
Felhasználónév UserName Sztring Felhasználóhoz rendelt név a felhasználói fiók identitásának létrehozásakor.
GitHub felhasználói azonosító GitHubUserId Sztring A felhasználói fiókhoz társított GitHub-felhasználói azonosító.
Felhasználó típusa UserType Egyéni A felhasználó típusa. Az érvényes értékek alább láthatók a UserType esetében.

UserType enumerált típustagok

Az enumerált típushoz a UserType következő tagok vannak definiálva.

Tag neve Érték Megjelenítendő név
Unknown 0 Ismeretlen
Unrecognized 1 Ismeretlen
User 2 Felhasználó
Organization 3 Organization
Bot 4 Robot