Referenční informace o datech kalendáře, projectu a uživatelových metadatech pro Azure DevOps Analytics

  • Článek

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

Typy entit a sady entit uvedené v následující tabulce se dají použít k filtrování a vytváření sestav na základě dat Analýzy.

Entityset EntityType Popis
Data CalendarDate Data použitá k filtrování a seskupení dalších entit pomocí relací.
Projekty Projekt Projekty definované pro organizaci (cloud) nebo kolekci projektů (místní).
Uživatelé Uživatel Informace o uživateli, které slouží k rozbalení nebo filtrování různých vlastností pracovní položky, například Přiřazeno, Vytvořeno uživatelem.

Poznámka:

Jsou k dispozici popisy entit, vlastností a výčtů podporovaných datovým modelem Analýza. Jedná se o dřívější koncept. Pošlete nám prosím zpětnou vazbu k oblastem, které chcete získat další informace. Dotazování datového modelu najdete v tématu Vytváření dotazů OData pro analýzu.

Kalendářní data

Následující vlastnosti jsou platné pro typ entity CalendarDate . Náhradní klíč přidružený k CalendarDate je DateSK. Můžete zadat vlastnosti kalendářního data pro filtrování a strukturování sestav.

Zobrazované jméno Název Datový typ Popis
IsLastDayOfPeriod Enumerated Slouží k filtrování dat k určení, jestli se den dokončí v různých obdobích, jako jsou dny, týdny, měsíce nebo roky. Platné hodnoty jsou uvedené níže pro období.
Date Date DateTime Konkrétní datum kalendáře.
Název dne DayName String Název dne, například pondělí, úterý, středa atd.
Krátký název dne DayShortName String Krátký název přiřazený k nějakému dni, například Mon, Út, Wed atd.
Den v týdnu DayOfWeek Int32 Číslo přidružené k danému dni v týdnu.
Den v měsíci DayOfMonth Int32 Číslo přidružené ke dni v měsíci.
Den roku DayOfYear Int32 Číslo přidružené ke dni v roce.
Počáteční datum týdne WeekStartingDate DateTime Datum přidružené k začátku týdne.
Koncové datum týdne WeekEndingDate DateTime Datum spojené s koncem týdne.
Month Month String Zkrácený název měsíce a roku, například leden 2022, únor 2022, březen 2022 atd.
Název měsíce MonthName String Název měsíce, například leden, únor, březen atd.
Krátký název měsíce MonthShortName String Zkrácený název měsíce, například Jan, Feb, Mar atd.
Měsíc roku MonthOfYear Int32 Číslo přiřazené k měsíci. Například 1, 2 a 3 odpovídající lednu, únoru a březnu.
YearMonth YearMonth Int32 Číslo odpovídající zřetězení roku a měsíce. Například 202201, 202202 a 202203 odpovídají lednu, únoru a březnu 2022.
Year Year Int32 Rok, například 2019, 2020, 2021 atd.

Ve výchozím nastavení se všechny tabulky snímků modelují jako tabulky faktů s denním snímkem. Pokud zadáte dotaz na časový rozsah, získá se hodnota pro každý den. Dlouhé časové rozsahy vedou k velkému počtu záznamů. Pokud takovou vysokou přesnost nepotřebujete, můžete použít týdenní nebo dokonce měsíční snímky.

Když agregujete data pro entitu snímku, měli byste zahrnout DateSK sloupec nebo DateValue sloupec do groupby klauzule, jak je popsáno v pokynech k dotazům OData. Například sestavy, které určují filtr kalendářních dat, najdete v následujících článcích:

Členové výčtu typů období

Následující členy jsou definovány pro Period výčtový typ, který můžete použít s jinými výrazy filtru k odebrání dnů, které nedokončí daný týden nebo měsíc. Na jeden z těchto členů se odkazuje na určení týdenního nebo měsíčního období pro dotazy trendu, které se zabývají dlouhou dobu. Výčtový Period typ má jeden atribut, IsFlagskterý je nastaven na True.

Název členu Hodnota Zobrazované jméno
None 0 Nic
Day 0 Day
WeekEndingOnSunday 2 Týden končící v neděli
WeekEndingOnMonday 4 Týden končící v pondělí
WeekEndingOnTuesday 8 Týden končí v úterý
WeekEndingOnWednesday 16 Týden končící ve středu
WeekEndingOnThursday 32 Týden končí ve čtvrtek
WeekEndingOnFriday 64 Konec týdne v pátek
WeekEndingOnSaturday 128 Týden končící v sobotu
Month 256 Month
Quarter 512 Čtvrtletí
Year 1024 Year
All 2047 Všechny

Projekty

Následující vlastnosti jsou platné pro sadu entit Projects a jeho náhradní klíč ProjectSK. Při generování dotazu s oborem organizace se můžete zaměřit na jeden nebo více projektů zadáním jednoho nebo více názvů projektů. Další informace najdete v tématu Projektové a organizační dotazy.

Zobrazované jméno Název Datový typ Popis
AnalyticsUpdatedDate DateTime Vodoznak, který označuje čas poslední aktualizace analytických dat.
ID projektu ProjectId Identifikátor GUID Jedinečný identifikátor přiřazený k projektu při jeho vytvoření
Název projektu ProjectName String Název přiřazený k projektu při jeho vytvoření
Viditelnost projektu ProjectVisibility Enumerated Označuje, jestli je projekt veřejný nebo soukromý. Platné hodnoty jsou uvedené níže pro ProjectVisibility.

Následující navigační vlastnosti jsou platné pro typ entity projektu .

Členové výčtu typu ProjectVisibility

Následující členy jsou definovány pro výčtový ProjectVisibility typ. Na jeden z těchto členů můžete odkazovat na filtrování konkrétních projektů.

Název členu Hodnota Zobrazované jméno
Private 0 Soukromé
Organization 0 Organizace
Public 2 Veřejný

Uživatelé

Následující vlastnosti jsou platné pro sadu entit Users a typ entity User s náhradním klíčem UserSK.

Zobrazované jméno Název Datový typ Popis
AnalyticsUpdatedDate DateTime Vodoznak, který označuje čas poslední aktualizace analytických dat.
E-mail uživatele UserEmail String E-mail přidružený k identitě uživatelského účtu
ID uživatele UserId Identifikátor GUID Jedinečný identifikátor přiřazený identitě uživatelského účtu
Uživatelské jméno UserName String Jméno přiřazené uživateli při vytvoření identity uživatelského účtu
ID uživatele GitHubu GitHubUserId String ID uživatele GitHubu přidružené k uživatelskému účtu
Typ uživatele UserType Vlastní Typ uživatele. Platné hodnoty jsou uvedené níže pro UserType.

UserType – členy výčtu typů

Následující členy jsou definovány pro výčtový UserType typ.

Název členu Hodnota Zobrazované jméno
Unknown 0 Nerozpoznaný
Unrecognized 0 Nerozpoznaný
User 2 Uživatelská
Organization 3 Organizace
Bot 4 Robot