Variabel lingkungan untuk Power Platform gambaran umum

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

Manfaat menggunakan variabel lingkungan:

• Berikan nilai parameter baru saat mengimpor solusi ke lingkungan lain.
• Konfigurasi penyimpanan untuk sumber data yang digunakan dalam aplikasi dan alur kanvas. Misalnya, SharePoint situs online dan parameter daftar dapat disimpan sebagai variabel lingkungan. Pendekatan ini memungkinkan Anda untuk terhubung ke situs dan daftar yang berbeda di lingkungan yang berbeda tanpa perlu 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 alat SolutionPackager dan DevOps memungkinkan integrasi berkelanjutan dan pengiriman berkelanjutan (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. Mereka juga dapat dibuat secara otomatis saat menyambungkan ke sumber data tertentu di aplikasi kanvas atau dengan kode. Mereka juga dapat diimpor ke lingkungan melalui solusi. Variabel lingkungan dapat digunakan sebagai input saat menulis aplikasi kanvas, Power Automate alur, plug-in, dan menambahkan Power BI dasbor ke aplikasi berdasarkan model. Saat Anda menggunakan variabel lingkungan, nilai kemudian diturunkan dari variabel lingkungan, dan dapat diubah saat solusi diimpor ke lingkungan lain.

Membuat variabel lingkungan secara manual dalam solusi

1. Masuk ke( Power Apps make.powerapps.com), lalu di panel kiri pilih Solusi. Jika item tidak ada di panel panel samping, pilih ... Lainnya lalu pilih item yang Anda inginkan.
2. Buka solusi yang Anda inginkan atau buat solusi baru.
3. Pada bilah perintah, pilih Baru Lainnya>, lalu pilih Variabel lingkungan.
4. Di panel kanan, lengkapi kolom berikut, lalu pilih Simpan:

   • Nama tampilan. Masukkan nama untuk variabel lingkungan.

   • Nama. Nama unik dibuat secara otomatis dari Nama tampilan, tetapi Anda dapat mengubahnya.

   • Tipe Data. Pilih dari Angka desimal, Teks, JSON, Dua opsi , Sumber data , atauRahasia .

     Catatan

     • Jika Sumber data adalah jenis yang dipilih, Anda harus memilih konektor , koneksiyang valid untuk konektor yang dipilih, dan jenis parameter. Koneksi tidak disimpan sebagai bagian dari variabel lingkungan. Variabel lingkungan menyimpan informasi yang tidak dalam koneksi yang diperlukan untuk terhubung Power Apps ke server dan tabel yang tepat. Sambungan hanya digunakan untuk mengambil nilai parameter yang tersedia seperti situs SharePoint yang Anda akses, atau daftar yang terkait dengan situs.

     • Jika Rahasia adalah jenis yang dipilih, informasi tambahan untuk menyiapkan dan mengonfigurasi Azure Key Vault diperlukan untuk memungkinkan Power Platform akses rahasia.

   • Nilai Saat Ini. Juga dikenal sebagai nilai. Properti ini opsional dan merupakan bagian dari tabel nilai variabel lingkungan. Nilai yang ditentukan digunakan bahkan jika 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 selengkapnya: 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.

Power Apps dapat secara otomatis membuat variabel lingkungan

Pada tab Umum pengaturan Power Apps :

• Aktifkan opsi Buat variabel lingkungan secara otomatis saat menambahkan sumber data. Sekarang, saat Anda menambahkan sumber data baru ke aplikasi, variabel lingkungan akan ditambahkan untuk Anda.

  

Sumber data yang berbeda

Sumber data yang berbeda memungkinkan berbagai jenis variabel lingkungan.

Microsoft Dataverse

Power Apps terhubung secara asli ke. Dataverse Anda tidak memerlukan variabel lingkungan untuk tabel di lingkungan Anda saat ini. Saat Anda menyambungkan Dataverse, aplikasi Anda secara otomatis mencari nama tabel yang persis sama di lingkungan mana pun yang Anda porting. Selama struktur nama tabel Anda sama di lingkungan target seperti di lingkungan asli, itu berfungsi.

Jika Anda menggunakan tabel eksternal dari lingkungan yang berbeda (melalui Change Environment), maka Power Apps asumsikan Anda ingin selalu merujuk ke tabel yang sama persis. Anda memerlukan variabel lingkungan jika Anda membutuhkan tabel eksternal tersebut menjadi tabel eksternal yang berbeda saat Anda berpindah dari dev ke test atau ke prod. Paling mudah untuk mengizinkan Power Apps untuk membuat variabel lingkungan secara otomatis untuk Anda. (Jika sebelumnya Anda menambahkan tabel ke aplikasi, aktifkan tombol setelan, lepaskan tabel eksternal, lalu tambahkan kembali.)

Saat Anda menambahkan tabel eksternal ke aplikasi, pilih tab Tingkat Lanjut untuk memilih variabel lingkungan.

SharePoint

SharePoint hanya mendukung Microsoft Entra koneksi. Jadi, untuk SharePoint, selain koneksi yang valid, variabel lingkungan terpisah diperlukan untuk Situs dan Daftar.

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 untuk harus SharePoint memiliki metadata yang cocok. SharePoint memiliki ID internal yang mungkin tidak cocok antar lingkungan target. Misalnya, jika Anda membuat daftar dengan nama dan kolom yang sama di lingkungan target, nama internal tidak akan cocok. Metadata selalu cocok jika Anda menduplikasi SharePoint situs dan menyalinnya ke lingkungan target Anda.

Server SQL

SQL Server mendukung berbagai jenis autentikasi dan koneksi. Gunakan variabel lingkungan untuk Microsoft Entra koneksi. Variabel lingkungan terpisah diperlukan untuk server dan database. Aplikasi terikat pada nama tabel tertentu sehingga diasumsikan sama antar lingkungan.

Jangan gunakan variabel lingkungan untuk koneksi bersama seperti autentikasi SQL dasar dengan SQL Server. Gunakan referensi koneksi untuk informasi yang secara tradisional diteruskan sebagai bagian dari string koneksi. Parameter autentikasi SQL dasar adalah bagian dari string koneksi. Contohnya, Nama Server dan Database diberikan saat membuat sambungan dan oleh karena itu, selalu diambil dari sambungan.

Variabel lingkungan sumber data digunakan untuk konektor dengan otentikasi seperti Microsoft Entra. Dalam jenis koneksi ini, Power Apps hanya memiliki pengguna yang teridentifikasi. Power Apps tidak dapat memperoleh layanan atau tabel apa yang ingin Anda gunakan dari koneksi.

Masukkan nilai baru saat mengimpor solusi

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

Nilai variabel lingkungan terlihat saat mengimpor solusi atau saat menggunakan Alur untuk menyebarkan. Variabel lingkungan tanpa nilai default atau permintaan nilai untuk suatu nilai, tetapi yang sebaliknya diisi sebelumnya dengan label di bawah area teks yang menunjukkan sumber nilai: nilai solusi, nilai lingkungan target, atau nilai default.

Pemberitahuan

Pemberitahuan akan ditampilkan bila variabel lingkungan tidak memiliki nilai apa pun. Tetapkan nilai sehingga komponen yang bergantung pada variabel lingkungan tidak gagal.

Keamanan

environmentvariabledefinition Tabel dimiliki oleh 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 environmentvariablevalue tabel diwarisi dari tabel induk environmentvariabledefinition dan oleh karena itu tidak memerlukan hak istimewa terpisah. Hak istimewa untuk environmentvariabledefinition tabel disertakan dalam peran keamanan Pembuat Lingkungan dan Pengguna Dasar secara default. Informasi lebih lanjut: 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 adalah parameter yang dicadangkan khusus untuk aliran 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.
• Power Platform Tugas 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.
• 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 di kontrol sumber dan dalam file solusi dengan melihat metadata aplikasi atau 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 lainnya.

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.

Haruskah saya menyertakan nilai dalam solusi saya?

Tidak. Variabel lingkungan dimaksudkan untuk digunakan oleh aplikasi yang perlu memiliki nilai yang berbeda di lingkungan yang berbeda tempat solusi disebarkan. Definisi variabel lingkungan harus disertakan dalam solusi Anda, tetapi nilainya harus disediakan untuk lingkungan target selama penyebaran. Perilaku ini menghasilkan definisi variabel lingkungan menjadi objek solusi terkelola di lingkungan target sementara variabel lingkungan adalah rekaman yang tidak dikelola.

Mengapa saya tidak dapat menghapus nilai di lingkungan saya?

Jika nilai disertakan dalam solusi terkelola, satu-satunya cara untuk menghapus nilai adalah dengan memperbarui solusi di lingkungan sumber untuk mengecualikan nilai, lalu mengekspor versi baru solusi. Versi baru ini kemudian dapat diimpor ke lingkungan menggunakan operasi pemutakhiran (bukan pembaruan), yang mengakibatkan rekaman nilai dihapus.

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 aplikasi Dynamics 365), 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 selengkapnya: 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 koneksi saya tidak disimpan untuk variabel lingkungan sumber data?

