Rappresentazione cronologica dei dati in Analisi

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

È possibile specificare set di entità specifici per creare report sui dati cronologici o creare report di tendenza. Comprendere in che modo Analytics registra i dati cronologici è importante per assicurarsi di poter tenere traccia e segnalare i dati di interesse.

Set di entità che supportano la creazione di report cronologici

Nella tabella seguente vengono descritti i set di entità che è possibile usare per creare report cronologici o di tendenza.

Uno snapshot fornisce un record dei valori definiti per il tipo di entità ogni giorno. Il record viene scritto in Analytics una volta al giorno ogni giorno. Gli snapshot vengono usati quando si desidera generare un report di tendenza. 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.

Tabelle dei fatti di snapshot periodici

Analisi modella i dati cronologici come tabella dei fatti snapshot periodica. La tabella dei fatti contiene una riga creata a mezzanotte per ogni elemento di lavoro o tipo di entità alla fine di ogni periodo. Ad esempio, la cronologia in un periodo giornaliero viene modellata come una riga a mezzanotte per ogni giorno, mentre un periodo settimanale sarà una riga a mezzanotte dell'ultimo giorno della settimana. Se la settimana non è stata completata, il valore dello snapshot per la settimana è basato sul valore corrente.

La granularità di questa tabella è il periodo, non il singolo elemento di lavoro. Significa che un singolo elemento di lavoro verrà visualizzato più volte, una volta per ogni periodo cronologico. La selezione degli ultimi 30 giorni di cronologia comporterà la visualizzazione di un singolo elemento di lavoro 30 volte nel modello di dati. Se l'elemento di lavoro non è stato modificato negli ultimi 30 giorni, la revisione più recente dell'elemento di lavoro viene replicata ogni giorno.

Quando si usano il connettore dati di Power BI e i dati cronologici, è consigliabile usare il Date campo . Se il set di dati contiene dati cronologici, ma sono necessari solo i valori correnti, questa operazione può essere configurata filtrando Is Current.

Ad esempio, se si desidera visualizzare una tabella di elementi di lavoro e valori per i campi associati, usare Is Current come filtro impostato su True. Se invece si desidera visualizzare una tendenza degli elementi di lavoro in base allo stato, è necessario includere la colonna Data sull'asse della visualizzazione.

Revisioni degli elementi di lavoro

Ogni volta che si aggiorna un elemento di lavoro, il sistema crea una nuova revisione e registra questa azione nel System.RevisedDate campo, che rende utile specificare un filtro di cronologia. La data modificata è rappresentata dalle RevisedDate proprietà (DateTime) e RevisedDateSK (Int32). Per ottenere prestazioni ottimali, usare la chiave surrogata di quest'ultima data. Rappresenta la data in cui è stata creata una revisione o ha null per le revisioni attive o incomplete.

Se si desidera che tutte le date dall'inclusione {startDate} corrispondano, aggiungere il filtro seguente alla query.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Usare il WorkItemRevisions set di entità per caricare tutte le revisioni per un determinato elemento di lavoro. La query restituisce tutte le revisioni cronologiche degli elementi di lavoro, inclusa la revisione corrente, per gli elementi di lavoro filtrati. Non include elementi di lavoro eliminati.

Sia le visualizzazioni di Analisi che i widget Burndown e Burnup consentono di configurare filtri che consentono di definire l'ambito del set di dati in base alle proprie esigenze. Si applicano filtri per definire l'ambito dei dati a team, tipi di elementi di lavoro o backlog specifici. I filtri possono essere applicati anche a proprietà o campi specifici e ai relativi valori corrispondenti. Ad esempio, è possibile applicare filtri per gli elementi di lavoro per restituire solo i bug definiti per il team di Fabrikam Voice e contrassegnati con il cliente.

Modalità di applicazione dei filtri ai dati cronologici

I filtri vengono applicati a ogni revisione di un elemento di lavoro. Si supponga, ad esempio, di avere un elemento di lavoro con le revisioni seguenti:

