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.
- Musisz być członkiem projektu. Jeśli nie masz jeszcze projektu, utwórz go.
- 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.
- Włączono lub zainstalowano usługę Analytics. Aby dodać rozszerzenia lub włączyć usługę, musisz być właścicielem konta lub członkiem grupy Administratorzy kolekcji projektów.
- Tablice muszą być włączone. Aby ją ponownie włączyć, zobacz Włączanie lub wyłączanie usługi Azure DevOps.
- Ustaw uprawnienie Wyświetl analizę na Zezwalaj. Zobacz Udzielanie uprawnień dostępu do analizy.
- 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:
Wybierz pozycję Pobierz dane, a następnie pozycję Puste zapytanie.
W edytorze Power BI Query wybierz pozycję Edytor zaawansowany.
Zostanie otwarte okno Edytor zaawansowany.
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
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.
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
, Iteration
i Area
.
Po zamknięciu Edytor zaawansowany i zachowaniu w Edytor Power Query wybierz przycisk rozwijania dla jednostek, które chcesz spłaszczać.
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 podobnaAreaName
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.
Tabela zawiera teraz pola jednostek.
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.
Kliknij prawym przyciskiem myszy nagłówek kolumny i wybierz polecenie Zmień nazwę...
Możesz również zmienić nazwę zapytania z domyślnego zapytania Query1 na bardziej zrozumiałą.
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:
- Wybierz pozycję Wykres liniowy wizualizacji usługi Power BI.
- Dodawanie pola "DateValue" do osi
- Kliknij prawym przyciskiem myszy pozycję "DateValue" i wybierz pozycję "DateValue", a nie pozycję Hierarchia dat
- Dodawanie pola "State" do legendy
- 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
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
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla