Aracılığıyla paylaş

Olayları işleme

  • Makale

Bahşiş

Power BI Embedded Analytics Playground'nin Geliştirici korumalı alanı bölümünde kendi raporunuzu veya örnek raporumuzu kullanarak API'lerle gerçek zamanlı olarak denemeler yapın.

Olaylar, Power BI bileşeni (örneğin, bir rapor) ile web uygulaması kodu arasında iletişim kurmak için kullanılır.

Katıştırılmış bileşen, bileşenin içinde bir eylem yürütüldükten sonra olayları yayar. Bunlar, bileşen içindeki kullanıcı etkileşimleri veya otomatik bir eylem (işlenen bir görsel gibi) olabilir.

Örneğin buttonClicked, kullanıcı rapordaki bir düğmeye tıkladığında Power BI raporu tarafından yayılan bir olaydır. report.on(...)kullanarak olayı dinleyebilir ve ardından bir olay işleyicisi ayarlayabilirsiniz.

Bir olayın nasıl işleneceğini gösteren örnek

Bu örnekte rapor olayının nasıl işleneceğini gösterilmektedir. Diğer olay türleri hakkında bilgi edinmek için bkz. Olaylar ve yanıt değerleri.

Not

API'leri kullanmadan önce bileşenin yüklenmesini bekleyin. Yüklenen olayı dinleyin ve ardından yeni komutlar yayımlayın.

report.on('loaded', function(event)
{
    reportPages = await report.getPages();
});

Olay işleyicilerini kaldırma

belirli bir olayın tüm olay işleyicilerini kaldırmak için report.off(...) kullanabilirsiniz.

Olaylar ve bunların yanıt değerleri

Olası olayların ve bunların yanıt değerlerinin tam listesini görüntüleyin.

Hata olayları (tüm eklemeler için geçerlidir)

Başarısız bir işlemi tanımlamak için bir hata olayı yayılır.

interface IError {
    message: string // A general message that describes the operation that failed (example: "Could not set page")
    detailedMessage?: string // Detailed message that describes the error
    errorCode?: string  //  Short message that describes the error
    level?: TraceType // The level of the error (example: 'Fatal')
    technicalDetails?: ITechnicalDetails
}

interface ITechnicalDetails {
    requestId?: string // Id for debugging - should be provided when reporting a bug
}

Not

Yalnızca message özelliği gereklidir ve diğer özellikler tanımlanmamış olabilir.

Rapor olayları

Bir rapor düğmesine tıklama veya görseli işleme gibi eklenmiş bir raporla etkileşim için bir rapor olayı yayılır.

buttonClicked

buttonClicked olayı, kullanıcı bir Rapor düğmesine tıkladığında oluşturulur.

 id: string
 title?: string
 type?: string (type of button)
 bookmark?: string

commandTriggered

olayı, kullanıcıbir uzantısı komutuna tıkladığında oluşturulur.

 command: string
 dataPoints?: IIdentityValue[]
 report: models.IReport
 page: models.IPage
 visual: models.IVisual

dataHyperlinkClicked

köprü tıklatıldığında dataHyperlinkClicked olayı oluşturulur ve köprü davranışıNavigateAndRaiseEvent veya RaiseEventolarak ayarlanır.

 url: string
 report: models.IReport
 page: models.IPage
 visual: models.IVisual

Daha fazla bilgi için bkz. Rapor ayarlarını yapılandırma.

dataSelected

belirli bir veri noktası seçildiğinde dataSelected olayı oluşturulur.

 report: models.IReport
 page: models.IPage
 visual: models.IVisual
 filters: IFilter[]
 dataPoints: IIdentityValue[]

Yüklü

rapor başlatıldığında loaded olayı oluşturulur. Power BI logosu kaybolduğunda yükleme tamamlanır.

pageChanged

sayfa değiştirildiğinde pageChanged olayı oluşturulur.

 newPage: Models.IPage

Işlen -miş

rendered olayı, bir rapor tam olarak işlendiğinde oluşturulur. Örneğin, tüm görseller bir rapor yüklendikten sonra veya kullanıcı etkileşimi sonrasında işleniyorsa.

saveAsTriggered

kullanıcı kullanıcı arabiriminde Farklı Kaydet tıkladığında olayı oluşturulur. Bu, Farklı Kaydet eylemi için kendi iletişim kutunuzu oluşturmanıza olanak tanır.

Kaydedilmiş

saved olayı, kullanıcı arabirimindeki bir save veya saveAs eylemi tarafından ya da API'ler kullanılarak bir kaydetme tetiklendiğinde oluşturulur.

selectionChanged

selectionChanged olayı, kullanıcı seçilen görseli her değiştirdiği zaman tetiklenir. selectedItems, birden fazla seçili durumdaki tüm görsellerin listesidir.

 report: models.IReport
 page: models.IPage
 visual?: models.IVisual
 selectedItems?: models.IVisual[]

visualClicked

visualClicked olayı bir görsele her tıklandığında oluşturulur.

 report: models.IReport
 page: models.IPage
 visual: models.IVisual

visualRendered

olayı bir görsel işlendiğinde oluşturulur (ayarlar nesnesinde doğru için ayarlanması gerekir).

Not

Görseller kullanıcı etkileşimleri nedeniyle işlenebileceği için, bu olayın yalnızca gerektiğinde açılması önerilir.

 name: string

Daha fazla bilgi için bkz. Rapor ayarlarını yapılandırma.

Rapor Ekleme Mobil olayları

Bir mobil düzendeki eklenmiş raporla etkileşim (çekmenin başlangıcı veya sonu gibi) için Rapor Ekleme Mobil olayı gösterilir.

swipeStart ve swipeEnd olayları

swipeStart veya swipeEnd olayları, bir kullanıcı eklenmiş bir raporda çekme hareketini başladığında veya sonlandırdığında tetiklenir.

interface ISwipeEvent {
    currentPosition: IPosition
    startPosition: IPosition
}

interface IPosition {
    x: number
    y: number
}

Pano olayları

Pano yüklendiğinde ve kullanıcı panodaki bir kutucuğa tıkladığında bir pano olayı yayılır.

Yüklü

pano başlatıldığında loaded olayı oluşturulur.

tileClicked

tileClicked olayı, son kullanıcı bir kutucuğa tıkladığında oluşturulur. Sabitlenmiş canlı sayfalar için tetiklenmez.

 tileId: string
 navigationUrl: string
 pageName: string
 reportEmbedUrl: string

Q&A olayları

Soru girildikten sonra bir görsel işlendiğinde soru ve yanıt (Q&A) olayı oluşturulur.

visualRendered (Q&A)

visualRendered olayı, bir soru girildikten ve yanıt görüntülendiğinde bir görsel işlendiğinde oluşturulur.

 question: string
 normalizedQuestion: string

Kutucuk olayları

Kullanıcı bir kutucuğa tıkladığında Kutucuk olayı oluşturulur.

tileClicked (kutucuk olayı)

tileClicked olayı, son kullanıcı bir kutucuğa tıkladığında oluşturulur. Sabitlenmiş canlı sayfalar için tetiklenmez.

 tileId: string
 navigationUrl: string
 pageName: string
 reportEmbedUrl: string

kutucuk Yüklendi

kutucuk başlatıldığında tileLoaded olayı oluşturulur. Power BI logosu kaybolduğunda yükleme tamamlanır.

İlgili içerik