Aggiungere, eliminare o rinominare una pagina del report

È possibile usare le API per l'operazione di pagina per aggiungere o eliminare una pagina da un report durante una sessione di analisi incorporata di Power BI.

Aggiungere una pagina

Per aggiungere una nuova pagina al report corrente, usare il metodo della classe Report report di Power BI:

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

• displayName imposta il nome visualizzato per la nuova pagina. Se non specificato, il nome visualizzato viene impostato su Page#<NUM>.
• La funzione restituisce un'istanza Page della nuova pagina.

Ad esempio, aggiungere una pagina con il nome visualizzato Sales al report corrente:

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

Eliminare una pagina

Per eliminare una pagina da un report, è possibile utilizzare il metodo della classe Report o il metodo della classe Page , a seconda del contesto. Il valore restituito viene risolto dopo l'eliminazione della pagina.

Eliminare una pagina usando un'istanza del report

Per eliminare una pagina da un report utilizzando un'istanza di Report:

deletePage(pageName: string): Promise<void>

pageName è un identificatore univoco diverso dal displayName. È possibile usare l'API report.getPages per ottenere il pageName.

Ad esempio, eliminare una pagina con il nome ReportSection123:

await report.deletePage("ReportSection123");

è il 'API restituita per la pagina Sales

Eliminare una pagina usando un'istanza di Page

Per eliminare una pagina da un report utilizzando un'istanza di Page:

delete(): Promise<void>

Per esempio:

newPage.delete();

Rinominare una pagina

Per rinominare una pagina in un report, è possibile utilizzare il metodo della classe Report o il metodo della classe page , a seconda del contesto. Il valore restituito viene risolto dopo la ridenominazione della pagina.

Rinominare una pagina usando un'istanza del report

Per rinominare una pagina da un report usando l'istanza di Report:

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

pageName è un identificatore univoco diverso dal displayName. È possibile usare l'API report.getPages per ottenere il pageName.

Ad esempio, rinominare la pagina con il nome ReportSection123 in New Sales:

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

ReportSection123 è il pageName'API getPages restituita per la pagina Sales.

Rinominare una pagina usando un'istanza di Page

Per rinominare una pagina da un report usando l'istanza di Page:

setDisplayName(displayName: string): Promise<void>

Ad esempio, rinominare la pagina in New Sales:

newPage.setDisplayName("New Sales");

Considerazioni e limitazioni

Le operazioni di pagina funzionano solo dopo il caricamento del report.

Contenuto correlato

• Ottenere pagine e oggetti visivi
• di spostamento nella pagina
• panoramica della creazione di report
• Creare, modificare e salvare un report incorporato