Pemboleh ubah persekitaran untuk Power Platform gambaran keseluruhan

Pembolehubah persekitaran membolehkan senario pengurusan kitaran hayat aplikasi asas (ALM) untuk memindahkan aplikasi antara Power Platform persekitaran. Dalam senario ini, aplikasi tetap sama kecuali beberapa rujukan aplikasi luaran utama (seperti jadual, sambungan dan kekunci) yang berbeza antara persekitaran sumber dan persekitaran destinasi. Aplikasi ini memerlukan struktur jadual atau sambungan yang sama antara sumber dan persekitaran destinasi, dengan beberapa perbezaan. Pembolehubah persekitaran membolehkan anda menentukan rujukan luaran yang berbeza ini harus dikemas kini kerana aplikasi dipindahkan ke seluruh persekitaran.

Pemboleh ubah persekitaran menyimpan kunci parameter dan nilai, yang kemudian berfungsi sebagai input kepada pelbagai objek aplikasi lain. Memisahkan parameter daripada objek yang memakan membolehkan anda mengubah nilai dalam persekitaran yang sama atau apabila anda memindahkan penyelesaian kepada persekitaran lain. Alternatif tersebut ialah meninggalkan nilai parameter berkod keras dalam komponen yang menggunakannya. Ini selalunya bermasalah; terutamanya apabila nilai perlu diubah semasa operasi ALM. Disebabkan pemboleh ubah persekitaran ialah komponen penyelesaian, anda boleh mengangkut rujukan (kekunci) dan mengubah nilai apabila penyelesaian dipindahkan ke persekitaran lain.

Nota

Keupayaan baharu untuk sumber data kini sedang digunakan dan mungkin belum tersedia lagi di rantau anda.

Faedah menggunakan pemboleh ubah persekitaran:

• Berikan nilai parameter baru sambil mengimport penyelesaian ke persekitaran lain.
• Simpan konfigurasi untuk sumber data yang digunakan dalam aplikasi kanvas dan aliran. Contohnya, tapak SharePoint Dalam Talian dan parameter senarai boleh disimpan sebagai pemboleh ubah persekitaran; oleh itu membenarkan anda untuk bersambung ke tapak yang berbeza dan senarai dalam persekitaran yang berbeza tanpa perlu mengubah suai aplikasi dan aliran.
• Bungkus dan angkut penyesuaian dan konfigurasi anda bersama dan uruskannya dalam satu lokasi.
• Bungkuskan dan pindahkan rahsia, seperti kelayakan yang digunakan oleh komponen berbeza, secara berasingan daripada komponen yang menggunakan rahsia.
• Satu pemboleh ubah persekitaran boleh digunakan merentasi banyak komponen penyelesaian yang berbeza - sama ada ia jenis komponen yang sama atau berbeza. Contohnya, aplikasi kanvas dan aliran boleh menggunakan pemboleh ubah persekitaran yang sama. Apabila nilai pemboleh ubah persekitaran perlu berubah, anda hanya perlu mengubah satu nilai.
• Di samping itu, jika anda perlu bersara sumber data dalam persekitaran pengeluaran, anda boleh mengemas kini nilai pembolehubah persekitaran dengan maklumat untuk sumber data baru. Apl dan aliran tidak memerlukan pengubahsuaian dan mula menggunakan sumber data baharu.
• Disokong oleh alat SolutionPackager dan devops mendayakan integrasi yang berterusan dan penghantaran yang berterusan (CI/CD).
• Pemboleh ubah persekitaran boleh dibuka dan disimpan dalam kawalan sumber. Anda juga mungkin menyimpan fail nilai pembolehubah persekitaran yang berbeza untuk konfigurasi berasingan yang diperlukan dalam persekitaran yang berbeza. Pembungkus Penyelesaian kemudiannya boleh menerima fail yang sepadan dengan persekitaran penyelesaian yang diimport ke.

Bagaimanakah pembolehubah persekitaran berfungsi?

