Lead time and Cycle time sample report

  • Artikel

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

Mithilfe der in diesem Artikel bereitgestellten Abfragen können Sie Leadzeit- und Zyklusdiagramme erstellen. Lead time and cycle time indicate how long it takes for work to flow through a team's development pipeline. Die Leadzeit misst die Gesamtzeit, die von der Erstellung von Arbeitsaufgaben bis zum Abschluss verstrichen ist. Zykluszeit misst die Zeit, die ein Team benötigt, um Arbeitsaufgaben abzuschließen, sobald sie aktiv daran arbeiten.

Die folgende Abbildung zeigt ein Beispiel für eine durchschnittliche Vorlaufzeit, die nach Prioritätszuweisungen für die Benutzergeschichten aufgeschlüsselt ist.

Screenshot des Power BI Lead Cycle Time-Trenddiagrammberichts.

Weitere Informationen zu Lead- und Zykluszeit finden Sie unter Lead Time and Cycle Time Widgets und kumulierter Fluss, Leadzeit und Zykluszeitleitfaden.

Hinweis

In diesem Artikel wird davon ausgegangen, dass Sie die Übersicht über Beispielberichte mit OData-Abfragen gelesen haben und über ein grundlegendes Verständnis von Power BI verfügen.

Voraussetzungen

  • Um Analytics-Daten anzuzeigen und den Dienst abzufragen, müssen Sie Mitglied eines Projekts mit oder höherer Basiszugriff sein. Standardmäßig erhalten alle Projektmitglieder Berechtigungen zum Abfragen von Analytics und zum Definieren von Analytics-Ansichten.
  • Weitere Informationen zu weiteren Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datennachverfolgungsaktivitäten finden Sie unter Berechtigungen und Voraussetzungen für den Zugriff auf Analytics.

Beispielabfragen

Abfragen in diesem Abschnitt unterstützen das Zurückgeben von Lead- und Zykluszeitdaten für abgeschlossene User Stories. Sie können nach Bereichspfad oder Teamnamen abfragen. Alle diese Abfragen geben den WorkItems Entitätssatz an, da sie Daten zurückgeben, die für jede Arbeitsaufgabe vom Analysedienst berechnet werden.

Hinweis

Informationen zum Ermitteln verfügbarer Eigenschaften für Filter- oder Berichtszwecke finden Sie unter Metadatenreferenz für Azure Boards. Sie können Ihre Abfragen filtern oder Eigenschaften zurückgeben, indem Sie einen der Werte unter oder NavigationPropertyBinding PathEntityType verwenden, die Property mit einem EntitySetverfügbar sind. Jede EntitySet entspricht einem EntityType. Weitere Informationen zum Datentyp der einzelnen Werte finden Sie in den Metadaten, die für den entsprechenden EntityTypebereitgestellt werden.

Leadzeit und Zykluszeit für Benutzergeschichten und Bereichspfade zurückgeben

Sie können die unten aufgeführte Power BI-Abfrage direkt in das Fenster Get Data-Blank> Query einfügen. Weitere Informationen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen.

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

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Ersetzen Sie die folgenden Zeichenfolgen durch Ihre Werte. Schließen Sie keine Klammern {} in Ihre Ersetzung ein. Wenn Ihr Organisationsname beispielsweise "Fabrikam" lautet, ersetzen Sie {organization} durch Fabrikam, nicht {Fabrikam}.

  • {organization} - Name Ihrer Organisation
  • {project} - Der Name Ihres Teamprojekts oder das vollständige Auslassen von "/{project}" für eine projektübergreifende Abfrage
  • {areapath} - Ihr Bereichspfad. Beispielformat: Project\Level1\Level2
  • {startdate} - Beginnen Sie Ihren Bericht für Elemente, die am oder nach einem bestimmten Datum mit dem Format abgeschlossen wurden: YYYY-MM-DDZ. Beispiel: 2022-04-01Z stellt 2022-April-01 dar. Schließen Sie keine Anführungszeichen ein.

Abfrageaufschlüsselung

In der folgenden Tabelle werden die einzelnen Teile der Abfrage beschrieben.

Abfrageteil

Beschreibung

$filter=WorkItemType eq 'User Story'

Gibt Daten für User Stories zurück.

and StateCategory eq 'Completed'

Gibt nur abgeschlossene Elemente zurück. Das System berechnet werte für Lead Time Days und Cycle Time Days only for work items that have completed.

Hinweis

