Sdílet prostřednictvím

Přidání, odstranění nebo přejmenování stránky sestavy

  • Článek

Pomocí rozhraní API operací stránky můžete přidat nebo odstranit stránku ze sestavy během relace vložených analytických možností Power BI.

Přidání stránky

Pokud chcete do aktuální sestavy přidat novou stránku, použijte metodu addPage třídy Sestava klienta Power BI:

addPage(displayName?: string): Promise<Page>
  • displayName nastaví zobrazovaný název nové stránky. Pokud není zadaný, zobrazovaný název je nastaven na Page#<NUM>.
  • Funkce vrátí Page instanci nové stránky.

Přidejte například stránku se zobrazovaným názvem Sales do aktuální sestavy:

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

Odstranění stránky

Pokud chcete odstranit stránku ze sestavy, můžete použít metodu deletePage třídy Sestava nebo metodu delete třídy Page v závislosti na kontextu. Vrácená hodnota se přeloží po odstranění stránky.

Odstranění stránky pomocí instance sestavy

Odstranění stránky ze sestavy pomocí instance Report:

deletePage(pageName: string): Promise<void>

pageName je jedinečný identifikátor, který se liší od displayName. K získání pageNamemůžete použít rozhraní API report.getPages .

Odstraňte například stránku s názvem ReportSection123:

await report.deletePage("ReportSection123");

ReportSection123 je pageName rozhraní API getPages vrácené na stránce Sales.

Odstranění stránky pomocí instance stránky

Odstranění stránky ze sestavy pomocí instance Page:

delete(): Promise<void>

Například:

newPage.delete();

Přejmenování stránky

Chcete-li přejmenovat stránku sestavy, můžete použít renamePage metodu sestavy třídy nebo setDisplayName metodu Page třídy v závislosti na kontextu. Vrácená hodnota se přeloží po přejmenování stránky.

Přejmenování stránky pomocí instance sestavy

Přejmenování stránky ze sestavy pomocí instance Report:

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

pageName je jedinečný identifikátor, který se liší od displayName. K získání pageNamemůžete použít rozhraní API report.getPages .

Například přejmenujte stránku s názvem ReportSection123 na New Sales:

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

ReportSection123 je pageName rozhraní API getPages vrácené pro stránku Sales.

Přejmenování stránky pomocí instance stránky

Přejmenování stránky ze sestavy pomocí instance Page:

setDisplayName(displayName: string): Promise<void>

Přejmenujte například stránku na New Sales:

newPage.setDisplayName("New Sales");

Důležité informace a omezení

Operace stránky fungují až po načtení sestavy.

Související obsah