Bagikan melalui

Tutorial: Mengotomatiskan konfigurasi penginstalan aplikasi templat menggunakan fungsi Azure

  • Artikel

Aplikasi templat adalah cara yang bagus bagi pelanggan untuk mulai mendapatkan wawasan dari data mereka. Aplikasi templat akan menyiapkan wawasan dan menjalankannya dengan cepat dengan menyambungkan wawasan ke data pelanggan. Aplikasi templat memberi pelanggan laporan bawaan yang dapat mereka sesuaikan jika diinginkan.

Pelanggan tidak selalu terbiasa dengan detail cara menyambungkan ke data mereka. Memberikan detail ini ketika mereka menginstal aplikasi templat bisa menjadi kesulitan tersendiri bagi mereka.

Jika Anda adalah penyedia layanan data dan telah membuat aplikasi templat untuk membantu pelanggan Anda memulai data mereka di layanan Anda, Anda dapat mempermudah mereka menginstal aplikasi templat Anda. Anda dapat mengotomatiskan konfigurasi parameter dari aplikasi templat Anda.

Saat pelanggan masuk ke portal Anda, mereka akan memilih tautan khusus yang telah Anda siapkan. Tautan ini:

  • Meluncurkan otomatisasi, yang mengumpulkan informasi yang dibutuhkan.
  • Mengonfigurasi parameter aplikasi templat.
  • Mengalihkan pelanggan ke akun Power BI di mana mereka dapat menginstal aplikasinya.

Yang harus mereka lakukan adalah memilih Instal dan mengautentikasi sumber data mereka, dan selesai!

Pengalaman pelanggan diilustrasikan di sini.

Illustration of user experience with an auto-installation application.

Dalam tutorial ini, Anda akan menggunakan sampel Azure Functions penginstalan otomatis yang telah kami buat untuk melakukan prakonfigurasi dan menginstal aplikasi templat Anda. Sampel ini sengaja disimpan sederhana untuk tujuan demonstrasi. Sampel ini merangkum penyiapan fungsi Azure untuk menggunakan API Power BI untuk menginstal aplikasi templat dan mengonfigurasinya untuk pengguna Anda secara otomatis.

Untuk informasi selengkapnya tentang alur otomatisasi umum dan API yang digunakan aplikasi, lihat Mengotomatiskan konfigurasi penginstalan aplikasi templat.

Aplikasi sederhana kami menggunakan fungsi Azure. Untuk informasi selengkapnya tentang Azure Functions, lihat Dokumentasi Azure Functions.

Alur dasar

Alur dasar berikut mencantumkan apa yang dilakukan aplikasi saat pelanggan meluncurkannya dengan memilih tautan di portal Anda.

  1. Pengguna masuk ke portal ISV dan memilih tautan yang disediakan. Tindakan ini memulai alur. Portal ISV menyiapkan konfigurasi khusus pengguna pada tahap ini.

  2. ISV memperoleh token khusus aplikasi berdasarkan perwakilan layanan (token khusus aplikasi) yang terdaftar di penyewa ISV.

  3. Dengan menggunakan REST API Power BI, ISV membuat tiket penginstalan, yang berisi konfigurasi parameter khusus pengguna seperti yang disiapkan oleh ISV.

  4. ISV mengalihkan pengguna ke Power BI dengan menggunakan POST metode pengalihan, yang berisi tiket penginstalan.

  5. Pengguna dialihkan ke akun Power BI mereka dengan tiket penginstalan dan diminta untuk menginstal aplikasi templat. Saat pengguna memilih Instal, aplikasi templat akan diinstal untuk mereka.

Catatan

Sementara nilai parameter dikonfigurasi oleh ISV dalam proses pembuatan tiket penginstalan,kredensial terkait sumber data hanya disediakan oleh pengguna pada tahap akhir penginstalan. Pengaturan ini mencegah pengguna diekspos ke pihak ketiga dan memastikan koneksi yang aman antara pengguna dan sumber data aplikasi templat.

Prasyarat

Menyiapkan lingkungan pengembangan otomatisasi aplikasi templat Anda

Sebelum Anda terus menyiapkan aplikasi, ikuti petunjuk di Mulai Cepat: Membuat aplikasi Azure Functions dengan Azure App Configuration untuk mengembangkan fungsi Azure bersama dengan konfigurasi aplikasi Azure. Buat konfigurasi aplikasi Anda seperti yang dijelaskan dalam artikel.

Mendaftarkan aplikasi di ID Microsoft Entra

Buat perwakilan layanan seperti yang dijelaskan dalam Menyematkan konten Power BI dengan perwakilan layanan dan rahasia aplikasi.

