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
addPage(displayName?: string): Promise<Page>
-
displayName
imposta il nome visualizzato per la nuova pagina. Se non specificato, il nome visualizzato viene impostato suPage#<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
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");
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
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