Share via

Przykładowy raport czas realizacji i czas cyklu

  • Artykuł

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

Wykresy czasu realizacji i cyklu można utworzyć przy użyciu zapytań podanych w tym artykule. Czas realizacji i czas cyklu wskazują, jak długo trwa przepływ pracy przez potok programowania zespołu. Czas realizacji mierzy całkowity czas, jaki upłynął od momentu utworzenia elementów roboczych do ich ukończenia. Czas cyklu mierzy czas potrzebny zespołowi na ukończenie elementów roboczych po rozpoczęciu aktywnej pracy nad nimi.

Na poniższej ilustracji przedstawiono przykład średniego czasu realizacji podzielonego według przypisań priorytetów w scenariuszach użytkownika.

Zrzut ekranu przedstawiający raport trendu cyklu potencjalnego klienta usługi Power BI.

Aby dowiedzieć się więcej na temat czasu prowadzenia i cyklu, zobacz Widżety czas realizacji i czas cyklu oraz przepływ skumulowany, czas realizacji i wskazówki dotyczące czasu cyklu.

Uwaga

W tym artykule założono, że znasz artykuł Omówienie przykładowych raportów przy użyciu zapytań OData i masz podstawową wiedzę na temat usługi Power BI.

Wymagania wstępne

  • Aby wyświetlić dane analizy i wykonać zapytanie dotyczące usługi, musisz być członkiem projektu z dostępem podstawowym lub większym. Domyślnie wszyscy członkowie projektu otrzymują uprawnienia do wykonywania zapytań w usłudze Analytics i definiowania widoków analizy.
  • Aby dowiedzieć się więcej o innych wymaganiach wstępnych dotyczących włączania usługi i funkcji oraz ogólnych działań śledzenia danych, zobacz Uprawnienia i wymagania wstępne dotyczące dostępu do analizy.

Przykładowe zapytania

Zapytania w tej sekcji obsługują zwracanie danych czasu potencjalnego klienta i cyklu dla ukończonych scenariuszy użytkownika. Zapytania można wykonywać według ścieżek obszaru lub nazw zespołu. Wszystkie te zapytania określają zestaw jednostek w miarę WorkItems zwracania danych obliczonych dla każdego elementu roboczego przez usługę Analytics.

Uwaga

Aby określić dostępne właściwości dla celów filtru lub raportu, zobacz Dokumentacja metadanych dla usługi Azure Boards. Możesz filtrować zapytania lub zwracać właściwości przy użyciu dowolnej z Property wartości dostępnych EntityType w elemecie EntitySetlub NavigationPropertyBinding Path . Każda z nich EntitySet odpowiada elementowi EntityType. Aby dowiedzieć się więcej o typie danych każdej wartości, przejrzyj metadane podane dla odpowiedniego EntityTypeelementu .

Zwracanie czasu i czasu cyklu dla scenariuszy użytkownika i ścieżki obszaru

Możesz wkleić zapytanie usługi Power BI wymienione poniżej bezpośrednio w oknie Pobieranie zapytania pustego> danych. Aby uzyskać więcej informacji, zobacz Omówienie przykładowych raportów przy użyciu zapytań 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

Ciągi podstawienia i podział zapytań

Zastąp następujące ciągi wartościami. Nie dołączaj nawiasów {} do podstawienia. Na przykład jeśli nazwa organizacji to "Fabrikam", zastąp Fabrikamciąg {organization} , a nie {Fabrikam}.

  • {organization} — Nazwa organizacji
  • {project} — Nazwa projektu zespołowego lub całkowicie pomiń "/{project}" dla zapytania obejmującego wiele projektów
  • {areapath} — Ścieżka obszaru. Przykładowy format: Project\Level1\Level2
  • {startdate} — Rozpocznij raport dla elementów zakończonych w dniu lub po danej dacie z formatem: YYYY-MM-DDZ. Na przykład: 2022-04-01Z reprezentuje 2022-Kwiecień-01. Nie ujęć w cudzysłów.

Podział zapytań

W poniższej tabeli opisano każdą część zapytania.

Część kwerendy

Opis

$filter=WorkItemType eq 'User Story'

Zwraca dane dla scenariuszy użytkownika.

and StateCategory eq 'Completed'

Zwróć tylko ukończone elementy. System oblicza wartości dni realizacji i dni cyklu tylko dla elementów roboczych, które zostały ukończone.

