Lead time and Cycle time sample report
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.
Weitere Informationen zu Lead- und Zykluszeit finden Sie unter Lead Time and Cycle Time Widgets und cumulative flow, lead time, and cycle time guidance.
Hinweis
In diesem Artikel wird davon ausgegangen, dass Sie eine Übersicht über Beispielberichte mit OData-Abfragen lesen und ein grundlegendes Verständnis von Power BI haben.
Voraussetzungen
- Access: Mitglied eines Projekts mit mindestens standardem Zugriff sein.
- Berechtigungen: Standardmäßig verfügen Projektmitglieder über die Berechtigung zum Abfragen von Analysen und Erstellen von Ansichten.
- Weitere Informationen zu anderen Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datenverfolgungsaktivitä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 Path
EntityType
verwenden, die Property
mit einem EntitySet
verfügbar sind. Jede EntitySet
entspricht einem EntityType
. Weitere Informationen zum Datentyp der einzelnen Werte erhalten Sie in den Metadaten, die für den entsprechenden Wert EntityType
bereitgestellt werden.
Leadzeit und Zykluszeit für Benutzergeschichten und Bereichspfade zurückgeben
Kopieren Sie die folgende Power BI-Abfrage, und fügen Sie sie direkt in das Fenster "Leere Datenabfrage> abrufen" ein. 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
, Iteration
und 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.
Kopieren Sie die folgende Power BI-Abfrage, und fügen Sie sie direkt in das Fenster "Leere Datenabfrage> abrufen" ein. 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.
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
, undAssignedTo
. - Transformieren Sie den Datentyp für die und
CycleTimeDays
dieLeadTimeDays
Spalten in eine ganze 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:
- Spalten erweitern.
- Transformieren Sie die Spalten "LeadTimeDays" und "CycleTimeDays" in ganze Zahlen.
- Transformieren eines Spaltendatentyps.
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.
Erstellen des Trenddiagramms
Im folgenden Beispiel wurde die Abfrage in "LeadCycleTime" umbenannt, aber keine Spalten umbenannt.
Wählen Sie in Power BI den Bericht "Liniendiagramm" unter "Visualisierungen" aus.
Zur X-Achse hinzufügen
CompletedDateSK
.Fügen Sie der Y-Achse hinzu, klicken Sie mit der rechten Maustaste, und wählen Sie "Mittelwert" aus.
LeadTimeDays
Zur Legende hinzufügen
Priority
.
Der Beispielbericht wird angezeigt. Beachten Sie, dass beim Daraufzeigen auf einen beliebigen Bereich im Bericht weitere Daten angezeigt werden.
Verwandte Artikel
- Erkunden von Beispielberichten mithilfe von OData-Abfragen
- Erstellen von OData-Abfragen für Analytics
- Herstellen einer Verbindung mit Power BI mithilfe von OData-Abfragen
- Informationen zu Metadaten für Azure Boards Analytics
- Access-Beispielberichte und Kurzübersichtsindex
- Hinzufügen eines Teamdatenschnitts zu einem vorhandenen Bericht