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

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

  1. Daftar masuk ke Power BI.

  2. Buka papan pemuka atau laporan yang anda mahu benamkan dalam portal anda.

  3. Salin URL itu daripada bar alamat.

    Dapatkan laluan papan pemuka Power BI.

Dapatkan ID jubin papan pemuka

  1. Daftar masuk ke Power BI.

  2. Buka papan pemuka yang anda mahu benamkan jubin dalam portal anda.

  3. Tunjuk jubin, pilih Lebih banyak pilihan, dan kemudian pilih Buka dalam mod fokus.

    Buka jubin papan pemuka Power BI dalam mod fokus.

  4. Salin ID jubin daripada URL dalam bar alamat. ID jubin adalah nilai selepas /jubin/.

    ID jubin papan pemuka Power BI.

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:

  1. Buka aplikasi Pengurusan Portal.
  2. Pilih Halaman Web daripada anak tetingkap kiri.
  3. Pilih halaman web yang mengandungi laporan atau papan pemuka Power BI.
  4. Pilih tab Lanjutan.
  5. Salin dan tampal JavaScript dalam bahagian JavaScript Tersuai.
  6. 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

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).