Pastikan untuk mendaftarkan aplikasi sebagai aplikasi web sisi server. Anda mendaftarkan aplikasi web sisi server untuk membuat rahasia aplikasi.

Simpan ID aplikasi (ClientID) dan rahasia aplikasi (ClientSecret) untuk langkah-langkah selanjutnya.

Anda dapat memeriksa alat penyiapan Penyematan untuk mulai membuat pendaftaran aplikasi dengan cepat. Jika Anda menggunakan Alat Pendaftaran Aplikasi Power BI, pilih opsi Sematkan untuk pelanggan Anda.

Tambahkan perwakilan layanan ke ruang kerja aplikasi templat sebagai Admin, sehingga Anda akan dapat menguji alur kerja otomatisasi Anda.

Persiapan aplikasi templat

Setelah Anda membuat aplikasi templat dan siap untuk penginstalan, simpan informasi berikut untuk langkah-langkah berikutnya:

  • ID Aplikasi, Kunci Paket, dan ID Pemilik saat muncul di URL penginstalan di akhir proses Tentukan properti aplikasi templat saat aplikasi dibuat.

    Anda juga bisa mendapatkan tautan yang sama dengan memilih Dapatkan tautan di panel Manajemen Rilis pada aplikasi templat.

  • Nama parameter seperti yang didefinisikan dalam model semantik aplikasi templat. Nama parameter adalah string peka huruf besar/kecil. Mereka juga dapat diambil dari tab Parameter Pengaturan saat Anda menentukan properti aplikasi templat atau dari pengaturan model semantik di Power BI.

Catatan

Anda dapat menguji aplikasi penginstalan yang telah dikonfigurasi sebelumnya di aplikasi templat jika aplikasi templat siap untuk diinstal, meskipun belum tersedia untuk umum di AppSource. Agar pengguna di luar penyewa Anda dapat menggunakan aplikasi penginstalan otomatis untuk menginstal aplikasi templat Anda, aplikasi templat harus tersedia untuk umum di marketplace aplikasi Power BI. Sebelum Anda mendistribusikan aplikasi templat dengan menggunakan aplikasi penginstalan otomatis yang Anda buat, pastikan untuk menerbitkannya ke Pusat Mitra.

Instal dan konfigurasikan perangkat lunak pada templat VM Anda

Di bagian ini, Anda akan menggunakan sampel Azure Functions penginstalan otomatis yang kami buat untuk melakukan prakonfigurasi dan menginstal aplikasi templat Anda. Sampel ini sengaja disimpan sederhana untuk tujuan demonstrasi. Sampel ini memungkinkan Anda menggunakan fungsi Azure dan Azure App Configuration untuk menyebarkan dengan mudah dan menggunakan API penginstalan otomatis untuk aplikasi templat Anda.

Unduh Visual Studio (versi 2017 atau yang lebih baru)

Unduh Visual Studio (versi 2017 atau yang lebih baru). Pastikan untuk mengunduh paket NuGet terbaru.

Mengunduh sampel Azure Functions penginstalan otomatis

Unduh sampel Azure Functions penginstalan otomatis dari GitHub untuk memulai.

Screenshot that shows the automated installation Azure Functions sample.

Menyiapkan konfigurasi aplikasi Azure Anda

Untuk menjalankan sampel ini, Anda perlu menyiapkan konfigurasi aplikasi Azure dengan nilai dan kunci seperti yang dijelaskan di sini. Kuncinya adalah ID aplikasi, rahasia aplikasi, dan nilai AppId, PackageKey, dan OwnerId aplikasi templat Anda. Lihat bagian berikut untuk informasi tentang cara mendapatkan nilai-nilai ini.

Kunci juga ditetapkan dalam file Constants.cs.

Kunci Konfigurasi Makna
TemplateAppInstall:Application:AppId AppId dari URL penginstalan
TemplateAppInstall:Application:PackageKey AppId dari URL penginstalan
TemplateAppInstall:Application:OwnerId AppId dari URL penginstalan
TemplateAppInstall:ServicePrincipal:ClientId ID aplikasi perwakilan layanan
TemplateAppInstall:ServicePrincipal:ClientSecret Rahasia aplikasi perwakilan layanan

File Constants.cs ditampilkan di sini.

Screenshot that shows the Constant.cs file.

Mendapatkan properti aplikasi templat

Mengisi semua properti aplikasi templat yang relevan jika ditetapkan saat aplikasi dibuat. Properti ini adalah nilai AppId, PackageKey, dan OwnerId aplikasi templat.

