Tutorial: Menyematkan konten Power BI menggunakan aplikasi sampel penyematan untuk organisasi Anda
Analitik power BI yang disematkan 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 penyematan untuk organisasi Anda (juga dikenal sebagai data milik pengguna).
Untuk menggunakan aplikasi Anda, pengguna Anda harus masuk ke Power BI.
Semat untuk solusi organisasi Anda biasanya digunakan oleh perusahaan dan organisasi besar, dan ditujukan untuk pengguna internal.
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 penyematan untuk organisasi Anda dalam salah satu kerangka kerja berikut:
- .NET Framework
- .NET Core
- React TypeScript
Catatan
Sampel .NET Core dan .NET Framework memungkinkan pengguna akhir menampilkan dasbor, laporan, atau petak peta Power BI apa pun yang dapat mereka akses di layanan Power BI. Sampel React TypeScript memungkinkan Anda menyematkan hanya satu laporan yang sudah diakses pengguna akhir Anda di layanan Power BI.
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:
Dependensi Power BI
Penyewa Microsoft Entra Anda sendiri.
Salah satu lisensi berikut:
Catatan
Untuk pindah ke produksi Anda memerlukan salah satu konfigurasi berikut:
- Semua pengguna dengan lisensi Pro.
- Semua pengguna dengan lisensi PPU.
- SKU yang setara atau lebih tinggi dengan SKU F64. Konfigurasi ini memungkinkan semua pengguna untuk memiliki lisensi gratis.
Dependensi kode
.NET Core 3.1 SDK (atau lebih tinggi)
Lingkungan pengembangan terintegrasi (IDE). Sebaiknya gunakan salah satu IDEs berikut:
Metode
Untuk membuat aplikasi sampel penyematan untuk organisasi Anda, ikuti langkah-langkah berikut:
Mendaftarkan aplikasi Microsoft Entra.
Langkah 1 - Mendaftarkan aplikasi Microsoft Entra
Mendaftarkan aplikasi Anda dengan MICROSOFT Entra ID memungkinkan Anda membuat identitas untuk aplikasi Anda.
Untuk mendaftarkan aplikasi Anda dengan ID Microsoft Entra, ikuti instruksi di Mendaftarkan aplikasi Anda.
Langkah 2 - Buat ruang kerja Power BI
Power BI menyimpan laporan, dasbor, dan petak peta Anda di ruang kerja. Untuk menyematkan item ini, Anda harus 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:
Masuk ke Power BI.
Pilih Ruang Kerja.
Pilih Buat Ruang Kerja.
Beri nama ruang kerja dan pilih Simpan.
Langkah 3 - 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:
Buka folder GitHub sampel Power BI Desktop.
Pilih Kode, lalu pilih Unduh ZIP.
Ekstrak ZIP yang diunduh dan navigasikan ke folder Laporan Sampel.
Pilih laporan untuk disematkan, dan terbitkan ke ruang kerja Anda.
Langkah 4 - Dapatkan nilai parameter penyematan
Untuk menyematkan konten, Anda harus mendapatkan beberapa nilai parameter. Nilai parameter bergantung pada bahasa aplikasi sampel yang ingin Anda gunakan. Tabel di bawah ini mencantumkan nilai parameter mana yang diperlukan untuk setiap sampel.
Parameter | .NET Core | .NET Framework | React TypeScript |
---|---|---|---|
ID klien | |||
Rahasia Klien | |||
ID Ruang Kerja | |||
ID Laporan |
ID klien
Tip
Berlaku untuk: .NET Core .NET Framework React TypeScript
Untuk mendapatkan GUID ID klien (juga dikenal sebagai ID aplikasi), ikuti langkah-langkah berikut:
Masuk ke Microsoft Azure.
Cari Pendaftaran aplikasi dan pilih tautan Pendaftaran aplikasi.
Pilih aplikasi Microsoft Entra yang Anda gunakan untuk menyematkan konten Power BI Anda.
Dari bagian Gambaran Umum, salin GUID ID Aplikasi (klien).
Rahasia Klien
Tip
Berlaku untuk: .NET Core .NET Framework React TypeScript
Untuk mendapatkan rahasia klien, ikuti langkah-langkah berikut:
Masuk ke Microsoft Azure.
Cari Pendaftaran aplikasi dan pilih tautan Pendaftaran aplikasi.
Pilih aplikasi Microsoft Entra yang Anda gunakan untuk menyematkan konten Power BI Anda.
Di bagian Kelola, pilih Sertifikat & rahasia.
Di bawah Rahasia klien, pilih Rahasia klien baru.
Di jendela pop-up Tambahkan rahasia klien, berikan deskripsi untuk rahasia aplikasi Anda, pilih kapan rahasia aplikasi akan kedaluwarsa, dan pilih Tambahkan.
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 Ruang Kerja
Tip
Berlaku untuk: .NET Core .NET Framework React TypeScript
Untuk mendapatkan GUID ID ruang kerja, ikuti langkah-langkah berikut:
Masuk ke layanan Power BI.
Buka laporan yang ingin Anda sematkan.
Salin GUID dari URL. GUID adalah angka antara /groups/ dan /reports/.
ID Laporan
Tip
Berlaku untuk: .NET Core .NET Framework ReactTypeScript
Untuk mendapatkan GUID ID laporan, ikuti langkah-langkah berikut:
Masuk ke layanan Power BI.
Buka laporan yang ingin Anda sematkan.
Salin GUID dari URL. GUID adalah angka antara /reports/ dan /ReportSection.
Langkah 5 - Sematkan konten Anda
Aplikasi sampel Power BI yang disematkan memungkinkan Anda membuat aplikasi Power BI penyematan untuk organisasi Anda.
Ikuti langkah-langkah ini untuk mengubah aplikasi sampel penyematan untuk organisasi Anda, untuk menyematkan laporan Power BI Anda.
Buka folder sampel pengembang Power BI.
Pilih Kode, lalu pilih Unduh ZIP.
Ekstrak ZIP yang diunduh dan navigasikan ke folder PowerBI-Developer-Samples-master.
Buka salah satu folder berikut tergantung pada bahasa yang Anda inginkan untuk digunakan aplikasi Anda:
- .NET Core
- .NET Framework
- React-TS
Catatan
Semat untuk aplikasi sampel organisasi Anda hanya mendukung kerangka kerja yang tercantum sebelumnya. Aplikasi sampel Java, Node JS, dan Python, hanya mendukung solusi penyematan untuk pelanggan Anda.
Mengonfigurasi aplikasi Microsoft Entra Anda
Masuk ke Portal Microsoft Azure.
Pilih Pendaftaran aplikasi. Jika Anda tidak dapat melihat opsi ini, cari opsi tersebut.
Buka aplikasi Microsoft Entra yang Anda buat di Langkah 1 - Daftarkan aplikasi Microsoft Entra.
Dari menu Kelola, pilih Autentikasi.
Di Konfigurasi platform, buka platform Web Anda dan di bagian URI Pengalihan, tambahkan
https://localhost:5000/signin-oidc
.Catatan
Jika Anda tidak memiliki platform Web , pilih Tambahkan platform dan di jendela Konfigurasikan platform , pilih Web.
Simpan perubahan.
Mengonfigurasi sampel aplikasi penyematan
Buka folder Penyematan untuk organisasi Anda.
Buka aplikasi sampel penyematan untuk organisasi Anda menggunakan salah satu metode berikut:
Jika Anda menggunakan Visual Studio, buka file AppOwnsData.sln.
Jika Anda menggunakan Visual Studio Code, buka folder AppOwnsData.
Buka appsettings.json dan isi nilai parameter berikut:
ClientId
- Gunakan GUID ID klienClientSecret
- Gunakan rahasia klien
Menjalankan contoh aplikasi
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.
Masuk ke aplikasi sampel penyematan.
Catatan
Selama masuk pertama kali, Anda akan diminta untuk mengizinkan izin Microsoft Entra untuk aplikasi.
Saat aplikasi sampel penyematan dimuat, pilih konten Power BI yang ingin Anda sematkan lalu pilih Sematkan.
Mengembangkan aplikasi Anda
Setelah mengonfigurasi dan menjalankan aplikasi sampel sematan untuk pelanggan, Anda dapat mulai mengembangkan aplikasi Anda sendiri.
Memperbarui izin pengguna
Pengguna memerlukan izin untuk mengakses folder Power BI tempat laporan berada. Saat Anda memberikan izin pengguna untuk mengakses folder, perubahan biasanya hanya berlaku setelah pengguna masuk ke Portal Power BI. Agar izin baru segera berlaku, dalam skenario Tersemat, lakukan panggilan eksplisit ke REST API Izin RefreshUser saat startup. Panggilan API ini akan merefresh izin dan menghindari kegagalan otorisasi bagi pengguna dengan izin yang baru diberikan.
Konten terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk