Добавление, удаление или переименование страницы отчета

Api операции страницы можно использовать для добавления или удаления страницы из отчета во время сеанса встроенной аналитики Power BI.

Добавление страницы

Чтобы добавить новую страницу в текущий отчет, используйте метод класса отчета клиента Power BI:

addPage(displayName?: string): Promise<Page>

displayName задает отображаемое имя новой страницы. Если не указано, отображаемое имя имеет значение Page#<NUM>.
Функция возвращает экземпляр Page новой страницы.

Например, добавьте страницу с отображаемым именем sales в текущий отчет:

let newPage = await report.addPage("Sales");

Удаление страницы

Чтобы удалить страницу из отчета, можно использовать метод deletePage класса Report или метод delete класса Page в зависимости от контекста. Возвращаемое значение разрешается после удаления страницы.

Удаление страницы с помощью экземпляра отчета

Чтобы удалить страницу из отчета с помощью экземпляра Report:

deletePage(pageName: string): Promise<void>

pageName — это уникальный идентификатор, который отличается от displayName. Api report.getPages можно использовать для получения pageName.

Например, удалите страницу с именем ReportSection123:

await report.deletePage("ReportSection123");

ReportSection123 — это pageName API getPages, возвращенный на страницу продаж

Удаление страницы с помощью экземпляра страницы

Чтобы удалить страницу из отчета с помощью экземпляра Page:

delete(): Promise<void>

Например:

newPage.delete();

Переименование страницы

Чтобы переименовать страницу в отчете, можно использовать метод renamePage класса Report или метод setDisplayName класса Page в зависимости от контекста. Возвращаемое значение разрешается после переименования страницы.

Переименование страницы с помощью экземпляра отчета

Чтобы переименовать страницу из отчета с помощью экземпляра Report:

renamePage(pageName: string, displayName: string): Promise<void>

Например, переименуйте страницу с именем ReportSection123 в New Sales:

report.renamePage("ReportSection123", "New Sales");

— это API , возвращенный для страницы продаж .

Переименование страницы с помощью экземпляра страницы

Чтобы переименовать страницу из отчета с помощью экземпляра Page:

setDisplayName(displayName: string): Promise<void>

Например, переименуйте страницу на new Sales:

newPage.setDisplayName("New Sales");