Herstellen einer Verbindung mit Analytics mit Power BI Data Connector
Azure DevOps Services | Azure DevOps Server 2022 - 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 Arbeitsaufgabenhierarchien. An diesem Punkt haben wir keine Pläne, den Connector zu aktualisieren, um andere Arten von Daten zu unterstützen. Informationen zu anderen Ansätzen finden Sie in der Power BI-Integrationsübersicht.
Voraussetzungen
Führen Sie die folgenden Schritte aus, um mit dem Azure DevOps Power BI Data Connector zu beginnen:
- Wenn Sie mit Analytics nicht vertraut sind, lesen Sie "Was ist Analytics", bevor Sie fortfahren.
- Installieren Sie das Power BI DesktopOctober 2018 Update oder eine neuere Version. Sie können es von der offiziellen Power BI Desktop Downloadseite herunterladen.
- Wenn Sie noch nicht als Projektmitglied hinzugefügt wurden, werden Sie jetzt hinzugefügt. Jeder, der Zugriff auf das Projekt hat, mit Ausnahme von Projektbeteiligten, kann Analyseansichten anzeigen.
- Boards müssen aktiviert sein. Wenn sie deaktiviert ist, werden Analyseansichten nicht angezeigt. Informationen zum erneuten Aktivieren von Boards finden Sie unter Aktivieren oder Deaktivieren eines Azure DevOps-Diensts.
- Stellen Sie sicher, dass Sie über Berechtigungen verfügen, die für den Zugriff auf Analytics erforderlich sind. Wenn Sie Mitglied der Gruppe "Mitwirkende" des Projekts sind, haben Sie die Berechtigung.
- Erstellen Sie eine Analyseansicht , die Sie einen Power BI-Bericht erstellen möchten.
- Lesen Sie die Wissensdatenbank von Power BI-Artikeln.
- Wenn Sie mit Analytics nicht vertraut sind, lesen Sie , was ist Analytics? bevor Sie fortfahren.
- Installieren Sie das Power BI DesktopOctober 2018 Update oder eine neuere Version. Sie können es von der offiziellen Power BI Desktop Downloadseite herunterladen.
- Sie müssen Mitglied eines Projekts sein, bei dem der Grundlegende Zugriff oder höher besteht. Wenn Sie noch kein Projekt haben, erstellen Sie ein Projekt.
- Wenn Sie noch nicht als Projektmitglied hinzugefügt wurden, werden Sie jetzt hinzugefügt. Jeder, der Zugriff auf das Projekt hat, mit Ausnahme von Projektbeteiligten, kann Analyseansichten anzeigen.
- Überprüfen Sie, ob Analytics] wird installiert, und wenn nicht, aktivieren Sie sie. Sie müssen ein Kontobesitzer oder Mitglied der Gruppe "Project-Sammlungsadministratoren" sein, um Erweiterungen hinzuzufügen oder den Dienst zu aktivieren.
- Boards müssen aktiviert sein. Wenn sie deaktiviert ist, werden Analyseansichten nicht angezeigt. Informationen zum erneuten Aktivieren von Boards finden Sie unter Aktivieren oder Deaktivieren eines Azure DevOps-Diensts.
- Stellen Sie sicher, dass Sie über Berechtigungen verfügen, die für den Zugriff auf Analytics erforderlich sind. Wenn Sie Mitglied der Gruppe "Mitwirkende" des Projekts sind, haben Sie die Berechtigung.
- Erstellen Sie eine Analyseansicht , die Sie einen Power BI-Bericht erstellen möchten.
- Lesen Sie die Wissensdatenbank von Power BI-Artikeln.
Wichtig
Azure DevOps unterstützt die Authentifizierung alternativer Anmeldeinformationen seit Beginn des 2. März 2020 nicht mehr. Wenn Sie noch alternative Anmeldeinformationen verwenden, empfehlen wir Ihnen dringend, zu einer sichereren Authentifizierungsmethode zu wechseln (z. B. persönliche Zugriffstoken). Weitere Informationen
Herstellen einer Verbindung mit einer Analyseansicht
Öffnen Sie Power BI Desktop.
Melden Sie sich beim Dienst an. Nach dem 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.
Wählen Sie "Verbinden " nach der Überprüfung Ihrer Anmeldeinformationen aus.
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 Arbeitsaufgaben und Testfälle.
Geben Sie die grundlegenden Parameter an, die eine Verbindung mit Ihren Daten herstellen sollen.
- Geben Sie für die Sammlungs-URL die URL ein, in der Ihre Azure DevOps Server Instanz gehostet wird. Beispiel-URL ist z. B. "
http://fabrikam-server/AzureDevOpsServer/fabrikam-collection
". - Geben Sie für Teamprojekt nur den Projektnamen ein (z. B. wenn
Fabrikam-Fiber
die URL Ihrer Azure DevOps Server Instanz "http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber
" lautet).
Wichtig
Verwechseln Sie den Teamnamen nicht mit dem Projektnamen, einem häufig auftretenden Fehler. Wenn die URL, die Sie täglich verwenden, "
http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device
" lautet, ist derFabrikam-Fiber-Git
Projektname, währendDevice
es sich um den Teamnamen handelt.Nach erfolgreicher Anmeldung überprüft Power BI, ob Ihre Benutzeranmeldeinformationen über die richtigen Berechtigungen für den Zugriff auf das angegebene Projekt verfügen. Wenn Fehler auftreten, verweisen Sie auf den Abschnitt Q & A , da er die am häufigsten auftretenden Probleme behandelt.
- Geben Sie für die Sammlungs-URL die URL ein, in der Ihre Azure DevOps Server Instanz gehostet wird. Beispiel-URL ist z. B. "
Auswählen der Analyseansicht
Erweitern Sie den Ordner "Freigegebene Ansichten ", wählen Sie eine Analyseansicht aus, und wählen Sie dann " Laden" aus. Der Datenconnector stellt eine Liste der verfügbaren Analyseansichten dar. Jede Ansicht stellt eine Reihe von Daten dar, die Sie in Power BI abrufen können. Sie können auch benutzerdefinierte Analyseansichten erstellen.
Die nachstehende Abbildung 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 enthalten historische Trenddaten.
Hier wählen wir Geschichten - Letzte 30 Tage. Diese Ansicht filtert nach Produktrückmeldeelementen.
Hinweis
Da Sie die Ansicht im vorherigen Abschnitt überprüft haben, sollte die Ansicht geladen werden. Wenn die Ansicht jedoch nicht geladen wird, liegt dies wahrscheinlich daran, dass 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.
Wählen Sie die Ansicht aus.
Hinweis
Die Vorschau für alle ausgewählten Ansichten im Navigator kann je nach ausgewählter Anzahl ausgewählter 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 " – Tabelle "Heute " aus, und warten Sie, bis die Vorschau geladen wird. Er stellt den aktuellen Status 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 in Power BI angewendeten Filter beschränken die angezeigten Daten auf Endbenutzer, verringern jedoch nicht die Menge der daten, die aus Analytics abgerufen werden. Wenn der Filter die Größe des Datasets verringern soll, sollte er angewendet werden, indem die Ansicht angepasst wird.
Warten Sie, bis die Daten geladen werden. Sie können den Fortschritt beobachten, indem Sie sich die Statusmeldungen ansehen, die direkt unter dem Tabellennamen angezeigt werden. Wenn Fehler angezeigt werden, verweisen Sie auf den Abschnitt Q & A , da er die am häufigsten auftretenden Probleme behandelt.
Überprüfen Sie das Datenmodell. Überprüfen Sie während des Ladens des Modells das Datasetdesign 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 untersuchen, indem Sie benutzerdefinierte Berichte erstellen. Beispiele für allgemeine Berichte finden Sie unter Beispielberichte – mithilfe des Datenconnectors.
Fragen und Antworten (Q & A)
F: Wie sollte ich Fehlermeldungen lesen, die vom Connector stammen?
Eine: Möglicherweise haben Sie die Herausforderung, Fehlermeldungen aus dem Connector zu lesen, da sie normalerweise zusätzliche kontextbezogene Informationen enthalten. Wenn der Ladevorgang fehlschlägt, beginnt die Nachricht mit Fehler beim Speichern von Änderungen am Server.... Wenn sie angezeigt wird, suchen Sie 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. Verringern Sie die Anzahl der Datensätze, indem Sie zusätzliche Filter anwenden.
F: Gewusst wie das Abfrageergebnis auflösen, überschreitet die maximale Größe. Reduzieren 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 am Server. Fehler zurückgegeben: 'OLE DB- oder ODBC-Fehler: [DataSource.Error] VSTS: Anforderung fehlgeschlagen: Der Remoteserver hat einen Fehler zurückgegeben: (400) Ungültige Anforderung. (Das 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 durch Anpassen der Ansicht reduziert werden. Gehen Sie dazu vor der Verwendung in Power BI vor.
F: Gewusst wie der Benutzer wurde nicht autorisiert?
Der Benutzer wurde nicht autorisiert.
Eine: Dieser Fehler kann auftreten, 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 Analyse- und Analyseansichten". Wenn es sich um ein Problem mit Anmeldeinformationen handelt, sollten Sie mit Ihrem Administrator arbeiten, um festzustellen, ob sie das Problem beheben können. Weitere Informationen finden Sie unter Power BI-Sicherheit, Benutzerauthentifizierung und Problembehandlung bei Anmeldeproblemen für Power BI.
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 Access to the resource is forbidden error?
Der Zugriff auf die Ressource ist verboten.
Eine: Sie können diesen Fehler feststellen, wenn Sie Zugriff auf ein bestimmtes Projekt haben, aber nicht über die Berechtigungen für die Ansichtsanalyse verfügen. Arbeiten Sie mit Ihrem Projektadministrator zusammen, um diese Berechtigungen abzurufen. Weitere Informationen zum Sicherheitsmodell finden Sie unter Analytics Security.
F: Gewusst wie Das Projekt "X" ist nicht vorhanden oder Sie verfügen nicht über Berechtigungen für den Zugriff auf den Fehler?
Beim Versuch, eine Verbindung herzustellen, ist ein Fehler aufgetreten.
Details: Ungültiger Parameter "Project". Project "X" ist nicht vorhanden oder Sie verfügen nicht über Berechtigungen für den Zugriff darauf.
Eine: Dieser Fehler gibt an, dass der wert, den Sie für den Namen von Project 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, "https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/Device
" lautet, ist der Fabrikam-Fiber-Git
Projektname und sollte im Parameter verwendet werden. Device
ist der Teamname.