Tworzenie raportu usługi Power BI przy użyciu zapytania OData

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

Program Power BI Desktop umożliwia łatwe rozpoczęcie tworzenia raportów dla projektu w usłudze Azure DevOps.

Jeśli nie masz programu Power BI Desktop, możesz pobrać go i zainstalować bezpłatnie.

Wykonaj kroki, aby utworzyć raport w programie Power BI Desktop, który pokazuje dzienny trend błędów.

• Tworzenie zapytania usługi Power BI
• Tworzenie przekształceń usługi Power BI
• Tworzenie raportu trendu otwartych usterek

Wymagania wstępne

Aby utworzyć raport usługi Power BI, należy spełnić następujące kryteria:

• Musisz być członkiem projektu. Jeśli nie masz jeszcze projektu, utwórz go. Zobacz Bezpłatne tworzenie konta.
• Jeśli nie dodano Cię jako członka projektu, dodaj go teraz. Każda osoba mająca dostęp do projektu, z wyjątkiem osób biorących udział w projekcie, może wyświetlać widoki analizy.
• Ustaw uprawnienie Wyświetl analizę na Zezwalaj. Zobacz Udzielanie uprawnień dostępu do analizy.
• Tablice muszą być włączone. Aby ją ponownie włączyć, zobacz Włączanie lub wyłączanie usługi Azure DevOps.
• Zainstalowano aktualizację programu Power BI Desktop z października 2018 r. lub nowszą. Tę aplikację kliencą można pobrać z oficjalnej strony pobierania programu Power BI Desktop.
• Śledzenie elementów roboczych przez pewien czas, na którym ma być generowany raport trendu.

Tworzenie zapytania usługi Power BI

Utwórz zapytanie usługi Power BI, aby ściągnąć dane do usługi Power BI w następujący sposób:

1. Wybierz pozycję Pobierz dane, a następnie pozycję Puste zapytanie.

   

2. W edytorze Power BI Query wybierz pozycję Edytor zaawansowany.

   

3. Zostanie otwarte okno Edytor zaawansowany.

   

4. Zastąp zawartość następującym zapytaniem.

   let
      Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/WorkItemSnapshot? "
         $apply=filter(
             WorkItemType eq 'Bug'  
         AND StateCategory ne 'Completed'  
         AND startswith(Area/AreaPath,'{areapath}')  
         AND DateValue ge {startdate} )/
         groupby((DateValue,State,WorkItemType,Area/AreaPath), aggregate($count as Count))  
         &$orderby=DateValue"
        ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
   in
       Source
   

   

5. Zastąp wartości w przykładowym zapytaniu.

   Przykładowe zapytanie zawiera ciągi, które należy zastąpić wartościami:

   • {organization} — Nazwa organizacji
   • {project} — Nazwa projektu zespołowego. Lub całkowicie pomiń /{project} zapytanie obejmujące wiele projektów
   • {areapath} — Ścieżka obszaru. Format: Project\Level1\Level2
   • {startdate} — Data rozpoczęcia raportu trendu. Format: RRRR-MM-DDZ. Przykład: 2022-09-01Z reprezentuje 2022-wrzesień-01. Nie ujęć w cudzysłów.

   

6. Wybierz pozycję Gotowe , aby wykonać zapytanie.

   Jeśli nigdy nie nawiązano połączenia z kontem, usługa Power BI może wymagać uwierzytelnienia. Aby uzyskać więcej informacji, zobacz Opcje uwierzytelniania klienta.

Rozwiń kolumny Area (Obszar), Iteration (Iteracja), AssignedTo (Przypisane)

Zapytanie zwraca kilka kolumn, które należy rozwinąć, zanim będzie można ich używać w usłudze Power BI. Każda jednostka ściągana przy użyciu $expand instrukcji zwraca rekord z potencjalnie kilkoma polami. Musisz rozwinąć rekord, aby spłaszczyć jednostkę w jego polach. Przykłady takich jednostek to: AssignedTo, Iterationi Area.

Po zamknięciu Edytor zaawansowany i zachowaniu w Edytor Power Query wybierz przycisk rozwijania dla jednostek, które chcesz spłaszczać.

1. Na przykład wybierz przycisk rozwiń dla pozycji Obszar, wybierz właściwości, które chcesz rozwinąć, a następnie wybierz przycisk OK. Tutaj wybieramy i AreaPath spłaszczamyAreaName. Właściwość jest podobna AreaName do pola Nazwa węzła.

   

   Uwaga

   Dostępne właściwości do wybrania zależą od właściwości żądanych do zwrócenia w zapytaniu. Jeśli nie określisz żadnych właściwości, wszystkie właściwości są dostępne. Aby dowiedzieć się więcej o tych właściwościach, zobacz następujące odwołania do metadanych: Obszary, Iteracji i Użytkownicy.

2. Tabela zawiera teraz pola jednostek.

   

3. Powtórz kroki od 1 do 3 dla wszystkich pól reprezentujących jednostki, które wymagają rozszerzenia. Są one wyświetlane z rekordem wymienionym w kolumnie tabeli, gdy nie jest rozpiętywane.

Zmień nazwy pól i zapytania, a następnie zamknij i zastosuj

Po zakończeniu możesz zmienić nazwę kolumn.

1. Kliknij prawym przyciskiem myszy nagłówek kolumny i wybierz polecenie Zmień nazwę...

   

2. Możesz również zmienić nazwę zapytania z domyślnego zapytania Query1 na bardziej zrozumiałą.

   

3. Po zakończeniu wybierz pozycję Zamknij i zastosuj , aby zapisać zapytanie i wrócić do usługi Power BI.

   

Tworzenie raportu

Usługa Power BI wyświetla pola, na których można raportować.

Uwaga

W poniższym przykładzie przyjęto założenie, że nikt nie zmienił nazwy żadnych kolumn.

W przypadku prostego raportu wykonaj następujące czynności:

1. Wybierz pozycję Wykres liniowy wizualizacji usługi Power BI.
2. Dodawanie pola "DateValue" do osi
   • Kliknij prawym przyciskiem myszy pozycję "DateValue" i wybierz pozycję "DateValue", a nie pozycję Hierarchia dat
3. Dodawanie pola "State" do legendy
4. Dodaj pole "Count" (Liczba) do wartości
   • Kliknij prawym przyciskiem myszy pole WorkItemId i upewnij się, że wybrano pozycję Suma

Przykładowy raport:

Następne kroki

Tworzenie raportu Otwartych usterek

Powiązane artykuły

• Omówienie przykładowych raportów korzystających z zapytań OData
• Konstruowanie zapytań OData na potrzeby analizy
• Nawiązywanie połączenia przy użyciu zapytań usługi Power BI i OData
• Dokumentacja metadanych usługi Azure Boards Analytics
• Przykładowe raporty i szybki indeks referencyjny
• Dodawanie fragmentatora zespołu do istniejącego raportu