Report class

Power BI 보고서 포함 구성 요소

Extends

Embed

속성

bookmarksManager

메서드

addContextMenuCommand(string, string, string, MenuLocation, string, string, string)

상황에 맞는 메뉴 확장 명령을 추가합니다.

report.addContextMenuCommand(commandName, commandTitle, contextMenuTitle, menuLocation, visualName, visualType, groupName)
 .catch(error => {
     ...
 });
addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)

옵션 메뉴 확장 명령을 추가합니다.

report.addOptionsMenuCommand(commandName, commandTitle, optionsMenuTitle, menuLocation, visualName, visualType, groupName, commandIcon)
 .catch(error => {
     ...
 });
addPage(string)

보고서에 빈 페이지 추가

// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
applyTheme(IReportTheme)

보고서에 테마 적용

report.applyTheme(theme);
arePersistentFiltersApplied()

보고서에 적용된 사용자의 필터, 슬라이서 또는 기타 데이터 뷰 변경 내용이 있는지 여부를 반환합니다. 영구 필터를 사용하지 않도록 설정하면 false를 반환합니다.

report.arePersistentFiltersApplied();
clearSelectedVisuals(boolean)

선택한 시각적 개체를 선택 취소합니다. 플래그가 전달되면 모든 시각적 개체 선택 항목이 지워집니다.

report.clearSelectedVisuals()
 .then(() => {
     ...
 });
closeAllOverlays()

열려 있는 모든 상황에 맞는 메뉴 및 도구 설명을 닫습니다.

report.closeAllOverlays()
 .then(() => {
     ...
 });
configChanged(boolean)

구성 변경 내용을 처리합니다.

deletePage(string)

보고서에서 페이지 삭제

// Delete a page from a report by pageName (PageName is different than the display name and can be acquired from the getPages API)
report.deletePage("ReportSection145");
getActivePage()

활성 보고서 페이지를 가져옵니다.

report.getActivePage()
 .then(activePage => {
     ...
 });
getFilters()

보고서 수준에서 적용되는 필터를 가져옵니다.

// Get filters applied at report level
report.getFilters()
  .then(filters => {
    ...
  });
getId()

사용 가능한 첫 번째 위치인 옵션, 특성, 포함 URL에서 보고서 ID를 가져옵니다.

getPageByName(string)

보고서 페이지를 이름으로 가져옵니다.

report.getPageByName(pageName)
 .then(page => {
     ...
 });
getPages()

보고서 내의 페이지 목록을 가져옵니다.

report.getPages()
 .then(pages => {
     ...
 });
getTheme()

보고서의 테마 가져오기

report.getTheme();
getZoom()

보고서의 현재 확대/축소 수준을 반환합니다.

isSaved()

보고서가 저장되었는지 확인합니다.

report.isSaved()
moveVisual(string, string, number, number, number)

페이지에서 시각적 개체의 위치를 업데이트합니다.

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
print()

embed iframe 구성 요소에서 window.print() 호출하여 보고서의 활성 페이지를 인쇄합니다.

refresh()

보고서의 데이터 원본을 새로 고칩니다.

report.refresh();
removeContextMenuCommand(string, string)

상황에 맞는 메뉴 확장 명령을 제거합니다.

report.removeContextMenuCommand(commandName, contextMenuTitle)
 .catch(error => {
     ...
 });
removeFilters()

보고서 수준에서 모든 필터를 제거합니다.

report.removeFilters();
removeOptionsMenuCommand(string, string)

옵션 메뉴 확장 명령을 제거합니다.

report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
 .then({
     ...
 });
renamePage(string, string)

보고서에서 페이지 이름 바꾸기

// Rename a page from a report by changing displayName (pageName is different from the display name and can be acquired from the getPages API)
report.renamePage("ReportSection145", "Sales");
render(IReportEmbedConfiguration | IReportLoadConfiguration)

단계별 포함 API를 사용하여 미리 로드된 보고서 렌더링