Pemboleh ubah persekitaran boleh dicipta dan diubah suai dalam antara muka penyelesaian moden, secara automatik dicipta apabila menyambung kepada sumber data tertentu dalam aplikasi kanvas atau dengan menggunakan kod. Ia juga boleh diimport ke persekitaran melalui penyelesaian. Sebaik sahaja pembolehubah persekitaran hadir dalam persekitaran, ia boleh digunakan sebagai input apabila mengarang apl kanvas, Power Automate mengalir, apabila membangunkan pemalam dan banyak tempat lain seperti menambah Power BI papan pemuka pada aplikasi berpandukan model. Apabila jenis objek ini menggunakan pemboleh ubah persekitaran, nilai kemudian diperoleh daripada pemboleh ubah persekitaran dan boleh diubah apabila penyelesaian diimport kepada persekitaran lain.

Cipta pemboleh ubah persekitaran dalam penyelesaian

1. Daftar masuk ke Power Apps (make.powerapps.com), dan kemudian pada anak tetingkap kiri, pilih Penyelesaian. Jika item tidak ditemukan dalam anak tetingkap panel sisi, pilih ...Lagi, kemudian pilih item yang anda kehendaki.
2. Buka penyelesaian yang anda mahu atau cipta yang baharu.
3. Pada bar perintah, pilih Baharu > Selanjutnya, dan kemudian pilih Pemboleh ubah persekitaran.
4. Pada anak tetingkap kanan, lengkapkan lajur berikut dan kemudian pilih Simpan:

   • Nama paparan. Masukkan nama untuk pemboleh ubah persekitaran.

   • Nama. Nama unik dijana secara automatik daripada Nama paparan, tetapi anda boleh mengubahnya.

   • Jenis Data. Pilih daripada Nombor perpuluhan, Teks, JSON, Dua pilihan, Sumber data atau Rahsia.

     Nota

     • Jika Sumber data adalah jenis yang dipilih, anda juga perlu memilih penyambung, sambungan yang sah untuk penyambung yang dipilih, dan jenis parameter. Walau bagaimanapun, sambungan tidak disimpan sebagai sebahagian daripada pemboleh ubah persekitaran. Sambungan hanya digunakan untuk mendapatkan semula nilai parameter yang tersedia seperti tapak SharePoint yang anda ada capaian, atau senarai yang berkaitan dengan tapak. Untuk parameter tertentu seperti senarai SharePoint, anda juga perlu memilih pemboleh ubah persekitaran sumber data induk seperti tapak SharePoint. Setelah disimpan, ini akan dikaitkan dalam pangkalan data.
     • Jika Rahsia ialah jenis yang dipilih, maklumat tambahan untuk menyediakan dan mengkonfigurasikan Azure Key Vault diperlukan untuk membolehkan Power Platform mengakses rahsia.

   • Nilai Semasa. Juga dikenali sebagai nilai. Sifat ini adalah pilihan dan sebahagian daripada jadual nilai pemboleh ubah persekitaran. Apabila nilai hadir, ia digunakan, walaupun nilai lalai juga hadir. Keluarkan nilai daripada penyelesaian anda jika anda tidak mahu menggunakannya dalam persekitaran yang seterusnya. Nilai juga dipisahkan ke dalam fail JSON berasingan dalam fail solution.zip yang dieksport dan boleh diedit di luar talian. Maklumat lanjut: Bagaimana saya mengalih keluar nilai daripada pemboleh ubah persekitaran?

   • Nilai Lalai. Lajur ini merupakan sebahagian daripada jadual takrifan pemboleh ubah persekitaran dan tidak diperlukan. Nilai lalai digunakan jika tiada nilai semasa.

     Pemisahan nilai lalai dan nilai semasa membolehkan anda memberikan takrifan dan nilai lalai secara berasingan daripada nilai tersebut. Contohnya, penerbit aplikasi mungkin menyenaraikan tawaran AppSource mereka dengan nilai lalai. Kemudian secara alternatif, pelanggan boleh memberikan nilai baharu. Apabila penerbit aplikasi menerbitkan kemas kini pada aplikasi, nilai yang ditetapkan oleh pelanggan tidak ditulis ganti.

     

     Nota

     Nilai tidak boleh wujud tanpa definisi. Antara muka hanya membenarkan penciptaan satu nilai bagi setiap definisi.

