Przykładowy raport czas realizacji i czas cyklu

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.

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

Uwaga

W tym artykule założono, że zapoznasz się z omówieniem przykładowych raportów przy użyciu zapytań OData i masz podstawową wiedzę na temat usługi Power BI.

Wymagania wstępne

• Dostęp: być członkiem projektu z co najmniej dostępem podstawowym.
• Uprawnienia: domyślnie członkowie projektu mają uprawnienia do wykonywania zapytań w usłudze Analytics i tworzenia widoków.
• Aby uzyskać więcej informacji na temat innych wymagań 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 uzyskać więcej informacji na temat typu danych każdej wartości, zapoznaj się z metadanymi podanymi dla odpowiedniego EntityTypeelementu .

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

Zapytanie usługi Power BI

Skopiuj i wklej następujące zapytanie usługi Power BI bezpośrednio w oknie Pobieranie pustego >zapytania. 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

Zapytanie OData

Możesz użyć następującego kodu zapytania OData, aby zmodyfikować lub przetestować zapytanie przed użyciem go w usłudze Power BI. Aby uzyskać więcej informacji, zobacz Connect using Power BI and OData queries (Nawiązywanie połączenia przy użyciu zapytań usługi Power BI i OData).

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)

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.

Zapytanie usługi Power BI

Skopiuj i wklej następujące zapytanie usługi Power BI bezpośrednio w oknie Pobieranie pustego >zapytania. 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

Zapytanie OData

Możesz użyć następującego kodu zapytania OData, aby zmodyfikować lub przetestować zapytanie przed użyciem go w usłudze Power BI. Aby uzyskać więcej informacji, zobacz Connect using Power BI and OData queries (Nawiązywanie połączenia przy użyciu zapytań usługi Power BI i OData).

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)

(Opcjonalnie) Zmienianie nazwy zapytania

Możesz zmienić nazwę domyślnej etykiety zapytania Query1 na bardziej zrozumiałą. Po prostu wprowadź nową nazwę w okienku Ustawienia 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ę całkowitą.
• 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:

• Rozwiń kolumny.
• Przekształć kolumny LeadTimeDays i CycleTimeDays na liczby całkowite.
• Przekształcanie typu danych kolumny.

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.

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.

   

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.

Powiązane artykuły

• Eksplorowanie przykładowych raportów przy użyciu zapytań OData
• Konstruowanie zapytań OData na potrzeby analizy
• Nawiązywanie połączenia z usługą Power BI przy użyciu zapytań OData
• Zapoznaj się z metadanymi usługi Azure Boards Analytics
• Uzyskiwanie dostępu do przykładowych raportów i szybkiego indeksu referencyjnego
• Dodawanie fragmentatora zespołu do istniejącego raportu