Menyiapkan Power BI Embedded
BERLAKU UNTUK: Aplikasi memiliki data Milik pengguna
Jika Anda ingin mulai menggunakan Power BI Embedded untuk berbagi laporan Anda dengan orang lain, gunakan alat penyiapan analitik tersemat Power BI untuk memulai. Artikel ini menunjukkan cara.
Untuk menggunakan analitik yang disematkan Power BI, Anda perlu mendaftarkan aplikasi Microsoft Entra di Azure. Aplikasi Microsoft Entra menetapkan izin untuk sumber daya Power BI REST, dan memungkinkan akses ke REST API Power BI.
Prasyarat
Untuk menyiapkan lingkungan analitik power BI yang disematkan, Anda memerlukan salah satu hal berikut ini:
- Penyewa Microsoft Entra dan pengguna organisasi (master)
- Akun Power BI Pro
Sebelum Anda mulai
Sebelum Anda dapat mendaftarkan aplikasi, putuskan solusi mana yang paling sesuai dengan kebutuhan Anda:
Menyematkan untuk pelanggan Anda
Gunakan solusi embed-for-your-customers, juga dikenal sebagai aplikasi memiliki data, jika Anda membuat aplikasi yang dirancang untuk pelanggan Anda. Pengguna tidak perlu masuk ke Power BI atau memiliki lisensi Power BI untuk menggunakan aplikasi Anda. Aplikasi Anda mengautentikasi terhadap Power BI dengan menggunakan akun pengguna master (lisensi Power BI Pro yang digunakan untuk masuk ke Power BI) atau perwakilan layanan.
Solusi embed-for-your-customers biasanya digunakan oleh vendor perangkat lunak independen (ISV) dan pengembang yang membuat aplikasi untuk pihak ketiga.
Menyematkan untuk organisasi Anda
Gunakan solusi embed-for-your-organization, juga dikenal sebagai pengguna memiliki data, jika Anda membuat aplikasi yang mengharuskan pengguna menggunakan kredensial mereka untuk mengautentikasi terhadap Power BI.
Solusi embed-for-your-organization biasanya digunakan oleh perusahaan dan organisasi besar, dan ditujukan untuk pengguna internal.
Untuk informasi selengkapnya tentang dua solusi tersebut, lihat Apa itu solusi analitik tersemat Power BI?.
Menyiapkan lingkungan Anda
Setelah Anda memahami dua opsi penyematan, Anda bisa menggunakan alat penyiapan untuk membuat lingkungan Power BI Embedded Anda.
Jika Anda lebih suka menyiapkan lingkungan Anda secara manual, lewati langkah-langkah di bagian berikut. Sebagai gantinya, ikuti langkah-langkah dalam Pendaftaran manual, nanti di artikel ini.
Penting
Jika Anda menyematkan untuk GCC, ikuti instruksi di Pendaftaran manual.
Untuk menggunakan alat untuk menyiapkan lingkungan Anda, buka alat penyiapan analitik tersemat Power BI. Pilih opsi penyematan yang Anda inginkan.
Langkah 1 - Masuk ke Power BI
Di bawah Langkah 1 di alat penyiapan, pilih Masuk. Langkah ini memasukkan Anda ke Power BI. Jika Anda diminta untuk memilih akun, masuk dengan pengguna milik penyewa Power BI Anda. Aplikasi Microsoft Entra terdaftar di bawah pengguna ini.
Catatan
Jika Anda sudah masuk, verifikasi bahwa Anda masuk dengan pengguna yang ingin Anda gunakan untuk membuat aplikasi Microsoft Entra. Untuk mengubah pengguna, pilih keluar. Setelah alat dimulai ulang, masuk dengan pengguna yang benar.
Pilih Berikutnya untuk masuk ke langkah berikutnya.
Langkah 2 - Daftarkan aplikasi Anda
Dalam langkah ini, Anda mendaftarkan aplikasi Microsoft Entra di Azure. Aplikasi Microsoft Entra menetapkan izin untuk sumber daya Power BI REST, dan memungkinkan akses ke REST API Power BI. Anda selalu dapat mengubah pengaturan ini di lain waktu.
Untuk mendaftarkan aplikasi Anda untuk pelanggan Anda, isi bidang berikut:
Nama Aplikasi - Beri nama aplikasi Anda.
Akses API - Pilih API Power BI (juga dikenal sebagai cakupan) yang dibutuhkan aplikasi Anda. Anda dapat memilih Pilih semua untuk memilih semua API. Untuk informasi selengkapnya tentang izin akses Power BI, lihat Izin dan persetujuan di titik akhir platform identitas Microsoft.
Pilih Daftarkan.
ID Aplikasi aplikasi Microsoft Entra Anda ditampilkan di kotak Ringkasan. Salin nilai ini untuk digunakan nanti.
Langkah 3 - Membuat ruang kerja (opsional)
Buat ruang kerja di layanan Power BI:
Jika Anda sudah memiliki ruang kerja Power BI, pilih Lewati.
Untuk membuat ruang kerja, masukkan nama untuk ruang kerja Anda, lalu pilih Buat ruang kerja. Nama dan ID ruang kerja Anda muncul di kotak Ringkasan . Salin nilai ini untuk digunakan nanti.
Tip
Agar aplikasi sampel analitik yang disematkan berfungsi seperti yang diharapkan, Anda harus menggunakan alat untuk membuat ruang kerja.
Langkah 4 - Mengimpor konten (opsional)
pilih salah satu dari opsi berikut ini:
Jika Anda memiliki aplikasi Power BI sendiri, Anda dapat memilih Lewati.
Jika Anda ingin membuat contoh aplikasi Power BI dengan menggunakan laporan sampel, pilih Sampel laporan Power BI, lalu pilih Impor.
Jika Anda ingin membuat contoh aplikasi Power BI dengan menggunakan laporan Anda sendiri, pilih Unggah file .pbix, telusuri file Anda, lalu pilih Impor.
Langkah 5 - Berikan izin (Sematkan hanya untuk pelanggan Anda)
Pilih Berikan izin dan dalam dialog, pilih Terima. Langkah ini memungkinkan aplikasi Microsoft Entra Anda mengakses API yang Anda pilih (juga dikenal sebagai cakupan) dengan pengguna yang masuk. Pengguna ini juga dikenal sebagai pengguna master.
Mengunduh aplikasi sampel (opsional)
Jika Anda membuat ruang kerja Power BI dan mengunggah konten ke ruang kerja tersebut dengan menggunakan alat ini, Anda sekarang dapat memilih Unduh aplikasi sampel.
Catatan
Jika melewati tahapan opsional, Anda masih dapat mengunduh sampel aplikasi Power BI. Namun, kode dalam aplikasi yang diunduh tidak memiliki properti yang diisi selama pendaftaran. Misalnya, jika Anda tidak membuat ruang kerja, aplikasi sampel tidak menyertakan ID ruang kerja.
Pastikan Anda menyalin semua informasi dalam kotak Ringkasan . Lingkungan penyematan Power BI Anda siap digunakan.
Pendaftaran manual
Jika Anda tidak menggunakan alat penyiapan analitik tersemat Power BI, gunakan prosedur di bagian ini untuk mendaftarkan aplikasi Microsoft Entra secara manual. Tetapi lakukan langkah-langkah ini hanya jika Anda membuat salah satu solusi berikut:
- Aplikasi embed-for-your-organization
- Aplikasi embed-for-your-customers dengan perwakilan layanan
Untuk informasi selengkapnya tentang cara mendaftarkan aplikasi di ID Microsoft Entra, lihat Mendaftarkan aplikasi dengan platform identitas Microsoft.
Masuk ke portal Azure.
Pilih penyewa Microsoft Entra Anda dengan memilih akun Anda di sudut kanan atas halaman.
Pilih Pendaftaran aplikasi. Jika Anda tidak melihat opsi ini, cari opsi tersebut.
Pilih Pendaftaran aplikasi, lalu pilih Pendaftaran baru.
Isi bidang berikut:
Nama Aplikasi - Beri nama aplikasi Anda.
Jenis akun yang didukung - Pilih siapa yang dapat menggunakan aplikasi.
(Opsional) Dalam kotak URI Pengalihan, tambahkan URL pengalihan.
Pilih Daftarkan. Setelah aplikasi terdaftar, Anda diarahkan ke halaman gambaran umum aplikasi, tempat Anda dapat memperoleh ID Aplikasi.
Konten terkait
Ada pertanyaan lagi? Coba tanyakan pada Komunitas Power BI.