// Load report
var report = powerbi.load(element, config);

...

// Render report
report.render()
resetPersistentFilters()

사용자의 필터, 슬라이서 및 기타 데이터 뷰 변경 내용을 보고서의 기본 상태로 다시 설정

report.resetPersistentFilters();
resetTheme()

보고서의 기본 테마 다시 설정 및 적용

report.resetTheme();
resizeActivePage(PageSizeType, number, number)

보고서의 활성 페이지 크기를 업데이트합니다.

report.resizeActivePage(pageSizeType, width, height)
  .catch(error => { ... });
resizeVisual(string, string, number, number)

페이지의 시각적 개체 크기를 조정합니다.

report.resizeVisual(pageName, visualName, width, height)
  .catch(error => { ... });
savePersistentFilters()

보고서의 사용자 필터, 슬라이서 및 기타 데이터 뷰 변경 내용 저장

report.savePersistentFilters();
setFilters(IFilter[])

보고서 수준에서 필터를 설정합니다.

const filters: [
   ...
];

report.setFilters(filters)
 .catch(errors => {
   ...
 });
setPage(string)

보고서의 활성 페이지를 설정합니다.

report.setPage("page2")
 .catch(error => { ... });
setVisualDisplayState(string, string, VisualContainerDisplayMode)

페이지에서 시각적 개체의 표시 상태를 업데이트합니다.

report.setVisualDisplayState(pageName, visualName, displayState)
  .catch(error => { ... });
setZoom(number)

보고서의 확대/축소 수준을 설정합니다.

switchLayout(LayoutType)

보고서 레이아웃 업데이트

report.switchLayout(layoutType);
switchMode(string | ViewMode)

보고서 보기 모드 전환

updateFilters(FiltersOperations, IFilter[])

작업: 추가, 모두 바꾸기, 대상으로 바꾸기 또는 제거 작업에 따라 보고서 수준에서 필터를 업데이트합니다.

report.updateFilters(FiltersOperations.Add, filters)
  .catch(errors => { ... });
updateSettings(ISettings)

필터 창 및 페이지 탐색 창에 대한 표시 유형 설정을 업데이트합니다.

const newSettings = {
  panes: {
    filters: {
      visible: false
    }
  }
};

report.updateSettings(newSettings)
  .catch(error => { ... });

상속된 메서드

exitFullscreen()

브라우저에 전체 화면 모드를 종료하도록 요청합니다.

fullscreen()

전체 화면 모드에서 구성 요소의 iframe을 렌더링하도록 브라우저에 요청합니다.

getCorrelationId()

현재 포함 세션의 correlationId를 가져옵니다.

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
off<T>(string, IEventHandler<T>)

처리기 목록에서 하나 이상의 이벤트 처리기를 제거합니다. 기존 핸들 함수에 대한 참조를 지정한 경우 특정 처리기를 제거합니다. 처리기를 지정하지 않으면 지정된 이벤트 이름에 대한 모든 처리기를 제거합니다.

report.off('pageChanged')

or

const logHandler = function (event) {
   console.log(event);
};

report.off('pageChanged', logHandler);
on<T>(string, IEventHandler<T>)

특정 이벤트에 대한 이벤트 처리기를 추가합니다.

report.on('pageChanged', (event) => {
  console.log('PageChanged: ', event.page.name);
});
reload()

기존 구성을 사용하여 포함을 다시 로드합니다. 예를 들어 보고서의 경우 모든 필터를 효과적으로 지우고 첫 번째 페이지를 활성화하여 보고서를 로드된 상태로 다시 설정하는 시뮬레이션을 수행합니다.

report.reload();
removeComponentTabIndex(number)

요소의 tabindex 특성을 제거합니다.

save()

보고서를 저장합니다.

saveAs(ISaveAsParameters)

SaveAs 보고서입니다.

setAccessToken(string)

accessToken을 설정합니다.

setComponentTabIndex(number)

요소의 tabindex 특성을 설정합니다.

setComponentTitle(string)

접근성을 위해 구성 요소 제목을 설정합니다. iframe의 경우 이 메서드는 iframe 제목을 변경합니다.

속성 세부 정보

bookmarksManager

bookmarksManager: BookmarksManager

속성 값

메서드 세부 정보

addContextMenuCommand(string, string, string, MenuLocation, string, string, string)

상황에 맞는 메뉴 확장 명령을 추가합니다.

report.addContextMenuCommand(commandName, commandTitle, contextMenuTitle, menuLocation, visualName, visualType, groupName)
 .catch(error => {
     ...
 });
function addContextMenuCommand(commandName: string, commandTitle: string, contextMenuTitle: string, menuLocation: MenuLocation, visualName: string, visualType: string, groupName?: string): Promise<IHttpPostMessageResponse<void>>

매개 변수

commandName

string

commandTitle

string

contextMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

반환

Promise<IHttpPostMessageResponse<void>>

addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)

옵션 메뉴 확장 명령을 추가합니다.

report.addOptionsMenuCommand(commandName, commandTitle, optionsMenuTitle, menuLocation, visualName, visualType, groupName, commandIcon)
 .catch(error => {
     ...
 });
function addOptionsMenuCommand(commandName: string, commandTitle: string, optionsMenuTitle?: string, menuLocation?: MenuLocation, visualName?: string, visualType?: string, groupName?: string, commandIcon?: string): Promise<IHttpPostMessageResponse<void>>

매개 변수

commandName

string

commandTitle

string

optionsMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

commandIcon

string

반환

Promise<IHttpPostMessageResponse<void>>

addPage(string)

보고서에 빈 페이지 추가

// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
function addPage(displayName?: string): Promise<Page>

매개 변수

displayName

string

반환

Promise<Page>

applyTheme(IReportTheme)

보고서에 테마 적용

report.applyTheme(theme);
function applyTheme(theme: IReportTheme): Promise<void>

매개 변수

theme
IReportTheme

반환

Promise<void>

arePersistentFiltersApplied()

보고서에 적용된 사용자의 필터, 슬라이서 또는 기타 데이터 뷰 변경 내용이 있는지 여부를 반환합니다. 영구 필터를 사용하지 않도록 설정하면 false를 반환합니다.

report.arePersistentFiltersApplied();
function arePersistentFiltersApplied(): Promise<boolean>

반환

Promise<boolean>

clearSelectedVisuals(boolean)

선택한 시각적 개체를 선택 취소합니다. 플래그가 전달되면 모든 시각적 개체 선택 항목이 지워집니다.

report.clearSelectedVisuals()
 .then(() => {
     ...
 });
function clearSelectedVisuals(clearPopOutState?: boolean): Promise<void>

매개 변수

clearPopOutState

boolean

시각적 개체 중 하나가 팝아웃 상태인 경우 false/정의되지 않은 시각적 개체 선택 영역이 지워지지 않는 경우(포커스에서 테이블로 표시, 스포트라이트...)

반환

Promise<void>

closeAllOverlays()

열려 있는 모든 상황에 맞는 메뉴 및 도구 설명을 닫습니다.

report.closeAllOverlays()
 .then(() => {
     ...
 });
function closeAllOverlays(): Promise<void>

반환

Promise<void>

configChanged(boolean)

구성 변경 내용을 처리합니다.

function configChanged(isBootstrap: boolean)

매개 변수

isBootstrap

boolean

deletePage(string)

보고서에서 페이지 삭제

// Delete a page from a report by pageName (PageName is different than the display name and can be acquired from the getPages API)
report.deletePage("ReportSection145");
function deletePage(pageName: string): Promise<void>

매개 변수

pageName

string

반환

Promise<void>

getActivePage()

활성 보고서 페이지를 가져옵니다.

report.getActivePage()
 .then(activePage => {
     ...
 });
function getActivePage(): Promise<Page>

