Zum Hauptinhalt springen

Überblick

Microsoft Power BI REST API-Integration für Datasets, Reports und Workspaces. Über die Langdock-Integration kannst du direkt aus deinen Chats auf Power BI zugreifen und es verwalten.
Authentifizierung: OAuth
Kategorie: Daten & Analytics
Verfügbarkeit: Alle Workspace-Tarife

Verfügbare Aktionen

Workspaces auflisten

powerbi.list_workspaces
Listet Workspaces (Gruppen) auf, auf die der Nutzer Zugriff hat. Bestätigung erforderlich: Nein Parameter: Keine Output: Gibt ein JSON-Array von Workspaces mit Workspace-Metadaten zurück

Datasets auflisten

powerbi.list_datasets
Listet Datasets in Mein Workspace oder einem angegebenen Workspace auf. Bestätigung erforderlich: Nein Parameter:
  • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, werden Datasets aus Mein Workspace aufgelistet
Output: Gibt ein JSON-Array von Datasets mit Dataset-Metadaten zurück

Dataset-Tabellen auflisten

powerbi.list_dataset_tables
Listet Tabellen für ein Dataset auf, um genaue Tabellen- und Spaltennamen vor dem Schreiben von DAX zu ermitteln. Hinweis: Funktioniert nur für Push-API-Datasets. Bestätigung erforderlich: Nein Parameter:
  • datasetId (TEXT, Required): Die Power BI Dataset-ID (GUID)
Output: Gibt ein JSON-Objekt mit Tabellendefinitionen einschließlich Spalten und Measures zurück

DAX-Abfrage ausführen

powerbi.execute_dax_query
Führt eine DAX-Abfrage (SQL-ähnlich) gegen ein Power BI-Dataset über die Execute Queries API aus. Bestätigung erforderlich: Ja Parameter:
  • datasetId (TEXT, Required): Die Power BI Dataset-ID für die Abfrage (GUID)
    • query (MULTI_LINE_TEXT, Required): DAX-Abfragetext. Beispiel: EVALUATE ROW("Total Sales", [Total Sales]) oder vollständiger DAX EVALUATE-Ausdruck
Output: Gibt Abfrageergebnisse mit Tabellendaten aus der ausgeführten DAX-Abfrage zurück

Datasets suchen

powerbi.search_datasets
Sucht nach Power BI-Datasets anhand des Namens. Bestätigung erforderlich: Nein Parameter:
  • searchTerm (TEXT, Required): Der Suchbegriff für Dataset-Namen
    • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, wird in Mein Workspace gesucht
Output: Gibt übereinstimmende Datasets mit id, name, configuredBy, isRefreshable, createdDate, webUrl und Gesamtzahlen zurück

Reports auflisten

powerbi.list_reports
Listet Reports in einem Workspace oder in Mein Workspace auf. Bestätigung erforderlich: Nein Parameter:
  • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, werden Reports aus Mein Workspace aufgelistet
Output: Gibt ein JSON-Array von Reports mit Report-Metadaten zurück

Report-Seiten auflisten

powerbi.list_report_pages
Listet Seiten eines Reports auf. Bestätigung erforderlich: Nein Parameter:
  • reportId (TEXT, Required): Die Report-ID (GUID)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID), wenn sich der Report in einem Workspace befindet
Output: Gibt ein JSON-Array von Report-Seiten mit Seitendetails zurück

Reports suchen

powerbi.search_reports
Sucht nach Power BI-Reports anhand von Name oder Beschreibung. Bestätigung erforderlich: Nein Parameter:
  • searchTerm (TEXT, Required): Der Suchbegriff für Report-Namen und -Beschreibungen
    • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, wird in Mein Workspace gesucht
Output: Gibt übereinstimmende Reports mit id, name, description, webUrl, embedUrl, datasetId und Zeitstempeln zurück

Report in Datei exportieren (Initiieren)

powerbi.export_report_to_file_initiate
Initiiert einen Power BI-Report-Export-Job. Gibt die Export-ID zur Verwendung mit der Fetch-Aktion zurück. Bestätigung erforderlich: Ja Parameter:
  • reportId (TEXT, Required): Die Report-ID (GUID)
    • format (SELECT, Required): Exportformat (PDF, PPTX, PNG)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID), der den Report enthält. Wenn nicht angegeben, wird aus Mein Workspace exportiert