Wenn Sie die Rohdaten von Datensätzen betrachten, werden möglicherweise Einträge angezeigt, in denen CycleTimeDays=0. Dies tritt auf, wenn der Benutzerabschnitt oder die Arbeitsaufgabe am selben Tag einen Status der Workflowkategorie "In Bearbeitung " und "Abgeschlossen " eingibt. Weitere Informationen zu Workflowstatuskategorien finden Sie unter Verwendung von Workflowzuständen und Statuskategorien in Backlogs und Boards.

and CompletedDate ge {startdate}

Gibt Elemente zurück, die nach dem angegebenen Datum abgeschlossen sind. Beispiel: 2022-04-01Z steht für 2022-April-01

and startswith(Area/AreaPath,'{areapath}')

Geben Sie Arbeitsaufgaben unter einem bestimmten Bereichspfad zurück, in'{areapath}' dem Sie angeben. Verwenden Sie die Filteranweisung Teams/any(x:x/TeamName eq '{teamname})', um nach Teamnamen zu filtern.

&$select=WorkItemId, Title, WorkItemType, State, Priority

Wählen Sie die zurückzugebenden Eigenschaften aus.

, CycleTimeDays, LeadTimeDays, CompletedDateSK

Gibt die Eigenschaften zurück , die Lead time Days, Cycle Time Days und CompletedDateSK. CompletedDateSK gibt einen Datumswert als ganze Zahl zurück.

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

Erweitern Sie die Eigenschaften für AssignedTo, Iterationund Area Entitäten, und wählen Sie Entitätsfelder für sie aus.

Leadzeit und Zykluszeit für Benutzergeschichten und -teams zurückgeben

Diese Abfrage ist identisch mit der im vorherigen Abschnitt angegebenen Abfrage, mit der Ausnahme, dass sie nach mehreren Teamnamen und nicht nach Bereichspfaden gefiltert wird.

Sie können die unten aufgeführte Power BI-Abfrage direkt in das Fenster Get Data-Blank> Query einfügen. Weitere Informationen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen.

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

(Optional) Abfrage umbenennen

Sie können die Standardabfragebezeichnung Query1 in aussagekräftiger umbenennen. Geben Sie einfach im Bereich Abfrageeinstellungen einen neuen Namen ein.

Screenshot: Menüoptionen für Power BI-Abfragen, Abfrage umbenennen.

Transformieren von Daten in Power Query-Editor

Wählen Sie im Power Query-Editor die Abfrage mit den Daten aus, die Sie transformieren möchten. Für ein Lead/Cycle-Zeitdiagramm sollten Sie die folgenden Transformationen vornehmen:

  • Erweitern von Spalten wie Area, Iteration, und AssignedTo.
  • Transformieren Sie den Datentyp für die und CycleTimeDays die LeadTimeDays Spalten in eine Wer le-Zahl.
  • Transformieren Sie den Datentyp für die CompletedDateSK Spalte von einer ganzen Zahl in einen Datumswert.

Informationen dazu finden Sie in den folgenden Abschnitten in Transform Analytics-Daten zum Generieren von Power BI-Berichten:

Schließen Sie die Abfrage, und wenden Sie Ihre Änderungen an.

Nachdem Sie alle Datentransformationen abgeschlossen haben, wählen Sie "Schließen" und "Übernehmen " im Menü "Start " aus, um die Abfrage zu speichern und zur Registerkarte "Bericht " in Power BI zurückzukehren.

Screenshot der Option

Erstellen des Trenddiagramms

Im folgenden Beispiel wurde die Abfrage in "LeadCycleTime" umbenannt, aber keine Spalten umbenannt.

  1. Wählen Sie in Power BI den Bericht "Liniendiagramm" unter "Visualisierungen" aus.

    Screenshot der Auswahl von Power BI-Visualisierungen und -Feldern für den Trenddiagrammbericht

  2. Zur X-Achse hinzufügenCompletedDateSK.

  3. Fügen Sie der Y-Achse hinzu, klicken Sie mit der rechten Maustaste, und wählen Sie "Mittelwert" aus.LeadTimeDays

  4. Zur Legende hinzufügenPriority.

Der Beispielbericht wird angezeigt. Beachten Sie, dass beim Daraufzeigen auf einen beliebigen Bereich im Bericht weitere Daten angezeigt werden.

Screenshot des Beispielberichts zum Power BI-Leadzyklus-Trenddiagramm.