Share via


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

このメソッドを 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);

制限事項

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

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

次のステップ