Bagikan melalui


Tutorial: Menyematkan konten Power BI menggunakan sampel yang disematkan untuk aplikasi pelanggan Anda

BERLAKU UNTUK: Aplikasi memiliki data Milik pengguna

Analitik tersemat dan Power BI Embedded (penawaran Azure) memungkinkan Anda menyematkan konten Power BI seperti laporan, dasbor, dan petak peta, ke dalam aplikasi Anda.

Dalam tutorial ini, Anda akan mempelajari cara:

  • Menyiapkan lingkungan tersemat.
  • Mengonfigurasi aplikasi sampel sematan untuk pelanggan Anda (juga dikenal sebagai data yang dimiliki aplikasi).

Untuk menggunakan aplikasi Anda, pengguna Anda tidak perlu masuk ke Power BI atau memiliki lisensi Power BI.

Sebaiknya gunakan metode sematan untuk pelanggan Anda untuk menyematkan konten Power BI Anda, jika Anda adalah vendor perangkat lunak independen (ISV) atau pengembang, yang ingin membuat aplikasi untuk pihak ketiga.

Penting

Jika Anda menyematkan konten untuk cloud nasional/regional, beberapa langkah pertama tutorial ini berbeda. Lihat Menyematkan konten untuk cloud nasional/regional untuk detailnya.

Spesifikasi sampel kode

Tutorial ini mencakup instruksi untuk mengonfigurasi aplikasi sampel sematan untuk pelanggan Anda dalam salah satu kerangka kerja berikut:

  • .NET Framework
  • .NET Core
  • Java
  • Node JS
  • Python

Sampel kode mendukung browser berikut:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Prasyarat

Sebelum memulai tutorial ini, verifikasi bahwa Anda memiliki dependensi Power BI dan kode berikut:

Metode

Untuk membuat aplikasi sampel sematan untuk pelanggan Anda, ikuti langkah-langkah berikut:

  1. Pilih metode autentikasi Anda.

  2. Mendaftarkan aplikasi Microsoft Entra.

  3. Buat ruang kerja Power BI.

  4. Buat dan terbitkan laporan Power BI.

  5. Dapatkan nilai parameter penyematan.

  6. Akses API perwakilan layanan

  7. Aktifkan akses ruang kerja.

  8. Sematkan konten Anda.

Langkah 1 - Pilih metode autentikasi Anda

Solusi tersemat Anda bervariasi tergantung pada metode autentikasi yang Anda pilih. Oleh karena itu, penting untuk memahami perbedaan antara metode autentikasi, dan memutuskan mana yang paling sesuai dengan solusi Anda.

Tabel berikut menjelaskan beberapa perbedaan utama antara perwakilan layanan dan metode autentikasi pengguna master.

Pertimbangan Perwakilan layanan Pengguna utama
Mekanisme Objek perwakilan layanan aplikasi Microsoft Entra Anda memungkinkan ID Microsoft Entra untuk mengautentikasi aplikasi solusi yang disematkan terhadap Power BI. Aplikasi Microsoft Entra Anda menggunakan kredensial (nama pengguna dan kata sandi) pengguna Power BI, untuk mengautentikasi terhadap Power BI.
Keamanan Perwakilan layanan adalah metode otorisasi yang direkomendasikan ID Microsoft Entra. Jika Anda menggunakan perwakilan layanan, Anda dapat mengautentikasi menggunakan rahasia aplikasi atau sertifikat.

Tutorial ini hanya menjelaskan penggunaan perwakilan layanan dengan rahasia aplikasi. Untuk menyematkan menggunakan perwakilan layanan dan sertifikat, lihat artikel perwakilan layanan dengan sertifikat.
Metode autentikasi ini tidak seaman perwakilan layanan. Anda harus waspada dengan info masuk pengguna master (nama pengguna dan kata sandi). Misalnya, jangan mengeksposnya di aplikasi penyematan Anda dan sering ubah kata sandi.
Izin yang didelegasikan ID Microsoft Entra Tidak wajib. Pengguna master atau administrator Anda harus memberikan persetujuan bagi aplikasi Anda untuk mengakses izin REST API Power BI (juga dikenal sebagai cakupan). Misalnya, Report.ReadWrite.All.
Akses layanan Power BI Anda tidak dapat mengakses layanan Power BI dengan perwakilan layanan. Anda dapat mengakses layanan Power BI dengan kredensial pengguna master Anda.
Lisensi Tidak memerlukan lisensi Pro. Anda dapat menggunakan konten dari ruang kerja mana pun tempat Anda menjadi anggota atau admin. Memerlukan lisensi Power BI Pro atau Premium Per Pengguna (PPU).

