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