Masukkan nilai baharu semasa mengimport penyelesaian

Antara muka import penyelesaian moden termasuk keupayaan untuk memasukkan nilai bagi pemboleh ubah persekitaran. Ini menetapkan sifat nilai pada jadual environmentvariablevalue.

Bermula dengan kemas kini pada 7 Disember 2023, semua nilai pembolehubah persekitaran dapat dilihat semasa mengimport penyelesaian (atau semasa menggunakan Pipelines untuk digunakan). Pemboleh ubah persekitaran tanpa nilai atau nilai lalai akan digesa untuk nilai, tetapi yang sebaliknya dipraisi dengan label di bawah kawasan teks yang menandakan sumber nilai: nilai penyelesaian, nilai persekitaran sasaran atau nilai lalai.

Nota

• Dalam sesetengah kes, untuk nilai pembolehubah persekitaran sumber data tertentu, amaran yang dinafikan Akses mungkin muncul jika pembuat pengimport tidak mempunyai akses kepada sambungan atau sumber yang digunakan untuk pembolehubah persekitaran. Ini adalah amaran yang tidak menyekat, tetapi sesuatu yang perlu diperhatikan bergantung pada bagaimana anda merancang untuk menggunakan pembolehubah persekitaran dalam persekitaran sasaran.
• Anda boleh mengalih keluar nilai daripada penyelesaian anda sebelum mengeksport penyelesaian. Ini memastikan nilai sedia ada akan kekal dalam persekitaran pembangunan anda tetapi tidak akan dieksport dalam penyelesaian. Pendekatan ini membolehkan nilai baharu disediakan di samping mengimport penyelesaian ke dalam persekitaran lain. Maklumat lanjut: Bagaimana saya mengalih keluar nilai daripada pemboleh ubah persekitaran?

Pemberitahuan

Pemberitahuan dipaparkan apabila pemboleh ubah persekitaran tidak mempunyai nilai. Inilah peringatan untuk menetapkan nilai supaya komponen yang bergantung pada pemboleh ubah persekitaran tidak gagal.

Keselamatan

Jadual environmentvariabledefinition adalah pengguna atau pasukan yang dimiliki. Apabila anda mencipta aplikasi yang menggunakan pemboleh ubah persekitaran, pastikan untuk menugaskan pengguna tahap kelayakan yang sesuai untuk jadual ini. Keizinan untuk jadual environmentvariablevalue diwarisi daripada jadual environmentvariabledefinition induk dan oleh itu, tidak memerlukan kelayakan berasingan. Kelayakan untuk jadual environmentvariabledefinition dimasukkan ke dalam Pembuat Persekitaran dan peranan keselamatan Pengguna Asas secara lalai. Maklumat lanjut: Keselamatan dalam Dataverse.

Penamaan

Memastikan nama pemboleh ubah persekitaran adalah unik supaya ia boleh dirujuk dengan tepat. Nama paparan pemboleh ubah persekitaran duplikasi membuat pemboleh ubah persekitaran untuk membezakan dan menggunakan. Memastikan nama pemboleh ubah persekitaran adalah unik supaya ia boleh dirujuk dengan tepat. Nama $pengesahan dan $sambungan adalah parameter ditempah khas untuk aliran dan perlu dielakkan. Penjimatan aliran disekat jika pembolehubah persekitaran dengan nama tersebut digunakan. Jika pembolehubah persekitaran digunakan dalam aliran dan nama paparan pembolehubah persekitaran diubah, maka pereka bentuk menunjukkan kedua-dua token nama paparan lama dan baru untuk membantu pengenalan. Apabila mengemas kini aliran, kami mengesyorkan agar anda mengalih keluar rujukan pembolehubah persekitaran dan menambahnya semula.

Had semasa

