Freigeben über

Hinzufügen, Löschen oder Umbenennen einer Berichtsseite

  • Artikel

Sie können Seitenvorgangs-APIs verwenden, um während einer eingebetteten Power BI-Analysesitzung eine Seite aus einem Bericht hinzuzufügen oder zu löschen.

Hinzufügen einer Seite

Um dem aktuellen Bericht eine neue Seite hinzuzufügen, verwenden Sie die addPage Methode des Power BI-Clients Report Klasse:

addPage(displayName?: string): Promise<Page>
  • displayName legt den Anzeigenamen für die neue Seite fest. Wenn nicht angegeben, wird der Anzeigename auf Page#<NUM>festgelegt.
  • Die Funktion gibt eine Page Instanz der neuen Seite zurück.

Fügen Sie beispielsweise eine Seite mit dem Anzeigenamen Sales zum aktuellen Bericht hinzu:

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

Löschen einer Seite

Zum Löschen einer Seite aus einem Bericht können Sie je nach Kontext die deletePage Methode der Report-Klasse oder die delete Methode der Page-Klasse verwenden. Der Rückgabewert wird aufgelöst, nachdem die Seite gelöscht wurde.

Löschen einer Seite mithilfe einer Berichtsinstanz

So löschen Sie eine Seite aus einem Bericht mithilfe einer Report Instanz:

deletePage(pageName: string): Promise<void>

pageName ist ein eindeutiger Bezeichner, der sich von der displayNameunterscheidet. Sie können die report.getPages-API verwenden, um die pageNameabzurufen.

Löschen Sie beispielsweise eine Seite mit dem Namen ReportSection123:

await report.deletePage("ReportSection123");

ReportSection123 ist die pageName der getPages-API, die für die Seite Sales zurückgegeben wird.

Löschen einer Seite mithilfe einer Page-Instanz

So löschen Sie eine Seite aus einem Bericht mithilfe einer Page Instanz:

delete(): Promise<void>

Zum Beispiel:

newPage.delete();

Umbenennen einer Seite

Um eine Seite in einem Bericht umzubenennen, können Sie je nach Kontext die renamePage Methode der Report Klasse oder die setDisplayName Methode der Page Klasse verwenden. Der Rückgabewert wird aufgelöst, nachdem die Seite umbenannt wurde.

Umbenennen einer Seite mithilfe einer Berichtsinstanz

So benennen Sie eine Seite aus einem Bericht mithilfe der Report Instanz um:

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

pageName ist ein eindeutiger Bezeichner, der sich von der displayNameunterscheidet. Sie können die report.getPages-API verwenden, um die pageNameabzurufen.

Benennen Sie z. B. die Seite mit dem Namen ReportSection123 in New Salesum:

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

ReportSection123 ist die pageName der getPages-API, die für die Seite Sales zurückgegeben wird.

Umbenennen einer Seite mithilfe einer Page-Instanz

So benennen Sie eine Seite aus einem Bericht mithilfe der Page Instanz um:

setDisplayName(displayName: string): Promise<void>

Benennen Sie z. B. die Seite in Neue Verkäufeum:

newPage.setDisplayName("New Sales");

Überlegungen und Einschränkungen

Seitenvorgänge funktionieren erst nach dem Laden des Berichts.

Verwandte Inhalte