実行時にレポート設定を更新する
このメソッドを report.updateSettings
使用すると、レポートが既に読み込まれているときにレポート設定を更新できます。
この settings
プロパティは、埋め込み Power BI レポートの外観と動作を調整するために使用されます。
レポート設定を更新する方法
Power BI クライアント レポート クラスは、メソッドを updateSettings
次のように定義します。
report.updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>
設定オブジェクトの詳細については、 レポート設定の構成 を参照してください。
例
レポート設定を更新し、ブックマーク ウィンドウを表示するには:
const newSettings = {
panes: {
bookmarks: {
visible: true
}
}
};
await report.updateSettings(newSettings);
制限事項
レポートの読み込み後に次の設定を更新することはできません。
- ロケール設定
- モバイル レイアウト (レポートが最初に読み込まれたか、モバイル レイアウトなしでブートストラップされた場合)
- ページ ナビゲーション ウィンドウの位置