Langkah 2 - Mendaftarkan aplikasi Microsoft Entra

Mendaftarkan aplikasi Anda dengan MICROSOFT Entra ID memungkinkan Anda untuk:

  • Membuat identitas untuk aplikasi Anda
  • Mengizinkan aplikasi Anda mengakses REST API Power BI
  • Jika Anda menggunakan pengguna master - Menentukan izin REST Power BI aplikasi Anda

Untuk mendaftarkan aplikasi Anda dengan ID Microsoft Entra, ikuti instruksi di Mendaftarkan aplikasi Anda.

Catatan

Sebelum mendaftarkan aplikasi, Anda harus menentukan metode autentikasi mana yang akan digunakan, perwakilan layanan, atau pengguna master.

Langkah 3 - Buat ruang kerja Power BI

Microsoft Fabric menyimpan laporan, dasbor, dan petak peta Anda di ruang kerja. Untuk menyematkan item ini, Anda perlu membuatnya dan mengunggahnya ke ruang kerja.

Tip

Jika Anda sudah memiliki ruang kerja, Anda dapat melewati langkah ini.

Untuk membuat ruang kerja, lakukan hal berikut:

  1. Masuk ke Fabric.

  2. Pilih Ruang Kerja.

  3. Pilih + Ruang kerja baru.

  4. Beri nama ruang kerja dan pilih Simpan.

Langkah 4 - Buat dan terbitkan laporan Power BI

Langkah Anda selanjutnya adalah membuat laporan dan mengunggahnya ke ruang kerja Anda. Anda dapat membuat laporan Anda sendiri menggunakan Power BI Desktop, lalu menerbitkannya ke ruang kerja Anda. Atau, Anda dapat mengunggah laporan sampel ke ruang kerja Anda.

Tip

Jika Anda sudah memiliki ruang kerja dengan laporan, Anda dapat melewati langkah ini.

Untuk mengunduh sampel laporan dan menerbitkannya ke ruang kerja Anda, ikuti langkah-langkah berikut:

  1. Buka folder GitHub sampel Power BI Desktop.

  2. Pilih Kode, lalu pilih Unduh ZIP.

    Cuplikan layar memperlihatkan opsi unduhan ZIP di GitHub sampel desktop Power B I

  3. Ekstrak ZIP yang diunduh dan navigasikan ke folder Laporan Sampel.

  4. Pilih laporan untuk disematkan, dan terbitkan ke ruang kerja Anda.

Langkah 5 - Dapatkan nilai parameter penyematan

Untuk menyematkan konten, Anda perlu mendapatkan nilai parameter tertentu. Tabel berikut menunjukkan nilai yang diperlukan, dan menunjukkan apakah nilai tersebut berlaku untuk metode autentikasi perwakilan layanan, metode autentikasi pengguna master, atau keduanya.

Sebelum menyematkan konten, pastikan Anda memiliki semua nilai yang tercantum di bawah ini. Beberapa nilai mungkin berbeda, tergantung pada metode autentikasi yang Anda gunakan.

Parameter Perwakilan layanan Pengguna utama
ID klien Berlaku untuk. Berlaku untuk.
ID Ruang Kerja Berlaku untuk. Berlaku untuk.
ID Laporan Berlaku untuk. Berlaku untuk.
Rahasia Klien Berlaku untuk. Tidak berlaku untuk.
ID Penyewa Berlaku untuk. hanya diperlukan untuk Node JS
Nama pengguna Power BI Tidak berlaku untuk. Berlaku untuk.
kata sandi Power BI Tidak berlaku untuk. Berlaku untuk.

ID klien

Tip

Berlaku untuk: Berlaku untuk.Pengguna Master perwakilan layanan Berlaku untuk.

Untuk mendapatkan GUID ID klien (juga dikenal sebagai ID aplikasi), ikuti langkah-langkah berikut:

  1. Masuk ke Microsoft Azure.

  2. Cari Pendaftaran aplikasi dan pilih tautan Pendaftaran aplikasi.

  3. Pilih aplikasi Microsoft Entra yang Anda gunakan untuk menyematkan konten Power BI Anda.

  4. Dari bagian Gambaran Umum, salin GUID ID Aplikasi (klien).

ID Ruang Kerja

Tip

Berlaku untuk: Berlaku untuk.Pengguna Master perwakilan layanan Berlaku untuk.

Untuk mendapatkan GUID ID ruang kerja, ikuti langkah-langkah berikut:

  1. Masuk ke layanan Power BI.

  2. Buka laporan yang ingin Anda sematkan.

  3. Salin GUID dari URL. GUID adalah angka antara /groups/ dan /reports/.

    Cuplikan layar memperlihatkan GUID ID ruang kerja di URL layanan Power BI

