Systemintegration von Power BI-Visuals

  • Artikel

Erfahren Sie mehr über die visuelle API und wie Power BI die Interaktionen zwischen Ihnen, dem visuellen Element und dem Host behandelt.

Aktionen und nachfolgende Aktualisierungen in Power BI können manuell oder automatisch ausgelöst werden. Typen aktualisieren:

Die folgende Abbildung zeigt, wie gängige, auf visuellen Elementen basierende Aktionen – beispielsweise das Auswählen eines Lesezeichens – in Power BI verarbeitet werden.

Diagram of the Power BI visual process.

Der Benutzer interagiert über Power BI mit visuellen Element.

Sie können ein Visual wie folgt mit Power BI aktualisieren:

  • Ein Benutzer öffnet den Eigenschaftenbereich eines visuellen Elements.

    Wenn ein Benutzer den Eigenschaftenbereich eines visuellen Elements öffnet, ruft Power BI unterstützte Objekte und Eigenschaften aus der Datei capabilities.json des Visuals ab. Um tatsächliche Werte von Eigenschaften zu erhalten, ruft Power BI die getFormattingModel -Methode des Visuals auf (apIs vor Version 5.0 rufen stattdessen auf enumerateObjectInstances ). Die API gibt moderne Formatbereichsmodellkomponenten, Eigenschaften und deren tatsächliche Werte zurück.

    Weitere Informationen finden Sie unter Funktionen und Eigenschaften von Power BI-Visuals.

  • Anpassen von Visualisierungstiteln, Hintergründen, Bezeichnungen und Legenden.

    Wenn Sie den Wert einer Eigenschaft im Formatbereich ändern, ruft Power BI die -Methode auf update . Power BI übergibt das neue options Objekt an die update -Methode, und die -Objekte enthalten die neuen Werte.

    Weitere Informationen finden Sie unter Objekte und Eigenschaften von Power BI-Visuals.

  • Ändern Sie Größe des Visuals.

    Wenn ein Benutzer die Größe eines Visuals ändert, ruft Power BI die update-Methode mit dem neuen options-Objekt auf. Das options-Objekt enthält geschachtelte viewport-Objekte mit der neuen Breite und Höhe des Visuals.

  • Ein Benutzer wendet einen Filter auf Berichts-, Seiten- oder Visualebene an.

    Power BI filtert die Daten basierend auf den Filterbedingungen. Power BI ruft die update-Methode des Visuals auf, um das Visual mit neuen Daten zu aktualisieren.

    Das Visual erhält eine neue Aktualisierung der options-Objekte, wenn eins der geschachtelten Objekte neue Daten enthält. Der genaue Ablauf der Aktualisierung richtet sich nach der Konfiguration der Zuordnung für die Datenansicht des Visuals.

    Weitere Informationen finden Sie unter Grundlegendes zur Zuordnung von Datenansichten in Power BI-Visuals.

  • Ein Benutzer wählt einen Datenpunkt in einem anderen visuellen Element im Bericht aus.

    Wenn ein Benutzer einen Datenpunkt in einem anderen Visual im Bericht auswählt, filtert oder hebt Power BI die ausgewählten Datenpunkte hervor und ruft die update-Methode des Datenpunkts auf. Das Visual erhält neue gefilterte Daten oder dieselben Daten mit einem Array von Hervorhebungen.

    Weitere Informationen finden Sie unter Hervorheben von Datenpunkten in Power BI-Visuals.

  • Ein Benutzer wählt im Bereich Lesezeichen des Berichts ein Lesezeichen aus.

    Wenn Sie im Bereich Lesezeichen ein Lesezeichen auswählen, können Sie folgendes ausführen:

    • Power BI ruft eine Funktion auf, die von der registerOnSelectionCallback-Methode übergeben und registriert wird. Die Rückruffunktion ruft Array mit Auswahloptionen für das entsprechende Lesezeichen auf.

    • Power BI ruft die update-Methode mit einem entsprechenden filter-Objekt innerhalb des options-Objekts auf.

      In beiden Fällen muss das visuelle Element seinen Zustand gemäß den empfangenen Auswahloptionen oder gemäß dem filter-Objekt ändern.

      Weitere Informationen zu Lesezeichen und Filtern finden Sie unter API für visuelle Filter für Power BI-Visuals.