La revisione più recente (#6) è la revisione corrente dell'elemento di lavoro. Nelle visualizzazioni analisi, se è stato selezionato "Solo corrente" nella scheda Cronologia, si otterrebbe una riga di dati per questo elemento di lavoro, la riga corrente.

Quando si segnala la cronologia, è possibile eseguire il pull delle revisioni da 1 a 6 per la creazione di report.

Si supponga, quando si crea una visualizzazione di Analisi o si configura il widget Burndown, si impostano questi due filtri:

• Percorso area = /Ammiraglii
• I tag contengono customer

L'applicazione di questi filtri al set di revisioni degli elementi di lavoro restituisce le corrispondenze seguenti:

Fiammifero?	Rev #	Data revisione	ID	Title	Provincia	Area Path	Tag
	1	Jan-01	1001	Un bug	Nuovo
	2	Jan-02	1001	Un bug	Nuovo	/Admirals
	3	10 gennaio	1001	Un bug	Attive	/Admirals
	4	12 gennaio	1001	Un bug	Attive	/Admirals	Customer
	5	20 gennaio	1001	Un bug	Risolto	/Admirals	Customer
	6 (corrente)	28 gennaio	1001	Un bug	Chiusa	/Admirals	Customer

Le revisioni 1, 2 e 3 non corrispondono, perché tali revisioni non corrispondono ai filtri. L'elemento di lavoro precedente non verrà visualizzato nel set di dati o nel grafico di tendenza fino alla revisione 4 o al 12 gennaio.

Si supponga di voler segnalare la tendenza dei bug attivi, si creerà un filtro Di stato = Attivo. Questi filtri corrispondono alle revisioni seguenti:

Fiammifero?	Rev #	Data modificata	ID	Title	Provincia	Area Path	Tag
	1	Jan-01	1001	Un bug	Nuovo
	2	Jan-02	1001	Un bug	Nuovo	/Admirals
	3	10 gennaio	1001	Un bug	Attive	/Admirals
	4	12 gennaio	1001	Un bug	Attive	/Admirals	Customer
	5	20 gennaio	1001	Un bug	Risolto	/Admirals	Customer
	6 (corrente)	28 gennaio	1001	Un bug	Chiusa	/Admirals	Customer

I filtri corrispondono solo alla revisione 3 e 4 dell'elemento di lavoro e includono solo le revisioni di gennaio-10 e gennaio-12 nel grafico di tendenza.

Cosa significa questo per Burndown o Burnup?

Quando si configura un widget Burndown o Burnup che filtra per un determinato tag (ad esempio, "Cliente"), gli elementi di lavoro non verranno visualizzati nel burndown fino alla data in cui il tag viene definito per l'elemento di lavoro. Se in qualsiasi momento il tag viene rimosso dall'elemento di lavoro, l'elemento di lavoro proviene dal burndown dopo la data di rimozione del tag .

Alcuni hanno supposto che se la versione corrente di un elemento di lavoro ha il tag, verrà inclusa nel burndown retroattivamente dall'inizio. Ad esempio, se la versione corrente dell'elemento di lavoro ha il tag "Customer", si presuppone che l'elemento di lavoro venga incluso nel burndown dal punto in cui è stato creato l'elemento di lavoro.

Non è il funzionamento del filtro cronologico. Se i filtri sono stati applicati solo in base alla versione corrente di un elemento di lavoro, i grafici di tendenza non funzioneranno. Non è possibile rimuovere un elemento dal burndown rimuovendo un tag o impostando il percorso area su un altro percorso dell'area del team.

Riepilogo

Per riformulare, quando si segnalano dati cronologici, tutti i filtri vengono applicati alla versione dell'elemento di lavoro come punto cronologico nel tempo. Gli elementi di lavoro verranno visualizzati nella tendenza quando soddisfano i criteri di filtro. Scompariranno dalla tendenza quando non soddisfano più i criteri di filtro.

Articoli correlati

• Linee guida per le query di OData Analytics
• Informazioni di riferimento su entità e proprietà per Azure Boards
• Modello di dati per Analytics