Atau, Anda dapat menemukan ID ruang kerja di pengaturan Portal admin dengan memilih Detail di samping nama ruang kerja.

Cuplikan layar memperlihatkan cara menemukan ID ruang kerja dari pengaturan admin.

ID Laporan

Tip

Berlaku untuk: Berlaku untuk.Pengguna Master perwakilan layanan Berlaku untuk.

Untuk mendapatkan GUID ID laporan, ikuti langkah-langkah berikut:

  1. Masuk ke layanan Power BI.

  2. Buka laporan yang ingin Anda sematkan.

  3. Salin GUID dari URL. GUID adalah angka antara /reports/ dan /ReportSection.

    Cuplikan layar memperlihatkan GUID ID laporan di U R L layanan Power B I

Rahasia Klien

Tip

Berlaku untuk: Berlaku untuk.Pengguna Master perwakilan layanan Tidak berlaku untuk.

Untuk mendapatkan rahasia klien, ikuti langkah-langkah berikut:

  1. Masuk ke Microsoft Azure.

  2. Cari Pendaftaran aplikasi dan pilih tautan Pendaftaran aplikasi.

  3. Pilih aplikasi Microsoft Entra yang Anda gunakan untuk menyematkan konten Power BI Anda.

  4. Di bagian Kelola, pilih Sertifikat & rahasia.

  5. Di bawah Rahasia klien, pilih Rahasia klien baru.

  6. Di jendela pop-up Tambahkan rahasia klien, berikan deskripsi untuk rahasia aplikasi Anda, pilih kapan rahasia aplikasi akan kedaluwarsa, dan pilih Tambahkan.

  7. Dari bagian Rahasia klien, salin string di kolom Nilai rahasia aplikasi yang baru dibuat. Nilai rahasia klien adalah ID klien Anda.

Catatan

Pastikan Anda menyalin nilai rahasia klien saat pertama kali muncul. Setelah keluar dari halaman ini, rahasia klien akan disembunyikan dan Anda tidak akan dapat mengambil nilainya.

ID Penyewa

Tip

Berlaku untuk: Berlaku untuk.Pengguna Master perwakilan layanan Tidak berlaku untuk.

Untuk mendapatkan GUID ID penyewa, ikuti langkah-langkah berikut:

  1. Masuk ke Microsoft Azure.

  2. Cari Pendaftaran aplikasi dan pilih tautan Pendaftaran aplikasi.

  3. Pilih aplikasi Microsoft Entra yang Anda gunakan untuk menyematkan konten Power BI Anda.

  4. Dari bagian Gambaran Umum, salin GUID ID Direktori (penyewa).

Nama pengguna dan kata sandi Power BI

Tip

Berlaku untuk: Tidak berlaku untuk.Pengguna Master perwakilan layanan Berlaku untuk.

Dapatkan nama pengguna dan kata sandi pengguna Power BI yang Anda gunakan sebagai pengguna master Anda. Ini adalah pengguna yang sama dengan yang Anda gunakan untuk membuat ruang kerja dan tempat Anda mengunggah laporan, di layanan Power BI.

Langkah 6 - Akses API perwakilan layanan

Tip

Berlaku untuk: Berlaku untuk.Pengguna Master perwakilan layanan Tidak berlaku untuk.

Langkah ini hanya relevan jika Anda menggunakan metode autentikasi perwakilan layanan. Jika Anda menggunakan pengguna master, lewati langkah ini dan lanjutkan dengan Langkah 7 - Aktifkan akses ruang kerja.

Agar aplikasi Microsoft Entra dapat mengakses konten dan API Power BI, admin Power BI perlu mengaktifkan akses perwakilan layanan di portal admin Power BI. Jika Anda bukan admin penyewa, dapatkan admin penyewa untuk mengaktifkan Pengaturan penyewa untuk Anda.

  1. Di layanan Power BI, pilih Pengaturan>Pengaturan>Portal admin.

    Cuplikan layar memperlihatkan opsi menu pengaturan admin di menu pengaturan layanan Power B I.

  2. Pilih Pengaturan penyewa lalu gulir ke bawah ke bagian Pengaturan pengembang.

  3. Perluas Perwakilan layanan dapat menggunakan FABRIC API, dan mengaktifkan opsi ini.

    Cuplikan layar memperlihatkan cara mengaktifkan opsi pengaturan pengembang, di opsi menu pengaturan penyewa, di layanan Power B I.

Catatan

Saat menggunakan perwakilan layanan, sebaiknya Anda batasi aksesnya ke pengaturan penyewa menggunakan grup keamanan. Untuk mempelajari selengkapnya tentang fitur ini, lihat bagian ini di artikel perwakilan layanan:

