페이지 작업 API를 사용하여 Power BI 임베디드 분석 세션 중에 보고서에서 페이지를 추가하거나 삭제할 수 있습니다.
페이지 추가
현재 보고서에 새 페이지를 추가하려면 Power BI 클라이언트 addPage 클래스의 메서드를 사용합니다.
addPage(displayName?: string): Promise<Page>
-
displayName새 페이지의 표시 이름을 설정합니다. 지정하지 않으면 표시 이름이Page#<NUM>. - 함수는 새 페이지의
Page인스턴스를 반환합니다.
예를 들어 표시 이름 Sales 있는 페이지를 현재 보고서에 추가합니다.
let newPage = await report.addPage("Sales");
페이지 삭제
보고서에서 페이지를 삭제하려면 컨텍스트에 따라 deletePage 클래스의 메서드 또는 delete 클래스의 메서드를 사용할 수 있습니다. 페이지가 삭제된 후 반환 값이 확인됩니다.
보고서 인스턴스를 사용하여 페이지 삭제
Report 인스턴스를 사용하여 보고서에서 페이지를 삭제하려면 다음을 수행합니다.
deletePage(pageName: string): Promise<void>
pageName
displayName다른 고유 식별자입니다.
report.getPages API를 사용하여 pageName가져올 수 있습니다.
예를 들어 이름이 ReportSection123있는 페이지를 삭제합니다.
await report.deletePage("ReportSection123");
ReportSection123
pageName 페이지에 대해 반환된 getPages API의 .
페이지 인스턴스를 사용하여 페이지 삭제
Page 인스턴스를 사용하여 보고서에서 페이지를 삭제하려면 다음을 수행합니다.
delete(): Promise<void>
예를 들어:
newPage.delete();
페이지 이름 바꾸기
보고서의 페이지 이름을 바꾸려면 컨텍스트에 따라 renamePage 클래스의 메서드 또는 setDisplayName 클래스의 메서드를 사용할 수 있습니다. 페이지 이름이 바뀐 후 반환 값이 확인됩니다.
보고서 인스턴스를 사용하여 페이지 이름 바꾸기
Report 인스턴스를 사용하여 보고서의 페이지 이름을 바꾸려면 다음을 수행합니다.
renamePage(pageName: string, displayName: string): Promise<void>
pageName
displayName다른 고유 식별자입니다.
report.getPages API를 사용하여 pageName가져올 수 있습니다.
예를 들어 이름
report.renamePage("ReportSection123", "New Sales");
ReportSection123
pageName 페이지에 대해 반환된 getPages API를 .
페이지 인스턴스를 사용하여 페이지 이름 바꾸기
Page 인스턴스를 사용하여 보고서의 페이지 이름을 바꾸려면 다음을 수행합니다.
setDisplayName(displayName: string): Promise<void>
예를 들어 새 판매
newPage.setDisplayName("New Sales");
고려 사항 및 제한 사항
페이지 작업은 보고서가 로드된 후에만 작동합니다.