Hinzufügen eines Teamdatenschnitts zu einem Power BI-Bericht

  • Artikel

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

Häufig enthalten Power BI-Berichte Daten aus mehreren Teams für Aggregation und Vergleich. In diesem Artikel wird gezeigt, wie Sie einem vorhandenen Power BI-Bericht einen Teamdatenschnitt hinzufügen. Mit dem Teamdatenschnitt können Sie die Berichtsdaten nach Teams und nicht nach Bereichspfad filtern.

Wichtig

Der Teamfilter erfordert, dass das Feld "AreaSK" in der Abfrage enthalten ist, die vom Bericht verwendet wird, den Sie filtern möchten. Alle in den Beispielberichten bereitgestellten Abfragen enthalten bereits "AreaSK". Wenn Sie eine eigene Abfrage erstellt haben, stellen Sie sicher, dass sie "AreaSK" in den Klauseln $select oder groupby() zurückgibt.

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

Um einen Teamdatenschnitt in einem Power BI-Bericht zu verwenden, müssen Sie Ihrem Power BI-Bericht eine weitere Abfrage hinzufügen. Die folgende Abfrage gibt die Zuordnung zwischen Teams und Flächenpfaden zurück.

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/v1.0/Areas?"
        &"$filter=startswith(AreaPath,'{areapath}') "
            &"&$select=AreaSK,AreaPath "
            &"&$expand=Teams($select=TeamName) "
    ,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=startswith(AreaPath, '{areapath}')

Gibt alle Teams zurück, die einem Bereichspfad bei oder unter dem angegebenen {areapath}zugeordnet sind. Wenn Sie alle Teams in ein Projekt einbeziehen möchten, lassen Sie diese Anweisung aus.

&$select=AreaSK, AreaPath

Geben Sie Felder für den Bereichspfad zurück, die für die Zuordnung verwendet werden sollen.

&$expand=Teams($select=TeamName)

Gibt das team zurück, das dem Bereichspfad zugeordnet ist.

(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 der Spalte "Teams"

  1. Wählen Sie die Schaltfläche "Erweitern" aus.

    Screenshot, der die Schaltfläche

  2. Wählen Sie die Felder aus, die abgeflacht werden sollen.

    Screenshot, der zeigt, wie die Felder zum Flachen ausgewählt werden sollen.

  3. Tabelle enthält nun Entitätsfeld(n).

    Screenshot der Tabelle, die jetzt Entitätsfelder enthält.

Erstellen einer Beziehung mit "AreaSK"

Nachdem Sie "Schließen und Übernehmen" ausgewählt haben und zu Power BI zurückkehren, führen Sie die folgenden Schritte aus:

  1. Wählen Sie in den Menüs "Modellieren" Beziehungen verwalten aus.

  2. Erstellen Sie eine Beziehung zwischen Ihrer Berichtsabfrage und der Teams-Abfrage. Es ist wahrscheinlich, dass Power BI die Beziehung automatisch angibt und für Sie erstellt. Hier ist ein Beispiel für eine Beziehung zwischen der Abfrage im Bericht "Fehler öffnen " und der Teams-Abfrage:

    Screenshot, der ein Beispiel für die Beziehung zwischen Abfragen zeigt.

Hinzufügen des Teamfilters zu einem vorhandenen Bericht

  1. Stellen Sie auf der Seite, der Sie den Teamfilter hinzufügen möchten, sicher, dass keine Diagramme ausgewählt sind, und wählen Sie dann "Datenschnitt " im Bereich "Visualisierungen " aus.

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

  2. Zu Feld hinzufügenTeam.TeamName.

Weitere Informationen zum Arbeiten mit Datenschnitten finden Sie unter Datenschnitte in Power BI.