Bagikan melalui

Cara menangani peristiwa

  • Artikel

Ujung

Bereksperimen dengan API secara real time menggunakan laporan Anda sendiri atau laporan sampel kami di bagian kotak pasir Pengembang Power BI Embedded Analytics Playground.

Peristiwa digunakan untuk berkomunikasi antara komponen Power BI (misalnya, laporan) dan kode aplikasi web.

Komponen yang disematkan memancarkan peristiwa setelah tindakan dijalankan di dalam komponen. Ini dapat berupa interaksi pengguna atau tindakan otomatis (seperti visual yang dirender) dalam komponen.

Misalnya, buttonClicked adalah peristiwa yang dipancarkan oleh laporan Power BI saat pengguna mengklik tombol dalam laporan. Anda dapat mendengarkan acara dengan menggunakan report.on(...), lalu mengatur penanganan aktivitas.

Contoh cara menangani peristiwa

Contoh ini menunjukkan cara menangani peristiwa laporan. Untuk mempelajari tentang jenis peristiwa lainnya, lihat peristiwa dan nilai responsnya.

Nota

Tunggu hingga komponen dimuat sebelum menggunakan API. Dengarkan peristiwa yang dimuat lalu terbitkan perintah baru.

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

Cara menghapus penanganan aktivitas

Anda dapat menggunakan report.off(...) untuk menghapus semua penanganan aktivitas untuk peristiwa tertentu.

Peristiwa dan nilai responsnya

Lihat daftar lengkap kemungkinan peristiwa dan nilai responsnya.

Peristiwa kesalahan (relevan untuk semua sematan)

Peristiwa kesalahan dipancarkan untuk menjelaskan operasi yang gagal.

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
}

Nota

Hanya properti message yang diperlukan, dan properti lainnya mungkin tidak terdefinisi.

Melaporkan peristiwa

Peristiwa laporan dipancarkan untuk interaksi dengan laporan yang disematkan, seperti mengklik tombol laporan atau menyajikan visual.

buttonClicked

Peristiwa dimunculkan saat pengguna mengklik tombol Laporan .

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

commandTriggered

Peristiwa commandTriggered dinaikkan saat pengguna mengklik perintah ekstensi .

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

dataHyperlinkClicked

Peristiwa dinaikkan saat hyperlink diklik, dan perilaku hyperlink diatur ke atau .

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

Untuk informasi selengkapnya, lihat Mengonfigurasi pengaturan laporan.

data Dipilih

Peristiwa dataSelected dinaikkan saat titik data tertentu dipilih.

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

Dimuat

Peristiwa loaded dimunculkan saat laporan diinisialisasi. Pemuatan selesai saat logo Power BI menghilang.

pageChanged

Peristiwa pageChanged dinaikkan setiap kali halaman diubah.

 newPage: Models.IPage

Diberikan

Peristiwa rendered dimunculkan saat laporan sepenuhnya dirender. Misalnya, jika semua visual dirender saat memuat laporan atau setelah interaksi pengguna.

saveAsTriggered

Peristiwa saveAsTriggered dinaikkan saat pengguna mengklik Simpan Sebagai di UI. Ini memungkinkan Anda membuat dialog Anda sendiri untuk tindakan Simpan Sebagai.

Disimpan

Peristiwa saved dinaikkan saat penyimpanan dipicu oleh tindakan save atau saveAs di UI atau dengan menggunakan API.

selectionChanged

Peristiwa selectionChanged dinaikkan setiap kali pengguna mengubah visual yang dipilih. selectedItems adalah daftar semua visual yang dipilih ketika lebih dari satu dipilih.

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

visualClicked

Peristiwa visualClicked dinaikkan setiap kali visual diklik.

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

visualRendered

Peristiwa visualRendered dinaikkan saat visual dirender (memerlukan pengaturan visualRenderedEvents untuk benar di objek pengaturan).

Nota

Karena visual mungkin dirender karena interaksi pengguna, disarankan agar peristiwa ini hanya diaktifkan saat diperlukan.

 name: string

Untuk informasi selengkapnya, lihat Mengonfigurasi pengaturan laporan.

Laporkan peristiwa Embed Mobile

Peristiwa Laporkan Sematkan Seluler dipancarkan untuk interaksi dengan laporan yang disematkan dalam tata letak seluler, seperti awal atau akhir gesek.

swipeStart dan swipeEnd peristiwa

swipeStart atau swipeEnd peristiwa dimunculkan saat pengguna memulai atau mengakhiri gerakan geser pada laporan yang disematkan.

interface ISwipeEvent {
    currentPosition: IPosition
    startPosition: IPosition
}

interface IPosition {
    x: number
    y: number
}

Peristiwa dasbor

Peristiwa dasbor dipancarkan saat dasbor dimuat dan saat pengguna mengklik petak di dasbor.

Dimuat

Peristiwa loaded dinaikkan saat dasbor diinisialisasi.

tileClicked

Peristiwa tileClicked dimunculkan saat pengguna akhir mengklik petak peta. Ini tidak dinaikkan untuk halaman langsung yang disematkan.

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

Peristiwa T&A

Peristiwa tanya jawab (Q&A) dimunculkan saat visual dirender setelah memasukkan pertanyaan.

visualRendered (Q&A)

Peristiwa visualRendered dimunculkan saat visual dirender setelah pertanyaan dimasukkan dan jawaban ditampilkan.

 question: string
 normalizedQuestion: string

Peristiwa petak peta

Peristiwa Petak peta dinaikkan saat pengguna mengklik petak peta.

tileClicked (peristiwa petak peta)

Peristiwa tileClicked dimunculkan saat pengguna akhir mengklik petak peta. Ini tidak dinaikkan untuk halaman langsung yang disematkan.

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

tileLoaded

Peristiwa tileLoaded dimunculkan saat petak peta diinisialisasi. Pemuatan selesai saat logo Power BI menghilang.

Konten terkait