Kongsi melalui

Pembolehubah persekitaran untuk Power Platform gambaran keseluruhan

  • Artikel

Pembolehubah persekitaran membolehkan senario pengurusan kitaran hayat aplikasi (ALM) asas untuk menggerakkan aplikasi antara Power Platform persekitaran. Dalam senario ini, aplikasi kekal sama kecuali untuk beberapa rujukan aplikasi luaran utama (seperti jadual, sambungan dan kunci) yang berbeza antara persekitaran sumber dan persekitaran destinasi. Aplikasi ini memerlukan struktur jadual atau sambungan agar betul-betul sama antara persekitaran sumber dan destinasi, dengan beberapa perbezaan. Pemboleh ubah persekitaran membolehkan anda menentukan rujukan luaran yang berbeza ini yang perlu dikemas kini apabila aplikasi dialihkan merentasi 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 sering 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:

  • Sediakan nilai parameter baharu semasa mengimport penyelesaian ke persekitaran lain.
  • Konfigurasi stor untuk sumber data yang digunakan dalam aplikasi dan aliran kanvas. 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.
  • Selain itu, jika anda perlu menamatkan sumber data dalam persekitaran pengeluaran, anda boleh mengemas kini nilai pembolehubah persekitaran dengan maklumat untuk sumber data baharu. Apl dan aliran tidak memerlukan pengubahsuaian dan mula menggunakan sumber data baharu.
  • Disokong oleh alat SolutionPackager dan DevOps membolehkan penyepaduan berterusan dan penghantaran 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 diimport.

Bagaimanakah pembolehubah persekitaran berfungsi?

Pemboleh ubah persekitaran boleh dicipta dan diubah suai dalam antara muka penyelesaian moden, dicipta secara automatik apabila menyambung ke sumber data tertentu dalam apl 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 aplikasi kanvas, Power Automate aliran, apabila membangunkan pemalam dan banyak tempat lain seperti menambah Power BI papan pemuka pada aplikasi dipacu 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. Log masuk ke( Power Apps make.powerapps.com), dan kemudian pada anak tetingkap kiri pilih Penyelesaian. Jika item tiada dalam anak tetingkap panel sisi, pilih... Lagi dan kemudian pilih item yang anda mahukan.
  2. Buka penyelesaian yang anda mahu atau cipta yang baharu.
  3. Pada bar perintah, pilih Baharu>Lagi 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 atauRahsia .

      Nota

      • Jika sumber dataialah 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 mengkonfigurasi Azure Key Vault diperlukan untuk membenarkan 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 turut 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: Bagaimanakah cara saya mengalih keluar nilai daripada pemboleh ubah persekitaran?

    • Nilai lalai. Lajur ini adalah sebahagian daripada jadual takrifan pembolehubah 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 kepada aplikasi, nilai yang ditetapkan oleh pelanggan tidak ditulis ganti.

      Pembolehubah persekitaran baharu.

      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 environmentvariablevalue jadual.

Bermula dengan kemas kini pada 7 Disember 2023, semua nilai pembolehubah persekitaran kelihatan apabila mengimport penyelesaian (atau apabila menggunakan Saluran Paip untuk digunakan). Pembolehubah persekitaran tanpa nilai atau nilai lalai akan digesa untuk nilai, tetapi pembolehubah sebaliknya diisi dengan label di bawah kawasan teks yang menandakan sumber nilai: nilai penyelesaian, nilai persekitaran sasaran atau nilai lalai.

Keterlihatan pembolehubah persekitaran semasa import penyelesaian.

Nota

  • Dalam sesetengah kes, untuk nilai pemboleh ubah persekitaran sumber data tertentu, amaran Akses ditolak mungkin muncul jika pembuat pengimport tidak mempunyai akses kepada sambungan atau sumber yang digunakan untuk pemboleh ubah persekitaran. Ini ialah amaran bukan menyekat, tetapi sesuatu yang perlu diberi perhatian bergantung pada cara 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: Bagaimanakah cara 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 adalah environmentvariabledefinition milik pengguna atau pasukan. Apabila anda mencipta aplikasi yang menggunakan pemboleh ubah persekitaran, pastikan untuk menugaskan pengguna tahap kelayakan yang sesuai untuk jadual ini. Keizinan kepada environmentvariablevalue jadual diwarisi daripada jadual induk environmentvariabledefinition dan oleh itu tidak memerlukan keistimewaan yang berasingan. Keistimewaan untuk environmentvariabledefinition jadual disertakan dalam peranan keselamatan pembuat persekitaran dan 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$authentication dan $connection adalah parameter yang dikhaskan khas untuk aliran dan harus dielakkan. Simpanan aliran disekat jika pembolehubah persekitaran dengan nama tersebut digunakan. Jika pemboleh ubah persekitaran digunakan dalam aliran dan nama paparan pemboleh ubah persekitaran diubah, maka pereka bentuk menunjukkan kedua-dua token nama paparan lama dan baharu untuk membantu pengenalan. Apabila mengemas kini aliran, kami mengesyorkan agar anda mengalih keluar rujukan pemboleh ubah 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.
  • Power Platform Tugas Alat Bina belum tersedia untuk mengurus pembolehubah 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 digunakan oleh kod bukan Microsoft.
  • Untuk berjaya menggunakan pembolehubah persekitaran dengan SharePoint senarai, nama paparan dan nama logik untuk setiap lajur yang sepadan dalam persekitaran sumber dan sasaran mesti sepadan.
  • Pembolehubah persekitaran terhad kepada maksimum 2,000 aksara.

