Variabel lingkungan untuk Power Platform gambaran umum

Artikel
04/11/2024

Variabel lingkungan memungkinkan skenario manajemen siklus hidup aplikasi (ALM) dasar untuk memindahkan aplikasi antar Power Platform lingkungan. Dalam skenario ini, aplikasi tetap persis sama kecuali untuk beberapa referensi aplikasi eksternal utama (seperti tabel, koneksi, dan kunci) yang berbeda antara lingkungan sumber dan lingkungan tujuan. Aplikasi ini memerlukan struktur tabel atau koneksi agar persis sama antara lingkungan sumber dan tujuan, dengan beberapa perbedaan. Variabel lingkungan memungkinkan Anda menentukan referensi eksternal mana yang berbeda ini yang harus diperbarui saat aplikasi dipindahkan lintas lingkungan.

Variabel lingkungan menyimpan kunci dan nilai parameter, yang kemudian berfungsi sebagai input ke berbagai objek aplikasi lainnya. Memisahkan parameter dari objek yang mengonsumsi memungkinkan Anda mengubah nilai dalam lingkungan yang sama atau ketika Anda memigrasi solusi ke lingkungan lain. Alternatif lainnya adalah membiarkan nilai parameter dengan kode keras dalam komponen yang menggunakannya. Ini sering bermasalah; terutama ketika nilai perlu diubah selama operasi ALM. Karena variabel lingkungan adalah komponen solusi, Anda dapat memindahkan referensi (kunci) dan mengubah nilai saat solusi dimigrasi ke lingkungan lain.

Catatan

Kemampuan baru untuk sumber data saat ini sedang disebarkan dan mungkin belum tersedia di kawasan Anda.

Manfaat menggunakan variabel lingkungan:

Berikan nilai parameter baru sementara mengimpor solusi ke lingkungan lain.
Simpan konfigurasi untuk sumber data yang digunakan pada aplikasi kanvas dan alur. Contohnya, situs SharePoint online dan parameter daftar dapat disimpan sebagai variabel lingkungan; oleh karena itu, memungkinkan Anda terhubung ke situs yang berbeda dan daftar di lingkungan yang berbeda tanpa harus memodifikasi aplikasi dan alur.
Kemas serta pindahkan penyesuaian dan konfigurasi Anda bersama-sama dan kelola di satu lokasi.
Rahasia paket dan angkut, seperti kredensial yang digunakan oleh komponen lain, secara terpisah dari komponen yang menggunakannya.
Satu variabel lingkungan dapat digunakan di berbagai komponen solusi, baik jenis komponen yang sama maupun yang berbeda. Contohnya, aplikasi kanvas dan alur dapat menggunakan variabel lingkungan yang sama. Bila nilai variabel lingkungan perlu diubah, Anda hanya perlu mengubah satu nilai.
Selain itu, jika Anda perlu menghentikan sumber data di lingkungan produksi, Anda dapat memperbarui nilai variabel lingkungan dengan informasi untuk sumber data baru. Aplikasi dan alur tidak memerlukan modifikasi dan mulai menggunakan sumber data baru.
Didukung oleh SolutionPackager dan DevOps memungkinkan integrasi berkelanjutan dan pengiriman kontinu (CI/CD).
Variabel lingkungan dapat dibuka dan disimpan dalam kontrol sumber. Anda juga dapat menyimpan file nilai variabel lingkungan yang berbeda untuk konfigurasi terpisah yang diperlukan di lingkungan yang berbeda. Solution Packager kemudian dapat menerima file yang sesuai dengan lingkungan tempat solusi diimpor.

Bagaimana cara kerja variabel lingkungan?

Variabel lingkungan dapat dibuat dan dimodifikasi dalam antarmuka solusi modern, yang secara otomatis dibuat saat tersambung ke sumber data tertentu di aplikasi kanvas atau dengan menggunakan kode. Mereka juga dapat diimpor ke lingkungan melalui solusi. Setelah variabel lingkungan hadir di lingkungan, variabel tersebut dapat digunakan sebagai input saat menulis aplikasi kanvas, Power Automate alur, saat mengembangkan plug-in, dan banyak tempat lain seperti menambahkan Power BI dasbor ke aplikasi berdasarkan model. Bila jenis objek ini menggunakan variabel lingkungan, maka nilai diambil dari variabel lingkungan dan dapat diubah bila solusi diimpor ke lingkungan lain.