Output: Gibt Export-Job-Details mit exportId, groupId, reportId und format zurück

Paginierten Report exportieren (Initiieren)

powerbi.export_paginated_report_initiate
Initiiert einen Power BI-Export-Job für paginierte Reports. Unterstützt mehr Formate als reguläre Reports, einschließlich XLSX, CSV, DOCX. Bestätigung erforderlich: Ja Parameter:
  • reportId (TEXT, Required): Die paginierte Report-ID (GUID)
    • format (SELECT, Required): Exportformat (PDF, XLSX, DOCX, CSV)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID), der den Report enthält
    • reportParameters (OBJECT, Optional): Parameter, die als Schlüssel-Wert-Paare an den Report übergeben werden (JSON-Objekt). Beispiel: {"StartDate": "2024-01-01", "EndDate": "2024-12-31"}
    • csvDelimiter (TEXT, Optional): Trennzeichen für CSV-Export (Standard ist Komma, max. 1 Zeichen)
    • csvEncoding (SELECT, Optional): Kodierung für CSV-Export (UTF-8, UTF-16)
    • imageFormat (SELECT, Optional): Wenn das Format IMAGE ist, Bildtyp angeben (JPEG, PNG)
Output: Gibt Export-Job-Initiierungsantwort mit Export-ID und Konfiguration zurück

Report in Datei exportieren (Abrufen)

powerbi.export_report_to_file_fetch
Ruft einen Power BI-Report-Export ab, indem der Status geprüft und die Datei heruntergeladen wird, wenn sie bereit ist. Bestätigung erforderlich: Nein Parameter:
  • reportId (TEXT, Required): Die Report-ID (GUID)
    • exportId (TEXT, Required): Die Export-ID, die von der Initiieren-Aktion zurückgegeben wurde
    • groupId (TEXT, Optional): Workspace (Gruppen-ID), der den Report enthält. Wenn nicht angegeben, wird aus Mein Workspace abgerufen
Output: Gibt Export-Dateiobjekt oder Statusinformationen zurück

Dashboards auflisten

powerbi.list_dashboards
Listet Dashboards in einem Workspace oder in Mein Workspace auf. Bestätigung erforderlich: Nein Parameter:
  • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, werden Dashboards aus Mein Workspace aufgelistet
Output: Gibt ein JSON-Array von Dashboards mit Dashboard-Metadaten zurück

Dashboard-Tiles auflisten

powerbi.list_dashboard_tiles
Listet Tiles auf einem Dashboard auf. Bestätigung erforderlich: Nein Parameter:
  • dashboardId (TEXT, Required): Die Dashboard-ID (GUID)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID), wenn sich das Dashboard in einem Workspace befindet
Output: Gibt ein JSON-Array von Dashboard-Tiles mit Tile-Metadaten zurück

Dataset-Details abrufen

powerbi.get_dataset_details
Ruft detaillierte Informationen zu einem bestimmten Power BI-Dataset ab. Bestätigung erforderlich: Nein Parameter:
  • datasetId (TEXT, Required): Die Dataset-ID (GUID)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, wird Mein Workspace verwendet
Output: Gibt detaillierte Dataset-Informationen zurück, einschließlich id, name, configuredBy, isRefreshable, targetStorageMode, createdDate, webUrl und mehr

Report-Details abrufen

powerbi.get_report_details
Ruft detaillierte Informationen zu einem bestimmten Power BI-Report ab. Bestätigung erforderlich: Nein Parameter:
  • reportId (TEXT, Required): Die Report-ID (GUID)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, wird Mein Workspace verwendet
Output: Gibt detailliertes Report-Metadaten-Objekt zurück

Dashboard-Details abrufen

powerbi.get_dashboard_details
Ruft detaillierte Informationen zu einem bestimmten Power BI-Dashboard ab. Bestätigung erforderlich: Nein Parameter:
  • dashboardId (TEXT, Required): Die Dashboard-ID (GUID)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, wird Mein Workspace verwendet
Output: Gibt detailliertes Dashboard-Metadaten-Objekt zurück

Tile-Details abrufen

powerbi.get_tile_details
Ruft detaillierte Informationen zu einem bestimmten Power BI-Dashboard-Tile ab. Bestätigung erforderlich: Nein Parameter:
  • dashboardId (TEXT, Required): Die Dashboard-ID (GUID)
    • tileId (TEXT, Required): Die Tile-ID (GUID)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, wird Mein Workspace verwendet
Output: Gibt detailliertes Tile-Metadaten-Objekt zurück

Tabellenstichprobe abrufen

powerbi.get_table_sample
Ruft eine Stichprobe von Daten aus einer bestimmten Tabelle in einem Power BI-Dataset ab. Bestätigung erforderlich: Nein Parameter:
  • datasetId (TEXT, Required): Die Dataset-ID (GUID)
    • tableName (TEXT, Required): Der Name der zu beprobenden Tabelle (z.B. “Sales”)
    • sampleSize (TEXT, Optional): Anzahl der Zeilen für die Stichprobe (Standard: 100)
Output: Gibt Tabellenstichprobe mit columns, sampleData-Zeilen, rowCount, columnCount und Metadaten zurück

Tabellenanzahl abrufen

powerbi.get_table_count
Ruft die Zeilenanzahl einer bestimmten Tabelle in einem Power BI-Dataset ab. Bestätigung erforderlich: Nein Parameter:
  • datasetId (TEXT, Required): Die Dataset-ID (GUID)
    • tableName (TEXT, Required): Der Name der zu zählenden Tabelle (z.B. “Sales”)
Output: Gibt die Zeilenanzahl für die angegebene Tabelle zurück

Dataset-Schema abrufen

powerbi.get_dataset_schema
Ruft das vollständige Schema eines Power BI-Datasets ab, einschließlich Tabellen, Spalten, Measures und Beziehungen. Bestätigung erforderlich: Nein Parameter:
  • datasetId (TEXT, Required): Die Dataset-ID (GUID)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, wird Mein Workspace verwendet
Output: Gibt umfassendes Schema mit Dataset-Metadaten, Tabellen mit Spalten und Measures, Parametern und zusammenfassenden Statistiken zurück

Dataset-Abhängigkeiten abrufen

powerbi.get_dataset_dependencies
Ruft Reports und Dashboards ab, die ein bestimmtes Power BI-Dataset verwenden. Bestätigung erforderlich: Nein Parameter:
  • datasetId (TEXT, Required): Die Dataset-ID (GUID)
    • groupId (TEXT, Optional): Workspace (Gruppen-ID). Wenn nicht angegeben, wird Mein Workspace verwendet
Output: Gibt eine Liste von Objekten (Reports und Dashboards) zurück, die das Dataset referenzieren

Häufige Anwendungsfälle

Datenverwaltung

Verwalte und organisiere deine Power BI-Daten

Automatisierung

Automatisiere Workflows mit Power BI

Reporting

Erstelle Einblicke und Berichte

Integration

Verbinde Power BI mit anderen Tools

Best Practices

Erste Schritte:
  1. Aktiviere die Power BI-Integration in deinen Workspace-Einstellungen
  2. Authentifiziere dich über OAuth
  3. Teste die Verbindung mit einer einfachen Leseabfrage
  4. Erkunde verfügbare Aktionen für deinen Anwendungsfall
Wichtige Überlegungen:
  • Stelle sicher, dass du die richtigen Authentifizierungsdaten hast
  • Respektiere Rate Limits und API-Kontingente
  • Prüfe Datenschutzeinstellungen
  • Teste Aktionen zuerst in einer sicheren Umgebung

Fehlerbehebung

ProblemLösung
Authentifizierung fehlgeschlagenÜberprüfe deine OAuth-Anmeldedaten
Rate Limit überschrittenReduziere die Anfragehäufigkeit
Daten nicht gefundenPrüfe Berechtigungen und Datenverfügbarkeit
VerbindungstimeoutÜberprüfe die Netzwerkverbindung

Support

Für zusätzliche Hilfe mit der Power BI-Integration kontaktiere support@langdock.com