Condividi tramite

Report di esempio di tempo di lead time e ciclo

  • Articolo

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.

Screenshot del report del grafico delle tendenze del ciclo dei lead di Power BI.

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 AssignedTole entità , Iteratione 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.

Screenshot delle opzioni del menu query di Power BI, rinominare la query.

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, Iteratione AssignedTo.
  • Trasformare il tipo di dati per le LeadTimeDays colonne e CycleTimeDays 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:

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.

Screenshot dell'opzione Chiudi e applica editor di Power Query.

Creare il grafico di tendenza

Nell'esempio seguente la query è stata rinominata LeadCycleTime, ma non sono state rinominate colonne.

  1. In Power BI scegliere il report Grafico a linee in Visualizzazioni.

    Screenshot delle visualizzazioni di Power BI e delle selezioni campi per il report grafico delle tendenze lead time.

  2. Aggiungere CompletedDateSK all'asse X.

  3. Aggiungere LeadTimeDays all'asse Y, fare clic con il pulsante destro del mouse e scegliere Media.

  4. 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.

Screenshot del report del grafico di tendenza del ciclo di lead di Power BI di esempio.