반환

Promise<Page>

getFilters()

보고서 수준에서 적용되는 필터를 가져옵니다.

// Get filters applied at report level
report.getFilters()
  .then(filters => {
    ...
  });
function getFilters(): Promise<IFilter[]>

반환

Promise<IFilter[]>

getId()

사용 가능한 첫 번째 위치인 옵션, 특성, 포함 URL에서 보고서 ID를 가져옵니다.

function getId(): string

반환

string

getPageByName(string)

보고서 페이지를 이름으로 가져옵니다.

report.getPageByName(pageName)
 .then(page => {
     ...
 });
function getPageByName(pageName: string): Promise<Page>

매개 변수

pageName

string

반환

Promise<Page>

getPages()

보고서 내의 페이지 목록을 가져옵니다.

report.getPages()
 .then(pages => {
     ...
 });
function getPages(): Promise<Page[]>

반환

Promise<Page[]>

getTheme()

보고서의 테마 가져오기

report.getTheme();
function getTheme(): Promise<IReportTheme>

반환

Promise<IReportTheme>

getZoom()

보고서의 현재 확대/축소 수준을 반환합니다.

function getZoom(): Promise<number>

반환

Promise<number>

isSaved()

보고서가 저장되었는지 확인합니다.

report.isSaved()
function isSaved(): Promise<boolean>

반환

Promise<boolean>

moveVisual(string, string, number, number, number)

페이지에서 시각적 개체의 위치를 업데이트합니다.

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
function moveVisual(pageName: string, visualName: string, x: number, y: number, z?: number): Promise<IHttpPostMessageResponse<void>>

매개 변수

pageName

string

visualName

string

x

number

y

number

z

number

반환

Promise<IHttpPostMessageResponse<void>>

print()

embed iframe 구성 요소에서 window.print() 호출하여 보고서의 활성 페이지를 인쇄합니다.

function print(): Promise<void>

반환

Promise<void>

refresh()

보고서의 데이터 원본을 새로 고칩니다.

report.refresh();
function refresh(): Promise<void>

반환

Promise<void>

removeContextMenuCommand(string, string)

상황에 맞는 메뉴 확장 명령을 제거합니다.

report.removeContextMenuCommand(commandName, contextMenuTitle)
 .catch(error => {
     ...
 });
function removeContextMenuCommand(commandName: string, contextMenuTitle: string): Promise<IHttpPostMessageResponse<void>>

매개 변수

commandName

string

contextMenuTitle

string

반환

Promise<IHttpPostMessageResponse<void>>

removeFilters()

보고서 수준에서 모든 필터를 제거합니다.

report.removeFilters();
function removeFilters(): Promise<IHttpPostMessageResponse<void>>

반환

Promise<IHttpPostMessageResponse<void>>

removeOptionsMenuCommand(string, string)

옵션 메뉴 확장 명령을 제거합니다.

report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
 .then({
     ...
 });
function removeOptionsMenuCommand(commandName: string, optionsMenuTitle: string): Promise<IHttpPostMessageResponse<void>>

매개 변수

commandName

string

optionsMenuTitle

string

반환

Promise<IHttpPostMessageResponse<void>>

renamePage(string, string)

보고서에서 페이지 이름 바꾸기

// Rename a page from a report by changing displayName (pageName is different from the display name and can be acquired from the getPages API)
report.renamePage("ReportSection145", "Sales");
function renamePage(pageName: string, displayName: string): Promise<void>

매개 변수

pageName

string

displayName

string

반환

Promise<void>

render(IReportEmbedConfiguration | IReportLoadConfiguration)

단계별 포함 API를 사용하여 미리 로드된 보고서 렌더링

// Load report
var report = powerbi.load(element, config);

...

// Render report
report.render()
function render(config?: IReportEmbedConfiguration | IReportLoadConfiguration): Promise<void>

매개 변수

반환

Promise<void>

resetPersistentFilters()