Membuat variabel lingkungan dalam solusi

Masuk ke Power Apps (make.powerapps.com), dan pilih solusi dari panel navigasi kiri. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
Buka solusi yang Anda inginkan atau buat solusi baru.
Di bilah perintah, pilih Baru > Lainnya lalu pilih Variabel lingkungan.
Pada panel kanan, lengkapi kolom berikut, lalu pilih Simpan:
- Nama tampilan. Masukkan nama untuk variabel lingkungan.
- Nama. Nama unik dibuat secara otomatis dari nama tampilan, namun anda dapat mengubahnya.
- Jenis Data. Pilih dari angka desimal, Teks, JSON, Dua pilihan, sumber data atau Rahasia.
  Catatan
  - Jika sumber data adalah jenis yang dipilih, Anda juga harus memilih konektor, sambungan yang valid untuk konektor yang dipilih, dan jenis parameter. Namun, sambungan tidak disimpan sebagai bagian dari variabel lingkungan. Sambungan hanya digunakan untuk mengambil nilai parameter yang tersedia seperti situs SharePoint yang Anda akses, atau daftar yang terkait dengan situs. Untuk parameter tertentu seperti daftar SharePoint, Anda juga harus memilih variabel lingkungan sumber data induk seperti situs SharePoint. Setelah disimpan, ini akan terkait di database.
  - Jika Rahasia adalah jenis yang dipilih, informasi tambahan untuk mengkonfigurasikan dan mengkonfigurasi Azure Key Vault diperlukan agar Power Platform dapat mengakses rahasia tersebut.
- Nilai Saat Ini. Juga dikenal sebagai nilai. Properti ini opsional dan merupakan bagian dari tabel nilai variabel lingkungan. Jika ada nilai, nilai tersebut digunakan, meskipun nilai default juga ada. Hapus nilai dari solusi jika Anda tidak ingin menggunakannya di lingkungan berikutnya. Nilai juga dipisahkan ke file JSON terpisah dalam file solution.zip yang diekspor dan dapat diedit secara offline. Informasi lebih lanjut: Bagaimana cara menghapus nilai dari variabel lingkungan?
- Nilai Default. Kolom ini adalah bagian dari tabel definisi variabel lingkungan dan tidak diperlukan. Nilai default digunakan jika tidak ada nilai saat ini.
  
  Pemisahan nilai default dan nilai saat ini memungkinkan Anda melayani definisi dan nilai default secara terpisah dari nilai. Misalnya, penerbit aplikasi mungkin mencantumkan penawaran AppSource mereka dengan nilai default. Selanjutnya, pelanggan dapat memberikan nilai baru. Saat penerbit aplikasi menerbitkan pembaruan ke aplikasi, nilai yang ditetapkan oleh pelanggan tidak ditimpa.
  
  Catatan
  
  Nilai tidak dapat ada tanpa definisi. Antarmuka hanya memungkinkan pembuatan satu nilai per definisi.

Masukkan nilai baru saat mengimpor solusi

Antarmuka impor solusi modern mencakup kemampuan untuk memasukkan nilai untuk variabel lingkungan. Ini menetapkan properti nilai pada tabel environmentvariablevalue.

Dimulai dengan pembaruan pada 7 Desember 2023, semua nilai variabel lingkungan terlihat saat mengimpor solusi (atau saat menggunakan Alur untuk menyebarkan). Variabel lingkungan tanpa nilai atau nilai default akan diminta untuk suatu nilai, tetapi variabel tersebut diisi sebelumnya dengan label di bawah area teks yang menunjukkan sumber nilai: nilai solusi, nilai lingkungan target, atau nilai default.

Visibilitas variabel lingkungan selama impor solusi.

Catatan

Dalam beberapa kasus, untuk nilai variabel lingkungan sumber data tertentu, peringatan Akses ditolak mungkin muncul jika pembuat pengimpor tidak memiliki akses ke koneksi atau sumber yang digunakan untuk variabel lingkungan. Ini adalah peringatan non-pemblokiran, tetapi sesuatu yang perlu diperhatikan tergantung pada bagaimana Anda berencana menggunakan variabel lingkungan di lingkungan target.
Anda dapat menghapus nilai dari solusi Anda sebelum mengekspor solusi. Langkah ini akan memastikan nilai yang ada akan tetap berada dalam lingkungan pengembangan, namun tidak akan diekspor dalam solusi. Pendekatan ini memungkinkan nilai baru diberikan saat mengimpor solusi ke lingkungan lain. Informasi lebih lanjut: Bagaimana cara menghapus nilai dari variabel lingkungan?