• Pengesahan nilai pemboleh ubah persekitaran berlaku dalam antara muka pengguna dan dalam komponen yang menggunakannya, tetapi tidak dalam Dataverse. Oleh itu, pastikan nilai yang sesuai ditetapkan jika ia diubah suai melalui kod.
• Tugas Alatan Binaan Power Platform belum tersedia untuk mengurus pemboleh ubah persekitaran sumber data. Walau bagaimanapun, ini tidak menghalang penggunaannya dalam peralatan yang disediakan oleh Microsoft dan dalam sistem kawalan sumber.
• Berinteraksi dengan pembolehubah persekitaran melalui kod tersuai memerlukan panggilan API untuk mengambil nilai; tiada cache yang terdedah untuk kod bukan Microsoft untuk digunakan.
• Untuk berjaya menggunakan pembolehubah persekitaran dengan SharePoint senarai, nama paparan dan nama logik bagi setiap lajur yang sepadan dalam persekitaran sumber dan sasaran mesti sepadan.
• Pembolehubah persekitaran terhad kepada maksimum 2,000 aksara.

Soalan lazim

Mengapa saya tidak dapat melihat nilai pembolehubah persekitaran saya?

Jika pemboleh ubah persekitaran berada dalam penyelesaian terurus, anda tidak akan dapat melihat nilai melainkan anda melihat ke dalam penyelesaian Lalai. Tingkah laku ini adalah mengikut reka bentuk, kerana nilai pembolehubah persekitaran adalah penyesuaian yang tidak terurus.

Bagaimanakah saya boleh melihat sama ada pemboleh ubah persekitaran sedang digunakan?

Sama ada melalui pemilihan Tunjukkan kebersandaran dalam antara muka penyelesaian, semasa mengarang komponen, atau dalam kawalan sumber dan dalam fail penyelesaian dengan melihat aplikasi atau metadata aliran.

Adakah pemboleh ubah persekitaran sumber data sama seperti sambungan?

Tidak. Walaupun sambungan tersebut berkaitan mewakili kelayakan atau pengesahan yang diperlukan untuk berinteraksi dengan penyambung. Pemboleh ubah persekitaran sumber data menyimpan parameter yang diperlukan oleh satu atau lebih tindakan dalam penyambung dan parameter ini selalunya berbeza bergantung pada tindakan. Contohnya, sambungan SharePoint Dalam Talian tidak menyimpan apa-apa maklumat tentang tapak, senarai atau pustaka dokumen. Oleh itu memanggil penyambung memerlukan kedua-dua sambungan yang sah dan beberapa parameter tambahan.

Bolehkah pemboleh ubah persekitaran sumber data digunakan dengan sambungan dikongsi seperti Pelayan SQL dengan pengesahan SQL?

Umumnya, tidak. Sambungan dikongsi seperti SQL Server menyimpan parameter yang diperlukan untuk menyambung kepada data dalam sambungan. Sebagai contoh, nama Pelayan dan Pangkalan Data disediakan apabila mencipta sambungan dan oleh itu sentiasa diperolehi daripada sambungan.

Sumber data pembolehubah persekitaran digunakan untuk penyambung yang bergantung pada pengesahan berasaskan pengguna seperti Microsoft Entra ID kerana parameter tidak boleh diperoleh daripada sambungan. Untuk tujuan ini, pengesahan dengan SQL Server, yang merupaan sambungan terkongsi, tidak akan menggunakan pemboleh ubah persekitaran sumber data.

Bolehkah talian paip ALM automatik saya menggunakan nilai fail berbeza untuk persekitaran yang berbeza?

Ya. Pembungkus penyelesaian menerima nama fail sebagai parameter input supaya talian paip anda boleh membungkus fail nilai yang berbeza ke dalam penyelesaian, bergantung pada jenis persekitaran ia dilaksanakan.

Bagaimanakah jika seseorang itu menghapuskan nilai secara tidak sengaja?

Sekiranya belum dicegah oleh sistem pergantungan, masa jalan menggunakan nilai terakhir yang diketahui sebagai sandaran.

Jika nilai berubah, bilakah nilai baharu digunakan dalam aplikasi kanvas dan aliran awan?

Ia mungkin mengambil masa sehingga satu jam untuk menerbitkan sepenuhnya pembolehubah persekitaran yang dikemas kini kerana nilai ditolak ke dalam apl dan mengalir secara tidak segerak.

Adakah lesen premium diperlukan?

