Freigeben über


Aktualisieren der Berichtseinstellungen zur Laufzeit

Sie können die report.updateSettings-Methode verwenden, um die Berichtseinstellungen zu aktualisieren, wenn der Bericht bereits geladen wurde. Die settings-Eigenschaft wird verwendet, um die Darstellung und das Verhalten Ihres eingebetteten Power BI-Berichts anzupassen.

So aktualisieren Sie die Berichtseinstellungen

Die Power BI Client Report Klasse definiert die updateSettings Methode wie:

report.updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>

Informationen zu den Details des Einstellungsobjekts finden Sie unter Konfigurieren von Berichtseinstellungen.

Beispiel

So aktualisieren Sie die Berichtseinstellungen und zeigen den Textmarkenbereich an:

const newSettings = {
    panes: {
        bookmarks: {
            visible: true
        }
    }
};

await report.updateSettings(newSettings);

Überlegungen und Einschränkungen

Die folgenden Einstellungen können nach dem Laden des Berichts nicht aktualisiert werden:

  • Gebietsschemaeinstellungen
  • Mobiles Layout, wenn der Bericht anfangs geladen oder ohne mobiles Layout gestartet wurde
  • Position des Seitennavigationsbereichs