페이지 탐색
애플리케이션에서 Power BI 보고서를 로드할 때 Power BI 클라이언트 API를 사용하여 보고서 페이지 간을 탐색할 수 있습니다. 예를 들어 기본 페이지를 설정하거나 페이지를 동적으로 변경할 수 있습니다. 이렇게 하면 브랜드에 맞게 고유한 사용자 지정 페이지 탐색을 만들 수 있습니다. 설정된 조건에 따라 페이지를 자동으로 변경하여 사용자에게 특정 시각적 개체 및 정보를 표시할 수도 있습니다.
보고서의 각 페이지는 Page 개체로 표시됩니다. 보고서의 모든 페이지를 반환하려면 페이지를 개체 컬렉션 Page 으로 반환하는 보고서의 getPages 메서드를 호출합니다. 페이지 컬렉션은 보고서와 동일한 순서로 반환됩니다.
Report 클래스는 다음과 같이 메서드를 getPages 정의합니다.
getPages(): Promise<Page[]>
예를 들면 다음과 같습니다.
let pages = await report.getPages();
보고서 페이지 간을 탐색하는 방법
다음 섹션의 코드 예제와 같이 애플리케이션의 Page 및 Report 개체를 사용하여 보고서 페이지 간을 탐색합니다.
활성 페이지 설정
개체의 setPage 메서드를 Report 사용하여 기존 페이지를 보고서의 활성 페이지로 만듭니다.
Report 클래스는 다음과 같이 메서드를 setPage 정의합니다.
setPage(pageName: string): Promise<void>
예를 들면 다음과 같습니다.
await report.setPage("page2");
현재 페이지를 활성화합니다.
setActive 지정된 보고서에 대해 페이지가 항상 유효한지 확인하려면 개체의 Page 메서드를 사용합니다. 개체를 얻으려면 Page 개체를 호출 getPages 합니다 Report .
Page 클래스는 다음과 같이 메서드를 setActive 정의합니다.
setActive(): Promise<void>
예를 들면 다음과 같습니다.
await page.setActive();
이벤트 처리기 추가
보고서에서 사용자의 페이지 탐색을 모니터링하는 경우 사용자가 페이지를 변경하는 시기를 알아야 합니다. 이렇게 하려면 이벤트에 대한 이벤트 처리기를 추가합니다 pageChanged . 예를 들면 다음과 같습니다.
report.on('pageChanged', event => {
const page = event.detail.newPage;
console.log(page.name);
});
이벤트에 대한 자세한 내용은 이벤트를 처리하는 방법을 참조하세요.