Langkah 7 - Aktifkan akses ruang kerja

Untuk mengaktifkan objek akses aplikasi Microsoft Entra Anda seperti laporan, dasbor, dan model semantik di layanan Power BI, tambahkan perwakilan layanan atau pengguna master, sebagai anggota atau admin ke ruang kerja Anda.

  1. Masuk ke Fabric.

  2. Gulir ke ruang kerja yang ingin Anda aktifkan aksesnya, dan pilih Kelola akses.

    Cuplikan layar memperlihatkan tombol akses ruang kerja di menu lainnya dari ruang kerja Power B I.

  3. Di panel Akses, bergantung pada metode autentikasi mana yang Anda gunakan, salin perwakilan layanan atau pengguna master ke kotak teks Masukkan alamat email.

    Catatan

    Jika Anda menggunakan perwakilan layanan, namanya adalah nama yang Anda berikan pada aplikasi Microsoft Entra Anda.

  4. Pilih Tambahkan.

Langkah 8 - Sematkan konten Anda

Aplikasi sampel Power BI yang disematkan memungkinkan Anda membuat aplikasi Power BI semat untuk pelanggan Anda.

Ikuti langkah-langkah ini untuk mengubah aplikasi sampel sematan untuk pelanggan Anda, untuk menyematkan laporan Power BI Anda.

  1. Buka folder sampel pengembang Power BI.

  2. Pilih Kode, lalu pilih Unduh ZIP.

    Cuplikan layar memperlihatkan opsi unduhan ZIP di GitHub sampel pengembang Power B I

  3. Ekstrak ZIP yang diunduh dan navigasikan ke folder PowerBI-Developer-Samples-master.

  1. Bergantung pada bahasa yang Anda inginkan untuk digunakan aplikasi Anda, buka salah satu folder ini:

    • .NET Core
    • .NET Framework
    • Java
    • Node JS
    • Python

    Catatan

    Aplikasi sampel sematan untuk pelanggan Anda hanya mendukung kerangka kerja yang tercantum di atas. Aplikasi sampel React hanya mendukung solusi sematan untuk organisasi Anda.

  2. Buka folder sematan untuk pelanggan Anda.

  1. Buka aplikasi sampel sematan untuk pelanggan Anda menggunakan salah satu metode berikut:

  2. Buka appsettings.json.

  3. Bergantung pada metode autentikasi Anda, isi nilai parameter berikut:

    Parameter Perwakilan layanan Pengguna utama
    AuthenticationMode ServicePrincipal MasterUser
    ClientId ID klien aplikasi Microsoft Entra Anda ID klien aplikasi Microsoft Entra Anda
    TenantId ID penyewa Microsoft Entra Anda T/A
    PbiUsername T/A Nama pengguna pengguna master Anda, lihat nama pengguna dan kata sandi Power BI
    PbiPassword T/A Kata sandi pengguna master Anda, lihat nama pengguna dan kata sandi Power BI
    ClientSecret Rahasia klien MICROSOFT Entra ID Anda T/A
    WorkspaceId ID ruang kerja dengan laporan tersemat Anda, lihat ID Ruang Kerja ID ruang kerja dengan laporan tersemat Anda, lihat ID Ruang Kerja
    ReportId ID laporan yang Anda sematkan, lihat ID Laporan ID laporan yang Anda sematkan, lihat ID Laporan
  4. Jalankan proyek dengan memilih opsi yang sesuai:

    • Jika Anda menggunakan Visual Studio, pilih IIS Express (putar).

    • Jika Anda menggunakan Visual Studio Code, pilih Jalankan > Mulai Debugging.

Mengembangkan aplikasi Anda

Setelah mengonfigurasi dan menjalankan aplikasi sampel sematan untuk pelanggan, Anda dapat mulai mengembangkan aplikasi Anda sendiri.

Cobalah taman bermain analitik power BI yang disematkan untuk mulai mengembangkan dan mengikuti semua fitur dan pembaruan Power BI Embedded baru.

Saat Anda siap, tinjau persyaratan pindahkan ke produksi. Anda juga memerlukan kapasitas, dan harus meninjau artikel perencanaan kapasitas untuk menetapkan SKU mana yang paling sesuai dengan kebutuhan Anda.

Penting

Jika Anda menggunakan token uji coba tersemat gratis untuk pengembangan, Anda harus membeli kapasitas untuk produksi. Hingga kapasitas dibeli, banner versi uji coba Gratis akan terus muncul di bagian atas laporan yang disematkan.

Ada pertanyaan lagi? Tanyakan kepada Komunitas Power BI.