Pemberitahuan

Pemberitahuan akan ditampilkan bila variabel lingkungan tidak memiliki nilai apa pun. Ini adalah pengingat untuk mengatur nilai sehingga komponen yang tergantung pada variabel lingkungan tidak gagal.

Keamanan

Tabel environmentvariabledefinition adalah milik pengguna atau tim. Saat Anda membuat aplikasi yang menggunakan variabel lingkungan, pastikan untuk menetapkan tingkat hak istimewa yang sesuai kepada pengguna ke tabel ini. Izin ke tabel environmentvariablevalue diturunkan dari tabel induk environmentvariabledefinition dan oleh karena itu tidak memerlukan hak istimewa terpisah. Hak istimewa untuk tabel environmentvariabledefinition tercakup dalam peran keamanan Pembuat Lingkungan dan Pengguna Dasar secara default. Informasi lebih lanjut: peran keamanan di Dataverse.

Penamaan

Pastikan nama variabel lingkungan itu unik sehingga dapat direferensikan secara akurat. Nama tampilan variabel lingkungan duplikat membuat variabel lingkungan sulit didiferensiasikan dan digunakan. Pastikan nama variabel lingkungan itu unik sehingga dapat direferensikan secara akurat. Nama $authentication dan $connection merupakan parameter yang dikhususkan untuk alur dan harus dihindari. Penyimpanan alur diblokir jika variabel lingkungan dengan nama tersebut digunakan. Jika variabel lingkungan digunakan dalam alur dan nama tampilan variabel lingkungan diubah, maka perancang menampilkan token nama tampilan lama dan baru untuk membantu identifikasi. Saat memperbarui alur, kami menyarankan Anda menghapus referensi variabel lingkungan dan menambahkannya lagi.

Keterbatasan saat ini

Validasi nilai variabel lingkungan terjadi dalam antarmuka pengguna dan dalam komponen yang menggunakannya, tetapi tidak dalam Dataverse. Oleh karena itu, pastikan nilai yang tepat ditetapkan jika dimodifikasi melalui kode.
Tugas Power Platform Build Tools belum tersedia untuk mengelola variabel lingkungan sumber data. Namun demikian, hal ini tidak memblokir penggunaannya dalam alat yang disediakan Microsoft dan dalam sistem kontrol sumber.
Berinteraksi dengan variabel lingkungan melalui kode kustom memerlukan panggilan API untuk mengambil nilai; tidak ada cache yang diekspos untuk digunakan oleh kode non-Microsoft.
Agar berhasil menggunakan variabel lingkungan dengan SharePoint daftar, nama tampilan dan nama logis untuk setiap kolom yang sesuai di lingkungan sumber dan target harus cocok.
Variabel lingkungan dibatasi hingga maksimum 2.000 karakter.

Tanya jawab

Mengapa saya tidak dapat melihat nilai untuk variabel lingkungan saya?

Jika variabel lingkungan berada dalam solusi terkelola, Anda tidak akan dapat melihat nilainya kecuali Anda melihat ke dalam solusi Default. Perilaku ini dirancang karena nilai variabel lingkungan adalah penyesuaian yang tidak dikelola.

Bagaimana cara melihat lokasi variabel lingkungan yang digunakan?

Baik melalui memilih Tampilkan dependensi di antarmuka solusi, saat menulis komponen, atau pada kontrol sumber dan pada file solusi dengan melihat aplikasi atau metadata alur.

Apakah sumber data variabel lingkungan sama seperti sambungan?

Tidak. Meskipun terkait, koneksi mewakili kredensial atau autentikasi yang diperlukan untuk berinteraksi dengan konektor. Variabel lingkungan sumber data menyimpan parameter yang diperlukan oleh satu atau beberapa tindakan di konektor dan parameter ini sering berbeda, tergantung pada tindakan. Contohnya, sambungan SharePoint Online tidak menyimpan informasi tentang situs, daftar, atau pustaka dokumen. Oleh karena itu, memanggil konektor memerlukan koneksi yang valid dan beberapa parameter tambahan.

Dapatkah sumber data variabel lingkungan digunakan dengan sambungan bersama seperti SQL Server dengan autentikasi SQL?

