Data del calendario, Riferimento ai metadati di Project e Utente per Azure DevOps Analytics

  • Articolo

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

I tipi di entità e i set di entità elencati nella tabella seguente possono essere usati per filtrare e compilare report in base ai dati di Analytics.

EntitySet EntityType Descrizione
Date CalendarDate Date usate per filtrare e raggruppare altre entità usando relazioni.
Progetti Progetto Progetti definiti per un'organizzazione (cloud) o una raccolta di progetti (locale).
Utenti Utente Informazioni utente utilizzate per espandere o filtrare varie proprietà dell'elemento di lavoro, ad esempio Assigned To, Created By.

Nota

Vengono fornite descrizioni delle entità, delle proprietà e dei tipi enumerati supportati dal modello di dati di Analisi. Si tratta di una bozza anticipata. Inviare commenti e suggerimenti sulle aree in cui si vogliono avere altre informazioni. Per eseguire query sul modello di dati, vedere Costruire query OData per Analytics.

Date

Le proprietà seguenti sono valide per il tipo di entità CalendarDate . La chiave surrogata associata a CalendarDate è DateSK. È possibile specificare le proprietà della data del calendario per filtrare e strutturare i report.

Nome visualizzato Nome Tipo di dati Descrizione
IsLastDayOfPeriod Enumerated Usare per filtrare i dati per determinare se un giorno termina in periodi diversi, ad esempio giorni, settimane, mesi o anni. I valori validi sono elencati di seguito per Periodo.
Data Date Data/Ora Data specifica del calendario.
Nome giorno DayName String Nome di un giorno, ad esempio lunedì, martedì, mercoledì e così via.
Nome breve giorno DayShortName String Il nome breve assegnato a un giorno, ad esempio Mon, Tue, Wed e così via.
Giorno della settimana DayOfWeek Int32 Numero associato al giorno entro una settimana.
Giorno del mese DayOfMonth Int32 Numero associato al giorno entro un mese.
Giorno dell'anno DayOfYear Int32 Numero associato al giorno di un anno.
Data di inizio settimana WeekStartingDate Data/Ora Data associata all'inizio di una settimana.
Data fine settimana WeekEndingDate Data/Ora Data associata alla fine di una settimana.
Month Month String Nome abbreviato di un mese e di un anno, ad esempio, gennaio 2022, febbraio 2022, mar 2022 e così via.
Nome mese MonthName String Nome di un mese, ad esempio gennaio, febbraio, marzo e così via.
Nome breve mese MonthShortName String Nome abbreviato di un mese, ad esempio Jan, Feb, Mar e così via.
Mese dell'anno MonthOfYear Int32 Numero assegnato a un mese. Ad esempio, 1, 2 e 3 corrispondenti a gennaio, febbraio e marzo.
YearMonth YearMonth Int32 Numero corrispondente all'anno e al mese concatenati. Ad esempio, 202201, 202202 e 202203 corrisponde a gennaio, febbraio e marzo 2022.
Year Year Int32 L'anno, ad esempio 2019, 2020, 2021 e così via.

Per impostazione predefinita, tutte le tabelle snapshot vengono modellate come tabelle dei fatti dello snapshot giornaliero. Se si esegue una query per un intervallo di tempo, si otterrà un valore per ogni giorno. Gli intervalli di tempo lunghi comportano un numero elevato di record. Se non è necessaria una precisione così elevata, è possibile usare snapshot settimanali o persino mensili.

Quando si aggregano i dati per un'entità snapshot, è necessario includere o DateSK una DateValue colonna in una groupby clausola come descritto nelle linee guida per le query OData. Per i report di esempio che specificano un filtro data, vedere gli articoli seguenti:

Membri del tipo enumerato period

I membri seguenti sono definiti per il Period tipo enumerato che è possibile usare con altre espressioni di filtro per rimuovere i giorni che non terminano una determinata settimana o mese. Fare riferimento a uno di questi membri per specificare un periodo settimanale o mensile per le query di tendenza che durano un lungo periodo di tempo. Il Period tipo enumerato ha un singolo attributo, IsFlags, che è impostato su True.

Nome del membro Valore Nome visualizzato
None 0 None
Day 1 Giorno
WeekEndingOnSunday 2 Fine settimana domenica
WeekEndingOnMonday 4 Fine settimana il lunedì
WeekEndingOnTuesday 8 Fine settimana il martedì
WeekEndingOnWednesday 16 Fine settimana mercoledì
WeekEndingOnThursday 32 Fine settimana il giovedì
WeekEndingOnFriday 64 Fine settimana il venerdì
WeekEndingOnSaturday 128 Fine settimana sabato
Month 256 Mese
Quarter 512 Trimestrale
Year 1024 Anno
All 2047 Tutte le date

Progetti

Le proprietà seguenti sono valide per il set di entità Projects e la relativa chiave ProjectSKsurrogata. Quando si genera una query con ambito organizzazione, è possibile concentrarsi su uno o più progetti specificando uno o più nomi di progetto. Per altre informazioni, vedere Query con ambito di progetto e organizzazione.

Nome visualizzato Nome Tipo di dati Descrizione
AnalyticsUpdatedDate Data/Ora Limite che indica l'ultima volta che i dati di Analisi sono stati aggiornati.
ID progetto ProjectId GUID Identificatore univoco assegnato a un progetto al momento della creazione.
Nome progetto ProjectName String Nome assegnato a un progetto al momento della creazione.
Visibilità del progetto ProjectVisibility Enumerated Indica se il progetto è pubblico o privato. I valori validi sono elencati di seguito per ProjectVisibility.

Le proprietà di navigazione seguenti sono valide per il tipo di entità Project .

Membri di tipo enumerati di ProjectVisibility

I membri seguenti sono definiti per il ProjectVisibility tipo enumerato. Fare riferimento a uno di questi membri per filtrare in base a progetti specifici.

Nome del membro Valore Nome visualizzato
Private 0 Privata
Organization 1 Organization
Public 2 Pubblico

Utenti

Le proprietà seguenti sono valide per il set di entità Users e il tipo di entità User con chiave UserSKsurrogata .

Nome visualizzato Nome Tipo di dati Descrizione
AnalyticsUpdatedDate Data/Ora Limite che indica l'ultima volta che i dati di Analisi sono stati aggiornati.
Indirizzo di posta elettronica utente UserEmail String Indirizzo di posta elettronica associato a un'identità dell'account utente.
ID utente UserId GUID Identificatore univoco assegnato a un'identità dell'account utente.
Nome utente UserName String Nome assegnato a un utente quando viene creata l'identità dell'account utente.
ID utente di GitHub GitHubUserId String ID utente di GitHub associato all'account utente.
Tipo di utente UserType Personalizzata Tipo di utente. I valori validi sono elencati di seguito per UserType.

Membri del tipo enumerato UserType

I membri seguenti sono definiti per il UserType tipo enumerato.

Nome del membro Valore Nome visualizzato
Unknown 0 Non riconosciuto
Unrecognized 1 Non riconosciuto
User 2 User
Organization 3 Organization
Bot 4 Bot