Partager via

Ajouter, supprimer ou renommer une page de rapport

  • Article

Vous pouvez utiliser des API d’opération de page pour ajouter ou supprimer une page d’un rapport pendant une session d’analytique incorporée Power BI.

Ajouter une page

Pour ajouter une nouvelle page au rapport actuel, utilisez la méthode de la classe Report Client Power BI :

addPage(displayName?: string): Promise<Page>
  • displayName définit le nom complet de la nouvelle page. Si ce n’est pas spécifié, le nom complet est défini sur Page#<NUM>.
  • La fonction retourne une instance Page de la nouvelle page.

Par exemple, ajoutez une page portant le nom complet Sales au rapport actuel :

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

Supprimer une page

Pour supprimer une page d’un rapport, vous pouvez utiliser la méthode de la classe Report ou la méthode de la classe Page , en fonction du contexte. La valeur de retour est résolue après la suppression de la page.

Supprimer une page à l’aide d’une instance de rapport

Pour supprimer une page d’un rapport à l’aide d’une instance de Report :

deletePage(pageName: string): Promise<void>

pageName est un identificateur unique différent de la displayName. Vous pouvez utiliser l’API report.getPages pour obtenir le pageName.

Par exemple, supprimez une page portant le nom ReportSection123:

await report.deletePage("ReportSection123");

ReportSection123 est la pageName l’API getPages retournée pour la page Sales

Supprimer une page à l’aide d’une instance de page

Pour supprimer une page d’un rapport à l’aide d’une instance de Page :

delete(): Promise<void>

Par exemple:

newPage.delete();

Renommer une page

Pour renommer une page sur un rapport, vous pouvez utiliser la méthode de la classe Report, ou la méthode de la classe page , en fonction du contexte. La valeur de retour se résout une fois la page renommée.

Renommer une page à l’aide d’une instance de rapport

Pour renommer une page à partir d’un rapport à l’aide de l’instance Report :

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

pageName est un identificateur unique différent de la displayName. Vous pouvez utiliser l’API report.getPages pour obtenir le pageName.

Par exemple, renommez la page avec le nom ReportSection123 pour new sales:

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

ReportSection123 est la pageName l’API getPages retournée pour la page Sales.

Renommer une page à l’aide d’une instance de page

Pour renommer une page à partir d’un rapport à l’aide de l’instance Page :

setDisplayName(displayName: string): Promise<void>

Par exemple, renommez la page en New Sales:

newPage.setDisplayName("New Sales");

Considérations et limitations

Les opérations de page fonctionnent uniquement une fois le rapport chargé.

Contenu connexe