実行時にレポート設定を更新する

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);

考慮事項と制限事項

レポートが読み込まれた後、次の設定を更新することはできません。

  • ロケールの設定
  • モバイル レイアウト (レポートが最初に読み込まれたか、モバイル レイアウトなしでブートストラップされた場合)
  • ページ ナビゲーション ウィンドウの位置