Zweck von API-Abfragen in Power BI
Power BI ist ein leistungsfähiges Tool, mit dem sich Daten visualisieren und analysieren lassen. Es kann in Ergänzung zu unserem System genutzt werden, um Daten aus teamspace für weiterführende Analysen, Reports etc. zu nutzen. Dazu kann Power BI über die API passende Endpunkte in teamspace bzw. projectfacts ansprechen und dort die gewünschten Daten abgreifen.
API-Endpunkte erkunden
Bevor die API-Daten in Power BI verwendet werden können, sollte zunächst geprüft werden, welche Daten verfügbar sind. Um auf den API Explorer zugreifen zu können, muss zuerst ein Token generiert werden. Hierfür bietet sich das Erstellen eines Gerätepassworts an. Bitte berücksichtigen Sie, dass der API-Zugriff im Basis-Hosting nicht möglich ist.
Gerätepasswort abrufen
Öffnen Sie die persönlichen Einstellungen und erstellen Sie ein neues Geräte-Passwort.
Die verfügbaren API-Endpunkte und Daten hängen von den Nutzerrechten des Erstellers des Geräte-Passworts ab.
API Explorer nutzen
Öffnen Sie den API Explorer. Diesen erreichen Sie, indem Sie die URL Ihres Systems nach dem .de abschneiden und auf dieser Seite dann den API Explorer auswählen.
Generieren Sie nun ein Token anhand des Benutzernamens und des Passworts aus dem Geräte-Passwort.
Navigieren Sie zu /api/api, um eine Übersicht über alle verfügbaren Endpunkte zu erhalten.
Beispiel:
Der Endpunkt /bookmark zeigt eine Liste aller gespeicherten Lesezeichen an.
Hier können Excel-Berichte oder benutzerdefinierte Exporte aus einer Liste generiert werden.
Es können jedoch auch einzelne oder mehrere Objekte gleichzeitig abgefragt werden.
Wichtige Parameter:
limit=10→ Begrenzung der Abfrage auf 10 Einträge.depth=2→ Stellt sicher, dass auch die untergeordneten Informationen enthalten sind.
Verbindung in Power BI herstellen
Nachdem die passenden Endpunkte identifiziert wurden, kann die Verbindung in Power BI hergestellt werden.
Daten abrufen
Öffnen Sie Power BI Desktop.
Klicken Sie auf Daten abrufen → Web.
Geben Sie die URL des gewünschten Endpunkts ein, z. B.:
https://example.com/api/project?limit=10&depth=2Dies ruft die ersten zehn Projekte mit detaillierten Informationen ab.
Authentifizierung
Wählen Sie die Standard-Authentifizierungsmethode aus.
Geben Sie das Gerätepasswort erneut ein.
Daten aufbereiten
Die Abfrage wird als Tabelle angezeigt.
Falls Daten in verschachtelten Strukturen (z. B. JSON) vorliegen, können tiefere Ebenen als Spalten hinzugefügt werden.
Nicht benötigte Spalten können gelöscht werden.
Verwendung der Daten
Die bereinigten Daten können nun für Visualisierungen und Analysen genutzt werden.
Automatische Aktualisierung einrichten
Damit die Daten regelmäßig aktualisiert werden, muss die Abfrage in Power BI Service veröffentlicht und ein Aktualisierungsplan eingerichtet werden.
Bericht veröffentlichen
Melden Sie sich bei Power BI Service an.
Veröffentlichen Sie den Bericht aus Power BI Desktop in den Online-Service.
Gehen Sie zu Mein Arbeitsbereich → Hier finden Sie das hochgeladene Semantikmodell.
Aktualisierungsplan einrichten
Öffnen Sie die Einstellungen für das Dataset.
Unter Geplante Aktualisierung einen Zeitplan festlegen:
Täglich oder wöchentlich aktualisieren.
Feste Uhrzeiten für die Aktualisierung definieren.
Nach dem Speichern wird der nächste geplante Aktualisierungszeitpunkt in der Liste angezeigt.
Status der Aktualisierung überprüfen
Die Aktualisierung kann einige Minuten dauern.
Unter Verlauf aktualisieren kann der Status der letzten Aktualisierungen eingesehen werden.
Falls Fehler auftreten, wird hier eine entsprechende Fehlermeldung angezeigt.