다음을 통해 공유


페이지 탐색

애플리케이션에서 Power BI 보고서를 로드할 때 Power BI 클라이언트 API를 사용하여 보고서 페이지 간에 이동할 수 있습니다. 예를 들어 기본 페이지를 설정하거나 페이지를 동적으로 변경할 수 있습니다. 이렇게 하면 브랜드와 일치하도록 고유한 사용자 지정 페이지 탐색을 만들 수 있습니다. 설정된 조건에 따라 페이지를 자동으로 변경하여 사용자에게 특정 시각적 개체와 정보를 표시할 수도 있습니다.

보고서의 각 페이지는 Page 개체로 표시됩니다. 보고서의 모든 페이지를 반환하려면 페이지를 Page 개체의 컬렉션으로 반환하는 보고서의 getPages 메서드를 호출합니다. 페이지 컬렉션은 보고서와 동일한 순서로 반환됩니다.

Report 클래스는 다음과 같이 getPages 메서드를 정의합니다.

getPages(): Promise<Page[]>

예를 들어:

let pages = await report.getPages();

보고서 페이지 간을 탐색하는 방법

다음 섹션의 코드 예제와 같이 애플리케이션에서 페이지보고서 개체를 사용하여 보고서 페이지 간을 탐색합니다.

활성 페이지 설정

Report 개체의 setPage 메서드를 사용하여 기존 페이지를 보고서의 활성 페이지로 만듭니다.

Report 클래스는 다음과 같이 setPage 메서드를 정의합니다.

setPage(pageName: string): Promise<void>

예를 들어:

await report.setPage("page2");

현재 페이지를 활성 상태로 만들기

지정된 보고서에 대해 페이지가 항상 유효한지 확인하려면 Page 개체의 setActive 메서드를 사용합니다. Page 개체를 얻으려면 Report 개체에서 getPages 호출합니다.

Page 클래스는 다음과 같이 setActive 메서드를 정의합니다.

setActive(): Promise<void>

예를 들어:

await page.setActive();

이벤트 처리기 추가

보고서에서 사용자의 페이지 탐색을 모니터링하는 경우 사용자가 페이지를 변경하는 시기를 알아야 합니다. 이렇게 하려면 pageChanged 이벤트에 대한 이벤트 처리기를 추가합니다. 예를 들어:

report.on('pageChanged', event => {
    const page = event.detail.newPage;
    console.log(page.name);
});

이벤트에 대한 자세한 내용은 이벤트처리하는 방법을 참조하세요.