Report di esempio di tempo di lead time e ciclo
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
È possibile creare grafici lead time e cicli usando le query fornite in questo articolo. Il tempo di lead time e il tempo del ciclo indicano il tempo necessario per il flusso del lavoro attraverso la pipeline di sviluppo di un team. Il lead time misura il tempo totale trascorso dalla creazione di elementi di lavoro al completamento. Il tempo del ciclo misura il tempo necessario per completare gli elementi di lavoro da parte di un team una volta che iniziano attivamente a lavorare su di essi.
L'immagine seguente mostra un esempio per il lead time medio suddiviso in base alle assegnazioni di priorità effettuate alle storie utente.
Per altre informazioni sul lead e sul tempo del ciclo, vedere i widget Lead Time e Cycle Time e Il flusso cumulativo, il lead time e il tempo di ciclo.
Nota
Questo articolo presuppone di avere letto Panoramica dei report di esempio usando query OData e avere una conoscenza di base di Power BI.
Prerequisiti
- Per visualizzare i dati di Analisi ed eseguire query sul servizio, è necessario essere membri di un progetto con accesso basic o superiore. Per impostazione predefinita, a tutti i membri del progetto vengono concesse le autorizzazioni per eseguire query su Analisi e definire le visualizzazioni di Analisi.
- Per altre informazioni sugli altri prerequisiti relativi all'abilitazione di servizi e funzionalità e alle attività generali di rilevamento dei dati, vedere Autorizzazioni e prerequisiti per l'accesso ad Analytics.
Query di esempio
Le query in questa sezione supportano la restituzione di dati relativi a lead e cicli per le storie utente completate. È possibile eseguire una query in base al percorso dell'area o ai nomi del team. Tutte queste query specificano il WorkItems
set di entità quando restituiscono i dati calcolati per ogni elemento di lavoro dal servizio Analisi.
Nota
Per determinare le proprietà disponibili a scopo di filtro o report, vedere Informazioni di riferimento sui metadati per Azure Boards. È possibile filtrare le query o restituire proprietà usando uno qualsiasi dei Property
valori in un EntityType
oggetto o NavigationPropertyBinding Path
i valori disponibili con un oggetto EntitySet
. Ognuno EntitySet
corrisponde a un oggetto EntityType
. Per altre informazioni sul tipo di dati di ogni valore, esaminare i metadati forniti per l'oggetto corrispondente EntityType
.
Restituire il lead time e il tempo del ciclo per le storie utente e il percorso dell'area
È possibile incollare la query di Power BI elencata di seguito direttamente nella finestra Recupera query vuota dati>. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
&"$filter=WorkItemType eq 'User Story' "
&"and StateCategory eq 'Completed' "
&"and CompletedDate ge {startdate} "
&"and startswith(Area/AreaPath,'{areapath}') "
&"&$select=WorkItemId,Title,WorkItemType,State,Priority,AreaSK "
&",CycleTimeDays,LeadTimeDays,CompletedDateSK "
&"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Stringhe di sostituzione e scomposizione delle query
Sostituire le stringhe seguenti con i valori. Non includere parentesi quadre {} con la sostituzione. Ad esempio, se il nome dell'organizzazione è "Fabrikam", sostituire {organization}
con Fabrikam
, non {Fabrikam}
.
{organization}
- Nome dell'organizzazione{project}
- Nome del progetto team o omettere completamente "/{project}" per una query tra progetti{areapath}
- Il percorso dell'area. Formato di esempio:Project\Level1\Level2
{startdate}
- Avviare il report per gli elementi completati in o dopo una data specifica con il formato :YYYY-MM-DDZ
. Ad esempio:2022-04-01Z
rappresenta il 2022-aprile-01. Non racchiudere tra virgolette.
Suddivisione delle query
La tabella seguente descrive ogni parte della query.
Parte della query
Descrizione
$filter=WorkItemType eq 'User Story'
Restituire i dati per le storie utente.
and StateCategory eq 'Completed'
Restituisce solo gli elementi completati. Il sistema calcola i valori per i giorni di lead time e i giorni di tempo del ciclo solo per gli elementi di lavoro completati.
Nota
Se si esaminano i dati non elaborati dei record, è possibile che vengano visualizzate voci in cui CycleTimeDays=0
. Ciò si verifica quando l'elemento di lavoro o la storia utente entra nello stato della categoria del flusso di lavoro In corso e Completato nello stesso giorno. Per altre informazioni sulle categorie di stato del flusso di lavoro, vedere How workflow states and state categories are used in Backlogs and Boards.
and CompletedDate ge {startdate}
Restituisce gli elementi completati dopo la data specificata. Esempio: 2022-04-01Z rappresenta il 2022-aprile-01
and startswith(Area/AreaPath,'{areapath}')
Restituisce elementi di lavoro in un percorso di area specifico specificato in'{areapath}'
. Per filtrare in base al nome del team, usare l'istruzione Teams/any(x:x/TeamName eq '{teamname})'
filter .
&$select=WorkItemId, Title, WorkItemType, State, Priority
Selezionare le proprietà da restituire.
, CycleTimeDays, LeadTimeDays, CompletedDateSK
Restituisce le proprietà che supportano i lead time days, cycle time days e CompletedDateSK
. CompletedDateSK restituisce un valore di data come numero intero
&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)
Espandere le proprietà per AssignedTo
le entità , Iteration
e Area
e selezionare i campi di entità per tali entità.
Restituire lead time e ciclo per storie utente e team
Questa query è identica a quella fornita nella sezione precedente, ad eccezione dei filtri in base a diversi nomi del team anziché ai percorsi di area.
È possibile incollare la query di Power BI elencata di seguito direttamente nella finestra Recupera query vuota dati>. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
&"$filter=WorkItemType eq 'User Story' "
&"and StateCategory eq 'Completed' "
&"and CompletedDate ge {startdate} "
&"and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) "
&"&$select=WorkItemId,Title,WorkItemType,State,Priority,AreaSK "
&",CycleTimeDays,LeadTimeDays,CompletedDateSK "
&"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
(Facoltativo) Rinominare la query
È possibile rinominare l'etichetta di query predefinita Query1 in qualcosa di più significativo. È sufficiente immettere un nuovo nome dal riquadro Query Impostazioni.
Trasformare i dati in editor di Power Query
Nella editor di Power Query scegliere la query con i dati da trasformare. Per un grafico tempo lead/ciclo, è necessario apportare le trasformazioni seguenti:
- Espandere colonne come
Area
,Iteration
eAssignedTo
. - Trasformare il tipo di dati per le
LeadTimeDays
colonne eCycleTimeDays
in un numero intero. - Trasformare il tipo di dati per la
CompletedDateSK
colonna da un numero intero a un valore di data.
Per informazioni su come, vedere le sezioni seguenti in Trasformare i dati di Analisi per generare report di Power BI:
- Espandere le colonne.
- Trasformare le colonne LeadTimeDays e CycleTimeDays in numeri interi.
- Trasformare un tipo di dati di colonna.
Chiudere la query e applicare le modifiche
Dopo aver completato tutte le trasformazioni dei dati, scegliere Chiudi e applica dal menu Home per salvare la query e tornare alla scheda Report in Power BI.
Creare il grafico di tendenza
Nell'esempio seguente la query è stata rinominata LeadCycleTime, ma non sono state rinominate colonne.
In Power BI scegliere il report Grafico a linee in Visualizzazioni.
Aggiungere
CompletedDateSK
all'asse X.Aggiungere
LeadTimeDays
all'asse Y, fare clic con il pulsante destro del mouse e scegliere Media.Aggiungi
Priority
alla legenda.
Viene visualizzato il report di esempio. Si noti che quando si passa il puntatore del mouse su qualsiasi area del report, vengono visualizzati altri dati.
Articoli correlati
- Panoramica dei report di esempio che usano query OData
- Costruire query OData per Analytics
- Connessione con le query di Power BI e OData
- Informazioni di riferimento sui metadati per Analisi di Azure Boards
- Report di esempio e indice di riferimento rapido
- Aggiungere un filtro dei dati team a un report esistente
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per