Data del calendario, Riferimento ai metadati di Project e Utente per Azure DevOps Analytics
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:
- Eseguire query sui dati di tendenza
- Definire query di base con OData Analytics
- Calcolare lo stato temporizzato per una visualizzazione di Analisi esistente
- Report di esempio di tendenze di bug
- Report di esempio di tempo di lead time e ciclo
- Report di esempio di tendenza del passaggio della pipeline
- Report di esempio di tendenza della durata dell'attività della pipeline
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 ProjectSK
surrogata. 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 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. |
Proprietà di navigazione
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 | Organizzazione |
Public |
2 | Pubblico |
Utenti
Le proprietà seguenti sono valide per il set di entità Users e il tipo di entità User con chiave UserSK
surrogata .
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 |
Personalizzazione | 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 | Organizzazione |
Bot |
4 | Bot |