Koneksi hanya digunakan untuk menghasilkan antarmuka pengguna. Misalnya, untuk mengambil nama ramah untuk SharePoint daftar yang terkait dengan situs. Saat mengedit variabel lingkungan sumber data, pastikan untuk memilih koneksi dengan akses ke sumber data. Jika Anda tidak lagi memiliki akses ke koneksi, Anda dapat memasukkan nilai secara manual. Misalnya, masukkan SharePoint URL situs atau pengidentifikasi unik (GUID) untuk daftar.

Ketika ada beberapa koneksi yang tersedia untuk satu variabel lingkungan (tipe sumber data), ada implementasi berdasarkan desain untuk memilih koneksi pertama dalam daftar koneksi. 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:

1. Di solusi tempat variabel lingkungan berada, pilih variabel lingkungan untuk menampilkan properti.

2. Di bawah Nilai Saat Ini, pilih ...>Hapus dari solusi ini.

   

Dapatkah saya menggunakan variabel lingkungan di konektor kustom?

Ya. Dukungan variabel lingkungan dalam konektor kustom

Baca juga

Menggunakan variabel lingkungan sumber data di aplikasi kanvas
Menggunakan variabel lingkungan dalam Power Automate alur cloud solusi
Referensi tabel/entitas
EnvironmentVariableDefinition Contoh API
Web Gunakan variabel lingkungan sumber data di aplikasi
Kanvas Gunakan variabel lingkungan dalam Power Automate alur
cloud solusi Gunakan rahasia
Azure Key Vault Dukungan variabel lingkungan di konektor
Power Apps kustom Blog: Variabel lingkungan tersedia dalam pratinjau!