Soalan lazim

Mengapakah saya tidak dapat melihat nilai untuk pemboleh ubah 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 ialah penyesuaian yang tidak terurus.

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

Sama ada melalui memilih Tunjukkan kebergantungan 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 ia berkaitan, sambungan 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.

Pembolehubah persekitaran sumber data digunakan untuk penyambung yang bergantung pada pengesahan berasaskan pengguna seperti Microsoft Entra ID kerana parameter tidak boleh diperolehi 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.

Patutkah saya memasukkan nilai dalam penyelesaian saya?

Tidak. Pembolehubah persekitaran bertujuan untuk digunakan oleh aplikasi yang perlu mempunyai nilai yang berbeza dalam persekitaran yang berbeza di mana penyelesaian digunakan. Takrifan pembolehubah persekitaran hendaklah disertakan dalam penyelesaian anda tetapi nilai hendaklah disediakan untuk persekitaran sasaran semasa penggunaan. Tingkah laku ini menyebabkan takrifan pembolehubah persekitaran menjadi objek penyelesaian terurus dalam persekitaran sasaran manakala pembolehubah persekitaran ialah rekod tidak terurus.

Mengapakah saya tidak boleh memadamkan nilai dalam persekitaran saya?

Jika nilai disertakan dalam penyelesaian terurus, satu-satunya cara untuk memadamkan nilai ialah mengemas kini penyelesaian dalam persekitaran sumber untuk mengecualikan nilai, kemudian mengeksport versi baharu penyelesaian. Versi baharu ini kemudiannya boleh diimport ke dalam persekitaran menggunakan operasi naik taraf (bukan kemas kini), menyebabkan rekod nilai dipadamkan.

Bagaimanakah jika seseorang itu menghapuskan nilai secara tidak sengaja?

Jika belum dihalang oleh sistem kebergantungan, 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 aplikasi dan mengalir secara tidak segerak.

Adakah lesen premium diperlukan?

Tidak. Walaupun ALM memerlukan Dataverse (atau aplikasi Dynamics 365), 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 95 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 sambungan saya tidak disimpan untuk pemboleh ubah persekitaran sumber data?

Sambungan hanya digunakan untuk menjana antara muka pengguna. Contohnya, untuk mendapatkan semula nama mesra bagi SharePoint senarai yang berkaitan dengan laman. Apabila mengedit pemboleh ubah persekitaran sumber data, pastikan anda memilih sambungan dengan capaian kepada sumber data. Jika anda tidak lagi mempunyai akses kepada sambungan, anda boleh memasukkan nilai secara manual. Contohnya, masukkan SharePoint URL laman atau pengecam unik (GUID) untuk senarai.

Apabila terdapat berbilang sambungan yang tersedia untuk pembolehubah persekitaran tunggal (jenis sumber data), terdapat pelaksanaan mengikut reka bentuk untuk memilih sambungan pertama dalam senarai sambungan. Oleh kerana biasanya hanya terdapat satu sambungan yang dikaitkan dengan pembolehubah persekitaran, ini bukan sesuatu yang biasanya perlu disahkan. Selain itu, dengan perubahan terkini pada keterlihatan nilai pembolehubah persekitaran, ini lebih mudah untuk 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 penyelesaian. 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... >Keluarkan daripada penyelesaian ini.

    Alih keluar nilai daripada pemboleh ubah persekitaran

Bolehkah saya menggunakan pemboleh ubah persekitaran dalam penyambung tersuai?

Ya. Sokongan pembolehubah persekitaran dalam penyambung tersuai

Lihat juga

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