Beispielberichte zu Fehlern oder Benutzergeschichten öffnen

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Um einen Bericht zu erstellen, der offene Fehler oder Benutzerberichte auflistet, wählen Sie den Matrixbericht in Power BI aus und verwenden Sie eine Abfrage, die den in diesem Artikel aufgeführten ähnelt. Der Bericht, den Sie generieren, listet geöffnete Fehler oder Benutzergeschichten auf, die nach den Feldern "Status" und "Zugewiesen an" aufgeschlüsselt sind, wie in der folgenden Abbildung dargestellt.

Screenshot des Beispielmatrixberichts

Hinweis

In diesem Artikel wird davon ausgegangen, dass Sie eine Übersicht über Beispielberichte mit OData-Abfragen lesen und ein grundlegendes Verständnis von Power BI haben.

Kategorie	Anforderungen
Zugriffsebenen	- Projektmitglied. - Mindestens Basic-Zugriff
Berechtigungen	Standardmäßig verfügen Projektmitglieder über die Berechtigung zum Abfragen von Analysen und Erstellen von Ansichten. Weitere Informationen zu anderen Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datenverfolgungsaktivitäten finden Sie unter Berechtigungen und Voraussetzungen für den Zugriff auf Analytics.

Beispielabfragen

Es werden mehrere Abfragen bereitgestellt, die Fehler oder Benutzergeschichten nach Bereichspfad, Iterationspfad oder Team filtern. Alle diese Abfragen geben die WorkItems Entitätsmenge an, während sie aktuelle und keine historischen Daten zurückgeben.

Hinweis

Informationen zum Ermitteln verfügbarer Eigenschaften für Filter- oder Berichtszwecke finden Sie unter Metadatenreferenz für Azure Boards. Sie können Ihre Abfragen filtern oder Eigenschaften zurückgeben, indem Sie einen der Property-Werte unter einem EntityType oder die NavigationPropertyBinding Path-Werte, die mit einem EntitySet verfügbar sind, verwenden. Jede EntitySet entspricht einem EntityType. Weitere Informationen zum Datentyp der einzelnen Werte erhalten Sie in den Metadaten, die für den entsprechenden Wert EntityTypebereitgestellt werden.

Kopieren Sie die folgende Power BI-Abfrage, und fügen Sie sie direkt in das Fenster Daten abrufen>Leere Abfrage ein. Weitere Informationen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and StateCategory ne 'Completed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Sie können den folgenden OData-Abfragecode verwenden, um die Abfrage vor der Verwendung in Power BI zu ändern oder zu testen. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Power BI- und OData-Abfragen.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Bug'
            and StateCategory ne 'Completed'
            and startswith(Area/AreaPath,'{areapath}')
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Ersetzen Sie die folgenden Zeichenfolgen durch Ihre Werte. Schließen Sie keine Klammern {} in Ihre Substitution ein. Wenn Ihr Organisationsname beispielsweise "Fabrikam" lautet, ersetzen Sie {organization} durch Fabrikam, nicht {Fabrikam}.

{organization} - Name Ihrer Organisation
{project} - Der Name Ihres Teamprojekts oder das vollständige Auslassen von "/{project}" für eine projektübergreifende Abfrage
{areapath}: Ihr Bereichspfad. Beispielformat: Project\Level1\Level2

Abfrageaufschlüsselung

In der folgenden Tabelle werden die einzelnen Teile der Abfrage beschrieben.

Abfrageteil

Beschreibung

$filter=WorkItemType eq 'Bug'

Geben Sie Fehler zurück.

and StateCategory ne 'Completed'

Elemente herausfiltern, die abgeschlossen sind. Weitere Informationen zu Statuskategorien finden Sie unter Verwendung von Workflowkategorien in Azure Boards-Backlogs und -Boards.

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

Und filtern Sie Arbeitselemente unter einem bestimmten Bereichspfad. Verwenden Sie die Filteranweisung Teams/any(x:x/TeamName eq '{teamname})', um nach Teamname zu filtern.

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

Wählen Sie felder aus, die zurückgegeben werden sollen.

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

Wählen Sie erweiterbare Eigenschaftsfelder AssignedTo, Iteration, Area aus.

Nach Teams gefilterte Benutzergeschichten

Statt offene Fehler mithilfe eines Berichtspfads abzurufen, können Sie ein oder mehrere Teams beauftragen.

Power BI-Abfrage
OData-Abfrage

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and StateCategory ne 'Completed'' "
            &"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,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Bug'
            and StateCategory ne 'Completed'
            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,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

Benutzergeschichten in einem bestimmten Bereichspfad und Iterationspfad

Die folgende Abfrage unterstützt das Filtern von Benutzergeschichten für einen bestimmten Bereichspfad und Iterationspfad.

Power BI-Abfrage
OData-Abfrage

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'User Story' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and startswith(Iteration/IterationPath,'{iterationpath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'User Story'
            and startswith(Area/AreaPath,'{areapath}')
            and startswith(Iteration/IterationPath,'{iterationpath}')
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

(Optional) Abfrage umbenennen

Sie können die Standardabfragebezeichnung Query1 in etwas Aussagekräftigeres umbenennen. Geben Sie einfach im Bereich Abfrageeinstellungen einen neuen Namen ein.

Screenshot: Menüoptionen für Power BI-Abfragen, Abfrage umbenennen.

Erweitern von Spalten in Power Query-Editor

Die &$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath) Klausel gibt Datensätze zurück, die mehrere Felder enthalten. Vor dem Erstellen des Berichts müssen Sie den Datensatz erweitern, um ihn in bestimmte Felder zu reduzieren. In diesem Fall sollten Sie die folgenden Datensätze erweitern:

AssignedTo
AreaPath
IterationPath

Informationen dazu finden Sie unter Transform Analytics-Daten zum Generieren von Power BI-Berichten.

(Optional) Umbenennen von Feldern

Nachdem Sie die Spalten erweitert haben, können Sie ein oder mehrere Felder umbenennen. Sie können z. B. die Spalte AreaPath umbenennen in Area Path. Informationen dazu finden Sie unter Umbenennen von Spaltenfeldern.

Schließen Sie die Abfrage, und wenden Sie Ihre Änderungen an.

Nachdem Sie alle Datentransformationen abgeschlossen haben, wählen Sie im Menü Start die Option Übernehmen schließen & aus, um die Abfrage zu speichern und zur Registerkarte Bericht in Power BI zurückzukehren.

Erstellen des Matrixberichts

Wählen Sie in Power BI den Matrixbericht unter "Visualisierungen" aus.
Assigned To zu Zeilen hinzufügen.
State zu Spalten hinzufügen.
Fügen Sie 1WorkItemId1 zu Werten hinzu, und klicken Sie mit der rechten Maustaste auf 1WorkItemId', und stellen Sie sicher, dass Anzahl ausgewählt ist.

Der Beispielbericht wird angezeigt.

Screenshot des Beispiel-Matrixberichts über offene Bugs.

Feedback

War diese Seite hilfreich?

Last updated on 2025-12-17