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, pobierz go i zainstaluj bezpłatnie.

Wymagania wstępne

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

• Być członkiem projektu. Jeśli nie jesteś, dodaj 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.
• Włącz tablice. Aby ponownie włączyć tablice, zobacz Włączanie lub wyłączanie usługi Azure DevOps.
• Aktualizacja programu Power BI Desktop z października 2018 r. lub nowsza.
• Śledzenie elementów roboczych przez pewien okres czasu, na którym ma być generowany raport trendu.

Tworzenie zapytania usługi Power BI

Utwórz zapytanie usługi Power BI w celu ściągnięcia danych 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
      The query you provided has a syntax issue due to the placement of double quotes. Specifically, the `$apply` and `$orderby` parameters should be part of the URL string, but they are not correctly concatenated. Here is the corrected version:
   
   

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

1. 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.

   

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

   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 uzyskać więcej informacji na temat tych właściwości, 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 należy rozwinąć. Te pola są wyświetlane z polem Rekord wymieniony w kolumnie tabeli po usunięciu rozciągniętym.

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

• 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