Verbinden zu Analytics mit Power BI Data Connector

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

Der Power BI Data Connector verwendet Analyseansichten.

Wichtig

Analyseansichten unterstützen nur Azure Boards Daten (Arbeitselemente). Analyseansichten unterstützen keine anderen Datentypen, z. B. Pipelines. Ansichten bieten eine flache Liste von Arbeitselementen und unterstützen keine Arbeitselementhierarchien. An diesem Punkt haben wir keine Pläne, den Connector zu aktualisieren, um andere Datentypen zu unterstützen. Weitere Informationen zu anderen Ansätzen finden Sie unter Power BI Integrationsübersicht.

Voraussetzungen

Führen Sie die folgenden Schritte aus, um mit dem Azure DevOps Power BI Data Connector zu beginnen:

Wichtig

Azure DevOps unterstützt seit Beginn des 2. März 2020 keine alternative Anmeldeinformationenauthentifizierung mehr. Wenn Sie weiterhin alternative Anmeldeinformationen verwenden, empfehlen wir Ihnen dringend, zu einer sichereren Authentifizierungsmethode zu wechseln (z. B. persönliche Zugriffstoken). Weitere Informationen

Verbinden einer Analyseansicht

  1. Öffnen Sie Power BI Desktop.

  2. Melden Sie sich beim Dienst an. Beim erstmaligen Zugriff müssen Sie sich anmelden und Ihre Anmeldeinformationen authentifiziert haben. Power BI Desktop speichert Ihre Anmeldeinformationen, damit Sie dies nur einmal tun müssen.

    Wählen Sie zwischen diesen beiden Authentifizierungsoptionen aus:

    • Wählen Sie Windows aus, wenn Sie sich mit Windows anmelden möchten.

    • Wählen Sie "Persönliches Zugriffstoken " aus, wenn Sie ein persönliches Zugriffstoken verwenden möchten.

      Sign in dialog

  3. Wählen Sie Verbinden nach der Überprüfung Ihrer Anmeldeinformationen aus.

    Connect dialog

  4. Wählen Sie (1) Daten abrufen, (2) Onlinedienste und (3) Azure DevOps (nur Boards) für Clouddienste oder Azure DevOps Server (nur Boards) für lokale Dienste. Wählen Sie dann Verbinden aus. Analyseansichten unterstützen nur Abfragen für Arbeitselemente und Testfälle.

    Connect to data

  5. Geben Sie die grundlegenden Parameter an, um eine Verbindung mit Ihren Daten herzustellen.

    Specify organization and project name.

    Specify organization and project name, on-premises version.

    • Geben Sie für die Sammlungs-URL die URL ein, in der Ihre Azure DevOps Server-Instanz gehostet wird. Beispielsweise ist eine Beispiel-URL "http://fabrikam-server/AzureDevOpsServer/fabrikam-collection".
    • Geben Sie für Teamprojekt nur den Projektnamen ein (z. B. verwenden Fabrikam-Fiber Sie, wenn die URL Ihrer Azure DevOps Server Instanz "http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber" ist).

    Wichtig

    Verwechseln Sie den Teamnamen nicht mit dem Projektnamen, einem gängigen Fehler. Wenn die URL, die Sie täglich verwenden, "http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device" lautet, Fabrikam-Fiber-Git ist der Projektname, während Device es sich um den Teamnamen handelt.

    Nach erfolgreicher Anmeldung überprüft Power BI, ob Ihre Benutzeranmeldeinformationen über die richtigen Berechtigungen zum Zugriff auf das angegebene Projekt verfügen. Wenn Fehler auftreten, verweisen Sie auf den Abschnitt Q & A , da er die häufigsten Probleme behandelt.