Tidak. Walaupun ALM memerlukan Dataverse (atau Dynamics 365 for Customer Engagement), penggunaan penyambung premium tidak diperlukan. Satu kaveat adalah jika anda menggunakan penyambung Dataverse untuk berinteraksi dengan pemboleh ubah persekitaran yang anda mahu dengan rekod data lain seperti akaun atau kenalan. Sebelum ini, ini adalah satu-satunya cara untuk menggunakan pemboleh ubah persekitaran dalam aplikasi kanvas dan aliran.

Adakah terdapat had kepada bilangan pemboleh ubah persekitaran yang saya boleh miliki?

Tidak. Walau bagaimanapun, saiz maks. penyelesaian ialah 120 MB. Maklumat lanjut: Cipta penyelesaian

Bolehkah nama paparan dan penerangan pemboleh ubah persekitaran disetempatkan?

Ya.

Perlukah saya menggunakan pemboleh ubah persekitaran dan bukannya menyimpan data konfigurasi dalam jadual tersuai?

Ya, jika data konfigurasi anda tidak mempunyai hubungan. Pemboleh ubah persekitaran sepatutnya digunakan untuk kunci: nilai berpasangan dan apabila nilai perlu berbeza dalam persekitaran lain. Alatan lain seperti kemudahan penghijrahan Konfigurasi adalah lebih sesuai untuk penghijrahan data konfigurasi berkaitan yang disimpan dalam jadual tersuai. Berbeza dengan data konfigurasi lain, pemboleh ubah persekitaran dipindahkan dalam penyelesaian dan oleh itu lebih mudah untuk mengurus dan lebih banyak prestasi perlu diimport.

Mengapakah nilai sambungan yang berbeza daripada nilai sambungan yang saya mahu diuntukkan secara automatik semasa mengimport?

Dalam sesetengah kes di mana terdapat berbilang sambungan yang tersedia untuk pembolehubah persekitaran tunggal (jenis sumber data), terdapat pelaksanaan reka bentuk sampingan untuk memilih sambungan pertama dalam senarai sambungan yang tersedia untuk pembolehubah persekitaran. Kerana biasanya hanya ada satu sambungan yang berkaitan dengan pembolehubah persekitaran, ini bukan sesuatu yang biasanya perlu disahkan. Di samping itu, dengan perubahan baru-baru ini kepada keterlihatan nilai pembolehubah persekitaran, ini lebih mudah disahkan semasa import.

Bagaimana saya mengalih keluar nilai daripada pemboleh ubah persekitaran?

Anda mungkin mahu mengalih keluar nilai pemboleh ubah persekitaran daripada penyelesaian anda sebelum mengeksport penyelesaian. Kemudian, nilai sedia ada kekal dalam persekitaran pembangunan anda, tetapi tidak dieksport dalam penyelesaiannya. Pendekatan ini membolehkan nilai baharu disediakan semasa mengimport penyelesaian ke dalam persekitaran lain.

Untuk mengalih keluar nilai, ikuti langkah ini:

1. Dalam penyelesaian bagi pemboleh ubah persekitaran, pilih pemboleh ubah persekitaran untuk memaparkan sifat.

2. Di bawah Nilai Semasa, pilih ... > Alih keluar daripada penyelesaian ini.

   

Bolehkah saya menggunakan pemboleh ubah persekitaran dalam penyambung tersuai?

Ya. Sokongan pemboleh ubah persekitaran dalam penyambung tersuai

Lihat juga

Gunakan pembolehubah persekitaran sumber data dalam aplikasi kanvas
Gunakan pembolehubah persekitaran dalam Power Automate aliran awan penyelesaian
Rujukan jadual/entiti EnvironmentVariableDefinition
Sampel Web API
Gunakan pembolehubah persekitaran sumber data dalam aplikasi Canvas
Gunakan pembolehubah persekitaran dalam Power Automate aliran awan penyelesaian
Gunakan Azure Key Vault rahsia
Sokongan pemboleh ubah persekitaran dalam penyambung tersuai
Blog Power Apps: Pembolehubah persekitaran tersedia dalam pratonton!

Nota

Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)

Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).