Tutorial: Menyematkan konten Power BI menggunakan contoh aplikasi 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:

• Siapkan lingkungan embedded Anda.
• Mengonfigurasi penyematan untuk organisasi Anda (juga dikenal sebagai data milik pengguna) pada aplikasi contoh.

Untuk menggunakan aplikasi Anda, pengguna Anda harus masuk ke Power BI.

Penyematan untuk solusi organisasi Anda biasanya digunakan oleh perusahaan besar dan organisasi besar, dan ditujukan untuk pengguna internal.

Penting

Jika Anda menyematkan konten untuk cloud nasional/regional, beberapa langkah pertama tutorial ini berbeda. Lihat Penyematan konten untuk awan nasional/regional untuk informasi lebih lanjut.

Spesifikasi sampel kode

Tutorial ini mencakup instruksi untuk mengonfigurasi aplikasi sampel yang tersematkan 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, petak peta, atau laporan 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:

• Ketergantungan Power BI

  • Penyewa Microsoft Entra Anda sendiri.

  • Salah satu lisensi berikut:

    • Microsoft Fabric

    • Power BI Pro

    • Premium Per Pengguna (PPU)

    Catatan

    Untuk memindahkan aplikasi yang disematkan ke produksi, Anda memerlukan salah satu konfigurasi berikut:

    • Semua pengguna dengan lisensi Pro.
    • Semua pengguna dengan lisensi PPU.
    • SKU yang setara dengan atau lebih tinggi dari SKU F64. Konfigurasi ini memungkinkan semua pengguna untuk memiliki lisensi gratis.

• Dependensi kode

  .NET Core

  • .NET Core 3.1 SDK (atau lebih tinggi)

  • Lingkungan pengembangan terintegrasi (IDE). Sebaiknya gunakan salah satu IDEs berikut:

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Editor teks.

  • Terminal baris perintah (atau PowerShell)

---

Metode

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

1. Mendaftarkan aplikasi Microsoft Entra.
2. Buat ruang kerja Power BI.
3. Buat dan terbitkan laporan Power BI.
4. Dapatkan nilai parameter penyematan.
5. Sematkan konten Anda.

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

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

Petunjuk / Saran

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 Anda dan pilih Terapkan.

Langkah 3 - Buat dan terbitkan laporan Power BI

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

Petunjuk / Saran

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

Untuk mengunduh laporan sampel (bukan dengan Direct Lake diaktifkan) dan menerbitkannya ke ruang kerja Anda, ikuti langkah-langkah berikut:

1. Buka folder GitHub contoh Power BI Desktop.

2. Pilih Kode lalu pilih Unduh ZIP.

   

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

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

Pengaturan	.NET Core	.NET Framework	React TypeScript
ID klien
Rahasia Klien
ID Ruang Kerja
ID Laporan

ID klien

Petunjuk / Saran

Berlaku untuk:.NET Core .NET Framework React TypeScript

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

Rahasia Klien

Petunjuk / Saran

Berlaku untuk:.NET Core .NET Framework React TypeScript

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 berpindah dari halaman ini, rahasia klien akan disembunyikan dan Anda tidak akan dapat memperoleh nilainya.

ID Ruang Kerja

Petunjuk / Saran

Berlaku untuk:.NET Core .NET Framework React TypeScript

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

   

ID Laporan

Petunjuk / Saran

Berlaku untuk:.NET Core .NET Framework React TypeScript

Untuk mendapatkan ID laporan GUID, 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.

   

Langkah 5 - Sematkan konten Anda

Aplikasi contoh Power BI yang disematkan memungkinkan Anda membuat aplikasi Power BI yang dapat disematkan untuk organisasi Anda.

Ikuti langkah-langkah ini untuk mengubah penyematan aplikasi sampel untuk organisasi Anda, guna menyematkan laporan Power BI Anda.

1. Buka folder sampel pengembang Power BI.

2. Pilih Kode lalu pilih Unduh ZIP.

   

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

4. Buka salah satu folder berikut tergantung pada bahasa yang Anda inginkan untuk digunakan aplikasi Anda:

   • .NET Core
   • .NET Framework
   • React-TS

   Catatan

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

.NET Core

Mengonfigurasi aplikasi Microsoft Entra Anda

1. Masuk ke Portal Microsoft Azure.
2. Pilih Pendaftaran aplikasi. Jika Anda tidak dapat melihat opsi ini, cari opsi tersebut.
3. Buka aplikasi Microsoft Entra yang Anda buat di Langkah 1 - Daftarkan aplikasi Microsoft Entra.
4. Dari menu Kelola, pilih Autentikasi.

5. 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. Kemudian, di jendela Konfigurasikan platform , pilih Web.

6. Simpan perubahan Anda.

Konfigurasikan aplikasi contoh penyematan

