Udostępnij przez

Data kalendarzowa, projekt i odniesienie do metadanych użytkownika dla Azure DevOps Analytics

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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

Zestaw Encji 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

Ten artykuł zawiera opisy jednostek, właściwości i wyliczonych typów obsługiwanych przez model danych analizy. 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 strukturyzować raporty.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
IsLastDayOfPeriod Wyliczony 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.

Tabele migawek są domyślnie modelowane jako codzienne tabele faktyczne migawek. Jeśli wykonasz zapytanie dotyczące zakresu czasu, otrzyma wartość dla każdego dnia. Długie zakresy czasowe powodują dużą liczbę rekordów. Jeśli nie potrzebujesz aż takiej wysokiej precyzji, możesz stosować cotygodniowe lub nawet comiesięczne zrzuty.

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

Elementy typu wyliczeniowego okresu

Następujące elementy członkowskie są zdefiniowane dla typu wyliczonego Period, którego można użyć wraz z innymi wyrażeniami filtrującymi, aby usunąć dni, które nie kończą danego tygodnia lub miesiąca. Odwołaj się do jednego z tych obszarów, aby określić tygodniowy lub miesięczny okres dla zapytań o trendy obejmujących długi czas. Wyliczony typ Period ma jeden atrybut, IsFlags, który jest ustawiony na True.

Nazwa członka Wartość Wyświetlana nazwa
None 0 Brak
Day 1 Dzień
WeekEndingOnSunday 2 Tydzień kończący się w niedzielę
WeekEndingOnMonday 4 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 Miesiąc
Quarter 512 Kwartał
Year 1024 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 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 GUID Unikatowy identyfikator przypisany do projektu podczas jego tworzenia.
Nazwa projektu ProjectName String Nazwa przypisana do projektu podczas jego tworzenia.
Widoczność projektu ProjectVisibility Wyliczony 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 typu ProjectVisibility

Dla typu wyliczeniowego ProjectVisibility zdefiniowano następujących członków. Odwołaj się do jednego z tych członków, aby filtrować określone projekty.

Nazwa członka Wartość Wyświetlana nazwa
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 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 Dostosowany Typ użytkownika. Prawidłowe wartości są wymienione poniżej dla parametru UserType.

Wyliczone składowe typu UserType

Dla typu wyliczeniowego UserType zdefiniowano następujących członków.

Nazwa członka Wartość Wyświetlana nazwa
Unknown 0 Nierozpoznany
Unrecognized 1 Nierozpoznany
User 2 Użytkownik
Organization 3 Organizacja
Bot 4 Bot
  • Last updated on