Secara umum tidak. Sambungan bersama seperti SQL Server menyimpan parameter yang diperlukan untuk tersambung ke data dalam sambungan. Contohnya, Nama Server dan Database diberikan saat membuat sambungan dan oleh karena itu, selalu diambil dari sambungan.

Variabel lingkungan sumber data digunakan untuk konektor yang mengandalkan autentikasi berbasis pengguna seperti Microsoft Entra ID karena parameter tidak dapat diturunkan dari koneksi. Karena itu, autentikasi dengan SQL Server, yang merupakan koneksi bersama, tidak akan menggunakan variabel lingkungan sumber data.

Dapatkah alur ALM otomatis saya menggunakan file nilai yang berbeda untuk lingkungan yang berbeda?

Ya. Pengemas solusi menerima nama file sebagai parameter input sehingga alur Anda dapat mengemas file nilai yang berbeda ke dalam solusi, tergantung pada jenis lingkungan yang dieksekusinya.

Bagaimana jika seseorang secara tidak sengaja menghapus nilai?

Jika belum dicegah oleh sistem dependensi, runtime menggunakan nilai terakhir yang diketahui sebagai fallback.

Jika nilai diubah, kapan nilai baru tersebut digunakan pada aplikasi kanvas dan alur cloud?

Mungkin diperlukan waktu hingga satu jam untuk sepenuhnya menerbitkan variabel lingkungan yang diperbarui karena nilainya didorong ke dalam aplikasi dan mengalir secara asinkron.

Apakah lisensi premium diperlukan?

Tidak. Meskipun ALM memerlukan Dataverse (atau Dynamics 365 for Customer Engagement), penggunaan konektor premium tidak diperlukan. Satu peringatan adalah jika Anda menggunakan konektor Dataverse untuk berinteraksi dengan variabel lingkungan seperti halnya rekaman data lain seperti akun atau kontak. Sebelumnya, ini adalah satu-satunya cara menggunakan variabel lingkungan dalam aplikasi dan alur kanvas.

Apakah terdapat batas jumlah variabel lingkungan yang dapat saya miliki?

Tidak. Namun, ukuran maksimum solusi adalah 95 MB. Informasi lebih lanjut: Membuat solusi

Dapatkah nama tampilan dan deskripsi variabel lingkungan dilokalkan?

Ya.

Haruskah saya menggunakan variabel lingkungan daripada menyimpan data konfigurasi dalam tabel kustom?

Ya jika data konfigurasi Anda bukan relasi. Variabel lingkungan harus digunakan untuk kunci: pasangan nilai dan bila nilainya mungkin perlu berbeda di lingkungan lain. Alat lain seperti kegunaan utilitas migrasi Konfigurasi lebih cocok untuk migrasi data konfigurasi relasional yang tersimpan dalam tabel kustom. Tidak seperti data konfigurasi lain, variabel lingkungan dimigrasi dalam solusi dan oleh karena itu, lebih sederhana untuk dikelola dan lebih berfungsi untuk diimpor.

Mengapa nilai koneksi berbeda dari yang ingin saya tetapkan secara otomatis saat mengimpor?

Dalam beberapa kasus di mana ada beberapa koneksi yang tersedia untuk satu variabel lingkungan (tipe sumber data), ada implementasi berdasarkan desain untuk memilih koneksi pertama dalam daftar koneksi yang tersedia untuk variabel lingkungan. Karena biasanya hanya ada satu koneksi yang terkait dengan variabel lingkungan, ini bukan sesuatu yang biasanya perlu divalidasi. Selain itu, dengan perubahan terbaru pada visibilitas nilai variabel lingkungan, ini lebih mudah divalidasi saat impor.

Bagaimana cara menghapus nilai dari variabel lingkungan?

Anda mungkin ingin menghilangkan nilai variabel lingkungan dari solusi sebelum mengekspor solusi. Kemudian, nilai yang ada tetap ada di lingkungan pengembangan Anda, tetapi tidak diekspor dalam solusi. Pendekatan ini memungkinkan nilai baru diberikan saat mengimpor solusi ke lingkungan lain.

Untuk menghapus nilai, ikuti langkah-langkah berikut:

Di solusi tempat variabel lingkungan berada, pilih variabel lingkungan untuk menampilkan properti.
Dalam Nilai Saat Ini, pilih ... > Hapus dari solusi ini.

Dapatkah saya menggunakan variabel lingkungan di konektor kustom?

Ya. Dukungan variabel lingkungan di konektor kustom

Bagikan melalui