Udostępnij za pośrednictwem

Dodawanie, usuwanie lub zmienianie nazwy strony raportu

  • Artykuł

Interfejsy API operacji strony umożliwiają dodawanie lub usuwanie strony z raportu podczas sesji osadzonej analizy usługi Power BI.

Dodawanie strony

Aby dodać nową stronę do bieżącego raportu, użyj metody addPage klasy Raport klienta usługi Power BI:

addPage(displayName?: string): Promise<Page>
  • displayName ustawia nazwę wyświetlaną nowej strony. Jeśli nie zostanie określona, nazwa wyświetlana jest ustawiona na Page#<NUM>.
  • Funkcja zwraca wystąpienie Page nowej strony.

Na przykład dodaj stronę z nazwą wyświetlaną Sales do bieżącego raportu:

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

Usuwanie strony

Aby usunąć stronę z raportu, możesz użyć metody klasy raportów lub metody klasy Strony w zależności od kontekstu. Wartość zwracana jest rozpoznawana po usunięciu strony.

Usuwanie strony przy użyciu wystąpienia raportu

Aby usunąć stronę z raportu przy użyciu wystąpienia Report:

deletePage(pageName: string): Promise<void>

pageName jest unikatowym identyfikatorem, który różni się od displayName. Aby uzyskać pageName, możesz użyć interfejsu API report.getPages .

Na przykład usuń stronę o nazwie ReportSection123:

await report.deletePage("ReportSection123");

ReportSection123 to pageName interfejs API getPages zwrócony dla strony Sales

Usuwanie strony przy użyciu wystąpienia strony

Aby usunąć stronę z raportu przy użyciu wystąpienia Page:

delete(): Promise<void>

Na przykład:

newPage.delete();

Zmienianie nazwy strony

Aby zmienić nazwę strony w raporcie, możesz użyć metody klasy Report lub metody klasy Page w zależności od kontekstu. Wartość zwracana jest rozpoznawana po zmianie nazwy strony.

Zmienianie nazwy strony przy użyciu wystąpienia raportu

Aby zmienić nazwę strony z raportu przy użyciu wystąpienia Report:

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

pageName jest unikatowym identyfikatorem, który różni się od displayName. Aby uzyskać pageName, możesz użyć interfejsu API report.getPages .

Na przykład zmień nazwę strony na nazwę ReportSection123 na New Sales:

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

ReportSection123 to pageName interfejsu API getPages zwróconego dla strony Sales.

Zmienianie nazwy strony przy użyciu wystąpienia strony

Aby zmienić nazwę strony z raportu przy użyciu wystąpienia Page:

setDisplayName(displayName: string): Promise<void>

Na przykład zmień nazwę strony na New Sales:

newPage.setDisplayName("New Sales");

Zagadnienia i ograniczenia

Operacje na stronach działają tylko po załadowaniu raportu.

Powiązana zawartość