Beispielberichte zu Fehlern oder Benutzergeschichten öffnen

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

Wenn Sie einen Bericht generieren möchten, der geöffnete Fehler oder Benutzerabschnitte auflistet, wählen Sie den Matrixbericht in Power BI aus, und verwenden Sie eine Abfrage ähnlich den in diesem Artikel aufgeführten. 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 die Übersicht über Beispielberichte mit OData-Abfragen gelesen haben und über ein grundlegendes Verständnis von Power BI verfügen.

Voraussetzungen

  • Um Analytics-Daten anzuzeigen und den Dienst abzufragen, müssen Sie Mitglied eines Projekts mit oder höherer Basiszugriff sein. Standardmäßig erhalten alle Projektmitglieder Berechtigungen zum Abfragen von Analytics und zum Definieren von Analytics-Ansichten.
  • Weitere Informationen zu weiteren Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datennachverfolgungsaktivitä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 Werte unter oder NavigationPropertyBinding PathEntityType verwenden, die Property mit einem EntitySetverfügbar sind. Jede EntitySet entspricht einem EntityType. Weitere Informationen zum Datentyp der einzelnen Werte finden Sie in den Metadaten, die für den entsprechenden EntityTypebereitgestellt werden.

Nach Bereichspfad gefilterte Fehler

Sie können die unten aufgeführte Power BI-Abfrage direkt in das Fenster Get Data-Blank> Query einfügen. 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

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Ersetzen Sie die folgenden Zeichenfolgen durch Ihre Werte. Schließen Sie keine Klammern {} in Ihre Ersetzung 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'

Gibt 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 Arbeitsaufgaben 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)

Select expandable property fields AssignedTo, Iteration, Area.

Nach Teams gefilterte Benutzergeschichten

Sie können offene Fehler von einem oder mehreren Teams anstelle von Bereichspfad abfragen.

Sie können die unten aufgeführte Power BI-Abfrage direkt in das Fenster Get Data-Blank> Query einfügen. 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 (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

Benutzergeschichten in einem bestimmten Bereichspfad und Iterationspfad

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

Sie können die unten aufgeführte Power BI-Abfrage direkt in das Fenster Get Data-Blank> Query einfügen. 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 '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

(Optional) Abfrage umbenennen

Sie können die Standardabfragebezeichnung Query1 in aussagekräftiger 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 "Schließen" und "Übernehmen " im Menü "Start " aus, um die Abfrage zu speichern und zur Registerkarte "Bericht " in Power BI zurückzukehren.

Screenshot der Option

Erstellen des Matrixberichts

  1. Wählen Sie in Power BI den Matrixbericht unter "Visualisierungen" aus.

    Screenshot der Auswahl von Power BI-Visualisierungen und -Feldern für den Bericht

  2. Zu Zeilen hinzufügenAssigned To.

  3. Zu Spalten hinzufügenState.

  4. 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 Beispielberichts zum Öffnen von Fehlern.