Udostępnij za pośrednictwem

Data kalendarza, projekt i dokumentacja metadanych użytkownika dla usługi Azure DevOps Analytics

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Typy jednostek i zestawy jednostek wymienione w poniższej tabeli mogą służyć do filtrowania i tworzenia raportów na podstawie danych analizy.

EntitySet Typ jednostki opis
Daty Daty kalendarza Daty używane do filtrowania i grupowania innych jednostek przy użyciu relacji.
Projekty Projekt Projekty zdefiniowane dla organizacji (w chmurze) lub kolekcji projektów (lokalnie).
Użytkownicy Użytkownik Informacje o użytkowniku używane do rozwijania lub filtrowania różnych właściwości elementu roboczego, na przykład Przypisane do, Utworzone przez.

Uwaga

Podano opisy jednostek, właściwości i wyliczonych typów obsługiwanych przez model danych analizy. Jest to wczesna wersja robocza. Prześlij opinię na temat obszarów, w których chcesz uzyskać więcej informacji. Aby wykonywać zapytania dotyczące modelu danych, zobacz Konstruowanie zapytań OData dla analizy.

Daty

Następujące właściwości są prawidłowe dla typu jednostki CalendarDate . Klucz zastępczy skojarzony z datą kalendarza to DateSK. Możesz określić właściwości daty kalendarza, aby filtrować i strukturę raportów.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
IsLastDayOfPeriod Enumerated Służy do filtrowania danych, aby określić, czy dzień kończy się w różnych okresach, takich jak dni, tygodnie, miesiące lub lata. Prawidłowe wartości są wymienione poniżej dla okresu.
Data Date DateTime Określona data kalendarza.
Nazwa dnia DayName String Nazwa dnia, takiego jak poniedziałek, wtorek, środa itd.
Krótka nazwa dnia DayShortName String Krótka nazwa przypisana do dnia, taka jak Mon, Tue, Wed itd.
Dzień tygodnia DayOfWeek Int32 Liczba skojarzona z dniem w ciągu tygodnia.
Dzień miesiąca DayOfMonth Int32 Liczba skojarzona z dniem w ciągu miesiąca.
Dzień Roku DayOfYear Int32 Liczba skojarzona z dniem roku.
Data rozpoczęcia tygodnia WeekStartingDate DateTime Data skojarzona z rozpoczęciem tygodnia.
Data zakończenia tygodnia WeekEndingDate DateTime Data skojarzona z końcem tygodnia.
Month Month String Skrócona nazwa miesiąca i roku, na przykład Jan 2022, Luty 2022, Mar 2022 itd.
Nazwa miesiąca MonthName String Nazwa miesiąca, takiego jak styczeń, luty, marzec itd.
Krótka nazwa miesiąca MonthShortName String Skrócona nazwa miesiąca, taka jak Jan, Luty, Mar itd.
Miesiąc roku MonthOfYear Int32 Liczba przypisana do miesiąca. Na przykład 1, 2 i 3 odpowiadające styczniu, lutym i marcu.
Miesiąc roku YearMonth Int32 Liczba odpowiadająca łączonemu rokowi i miesiącowi. Na przykład 202201, 202202 i 202203 odpowiadają styczniu, lutym i marcu 2022 r.
Year Year Int32 Rok, taki jak 2019, 2020, 2021 itd.

Domyślnie wszystkie tabele migawek są modelowane jako codzienne tabele faktów migawek. Jeśli wykonasz zapytanie dotyczące zakresu czasu, otrzyma wartość dla każdego dnia. Zakresy czasu długiego powodują dużą liczbę rekordów. Jeśli nie potrzebujesz takiej wysokiej precyzji, możesz użyć cotygodniowych lub nawet miesięcznych migawek.

W przypadku agregowania danych dla jednostki migawki należy uwzględnić DateSK kolumnę lub w klauzuli zgodnie z opisem DateValue groupby w wytycznych dotyczących zapytań OData. Na przykład raporty określające filtr daty można znaleźć w następujących artykułach:

