Sayfa gezintisi

Bir uygulamaya Power BI raporu yüklediğinizde, rapor sayfaları arasında gezinmek için Power BI İstemci API'lerini kullanabilirsiniz. Örneğin, varsayılan sayfayı ayarlayabilir veya bir sayfayı dinamik olarak değiştirebilirsiniz. Bunu yaptığınızda markanızla eşleşecek şekilde kendi özel sayfa gezintinizi oluşturabilirsiniz. Ayrıca, belirli görselleri ve bilgileri kullanıcıya göstermek için sayfaları belirli ölçütlere göre otomatik olarak değiştirebilirsiniz.

Rapordaki her sayfa bir Page nesnesiyle temsil edilir. Rapordaki tüm sayfaları döndürmek için raporun getPages yöntemini çağırın ve bu yöntem sayfaları Page nesneleri koleksiyonu olarak döndürür. Sayfa koleksiyonu rapordakiyle aynı sırada döndürülür.

Rapor sınıfı, getPages yöntemini aşağıdaki gibi tanımlar:

getPages(): Promise<Page[]>

Mesela:

let pages = await report.getPages();

Rapor sayfaları arasında gezinme

Aşağıdaki bölümlerdeki kod örneklerinde gösterildiği gibi rapor sayfaları arasında gezinmek için Sayfa ve Rapor nesnelerini kullanın.

Etkin sayfayı ayarlama

Var olan bir sayfayı raporun etkin sayfası yapmak için setPage nesnesinin Report yöntemini kullanın.

Rapor sınıfı, setPage yöntemini aşağıdaki gibi tanımlar:

setPage(pageName: string): Promise<void>

Mesela:

await report.setPage("page2");

Geçerli sayfayı etkin yapma

Sayfanın belirli bir rapor için her zaman geçerli olduğundan emin olmak için setActive nesnesinin Page yöntemini kullanın. Page nesneleri almak için, getPages nesnede Report çağır.

Page sınıfı, setActive yöntemini aşağıdaki gibi tanımlar:

setActive(): Promise<void>

Mesela:

await page.setActive();

Olay işleyicisi ekleme

Bir raporda kullanıcının sayfa gezintisini izlerken, bir kullanıcının sayfaları ne zaman değiştirdiğinize dikkat etmeniz gerekir. Bunu yapmak için pageChanged olayı için bir olay işleyicisi ekleyin. Mesela:

report.on('pageChanged', event => {
    const page = event.detail.newPage;
    console.log(page.name);
});

Olaylar hakkında daha fazla bilgi için olayları işleme bölümüne bakın.

İlgili içerik

  • Last updated on