사용자의 필터, 슬라이서 및 기타 데이터 뷰 변경 내용을 보고서의 기본 상태로 다시 설정

report.resetPersistentFilters();
function resetPersistentFilters(): Promise<IHttpPostMessageResponse<void>>

반환

Promise<IHttpPostMessageResponse<void>>

resetTheme()

보고서의 기본 테마 다시 설정 및 적용

report.resetTheme();
function resetTheme(): Promise<void>

반환

Promise<void>

resizeActivePage(PageSizeType, number, number)

보고서의 활성 페이지 크기를 업데이트합니다.

report.resizeActivePage(pageSizeType, width, height)
  .catch(error => { ... });
function resizeActivePage(pageSizeType: PageSizeType, width?: number, height?: number): Promise<IHttpPostMessageResponse<void>>

매개 변수

pageSizeType
PageSizeType
width

number

height

number

반환

Promise<IHttpPostMessageResponse<void>>

resizeVisual(string, string, number, number)

페이지의 시각적 개체 크기를 조정합니다.

report.resizeVisual(pageName, visualName, width, height)
  .catch(error => { ... });
function resizeVisual(pageName: string, visualName: string, width: number, height: number): Promise<IHttpPostMessageResponse<void>>

매개 변수

pageName

string

visualName

string

width

number

height

number

반환

Promise<IHttpPostMessageResponse<void>>

savePersistentFilters()

보고서의 사용자 필터, 슬라이서 및 기타 데이터 뷰 변경 내용 저장

report.savePersistentFilters();
function savePersistentFilters(): Promise<IHttpPostMessageResponse<void>>

반환

Promise<IHttpPostMessageResponse<void>>

setFilters(IFilter[])

보고서 수준에서 필터를 설정합니다.

const filters: [
   ...
];

report.setFilters(filters)
 .catch(errors => {
   ...
 });
function setFilters(filters: IFilter[]): Promise<IHttpPostMessageResponse<void>>

매개 변수

filters

IFilter[]

반환

Promise<IHttpPostMessageResponse<void>>

setPage(string)

보고서의 활성 페이지를 설정합니다.

report.setPage("page2")
 .catch(error => { ... });
function setPage(pageName: string): Promise<IHttpPostMessageResponse<void>>

매개 변수

pageName

string

반환

Promise<IHttpPostMessageResponse<void>>

setVisualDisplayState(string, string, VisualContainerDisplayMode)

페이지에서 시각적 개체의 표시 상태를 업데이트합니다.

report.setVisualDisplayState(pageName, visualName, displayState)
  .catch(error => { ... });
function setVisualDisplayState(pageName: string, visualName: string, displayState: VisualContainerDisplayMode): Promise<IHttpPostMessageResponse<void>>

매개 변수

pageName

string

visualName

string

반환

Promise<IHttpPostMessageResponse<void>>

setZoom(number)

보고서의 확대/축소 수준을 설정합니다.

function setZoom(zoomLevel: number): Promise<void>

매개 변수

zoomLevel

number

설정할 확대/축소 수준

반환

Promise<void>

switchLayout(LayoutType)

보고서 레이아웃 업데이트

report.switchLayout(layoutType);
function switchLayout(layoutType: LayoutType): Promise<IHttpPostMessageResponse<void>>

매개 변수

layoutType
LayoutType

반환

Promise<IHttpPostMessageResponse<void>>

switchMode(string | ViewMode)

보고서 보기 모드 전환

function switchMode(viewMode: string | ViewMode): Promise<void>

매개 변수

viewMode

string | ViewMode

반환

Promise<void>

updateFilters(FiltersOperations, IFilter[])

작업: 추가, 모두 바꾸기, 대상으로 바꾸기 또는 제거 작업에 따라 보고서 수준에서 필터를 업데이트합니다.

report.updateFilters(FiltersOperations.Add, filters)
  .catch(errors => { ... });
