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:

      • Power BI Pro

      • Premium Per Pengguna (PPU)

    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

  • .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 aplikasi sampel penyematan untuk 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

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:

1. Masuk ke Power BI.

2. Pilih Ruang Kerja.

3. Pilih Buat Ruang Kerja.

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

1. Buka folder GitHub sampel 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.

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:

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

Tip

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 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:

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

Tip

Berlaku untuk: .NET Core .NET Framework ReactTypeScript

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.

   

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.

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

   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.

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

6. Simpan perubahan.

Mengonfigurasi sampel aplikasi penyematan

1. Buka folder Penyematan untuk organisasi Anda.

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

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. Masuk ke aplikasi sampel 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, tambahkan https://localhost:44300/ di bagian URI Pengalihan.

      Catatan

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

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

6. Simpan perubahan.

Mengonfigurasi sampel aplikasi penyematan

1. Buka folder Penyematan 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. Masuk ke aplikasi sampel 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 Konfigurasikan.

      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.

Mengonfigurasi sampel aplikasi 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 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

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

Sematan laporan bernomor halaman

Tanyakan kepada Komunitas Power BI