Auswählen der Analyseansicht

  1. Erweitern Sie den Ordner "Freigegebene Ansichten ", wählen Sie eine Analyseansicht aus, und wählen Sie dann "Laden" aus. Der Data Connector stellt eine Liste der verfügbaren Analyseansichten dar. Jede Ansicht stellt eine Reihe von Daten dar, die Sie in Power BI ziehen können. Sie können auch benutzerdefinierte Analyseansichten erstellen.

    Das folgende Bild zeigt die Standardansichten für Analytics. Ihre Liste der Ansichten kann sich je nach dem Prozessmodell unterscheiden, das zum Erstellen Ihres Projekts verwendet wird. Alle mit "Heute" angefügten Ansichten bieten historische Trenddaten.

    Hier wählen wir Stories - Letzte 30 Tage. Diese Ansicht filtert nach Produktrückführungselementen.

    Navigator dialog, Choose an Analytics view

    Hinweis

    Da Sie die Ansicht im vorherigen Abschnitt überprüft haben, sollte die Ansicht geladen werden. Wenn die Ansicht jedoch nicht geladen wird, ist es wahrscheinlich, weil das Dataset zu groß ist. Kehren Sie zur Ansicht unter der Analyseansicht im Webportal zurück, und passen Sie die Filter an, um die Größe des Datasets zu verringern.

  2. Wählen Sie die Ansicht aus.

    Navigator dialog, default views

    Hinweis

    Die Vorschau, die für alle ausgewählten Ansichten im Navigator angezeigt wird, kann abhängig von der Anzahl der ausgewählten Felder und der Größe des Datasets abgeschnitten werden. Die Daten werden nur für die Vorschau abgeschnitten und wirken sich nicht auf die vollständige Datenaktualisierung aus.

    Wählen Sie "Arbeitselemente" aus, und warten Sie, bis die Vorschau geladen werden soll. Es stellt den aktuellen Zustand aller Arbeitselemente im Projekt dar.

    Aktivieren Sie das Kontrollkästchen neben "Arbeitselemente" – Tabelle "Heute " und wählen Sie "Laden" aus.

    Hinweis

    Analyseansichten wenden keine Filter an, die mithilfe von Power BI auf dem Server definiert wurden. Alle filter, die in Power BI angewendet werden, beschränken die daten, die auf Endbenutzer angezeigt werden, aber nicht die Menge der von Analytics abgerufenen Daten. Wenn der Filter die Größe des Datasets verringern soll, sollte sie angewendet werden, indem Sie die Ansicht anpassen.

  3. Warten Sie, bis die Daten geladen werden. Sie können den Fortschritt beobachten, indem Sie sich die Statusnachrichten ansehen, die direkt unter dem Tabellennamen angezeigt werden. Wenn Fehler angezeigt werden, verweisen Sie auf den Abschnitt Q & A , da es die häufigsten Probleme behandelt.

    Apply query changes loading dialog

  4. Überprüfen Sie das Datenmodell. Während das Modell geladen wird, überprüfen Sie den Datasetentwurf für den Power BI Data Connector.

Erstellen Ihres Berichts

Erstellen Sie Berichte basierend auf den geladenen Daten. Nach Abschluss des Ladevorgangs können Sie die Daten erkunden, indem Sie benutzerdefinierte Berichte erstellen. Beispiele für allgemeine Berichte finden Sie unter Beispielberichte – verwenden sie den Data Connector.

Power BI desktop report view

Fragen und Antworten (Q & A)

F: Wie sollte ich Fehlermeldungen aus dem Connector lesen?

Eine: Möglicherweise haben Sie die Herausforderung, Fehlermeldungen aus dem Connector zu lesen, da sie in der Regel zusätzliche Kontextinformationen enthalten. Wenn der Ladevorgang fehlschlägt, beginnt die Nachricht mit Fehler beim Speichern von Änderungen am Server.... Wenn sie angezeigt wird, suchen Sie dann nach [DataSource.Error] Azure DevOps...:. Der folgende Text ist die echte Fehlermeldung, die vom Connector zurückgegeben wird.

Im folgenden Beispiel ist der wichtigste Teil der Fehlermeldung:

Das Abfrageergebnis überschreitet die maximale Größe. Reduzieren Sie die Anzahl der Datensätze, indem Sie zusätzliche Filter anwenden.

Screenshot showing the QueryExceedsPreferredMaxSize exception.

F: Gewusst wie das Abfrageergebnis überschreitet die maximale Größe. Verringern Sie die Anzahl der Datensätze, indem Sie zusätzliche Filterfehler anwenden?

Eine: Sie erhalten den folgenden Fehler, wenn die Anzahl der von Analytics abgerufenen Datensätze 250.000 überschreitet.

Fehler beim Speichern von Änderungen an dem Server. Fehler zurückgegeben: 'OLE DB- oder ODBC-Fehler: [DataSource.Error] VSTS: Fehler: Fehler beim Anfordern: Der Remoteserver hat einen Fehler zurückgegeben: (400) Schlechte Anforderung. (Abfrageergebnis überschreitet die maximale Größe. Reduzieren Sie die Anzahl der Datensätze, indem Sie zusätzliche Filter anwenden).'.

Dieser Fehler tritt in der Regel auf, wenn Ihr Projekt eine große Anzahl von Arbeitselementen aufweist. Die Größe des Datasets muss reduziert werden, indem sie die Ansicht anpassen. Führen Sie dies vor der Verwendung in Power BI aus.

Query result exceeds maximum size. Please reduce the number of records by applying additional filters

F: Gewusst wie beheben den Benutzer nicht autorisierten Fehler?

Der Benutzer wurde nicht autorisiert.

Eine: Sie können diesen Fehler erkennen, wenn Sie versuchen, auf ein Projekt zuzugreifen, für das Sie keine Berechtigungen haben. Außerdem wird angezeigt, ob Ihre Anmeldeinformationen von Power BI nicht erkannt werden. Informationen zum Überprüfen Ihrer Berechtigungen finden Sie unter Festlegen von Berechtigungen für den Zugriff auf Analytics- und Analytics-Ansichten. Wenn es sich um ein Anmeldeinformationenproblem handelt, sollten Sie mit Ihrem Administrator arbeiten, um zu sehen, ob sie das Problem beheben können. Weitere Informationen finden Sie unter Power BI Sicherheit, Benutzerauthentifizierung und Problembehandlung bei Anmeldeproblemen für Power BI.

The user was not authorized.

Hinweis

Power BI verwendet Azure Active Directory (AAD) zum Authentifizieren von Benutzern, die sich beim Power BI-Dienst anmelden, und verwendet wiederum die Power BI-Anmeldeinformationen, wenn ein Benutzer versucht, auf Ressourcen zuzugreifen, die eine Authentifizierung erfordern. Benutzer melden sich beim Power BI-Dienst mit der E-Mail-Adresse an, die sie zum Einrichten ihres Power BI-Kontos verwendet haben. Power BI verwendet diese zur Anmeldung verwendete E-Mail-Adresse als den gültigen Benutzernamen, der an Ressourcen übergeben wird, wenn ein Benutzer versucht, Daten abzurufen. Der effektive Benutzername wird dann einem Benutzerprinzipalnamen (User Principal Name, UPN) zugeordnet und in das zugehörige Windows-Domänenkonto aufgelöst, mit dem die Authentifizierung erfolgt.

F: Gewusst wie den Zugriff auf die Ressource auflösen ist verboten?

Der Zugriff auf die Ressource ist verboten.

Eine: Sie können diesen Fehler erkennen, wenn Sie Zugriff auf ein bestimmtes Projekt haben, aber nicht über die Berechtigungen für die Ansichtsanalyse verfügen. Arbeiten Sie mit Ihrem Projektadministrator, um diese Berechtigungen abzurufen. Weitere Informationen zum Sicherheitsmodell finden Sie unter Analytics-Sicherheit.

Access to the resource is forbidden.

F: Gewusst wie die Project "X" nicht vorhanden ist, oder Sie haben keine Berechtigungen zum Zugriff auf den Fehler?

Beim Versuch, eine Verbindung herzustellen, wurde ein Fehler aufgetreten.
Details: Ungültiger Parameter "Project". Project "X" ist nicht vorhanden oder Sie verfügen nicht über Berechtigungen für den Zugriff.

Eine: Dieser Fehler gibt an, dass der wert, den Sie für Project Namen eingegeben haben, keinem Projekt entspricht. Ein allgemeiner Fehler, den Benutzer vornehmen können, besteht darin, den Projektnamen mit einem Teamnamen zu verwechseln.

Wenn die URL, die Sie jeden Tag verwenden, Fabrikam-Fiber-Git "https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/Device" ist der Projektname und sollte im Parameter verwendet werden. Device ist der Teamname.

ProjectNotFoundError