Condividi tramite

Report di esempio sui tempi 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 lead time e il tempo del ciclo indicano quanto tempo è necessario affinché il lavoro scorra attraverso la pipeline di sviluppo del 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 tempo di ciclo dei lead di Power BI.

Per ulteriori informazioni sul tempo di consegna e sul tempo del ciclo, vedere i widget Lead Time e Cycle Time e la guida su flusso cumulativo, tempo di consegna e tempo del ciclo.

Nota

Questo articolo presuppone che lei abbia letto Panoramica dei report di esempio usando le query OData e abbia una conoscenza di base di Power BI.

Categoria Requisiti
Livelli di accesso - membro del progetto.
- Accesso almeno di livello di base.
Autorizzazioni Per impostazione predefinita, i membri del progetto dispongono dell'autorizzazione per eseguire query su Analisi e creare viste. 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à utilizzando uno qualsiasi dei valori Property all'interno di un EntityType oppure i valori disponibili con un NavigationPropertyBinding Path in 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

Copia e incolla la query di Power BI seguente direttamente nella finestra Recupera dati>Query vuota. 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 le parentesi angolari {} con la tua sostituzione. Ad esempio, se il nome dell'organizzazione è "Fabrikam", sostituire {organization} con Fabrikam, non {Fabrikam}.

  • {organization} - Nome dell'organizzazione
  • {project} - Nome del progetto del team, oppure 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}')

Restituisci gli elementi di lavoro sotto un'Area Path specifica che specifichi 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

Restituisci le proprietà che supportano i giorni di tempo di consegna, i giorni di tempo di ciclo e CompletedDateSK. CompletedDateSK restituisce un valore di data come numero intero

&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)

Espandere le proprietà delle entità AssignedTo, Iteration e Area e selezionare i campi di entità per esse.

Restituire Lead Time e Cycle Time per le storie utente e i team

Questa query è identica a quella fornita nella sezione precedente, tranne che filtra in base a diversi nomi di team anziché ai percorsi di area.

Copiare e incollare la seguente query di Power BI direttamente nella finestra Recupera dati>Query vuota. 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 Impostazioni Query.

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:

  • Espandi colonne come Area, Iteration e 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 nell'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 di esempio del grafico del ciclo di lead di Power BI nel tempo.