다음을 통해 공유

런타임에 보고서 설정 업데이트

  • 아티클

report.updateSettings 메서드를 사용하여 보고서가 이미 로드된 경우 보고서 설정을 업데이트할 수 있습니다. settings 속성은 포함된 Power BI 보고서의 모양과 동작을 조정하는 데 사용됩니다.

보고서 설정을 업데이트하는 방법

Power BI 클라이언트 Report 클래스는 updateSettings 메서드를 다음과 같이 정의합니다.

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

설정 개체 세부 정보는 보고서 설정 구성을 참조하세요.

본보기

보고서 설정을 업데이트하고 책갈피 창을 표시하려면 다음을 수행합니다.

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

await report.updateSettings(newSettings);

고려 사항 및 제한 사항

보고서를 로드한 후에는 다음 설정을 업데이트할 수 없습니다.

  • 로캘 설정
  • 모바일 레이아웃( 보고서가 처음에 로드되었거나 모바일 레이아웃 없이 부트스트랩된 경우)
  • 페이지 탐색 창 위치

관련 콘텐츠