1. Buka folder Sematkan untuk organisasi Anda.

2. Buka aplikasi contoh embed 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.

3. Buka appsettings.json dan isi nilai parameter berikut:

   • ClientId - Gunakan GUID ID klien

   • ClientSecret- Gunakan rahasia klien

Menjalankan contoh aplikasi

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

2. Login ke aplikasi contoh penyematan.

   Catatan

   Selama masuk pertama kali, Anda akan diminta untuk mengizinkan izin Microsoft Entra untuk aplikasi.

3. Saat aplikasi sampel penyematan dimuat, pilih konten Power BI yang ingin Anda sematkan lalu pilih Sematkan.

   

.NET Framework

Mengonfigurasi aplikasi Microsoft Entra Anda

1. Masuk ke Portal Microsoft Azure.
2. Pilih Pendaftaran aplikasi. Jika Anda tidak dapat melihat opsi ini, cari opsi tersebut.
3. Buka aplikasi Microsoft Entra yang Anda buat di Langkah 1 - Daftarkan aplikasi Microsoft Entra.
4. Dari menu Kelola, pilih Autentikasi.

5. Di Konfigurasi platform, konfigurasikan opsi berikut:

   1. Di platform Web Anda, di bagian Redirect URIs, tambahkan https://localhost:44300/.

      Catatan

      Jika Anda tidak memiliki platform Web , pilih Tambahkan platform. Kemudian, di jendela Konfigurasi platform , pilih Web.

   2. Di Izin implisit dan alur hibrid, aktifkan opsi token ID.

6. Simpan perubahan Anda.

Mengonfigurasi aplikasi contoh penyematan

1. Buka folder Sematkan untuk organisasi Anda.

2. Jika Anda menggunakan Visual Studio, buka file AppOwnsData.sln.

3. Buka Web.config dan isi nilai parameter berikut:

   • clientId - Gunakan GUID ID klien.

   • clientSecret - Gunakan rahasia klien.

Menjalankan contoh aplikasi

1. Jalankan proyek dengan memilih IIS Express (putar).

2. Login ke aplikasi contoh penyematan.

   Catatan

   Selama masuk pertama kali, Anda akan diminta untuk mengizinkan izin Microsoft Entra untuk aplikasi.

3. Saat aplikasi sampel penyematan dimuat, pilih konten Power BI yang ingin Anda sematkan lalu pilih Sematkan.

   

React TypeScript

Mengonfigurasi aplikasi Microsoft Entra Anda

1. Masuk ke Portal Microsoft Azure.
2. Pilih Pendaftaran aplikasi. Jika Anda tidak dapat melihat opsi ini, cari opsi tersebut.
3. Buka aplikasi Microsoft Entra yang Anda buat di Langkah 1 - Daftarkan aplikasi Microsoft Entra.
4. Dari menu Kelola, pilih Autentikasi.

5. Dalam Konfigurasi platform, konfigurasikan platform Web Anda sebagai berikut:

   1. Di URI Pengalihan, tambahkan https://localhost:3000 dan pilih Konfigurasi.

      Catatan

      Jika Anda tidak memiliki platform Web , pilih Tambahkan platform, dan di jendela Konfigurasikan platform , pilih Web.

   2. Di bawah Izin implisit dan alur hibrid, aktifkan keduanya:

      • Token akses
      • Token ID

6. Simpan perubahan Anda.

Konfigurasikan aplikasi contoh penyematan

1. Buka folder Penyematan untuk organisasi Anda>UserOwnsData>src.

2. Menggunakan editor teks, buka file Config.ts dan isi nilai parameter berikut:

   • clientId - Gunakan GUID ID klien.

   • workspaceId - Gunakan ID ruang kerja.

   • reportId - Gunakan ID laporan.

3. Simpan file.

Menjalankan contoh aplikasi

1. Buka terminal dan navigasi ke Sematkan untuk organisasi Anda>UserOwnsData.

2. Instal dependensi yang diperlukan dengan memasukkan perintah berikut:

   npm install

3. Jalankan aplikasi dengan memasukkan perintah berikut:

   npm run start

   Catatan

   Selama masuk pertama kali, Anda akan diminta untuk mengizinkan izin Microsoft Entra untuk aplikasi.

Mengembangkan aplikasi Anda

Setelah mengonfigurasi dan menjalankan aplikasi contoh untuk pelanggan Anda, 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 Refresh Izin Pengguna saat memulai. Panggilan API ini me-refresh izin dan menghindari kegagalan otorisasi untuk pengguna dengan izin yang baru diberikan.

Konten terkait

• Tutorial: Menyematkan konten Power BI menggunakan sampel yang disematkan untuk aplikasi pelanggan Anda
• Tanamkan laporan berhalaman
• Pertanyaan lebih lanjut? Coba tanyakan kepada Komunitas Power BI