Uwaga

Jeśli spojrzysz na nieprzetworzone dane rekordów, mogą pojawić się wpisy, w których CycleTimeDays=0. Dzieje się tak, gdy historia użytkownika lub element roboczy wchodzi w stan kategorii Przepływ pracy w toku i Ukończono w tym samym dniu. Aby uzyskać więcej informacji na temat kategorii stanu przepływu pracy, zobacz How workflow states and state categories are used in Backlogs and Boards (Jak stany i kategorie stanów przepływu pracy są używane w listach prac i tablicach).

and CompletedDate ge {startdate}

Zwracaj elementy, które są ukończone po określonej dacie. Przykład: 2022-04-01Z reprezentuje 2022-kwiecień-01

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

Zwracanie elementów roboczych w ramach określonej ścieżki obszaru określonej w'{areapath}'. Aby filtrować według nazwy zespołu, użyj instrukcji Teams/any(x:x/TeamName eq '{teamname})'filter .

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

Wybierz właściwości do zwrócenia.

, CycleTimeDays, LeadTimeDays, CompletedDateSK

Zwróć właściwości, które obsługują dni realizacji, dni cyklu i CompletedDateSK. CompletedDateSK zwraca wartość daty jako liczbę całkowitą

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

Rozwiń właściwości dla AssignedTojednostek , Iterationi Area i wybierz dla nich pola jednostki.

Zwracanie czasu i czasu cyklu realizacji dla historii użytkowników i zespołów

To zapytanie jest takie samo jak zapytanie podane w poprzedniej sekcji, z wyjątkiem filtrów według kilku nazw zespołów, a nie ścieżek obszaru.

Możesz wkleić zapytanie usługi Power BI wymienione poniżej bezpośrednio w oknie Pobieranie zapytania pustego> danych. Aby uzyskać więcej informacji, zobacz Omówienie przykładowych raportów przy użyciu zapytań 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

(Opcjonalnie) Zmienianie nazwy zapytania

Możesz zmienić nazwę domyślnej etykiety zapytania Query1 na bardziej zrozumiałą. Po prostu wprowadź nową nazwę w okienku Zapytanie Ustawienia.

Zrzut ekranu przedstawiający opcje menu zapytania usługi Power BI, zmień nazwę zapytania.

Przekształcanie danych w Edytor Power Query

W Edytor Power Query wybierz zapytanie z danymi, które chcesz przekształcić. W przypadku wykresu czasu potencjalnego/cyklu należy wykonać następujące przekształcenia:

  • Rozwiń kolumny, takie jak Area, Iterationi AssignedTo.
  • Przekształć typ danych kolumn LeadTimeDays i CycleTimeDays na liczbę KtoTo le.
  • Przekształć typ danych dla kolumny CompletedDateSK z liczby całkowitej na wartość daty.

Aby dowiedzieć się, jak to zrobić, zobacz następujące sekcje w temacie Przekształcanie danych analizy w celu generowania raportów usługi Power BI:

Zamknij zapytanie i zastosuj zmiany

Po zakończeniu wszystkich przekształceń danych wybierz pozycję Zamknij i zastosuj z menu Narzędzia główne , aby zapisać zapytanie i wrócić do karty Raport w usłudze Power BI.

Zrzut ekranu przedstawiający opcję zamknij i zastosuj Edytor Power Query.

Tworzenie wykresu trendu

W poniższym przykładzie nazwa zapytania została zmieniona na LeadCycleTime, ale nie zmieniono nazwy kolumn.

  1. W usłudze Power BI wybierz raport Wykres liniowy w obszarze Wizualizacje.

    Zrzut ekranu przedstawiający opcje Wizualizacje i Pola usługi Power BI dla raportu wykresu trendu czasu realizacji.

  2. Dodaj CompletedDateSK do osi X.

  3. Dodaj LeadTimeDays do osi Y, kliknij prawym przyciskiem myszy i wybierz pozycję Średnia.

  4. Dodaj Priority do legendy.

Zostanie wyświetlony przykładowy raport. Pamiętaj, że po umieszczeniu wskaźnika myszy na dowolnym obszarze w raporcie wyświetlane jest więcej danych.

Zrzut ekranu przedstawiający przykładowy raport wykresu trendu cyklu potencjalnego klienta usługi Power BI.