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

BERLAKU UNTUK: Aplikasi memiliki data Milik pengguna

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

Dalam tutorial ini, Anda akan mempelajari cara:

• Siapkan lingkungan embedded Anda.
• Mengonfigurasi penanaman aplikasi untuk pelanggan Anda (juga dikenal sebagai aplikasi memiliki data).

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 Penyematan konten untuk awan nasional/regional untuk informasi lebih lanjut.

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
• Phyton

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.

  • Untuk mengautentikasi aplikasi Anda terhadap Power BI, Anda memerlukan salah satu hal berikut ini:

    • Prinsipal layanan - objek prinsipal layanan Microsoft Entra yang memungkinkan ID Microsoft Entra mengautentikasi aplikasi Anda.

    • Lisensi Power BI Pro - Ini adalah pengguna utama Anda dan aplikasi Anda menggunakannya untuk mengautentikasi ke Power BI.

    • Lisensi Power BI Premium Per Pengguna (PPU) - Ini adalah pengguna master Anda dan aplikasi Anda menggunakannya untuk mengautentikasi ke Power BI.

    Catatan

    Untuk pindah ke produksi, Anda memerlukan kapasitas.

• Dependensi kode

.NET Core

• .NET Core 3.1 SDK (atau lebih tinggi)

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

  • Visual Studio

  • Visual Studio Code

.NET Framework

• .NET Framework 4.8

• Visual Studio

Jawa

• JDK (atau JRE)

• Eclipse IDE - Pastikan Anda memiliki Eclipse untuk Pengembang Java EE (edisi enterprise)

• Distribusi Biner Apache Tomcat

Node JS

• Node.js

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

  • Visual Studio

  • Visual Studio Code

Python

• Python 3 (atau lebih tinggi)

  Catatan

  • Jika Anda menginstal Python untuk pertama kalinya, pilih opsi Tambahkan Python ke PATH, untuk menambahkan penginstalan ke PATH variabel.
  • Jika Anda sudah menginstal Python, pastikan variabel menyertakan PATH jalur penginstalannya. Untuk informasi selengkapnya, lihat dokumentasi Python Excursus: Mengatur variabel lingkungan (tautan ini mengacu pada Python 3).

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

  • Visual Studio

  • Visual Studio Code

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 metode autentikasi service principal dan pengguna utama.

Pertimbangan	Prinsipal Layanan	Pengguna utama
Mekanisme	Objek prinsipal layanan Microsoft Entra Anda memungkinkan ID Microsoft Entra untuk mengautentikasi aplikasi solusi yang disematkan di Power BI.	Aplikasi Microsoft Entra Anda menggunakan kredensial (nama pengguna dan kata sandi) pengguna Power BI, untuk mengautentikasi terhadap Power BI.
Keamanan	Prinsipal layanan adalah metode otorisasi yang direkomendasikan oleh Microsoft Entra ID. 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 kredensial pengguna master (nama pengguna dan kata sandi). Misalnya, jangan mengeksposnya dalam aplikasi yang mengintegrasikan Anda dan sering-seringlah mengubah 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 service principal.	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.

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

Catatan

Jika laporan Anda menggunakan model semantik Direct Lake, pastikan tinjau batasan ini.

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.

Pengaturan	Prinsipal Layanan	Pengguna utama
ID klien
ID Ruang Kerja
ID Laporan
Rahasia Klien
ID Penyewa		hanya diperlukan untuk Node JS
Nama pengguna Power BI
kata sandi Power BI

ID klien

Petunjuk / Saran

Berlaku untuk:Principal Layanan Pengguna Master

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

Petunjuk / Saran

Berlaku untuk:Principal Layanan Pengguna Master

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

   

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

ID Laporan

Petunjuk / Saran

Berlaku untuk:Principal Layanan Pengguna Master

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.

   

Rahasia Klien

Petunjuk / Saran

Berlaku untuk:Utusan layanan Pengguna Master

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 Penyewa

Petunjuk / Saran

Berlaku untuk:Prinsipal layanan Pengguna Master

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 Penyewa (Direktori).

Nama pengguna dan kata sandi Power BI

Petunjuk / Saran

Berlaku untuk:Prinsipal layanan Pengguna Master

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

Langkah 6 - Akses API prinsipal layanan

Petunjuk / Saran

Berlaku untuk:Service principal Pengguna utama

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, mintalah admin penyewa untuk mengaktifkan Pengaturan penyewa bagi Anda.

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

   

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

3. Perluas perwakilan layanan dapat menggunakan Fabric APIs, dan aktifkan opsi ini.

   

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:

• Membuat grup keamanan Microsoft Entra
• Mengaktifkan pengaturan admin layanan Power BI

Langkah 7 - Aktifkan akses ruang kerja

Untuk memungkinkan aplikasi Microsoft Entra Anda mengakses objek seperti laporan, dasbor, dan model semantik di layanan Power BI, tambahkan prinsipal layanan atau pengguna utama 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.

   

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

   

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

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

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

   Catatan

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

5. Buka folder Embed untuk pelanggan Anda.

.NET Core

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

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

   • Jika Anda menggunakan Visual Studio Code, buka folder AppOwnsData.

7. Buka appsettings.json.

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

   Pengaturan	Prinsipal 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	Tidak Berlaku	Kata sandi pengguna master Anda, lihat nama pengguna dan kata sandi Power BI
   ClientSecret	Rahasia klien Microsoft Entra ID Anda	Tidak Berlaku
   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

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

.NET Framework

6. Dengan menggunakan Visual Studio, buka file AppOwnsData.sln.

7. Buka Web.config.

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

   Pengaturan	Prinsipal Layanan	Pengguna utama
   authenticationType	ServicePrincipal	MasterUser
   applicationId	ID klien aplikasi Microsoft Entra Anda	ID klien aplikasi Microsoft Entra Anda
   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
   pbiUsername	Tidak Tersedia	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
   applicationSecret	Rahasia klien Microsoft Entra ID Anda	Tidak Ada
   tenant	ID penyewa Microsoft Entra Anda	Tidak Ada

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

Jawa

6. Buka Eclipse dan ikuti instruksi yang dijelaskan di bawah ini.

   Catatan

   Instruksi untuk penyematan Java untuk aplikasi sampel pelanggan Anda, lihat Eclipse IDE untuk Pengembang Java EE (Edisi Enterprise). Jika Anda menggunakan aplikasi yang berbeda, Anda harus menyiapkannya sendiri.

7. Tambahkan server Tomcat ke Eclipse:

   sebuah. Pilih Window>Show View>Servers.

   b. Di tab server, pilih Tidak ada server yang tersedia. Klik tautan ini untuk membuat server baru.

   c. Di jendela Define a New Server, luaskan Apache dan pilih server Tomcat yang Anda jalankan di mesin Anda. Misalnya, Tomcat v9.0 Server.

   d. Pilih Selanjutnya.

   e. Di jendela Tomcat Server, pilih Browse dan navigasikan ke folder yang berisi server Tomcat.

   f. Di jendela Tomcat Server, pilih Installed JREs.

   g. Di jendela Installed JREs, pilih jre yang tersedia, dan pilih Apply and Close.

   Halo. Di jendela Tomcat Server, pilih Finish. Anda dapat melihat server Tomcat di tab Server .

8. Buka proyek di Eclipse:

   Penting

   Eclipse mungkin mengalami masalah jika nama jalur Anda terlalu panjang. Untuk menghindari masalah ini, pastikan folder aplikasi sampel Anda tidak ditumpuk terlalu dalam di struktur folder komputer Anda.

   sebuah. Pilih File, lalu pilih Open Projects from File System.

   b. Di jendela Import Projects from File System or Archive, pilih Directory dan buka folder AppOwnsData.

   c. Pilih Selesai.

9. Tambahkan server Tomcat ke proyek:

   sebuah. Di panel Package Explorer, klik kanan AppOwnsData, dan pilih Properties.

   b. Di jendela Properties for AppOwnsData, pilih Targeted Runtimes, lalu pilih Apache Tomcat. Pilihan ini mencakup versi Apache Tomcat yang Anda gunakan, misalnya Apache Tomcat v9.0.

   c. Pilih Apply and Close.

10. Isi parameter yang diperlukan

    sebuah. Di Package explorer, luaskan proyek AppOwnsData.

    b. Luaskan Java Resources.

    c. Luaskan src.

    d. Luaskan com.embedsample.appoensdata.config.

    e. Buka Config.java.

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

    Pengaturan	Prinsipal Layanan	Pengguna utama
    authenticationType	ServicePrincipal	MasterUser
    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
    clientId	ID klien aplikasi Microsoft Entra Anda	ID klien aplikasi Microsoft Entra Anda
    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
    tenantId	ID penyewa Microsoft Entra Anda	T/A
    appSecret	Rahasia klien Microsoft Entra ID Anda	T/A

11. Jalankan proyek

    sebuah. Di Package Explorer, klik kanan AppOwnesData.

    b. Pilih Jalankan Sebagai>Jalankan di Server.

    c. Di jendela Run on Server, pilih Choose an existing server dan pilih server Tomcat.

    d. Pilih Selesai.

Node JS

6. Buka folder App Owns Data menggunakan IDE pilihan Anda. Sebaiknya gunakan salah satu dari berikut ini:

   • Visual Studio

   • Visual Studio Code

7. Buka terminal dan instal dependensi yang diperlukan dengan mengeksekusi: npm install.

8. Luaskan folder Config dan buka config.json.

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

   Pengaturan	Prinsipal Layanan	Pengguna utama
   authenticationMode	ServicePrincipal	MasterUser
   clientId	ID klien aplikasi Microsoft Entra Anda	ID klien aplikasi Microsoft Entra Anda
   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
   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
   tenantId	ID penyewa Microsoft Entra Anda	ID penyewa Microsoft Entra Anda

10. Jalankan proyek dengan melakukan hal berikut:

    sebuah. Di terminal IDE, jalankan npm start.

    b. Buka tab baru di browser Anda dan navigasikan ke http://localhost:5300.

Python

6. Buka PowerShell atau Prompt Perintah.

7. Pastikan Anda berada di folder Python>Embed untuk pelanggan Anda, dan file requirements.txt ada di folder, dan jalankan pip3 install -r requirements.txt.

8. Buka folder App Owns Data menggunakan IDE pilihan Anda. Sebaiknya gunakan salah satu lingkungan berikut:

   • Visual Studio

   • Visual Studio Code

9. Buka config.py.

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

    Pengaturan	Prinsipal Layanan	Pengguna utama
    AUTHENTICATION_MODE	ServicePrincipal	MasterUser
    WORKSPACE_ID	ID ruang kerja dengan laporan tersemat Anda, lihat ID Ruang Kerja	ID ruang kerja dengan laporan tersemat Anda, lihat ID Ruang Kerja
    REPORT_ID	ID laporan yang Anda sematkan, lihat ID Laporan	ID laporan yang Anda sematkan, lihat ID Laporan
    TENANT_ID	ID penyewa Microsoft Entra Anda	T/A
    CLIENT_ID	ID klien aplikasi Microsoft Entra Anda	ID klien aplikasi Microsoft Entra Anda
    CLIENT_SECRET	Rahasia klien Microsoft Entra ID Anda	T/A
    POWER_BI_USER	T/A	Nama pengguna pengguna master Anda, lihat nama pengguna dan kata sandi Power BI
    POWER_BI_PASS	T/A	Kata sandi pengguna master Anda, lihat nama pengguna dan kata sandi Power BI

11. Simpan file.

12. Jalankan proyek dengan melakukan langkah-langkah berikut:

    sebuah. Di PowerShell atau Command Prompt, buka folder Python>sematkan untuk pelanggan Anda>AppOwnesData, dan jalankan flask run.

    b. Buka tab baru di browser Anda dan navigasikan ke http://localhost:5000.

Mengembangkan aplikasi Anda

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

Cobalah ruang coba analitik Power BI Embedded untuk memulai pengembangan dan mengikuti berbagai fitur serta pembaruan terbaru Power BI Embedded.

Saat Anda siap, tinjau persyaratan beralih 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.

Pertimbangan dan batasan

Batasan berikut berlaku untuk mode Direct Lake:

• Memerlukan token semat V2.
• Jika Anda menggunakan prinsipal layanan, Anda memerlukan koneksi Identitas Tetap (No-SSO).
• Saat ini, mengatur perwakilan layanan sebagai metode otentikasi pada koneksi Identitas Tetap adalah satu-satunya opsi yang didukung melalui otomatisasi. Metode lain didukung secara manual melalui portal.

Konten terkait

• Masukkan ke tahapan produksi
• Menyematkan untuk organisasi Anda
• Tanamkan laporan berhalaman

Ada pertanyaan lagi? Tanyakan kepada Komunitas Power BI.