Der Benutzer interagiert direkt mit dem visuellen Element

Der Benutzer kann auch direkt mit dem Visual interagieren, um es wie folgt zu aktualisieren:

  • Zeigen Sie mit der Maus auf ein Datenelement.

    Ein Visual kann über die API für Power BI-QuickInfos weitere Informationen zu einem Datenpunkt anzeigen. Wenn ein Benutzer mit der Maus auf ein Visual zeigt, kann das Visual das Ereignis verarbeiten und Daten zum zugehörigen QuickInfo-Element anzeigen. Das Visual kann entweder eine standardmäßige QuickInfo oder eine QuickInfo der Berichtsseite anzeigen.

    Weitere Informationen finden Sie unter Hinzufügen von QuickInfos zu Ihren Power BI-Visuals.

  • Ein Benutzer ändert visuelle Eigenschaften (z. B. durch Erweitern einer Struktur) und das Visual speichert den neuen Zustand in seinen visuellen Eigenschaften.

    Ein Visual kann mithilfe der Power BI-API Eigenschaftswerte speichern. Wenn ein Benutzer beispielsweise mit dem Visual interagiert, und das Visual Eigenschaftswerte speichern oder aktualisieren muss, kann es die persistProperties-Methode aufrufen.

  • Wählen Sie eine URL aus.

    Standardmäßig kann ein Visual URLs nicht direkt öffnen. Stattdessen kann das visuelle Element die launchUrl-Methode aufrufen und die URL als Parameter übergeben, um eine URL in einer neuen Registerkarte zu öffnen.

    Weitere Informationen finden Sie unter Erstellen einer Start-URL.

  • Ein Benutzer wendet über das visuelle Element einen Filter an.

    Ein Visual kann die applyJsonFilter-Methode aufrufen und Bedingungen übergeben, um nach Daten in anderen Visuals zu filtern. Es stehen verschiedene Arten von Filtern zur Verfügung, beispielsweise einfache Filter, erweiterte Filter und Tupelfilter.

    Weitere Informationen finden Sie unter API für visuelle Filter für Power BI-Visuals.

  • Wählen Sie Elemente im visuellen Element aus.

    Weitere Informationen zu Auswahloptionen in einem Power BI-Visual finden Sie unter Power BI-Visuals interaktiv gestalten mithilfe von Auswahloptionen.

Das Visual interagiert mit Power BI

Manchmal initiiert das visuelle Element die Kommunikation mit dem Power BI-Host auch ohne eine Eingabe des Benutzers:

  • Ein Visual fordert mehr Daten von Power BI an.

    Ein Visual verarbeitet Daten nacheinander. Die fetchMoreData-API-Methode fordert das nächste Datenfragment im semantischen Modell an.

    Weitere Informationen finden Sie unter Abrufen größerer Datenmengen von Power BI.

  • Der Ereignisdienst wird ausgelöst.

    Power BI kann einen Bericht als PDF exportieren oder per E-Mail senden (gilt nur für zertifizierte Visuals). Um Power BI zu benachrichtigen, dass das Rendern abgeschlossen und das Visual zur Erfassung als PDF oder E-Mail bereit ist, muss das Visual die API zum Rendern von Ereignissen aufrufen.

    Weitere Informationen finden Sie unter Exportieren von Power BI-Berichten als PDF-Dateien.

    Informationen zum Ereignisdienst finden Sie unter Rendern von Ereignissen in Power BI-Visuals.

Zugehöriger Inhalt

Möchten Sie eigene Visualisierungen erstellen und zu Microsoft AppSource hinzufügen? Informationen hierzu finden Sie in diesen Artikeln: