Freigeben über

Kalenderdatum, Projekt und Benutzermetadatenreferenz für Azure DevOps Analytics

  • Artikel

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

Die entitätstypen und Entitätssätze, die in der folgenden Tabelle aufgeführt sind, können verwendet werden, um Berichte basierend auf Analysedaten zu filtern und zu erstellen.

EntitySet EntityType Beschreibung
Datumsangaben CalendarDate Die Datumsangaben, die zum Filtern und Gruppieren anderer Entitäten mithilfe von Beziehungen verwendet werden.
Projekte Projekt Projekte, die für eine Organisation (Cloud) oder Projektsammlung (lokal) definiert sind.
Benutzer Benutzer Benutzerinformationen, die zum Erweitern oder Filtern verschiedener Arbeitselementeigenschaften verwendet werden, z. B . Zugewiesen an, Erstellt von.

Hinweis

Beschreibungen der Entitäten, Eigenschaften und enumerierten Typen, die vom Analytics-Datenmodell unterstützt werden, werden bereitgestellt. Dies ist ein früher Entwurf. Bitte geben Sie Feedback zu Bereichen, die Sie gerne mehr Informationen haben möchten. Informationen zum Abfragen des Datenmodells finden Sie unter Erstellen von OData-Abfragen für Analytics.

Datumsangaben

Die folgenden Eigenschaften gelten für den Entitätstyp "CalendarDate ". Der mit CalendarDate verknüpfte Ersatzschlüssel ist DateSK. Sie können Kalenderdatumseigenschaften zum Filtern und Strukturieren von Berichten angeben.

Anzeigename Name Datentyp Beschreibung
IsLastDayOfPeriod Enumerated Dient zum Filtern von Daten, um zu ermitteln, ob ein Tag in verschiedenen Zeiträumen endet, z. B. Tage, Wochen, Monate oder Jahre. Gültige Werte sind unten für "Zeitraum" aufgeführt.
Datum Date DateTime Ein bestimmtes Kalenderdatum.
Tagname DayName String Der Name eines Tages, z. B. Montag, Dienstag, Mittwoch usw.
Kurzname für Tag DayShortName String Der kurze Name, der einem Tag zugewiesen ist, z. B. Mon, Di, Wed usw.
Wochentag DayOfWeek Int32 Die Zahl, die dem Tag innerhalb einer Woche zugeordnet ist.
Tag des Monats DayOfMonth Int32 Die Zahl, die dem Tag innerhalb eines Monats zugeordnet ist.
Tag des Jahres DayOfYear Int32 Die Zahl, die dem Tag eines Jahres zugeordnet ist.
Startdatum der Woche WeekStartingDate DateTime Das Datum, das dem Beginn einer Woche zugeordnet ist.
Enddatum der Woche WeekEndingDate DateTime Das Datum, das dem Ende einer Woche zugeordnet ist.
Monat Month String Der gekürzte Name eines Monats und Jahres, z. B. Jan 2022, Februar 2022, März 2022 usw.
Monatsname MonthName String Der Name eines Monats, z. B. Januar, Februar, März usw.
Name des Monats kurz MonthShortName String Der gekürzte Name eines Monats, z. B. Jan, Feb, Mar usw.
Monat des Jahres MonthOfYear Int32 Die einem Monat zugewiesene Nummer. Beispiel: 1, 2 und 3 entsprechend Januar, Februar und März.
YearMonth YearMonth Int32 Eine Zahl, die dem verketteten Jahr und Monat entspricht. Beispielsweise entspricht 202201, 202202 und 202203 Januar, Februar und März 2022.
Year Year Int32 Das Jahr, z. B. 2019, 2020, 2021 usw.

Standardmäßig werden alle Momentaufnahmetabellen als tägliche Faktentabellen modelliert. Wenn Sie einen Zeitraum abfragen, wird ein Wert für jeden Tag abgerufen. Lange Zeitbereiche führen zu einer großen Anzahl von Datensätzen. Wenn Sie diese hohe Genauigkeit nicht benötigen, können Sie wöchentliche oder sogar monatliche Momentaufnahmen verwenden.

Wenn Sie Daten für eine Momentaufnahmeentität aggregieren, sollten Sie die DateSK Spalte oder DateValue Spalte in eine groupby Klausel einschließen, wie in den OData-Abfragerichtlinien beschrieben. Beispielberichte, die einen Datumsfilter angeben, finden Sie in den folgenden Artikeln:

Elemente des Aufzählungstyps "Period"

Die folgenden Member sind für den Period Aufzählungstyp definiert, den Sie mit anderen Filterausdrücken verwenden können, um Tage zu entfernen, die keine bestimmte Woche oder einen bestimmten Monat abgeschlossen haben. Verweisen Sie auf eines dieser Mitglieder, um einen wöchentlichen oder monatlichen Zeitraum für Trendabfragen anzugeben, die einen langen Zeitraum umfassen. Der Period Aufzählungstyp weist ein einzelnes Attribut auf, IsFlagsdas auf True. festgelegt ist.

Membername Wert `Display name`
None 0 Keine
Day 1 Tag
WeekEndingOnSunday 2 Woche endet am Sonntag
WeekEndingOnMonday 4 Woche endet am Montag
WeekEndingOnTuesday 8 Woche endet am Dienstag
WeekEndingOnWednesday 16 Woche endet am Mittwoch
WeekEndingOnThursday 32 Woche endet am Donnerstag
WeekEndingOnFriday 64 Woche endet am Freitag
WeekEndingOnSaturday 128 Woche endet am Samstag
Month 256 Monat
Quarter 512 Quarter
Year 1024 Jahr
All 2047 Alle

Projekte

Die folgenden Eigenschaften gelten für den Entitätssatz "Projects " und dessen Ersatzschlüssel ProjectSK. Beim Generieren einer Abfrage mit Organisationsbereich können Sie sich auf ein oder mehrere Projekte konzentrieren, indem Sie einen oder mehrere Projektnamen angeben. Weitere Informationen finden Sie unter Project- und organisationsbezogenen Abfragen.

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate DateTime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
Projekt-ID ProjectId GUID Eindeutiger Bezeichner, der einem Projekt zugewiesen ist, wenn es erstellt wird.
Projektname ProjectName String Name, der einem Projekt zugewiesen ist, wenn es erstellt wird.
Projektsichtbarkeit ProjectVisibility Enumerated Gibt an, ob das Projekt öffentlich oder privat ist. Gültige Werte sind unten für ProjectVisibility aufgeführt.

Die folgenden Navigationseigenschaften sind für den Project-Entitätstyp gültig.

Elemente des Aufzählungstyps "ProjectVisibility"

Die folgenden Member werden für den ProjectVisibility Aufzählungstyp definiert. Verweisen Sie auf eines dieser Member, um nach bestimmten Projekten zu filtern.

Membername Wert `Display name`
Private 0 Privat
Organization 1 Organisation
Public 2 Öffentlich

Benutzer

Die folgenden Eigenschaften gelten für den Entitätssatz "Users" und den Benutzerentitätstyp mit ErsatzschlüsselUserSK.

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate DateTime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
E-Mail-Adresse des Benutzers UserEmail String E-Mail, die einer Benutzerkontoidentität zugeordnet ist.
Benutzer-ID UserId GUID Eindeutiger Bezeichner, der einer Benutzerkontoidentität zugewiesen ist.
Benutzername UserName String Dem Benutzer zugewiesener Name, wenn die Benutzerkontoidentität erstellt wird.
GitHub-Benutzer-ID GitHubUserId String GitHub-Benutzer-ID, die dem Benutzerkonto zugeordnet ist.
Benutzertyp UserType Benutzerdefiniert Der Typ des Benutzers. Gültige Werte sind unten für UserType aufgeführt.

Elemente des Aufzählungstyps "UserType"

Die folgenden Member werden für den UserType Aufzählungstyp definiert.

Membername Wert `Display name`
Unknown 0 Unerkannt
Unrecognized 1 Unerkannt
User 2 Benutzer
Organization 3 Organization
Bot 4 Bot