Tambahkan laporan atau papan pemuka Power BI pada halaman web dalam portal
Nota
- Berkuat kuasa pada Oktober 2022, portal Power Apps ialah Power Pages.
- Topik ini digunakan untuk keupayaan legasi. Untuk mendapatkan maklumat terkini, sila pergi ke dokumentasi Microsoft Power Pages.
Petua
Artikel ini menerangkan cara untuk menambah laporan atau papan pemuka Power BI menggunakan tag Liquid powerbi. Untuk menambah komponen Power BI pada halaman web dalam portal anda menggunakan Studio portal, pergi ke Tambah komponen Power BI pada halaman web menggunakan Studio portal.
Anda boleh menambah laporan atau papan pemuka Power BI pada laman web dalam portal dengan menggunakan tag powerbi Liquid. Gunakan tag powerbi dalam medan Salin pada halaman web atau dalam medan Sumber pada templat web.
Jika anda menambah laporan atau papan pemuka Power BI yang dicipta dalam ruang kerja baharu Power BI, anda mesti menetapkan jenis pengesahan sebagai powerbiembedded dalam tag Liquid powerbi.
Nota
- Jika anda telah menentukan Microsoft Entra ID sebagai jenis pengesahan dalam powerbi Liquid tag, anda mesti berkongsinya dengan pengguna yang diperlukan sebelum menambah laporan selamat Power BI atau papan pemuka pada halaman web dalam portal. Maklumat lanjut: Kongsi ruang kerja Power BI dan Kongsi laporan dan papan pemuka Power BI.
- powerbiembedded menyokong papan pemuka dan laporan Power BI yang bersambung kepada Perkhidmatan Analisis Azure. Anda juga boleh menggunakan sifat "customdata" dalam kod liquid untuk lulus nilai bagi sifat CustomData.
- Laporan Power BI bernombor halaman tidak disokong.
Contohnya:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Untuk mengetahui tentang cara untuk mendapatkan laluan papan pemuka, dan ID jubin papan pemuka, rujuk bahagian di belakang artikel ini.
Menggunakan papan pemuka atau laporan yang bersambung ke Perkhidmatan Analisis Azure
Anda boleh menambah tag Liquid powerbi dengan papan pemuka, atau laporan yang menyambung ke Perkhidmatan Analisis Azure.
Untuk menambah papan pemuka atau laporan yang bersambung ke Perkhidmatan Analisis Azure, gunakan parameter CustomData dalam rentetan sambungan.
Contohnya:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/<GroupID>/reports/<ReportID>" roles:"<roles associated with report>" customdata:"<customdata>" %}
Tag pilihan customdata boleh dikonfigurasikan sebagai rentetan atau dijana secara dinamik berdasarkan atribut objek, menggunakan noktah (".") atau kurungan persegi ("[]") untuk memisahkan antara objek dan atribut, antara dua pasangan kurungan kerinting.
Contoh:
customdata: {{ object.attribute }}customdata: {{ object[attribute] }}
Apabila tag customdata mengembalikan rentetan, ia mungkin perlu menukar rentetan ini kepada integer dalam pertanyaan DAX.
Penting
- Portal tidak menyokong papan pemuka atau laporan Power BI bersambung ke Perkhidmatan Analisis Azure yang menggunakan get laluan data untuk bersambung ke sumber data di premis.
- Versi portal anda mesti 9.3.4.x atau kemudian untuk ciri berfungsi.
Perkhidmatan dan Peranan Analisis Azure (RLS)
Tag peranan adalah pilihan untuk laporan dan papan pemuka berasaskan Perkhidmatan Analisis Azure. Apabila tidak digunakan, peranan lalai kepada peranan aplikasi ditugaskan dalam Perkhidmatan Analisis Azure.
Walau bagaimanapun, tag ini mungkin diperlukan untuk menentukan peranan (atau peranan) tertentu antara beberapa peranan yang tersedia dan mungkin masih diperlukan apabila menggunakan keselamatan Peringkat Baris.
Peranan terkandung dalam pangkalan data Perkhidmatan Analisi Azure dan tidak dalam laporan itu sendiri, tidak seperti jenis laporan Power BI lain.
Tidak menyediakan peranan dalam kod Liquid.
Jika tiada peranan dibekalkan dalam kod Liquid, peranan Perkhidmatan Analisis Azure akan ditentukan oleh peranan yang Aplikasi tersebut mempunyai akses kepada, dan akan menapis hasil berdasarkan data tersuai yang diberikan terhadap pertanyaan DAX dalam peranan. Iaitu, semua peranan yang tersedia akan menggabungkan akses mereka, tetapi masih akan menapis jika data tersuai yang disediakan adalah relevan. Senario ini paling kerap berlaku dengan laporan Perkhidmatan Analisis Azure atau papan pemuka jubin tunggal.
Menyediakan peranan dalam kod Liquid.
Peranan Perkhidmatan Analisis Azure boleh disediakan dalam kod Liquid, serupa dengan peranan RLS. Menggunakan peranan ini mungkin diperlukan apabila berbilang peranan tersedia, tetapi anda ingin menggunakan peranan tertentu untuk halaman. Apabila menggunakan sebarang peranan dalam rentetan sambungan, menentukan peranan Perkhidmatan Analisis Azure ialah satu kemestian. Sebagai contoh, papan pemuka berbilang jubin yang menggunakan jubin Perkhidmatan Analisis Azure dengan jubin RLS.
Pertimbangan berikut diguna pakai apabila menggunakan jubin Perkhidmatan Analisis Azure dalam papan pemuka:
- Jika jubin Perkhidmatan Analisis Azure digunakan dalam papan pemuka dengan jubin lain yang memerlukan peranan tersebut, peranan Perkhidmatan Analisis Azure mesti ditambah pada senarai peranan.
- Berbilang jubin daripada sumber Perkhidmatan Analisis Azure yang berbeza boleh digunakan dengan peranannya sendiri, tetapi data tersuai mestilah sama untuk setiap satunya dan berbilang nilai data tersuai tidak boleh digunakan dalam kod Liquid. Tag customdata dan parameter customdata untuk EffectiveIdentity mengambil hanya nilai rentetan.
Dapatkan laluan papan pemuka atau laporan
Daftar masuk ke Power BI.
Buka papan pemuka atau laporan yang anda mahu benamkan dalam portal anda.
Salin URL itu daripada bar alamat.
Dapatkan ID jubin papan pemuka
Daftar masuk ke Power BI.
Buka papan pemuka yang anda mahu benamkan jubin dalam portal anda.
Tunjuk jubin, pilih Lebih banyak pilihan, dan kemudian pilih Buka dalam mod fokus.
Salin ID jubin daripada URL dalam bar alamat. ID jubin adalah nilai selepas /jubin/.
Cara penggunaan perpustakaan JavaScript powerbi-klien dalam portal
Anda boleh menggunakan pustaka JavaScript klien powerbi untuk Power BI Embedded laporan atau papan pemuka dalam portal anda. Untuk maklumat lanjut tentang pustaka powerbi-klien JavaScript, lihat wiki Power BI JavaScript.
Di bawah ialah sampel JavaScript untuk mengemas kini tetapan laporan atau untuk mengendalikan peristiwa. Sampel ini menyahdayakan anak tetingkap penapis, menyahdayakan navigasi halaman dan mendayakan peristiwa dataSelected.
Penting
- Gunakan perpustakaan JavaScript powerbi-klien untuk menyahdayakan atau mendayakan anak tetingkap penapis. Walau bagaimanapun, jika anda mahu mengehadkan akses kepada data atau konfigurasi keselamatan, gunakan Keselamatan peringkat baris (RLS) dengan Power BI. Menyahdayakan anak tetingkap penapis tidak mengehadkan akses data dan ia boleh didayakan semula dengan menggunakan kod perpustakaan JavaScript.
- Pustaka JavaScript klien powerbi hanya disokong untuk aliran Terbenam PowerBI.
$(document).ready(function () {
var embedContainer = $(".powerbi")[0];
if (embedContainer) {
var report = powerbi.get(embedContainer);
report.on("loaded", function () {
report.updateSettings({
panes: {
filters: {
visible: false
},
pageNavigation: {
visible: false
}
}
}).catch(function (errors) {
console.log(errors);
});
})
}
});
Untuk menambah JavaScript tesuai pada halaman web:
- Buka aplikasi Pengurusan Portal.
- Pilih Halaman Web daripada anak tetingkap kiri.
- Pilih halaman web yang mengandungi laporan atau papan pemuka Power BI.
- Pilih tab Lanjutan.
- Salin dan tampal JavaScript dalam bahagian JavaScript Tersuai.
- Pilih Simpan & Tutup.
Sekarang, mari kita fahami tentang operasi JavaScript sampel dan pilihan yang berbeza.
Dapatkan rujukan ke HTML laporan yang ditanam
Dapatkan rujukan ke HTML laporan yang ditanam.
var embedContainer = $(".powerbi")[0];
Maklumat lanjut: Dapatkan rujukan kepada komponen Power BI sedia ada yang diberikan mengandungi elemen
Dapatkan rujukan ke laporan yang dibenam
var report = powerbi.get(embedContainer);
Bekerja dengan anak tetingkap Power BI
Anda boleh menggunakan tetapan untuk anak tetingkap untuk bekerja dengan anak tetingkap Power BI pada halaman web portal. Sebagai contoh, anda boleh menggunakan tetapan penapis untuk menyembunyikan atau menunjukkan anak tetingkap, atau bekerja dengan tetapan navigasi halaman.
Di bawah adalah sampel untuk mengalih keluar anak tetingkap penapis:
report.updateSettings({
panes: {
filters :{
visible: false
}
}
}).catch(function (errors) {
console.log(errors);
});
Di bawah ini adalah sampel untuk bekerja dengan kedua-dua anak tetingkap navigasi dan penapis:
report.updateSettings({
panes: {
filters :{
visible: false
},
pageNavigation:{
visible: false
}
}
}).catch(function (errors) {
console.log(errors);
});
Maklumat lanjut: Kemas kini tetapan dan Konfigurasu dibenam - Tetapan
Kendalikan peristiwa
Komponen yang dibenamkan boleh mengeluarkan peristiwa apabila memohon penyempurnaan perintah yang dilaksanakan. Contohnya, di bawah ialah sampel untuk peristiwa dataSelected.
//Report.off removes a given event listener if it exists
report.off("dataSelected");
//Report.on will add an event list
report.on('dataSelected', function(event){
console.log('Event - dataSelected:');
console.log(event.detail);
})
Maklumat lanjut: Mengendalikan peristiwa
Lihat juga
- Tambah komponen Power BI kepada halaman web menggunakan Studio portal
- Sediakan integrasi Power BI
- tag Liquid powerbi
Nota
Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)
Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).