function updateFilters(operation: FiltersOperations, filters?: IFilter[]): Promise<IHttpPostMessageResponse<void>>

매개 변수

operation
FiltersOperations
filters

IFilter[]

반환

Promise<IHttpPostMessageResponse<void>>

updateSettings(ISettings)

필터 창 및 페이지 탐색 창에 대한 표시 유형 설정을 업데이트합니다.

const newSettings = {
  panes: {
    filters: {
      visible: false
    }
  }
};

report.updateSettings(newSettings)
  .catch(error => { ... });
function updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>

매개 변수

settings
ISettings

반환

Promise<IHttpPostMessageResponse<void>>

상속된 메서드 세부 정보

exitFullscreen()

브라우저에 전체 화면 모드를 종료하도록 요청합니다.

function exitFullscreen()

Embed.exitFullscreen에서 상속된

fullscreen()

전체 화면 모드에서 구성 요소의 iframe을 렌더링하도록 브라우저에 요청합니다.

function fullscreen()

Embed.fullscreen에서 상속된

getCorrelationId()

현재 포함 세션의 correlationId를 가져옵니다.

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
function getCorrelationId(): Promise<string>

반환

Promise<string>

Embed.getCorrelationId에서 상속된

off<T>(string, IEventHandler<T>)

처리기 목록에서 하나 이상의 이벤트 처리기를 제거합니다. 기존 핸들 함수에 대한 참조를 지정한 경우 특정 처리기를 제거합니다. 처리기를 지정하지 않으면 지정된 이벤트 이름에 대한 모든 처리기를 제거합니다.

report.off('pageChanged')

or

const logHandler = function (event) {
   console.log(event);
};

report.off('pageChanged', logHandler);
function off<T>(eventName: string, handler?: IEventHandler<T>)

매개 변수

eventName

string

handler

IEventHandler<T>

Embed.off에서 상속된

on<T>(string, IEventHandler<T>)

특정 이벤트에 대한 이벤트 처리기를 추가합니다.

report.on('pageChanged', (event) => {
  console.log('PageChanged: ', event.page.name);
});
function on<T>(eventName: string, handler: IEventHandler<T>)

매개 변수

eventName

string

handler

IEventHandler<T>

Embed.on에서 상속된

reload()

기존 구성을 사용하여 포함을 다시 로드합니다. 예를 들어 보고서의 경우 모든 필터를 효과적으로 지우고 첫 번째 페이지를 활성화하여 보고서를 로드된 상태로 다시 설정하는 시뮬레이션을 수행합니다.

report.reload();
function reload(): Promise<void>

반환

Promise<void>

Embed.reload에서 상속된

removeComponentTabIndex(number)

요소의 tabindex 특성을 제거합니다.

function removeComponentTabIndex(_tabIndex?: number)

매개 변수

_tabIndex

number

Embed.removeComponentTabIndex에서 상속된

save()

보고서를 저장합니다.

function save(): Promise<void>

반환

Promise<void>

Embed.save에서 상속된

saveAs(ISaveAsParameters)

SaveAs 보고서입니다.

function saveAs(saveAsParameters: ISaveAsParameters): Promise<void>

매개 변수

saveAsParameters
ISaveAsParameters

반환

Promise<void>

Embed.saveAs에서 상속된

setAccessToken(string)

accessToken을 설정합니다.

function setAccessToken(accessToken: string): Promise<void>

매개 변수

accessToken

string

반환

Promise<void>

Embed.setAccessToken에서 상속된

setComponentTabIndex(number)

요소의 tabindex 특성을 설정합니다.

function setComponentTabIndex(tabIndex?: number)

매개 변수

tabIndex

number

Embed.setComponentTabIndex에서 상속된

setComponentTitle(string)

접근성을 위해 구성 요소 제목을 설정합니다. iframe의 경우 이 메서드는 iframe 제목을 변경합니다.

function setComponentTitle(title: string)

매개 변수

title

string

Embed.setComponentTitle에서 상속된