Składowe typu wyliczanego okresu

Następujące elementy członkowskie są zdefiniowane dla wyliczonego Period typu, którego można użyć z innymi wyrażeniami filtru, aby usunąć dni, które nie zakończą danego tygodnia lub miesiąca. Odwołaj się do jednego z tych elementów członkowskich, aby określić tygodniowy lub miesięczny okres dla zapytań trendów obejmujących długi okres. Wyliczony Period typ ma jeden atrybut , IsFlagsktóry jest ustawiony na Truewartość .

Nazwa elementu członkowskiego Wartość Display name
None 0 Brak
Day 1 Dzień
WeekEndingOnSunday 2 Tydzień kończący się w niedzielę
WeekEndingOnMonday 100 Tydzień kończący się w poniedziałek
WeekEndingOnTuesday 8 Tydzień kończący się we wtorek
WeekEndingOnWednesday 16 Tydzień kończący się w środę
WeekEndingOnThursday 32 Tydzień kończący się w czwartek
WeekEndingOnFriday 64 Tydzień kończący się w piątek
WeekEndingOnSaturday 128 Tydzień kończący się w sobotę
Month 256 Month
Quarter 512 Ćwiartkowy
Year 1024 Year (Rok)
All 2047 wszystkie

Projekty

Następujące właściwości są prawidłowe dla zestawu jednostek Projects i jego klucza ProjectSKzastępczego . Podczas generowania zapytania o zakresie organizacji można skoncentrować się na co najmniej jednym projekcie, określając co najmniej jedną nazwę projektu. Aby uzyskać więcej informacji, zobacz Project and organization-scoped queries (Zapytania w zakresie projektu i organizacji).

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
AnalyticsUpdatedDate DateTime Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Identyfikator projektu ProjectId Identyfikator GUID Unikatowy identyfikator przypisany do projektu podczas jego tworzenia.
Nazwa projektu ProjectName String Nazwa przypisana do projektu podczas jego tworzenia.
Widoczność projektu ProjectVisibility Enumerated Wskazuje, czy projekt jest publiczny lub prywatny. Prawidłowe wartości są wymienione poniżej dla pozycji ProjectVisibility.

Następujące właściwości nawigacji są prawidłowe dla typu jednostki Project .

Wyliczone elementy członkowskie typu ProjectVisibility

Następujące elementy członkowskie są zdefiniowane dla wyliczonego ProjectVisibility typu. Odwołuj się do jednego z tych elementów członkowskich, aby filtrować określone projekty.

Nazwa elementu członkowskiego Wartość Display name
Private 0 Prywatne
Organization 1 Organizacja
Public 2 Publiczne

Użytkownicy

Następujące właściwości są prawidłowe dla zestawu jednostek Użytkownicy i typu jednostki Użytkownik z kluczem UserSKzastępczym .

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
AnalyticsUpdatedDate DateTime Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Adres e-mail użytkownika UserEmail String Adres e-mail skojarzony z tożsamością konta użytkownika.
Identyfikator użytkownika UserId Identyfikator GUID Unikatowy identyfikator przypisany do tożsamości konta użytkownika.
Nazwa użytkownika UserName String Nazwa przypisana użytkownikowi podczas tworzenia tożsamości konta użytkownika.
Identyfikator użytkownika usługi GitHub GitHubUserId String Identyfikator użytkownika usługi GitHub skojarzony z kontem użytkownika.
Typ użytkownika UserType Niestandardowy Typ użytkownika. Prawidłowe wartości są wymienione poniżej dla parametru UserType.

Wyliczone składowe typu UserType

Następujące elementy członkowskie są zdefiniowane dla wyliczonego UserType typu.

Nazwa elementu członkowskiego Wartość Display name
Unknown 0 Nierozpoznany
Unrecognized 1 Nierozpoznany
User 2 User
Organization 3 Organizacja
Bot 100 Bot