レポートページを追加、削除、または名前変更する

ページ操作 API を使用して、Power BI 埋め込み分析セッション中にレポートからページを追加または削除できます。

ページを追加する

現在のレポートに新しいページを追加するには、Power BI クライアント addPage クラスのメソッドを使用します。

addPage(displayName?: string): Promise<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");

ページ操作は、レポートが読み込まれた後にのみ機能します。