Aracılığıyla paylaş


Rapor sayfası ekleme, silme veya yeniden adlandırma

Power BI tümleşik analiz oturumu sırasında rapora sayfa eklemek veya rapordan sayfa silmek için sayfa işlemi API'lerini kullanabilirsiniz.

Sayfa ekleme

Geçerli rapora yeni bir sayfa eklemek için Power BI İstemcisi addPage sınıfının yöntemini kullanın:

addPage(displayName?: string): Promise<Page>
  • displayName yeni sayfanın görünen adını ayarlar. Belirtilmezse, görünen ad Page#<NUM>olarak ayarlanır.
  • İşlev, yeni sayfanın Page bir örneğini döndürür.

Örneğin, geçerli rapora Sales görünen adıyla bir sayfa ekleyin:

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

Sayfa silme

Rapordan sayfa silmek için, bağlama bağlı olarak deletePage sınıfının yöntemini veya delete sınıfının yöntemini kullanabilirsiniz. Dönüş değeri, sayfa silindikten sonra çözülür.

Rapor örneği kullanarak sayfa silme

Report örneği kullanarak bir rapordan sayfa silmek için:

deletePage(pageName: string): Promise<void>

pageName, displayNamefarklı benzersiz bir tanımlayıcıdır. report.getPagesalmak için pageName API'sini kullanabilirsiniz.

Örneğin, ReportSection123adlı bir sayfayı silin:

await report.deletePage("ReportSection123");

ReportSection123, pageName sayfası için döndürülen getPages API'sinin

Sayfa örneğini kullanarak sayfa silme

Page örneği kullanarak bir rapordan sayfa silmek için:

delete(): Promise<void>

Mesela:

newPage.delete();

Sayfayı yeniden adlandırma

Rapordaki bir sayfayı yeniden adlandırmak için renamePage sınıfının yöntemini veya bağlama bağlı olarak setDisplayName sınıfının yöntemini kullanabilirsiniz. Dönüş değeri, sayfa yeniden adlandırıldıktan sonra çözülür.

Rapor örneği kullanarak sayfayı yeniden adlandırma

Report örneğini kullanarak rapordaki bir sayfayı yeniden adlandırmak için:

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

pageName, displayNamefarklı benzersiz bir tanımlayıcıdır. report.getPagesalmak için pageName API'sini kullanabilirsiniz.

Örneğin, sayfayı ReportSection123 adıyla Yeni Satışlarolarak yeniden adlandırın:

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

ReportSection123, pageName sayfası için döndürülen getPages API'sinin .

Sayfa örneğini kullanarak sayfayı yeniden adlandırma

Page örneğini kullanarak rapordaki bir sayfayı yeniden adlandırmak için:

setDisplayName(displayName: string): Promise<void>

Örneğin, sayfayı Yeni Satışlarolarak yeniden adlandırın:

newPage.setDisplayName("New Sales");

Dikkat edilmesi gerekenler ve sınırlamalar

Sayfa işlemleri yalnızca rapor yüklendikten sonra çalışır.