Compartir a través de

Agregar, eliminar o cambiar el nombre de una página de informe

  • Artículo

Puede usar las API de operación de página para agregar o eliminar una página de un informe durante una sesión de análisis insertado de Power BI.

Agregar una página

Para agregar una nueva página al informe actual, use el método de la clase Report Report:

addPage(displayName?: string): Promise<Page>
  • displayName establece el nombre para mostrar de la nueva página. Si no se especifica, el nombre para mostrar se establece en Page#<NUM>.
  • La función devuelve una instancia de Page de la nueva página.

Por ejemplo, agregue una página con el nombre para mostrar Sales al informe actual:

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

Eliminar una página

Para eliminar una página de un informe, puede usar el método de la clase Report de o el método de la clase Page, en función del contexto. El valor devuelto se resuelve después de eliminar la página.

Eliminación de una página mediante una instancia de informe

Para eliminar una página de un informe mediante una instancia de Report:

deletePage(pageName: string): Promise<void>

pageName es un identificador único diferente del displayName. Puede usar la API de report.getPages para obtener el pageName.

Por ejemplo, elimine una página con el nombre ReportSection123:

await report.deletePage("ReportSection123");

ReportSection123 es el pageName la API de getPages devuelta para la página de Sales

Eliminación de una página mediante una instancia de Page

Para eliminar una página de un informe mediante una instancia de Page:

delete(): Promise<void>

Por ejemplo:

newPage.delete();

Cambiar el nombre de una página

Para cambiar el nombre de una página de un informe, puede usar el método de la clase Report o el método de la clase Page de , en función del contexto. El valor devuelto se resuelve después de cambiar el nombre de la página.

Cambiar el nombre de una página mediante una instancia de informe

Para cambiar el nombre de una página de un informe mediante la instancia de Report:

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

pageName es un identificador único diferente del displayName. Puede usar la API de report.getPages para obtener el pageName.

Por ejemplo, cambie el nombre de la página por el nombre ReportSection123 a New Sales:

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

es el la API de devuelta para la página Sales de .

Cambiar el nombre de una página mediante una instancia de Page

Para cambiar el nombre de una página de un informe mediante la instancia de Page:

setDisplayName(displayName: string): Promise<void>

Por ejemplo, cambie el nombre de la página a New Sales:

newPage.setDisplayName("New Sales");

Consideraciones y limitaciones

Las operaciones de página solo funcionan después de cargar el informe.

Contenido relacionado