Навигация по страницам
При загрузке отчета Power BI в приложении можно использовать API клиента Power BI для перехода между страницами отчета. Например, можно задать страницу по умолчанию или динамически изменить страницу. Это позволяет создавать собственную пользовательскую навигацию по страницам в соответствии с фирменной символией. Вы также можете автоматически изменять страницы на основе заданных критериев, чтобы отобразить определенные визуальные элементы и сведения пользователя.
Каждая страница отчета представлена объектом Page . Чтобы вернуть все страницы в отчете, вызовите метод отчета getPages , который возвращает страницы в виде коллекции Page объектов. Коллекция страниц возвращается в том же порядке, что и в отчете.
Класс Report определяет getPages метод следующим образом:
getPages(): Promise<Page[]>
Например:
let pages = await report.getPages();
Навигация между страницами отчета
Используйте объекты страниц и отчетов в приложении для перехода между страницами отчета, как показано в примерах кода в следующих разделах.
Установка активной страницы
setPage Используйте метод Report объекта, чтобы сделать существующую страницу активной страницей отчета.
Класс Report определяет setPage метод следующим образом:
setPage(pageName: string): Promise<void>
Например:
await report.setPage("page2");
Активная текущая страница
setActive Используйте метод Page объекта, чтобы гарантировать, что страница всегда действительна для данного отчета. Чтобы получить Page объекты, вызовите getPagesReport объект.
Класс Page определяет setActive метод следующим образом:
setActive(): Promise<void>
Пример:
await page.setActive();
Добавление обработчика событий
При мониторинге навигации по страницам пользователя в отчете необходимо учитывать, когда пользователь изменяет страницы. Для этого добавьте обработчик событий для pageChanged события. Например:
report.on('pageChanged', event => {
const page = event.detail.newPage;
console.log(page.name);
});
Дополнительные сведения о событиях см. в разделе "Обработка событий".