Untuk mendapatkan nilai sebelumnya, ikuti langkah-langkah berikut:

  1. Masuk ke Power BI.

  2. Buka ruang kerja asli aplikasi.

  3. Buka panel Manajemen Rilis.

    Screenshot that shows the Release Management pane.

  4. Pilih versi aplikasi, dan dapatkan tautan penginstalannya.

    Screenshot that shows the Release Management button.

  5. Salin tautan ke clipboard.

    Screenshot that shows the Get link button.

  6. URL penginstalan ini menyimpan tiga parameter URL yang nilainya Anda butuhkan. Gunakan nilai appId, packageKey, dan ownerId untuk aplikasi. URL sampel akan mirip dengan apa yang ditampilkan di sini.

    https://app.powerbi.com/Redirect?action=InstallApp&appId=3c386...16bf71c67&packageKey=b2df4b...dLpHIUnum2pr6k&ownerId=72f9...1db47&buildVersion=5

Dapatkan ID aplikasi

Isi informasi applicationId dengan ID aplikasi dari Azure. Nilai applicationId digunakan oleh aplikasi untuk mengidentifikasi dirinya sendiri kepada pengguna tempat Anda meminta izin.

Untuk mendapatkan ID aplikasi, ikuti langkah-langkah berikut:

  1. Masuk ke portal Azure.

  2. Di panel kiri, pilih Semua layanan>Pendaftaran aplikasi.

    Screenshot that shows app registrations search.

  3. Pilih aplikasi yang memerlukan ID aplikasi.

    Screenshot that shows choosing an app.

  4. Ada ID aplikasi yang terdaftar sebagai GUID. Gunakan ID aplikasi ini sebagai nilai applicationId untuk aplikasi.

    Screenshot that shows the applicationId value.

Mendapatkan rahasia aplikasi

Isi informasi ApplicationSecret dari bagian Kunci di bagian Pendaftaran aplikasi Anda di Azure. Atribut ini berfungsi saat Anda menggunakan perwakilan layanan.

Untuk mendapatkan ID aplikasi, ikuti langkah-langkah berikut:

  1. Masuk ke portal Azure.

  2. Di panel kiri, pilih Semua layanan>Pendaftaran aplikasi.

    Screenshot that shows App registration search.

  3. Pilih aplikasi yang memerlukan ID aplikasi.

    Screenshot shows choosing an app.

  4. Pilih Sertifikat dan rahasia di bawah Kelola.

  5. Pilih Rahasia klien baru.

  6. Masukkan nama dalam kotak Deskripsi, dan pilih durasi. Kemudian pilih Simpan untuk mendapatkan nilai untuk aplikasi Anda. Saat Anda menutup panel Kunci setelah Anda menyimpan nilai kunci, bidang Nilai hanya ditampilkan secara tersembunyi. Pada saat itu, Anda tidak dapat mengambil nilai kunci. Jika Anda kehilangan nilai kunci, buat nilai baru di portal Azure.

    Screenshot that shows the key value.

Uji fungsi secara lokal

Ikuti langkah-langkah seperti yang dijelaskan dalam Menjalankan fungsi secara lokal untuk menjalankan fungsi Anda.

Konfigurasikan portal Anda untuk mengeluarkan POST permintaan ke URL fungsi. Contohnya POST http://localhost:7071/api/install. Isi permintaan harus menjadi objek JSON yang menjelaskan pasangan kunci-nilai. Kunci adalah nama parameter seperti yang ditetapkan dalam Power BI Desktop. Nilai adalah nilai yang diinginkan untuk diatur untuk setiap parameter di aplikasi templat.

Catatan

Dalam produksi, nilai parameter disimpulkan untuk setiap pengguna oleh logika portal Anda yang dimaksudkan.

Alur yang diinginkan adalah:

  1. Portal menyiapkan permintaan, per pengguna atau sesi.
  2. Permintaan POST /api/install dikeluarkan untuk fungsi Azure Anda. Isi permintaan terdiri dari pasangan kunci-nilai. Nama parameter. Nilai adalah nilai yang diinginkan untuk ditetapkan.
  3. Jika semuanya dikonfigurasi dengan benar, browser harus secara otomatis mengalihkan ke akun Power BI pelanggan dan menunjukkan alur penginstalan otomatis.
  4. Setelah penginstalan, nilai parameter diatur seperti yang dikonfigurasi dalam langkah 1 dan 2.

Konten terkait

Terbitkan proyek Anda ke Azure

Untuk menerbitkan proyek Anda ke Azure, ikuti petunjuk dalam dokumentasi Azure Functions. Kemudian Anda dapat mengintegrasikan API penginstalan otomatis aplikasi templat ke dalam produk Anda dan mulai mengujinya di lingkungan produksi.