Spremenljivke okolja za Power Platform pregled

Spremenljivke okolja omogočajo osnovni scenarij upravljanja življenjskega cikla aplikacije (ALM) za premikanje aplikacije med Power Platform okolji. V tem scenariju ostane aplikacija popolnoma enaka, razen nekaj ključnih zunanjih referenc aplikacije (kot so tabele, povezave in ključi), ki se med izvornim in ciljnim okoljem razlikujejo. Aplikacija zahteva, da je struktura tabel ali povezav popolnoma enaka med izvornim in ciljnim okoljem, z nekaj razlikami. Spremenljivke okolja vam omogočajo, da določite, katere od teh različnih zunanjih referenc je treba posodobiti, ko se aplikacija premika med okolji.

Spremenljivke okolja hranijo ključe in vrednosti parametrov, ki nato služijo kot vhodni podatki za različne druge predmete aplikacije. Ločevanje parametrov od predmetov, ki jih porabljajo, vam omogoča spreminjanje vrednosti znotraj istega okolja ali pri selitvi rešitev v druga okolja. Sicer lahko pustite vrednosti kodiranih parametrov v komponentah, ki jih uporabljajo. Ta pristop je pogosto problematičen; zlasti kadar je treba vrednosti spremeniti med operacijami ALM. Ker so spremenljivke okolja komponente rešitve, lahko pri selitvi rešitev v druga okolja prenesete reference (ključe) in spremenite vrednosti.

Prednosti uporabe spremenljivk okolja:

• Zagotovite nove vrednosti parametrov, medtem ko uvažate rešitve v druga okolja.
• Konfiguracija shranjevanja za podatkovne vire uporabljane v aplikacijah in tokovih platna. Na primer, parametri strani in seznama SharePoint Online se lahko shranijo kot okoljske spremenljivke. Ta pristop vam omogoča povezovanje z različnimi spletnimi mesti in seznami v različnih okoljih, ne da bi morali spreminjati aplikacije in tokove.
• Spakirajte in prenesite prilagoditve in konfiguracijo skupaj ter jih upravljajte na enem mestu.
• Skrivnosti paketa in transporta, kot so poverilnice, ki jih uporabljajo različne komponente, ločeno od komponent, ki jih uporabljajo.
• Ena spremenljivka okolja se lahko uporablja v številnih različnih komponentah rešitve – ne glede na to, ali gre za isto vrsto komponent ali različne. Aplikacija s platnom in tok lahko na primer uporabljata isto spremenljivko okolja. Ko se mora vrednost spremenljivke okolja spremeniti, morate spremeniti le eno vrednost.
• Poleg tega, če morate umakniti vir podatkov v produkcijskih okoljih, lahko posodobite vrednosti spremenljivke okolja z informacijami za nov vir podatkov. Aplikacije in tokovi ne zahtevajo spreminjanja in začnejo uporabljati nov vir podatkov.
• Podprta z orodji SolutionPackager in DevOps omogočajo neprekinjeno integracijo in neprekinjeno dostavo (CI/CD).
• Spremenljivke okolja lahko razpakirate in shranite v kontrolnik virov. Lahko tudi shranite različne datoteke z vrednostmi spremenljivk okolja za ločeno konfiguracijo, ki je potrebna v različnih okoljih. Solution Packager lahko nato sprejme datoteko, ki ustreza okolju, v katerega je uvožena rešitev.

Kako delujejo spremenljivke okolja?

Spremenljivke okolja je mogoče ustvariti in spremeniti v sodobnem vmesniku rešitve. Prav tako jih je mogoče samodejno ustvariti, ko se povežete z določenimi viri podatkov v aplikacijah platna ali s kodo. Prav tako jih je mogoče uvoziti v okolje prek rešitev. Okoljske spremenljivke se lahko uporabljajo kot vhodi pri ustvarjanju aplikacij za platno, tokov Power Automate, vtičnikov in dodajanja Power BI nadzornih plošč v aplikacije, ki temeljijo na modelih. Ko uporabljate spremenljivke okolja, so vrednosti nato izpeljane iz spremenljivk okolja in jih je mogoče spremeniti, ko so rešitve uvožene v druga okolja.

Ročno ustvarite spremenljivko okolja v rešitvi

1. Prijavite se na Power Apps (make.powerapps.com), nato pa na levem oknu izberite Rešitve. Če elementa ni v stranskem podoknu, izberite …Več in nato izberite želeni element.
2. Odprite želeno rešitev ali ustvarite novo.
3. V ukazni vrstici izberite Novo>Več in nato izberite Spremenljivka okolja.
4. V desnem podoknu izpolnite naslednje stolpce in nato izberite Shrani:

   • Prikazno ime. Vnesite ime za spremenljivko okolja.

   • Ime. Enolično ime se samodejno ustvari iz Prikaznega imena, vendar ga lahko spremenite.

   • Vrsta podatkov. Izberite med Decimalno število, Besedilo, JSON, Dve možnosti, Podatki virali Skrivnost.

     opomba,

     • Če je izbrana vrsta Vir podatkov , morate izbrati konektor, veljavno povezavo za izbrani konektor in tip parametra. Povezava ni shranjena kot del spremenljivke okolja. Spremenljivka okolja shranjuje informacije, ki niso v povezavi, ki je potrebna za povezavo Power Apps s pravim strežnikom in tabelo. Povezava se uporablja le za pridobivanje razpoložljivih vrednosti parametrov, kot so SharePoint strani, do katerih imate dostop, ali seznami, povezani s spletnimi mesti.
     • Če je izbrana vrsta Secret, so potrebne dodatne informacije za nastavitev in konfiguracijo, Azure Key Vault da Power Platform lahko dostopa do skrivnosti.

   • Trenutna vrednost. Znana tudi kot vrednost. Ta lastnost ni obvezna in je del tabele z vrednostjo spremenljivke okolja. Določena vrednost se uporabi tudi, če je prisotna tudi privzeta vrednost. Odstranite vrednost iz rešitve, če je ne želite uporabiti v naslednjem okolju. Vrednosti so ločene tudi v ločene datoteke JSON v izvoženi datoteki solution.zip in jih je mogoče urejati brez povezave. Več informacij: Kako odstranim vrednost iz spremenljivke okolja?

   • Privzeta vrednost. Ta stolpec je del tabele definicij spremenljivk okolja in ni obvezen. Privzeta vrednost se uporabi, če ni trenutne vrednosti.

     Ločevanje privzete vrednosti in trenutne vrednosti vam omogoča, da definicijo in privzeto vrednost posredujete ločeno od vrednosti. Na primer, založnik aplikacije lahko na Marketplace objavi svojo ponudbo z privzeto vrednostjo. Nato lahko stranka zagotovi novo vrednost (izbirno). Ko izdajatelj aplikacije objavi posodobitve aplikacije, vrednost, ki jo nastavi stranka, ni prepisana.

     

     opomba,

     Vrednost ne more obstajati brez definicije. Vmesnik omogoča ustvarjanje samo ene vrednosti na definicijo.

Power Apps lahko samodejno ustvari okoljske spremenljivke

Na zavihku General v nastavitvah Power Apps:

• Omogočite možnost Samodejno ustvari spremenljivke okolja pri dodajanju virov podatkov . Zdaj, ko svoji aplikaciji dodate nov vir podatkov, ta za vas doda spremenljivko okolja.

  

Različni viri podatkov

Različni viri podatkov omogočajo različne vrste spremenljivk okolja.

Microsoft Dataverse

Power Apps se nativno poveže z Dataverse. Za tabele v vašem trenutnem okolju ne potrebujete spremenljivke okolja. Ko se povežete z Dataverse, vaša aplikacija samodejno poišče popolnoma isto ime tabele v katerem koli okolju, v katerem jo prenesete. Dokler je struktura imena vaše tabele v ciljnem okolju enaka kot v izvirnem okolju, deluje.

Če uporabljaš zunanjo tabelo iz drugega okolja (prek Change Environment), potem Power Apps predpostavlja, da želiš vedno uporabljati točno isto tabelo. Potrebuješ okoljsko spremenljivko, če želiš, da je ta zunanja tabela druga zunanja tabela, ko prehajaš iz razvoja v testno ali produkcijsko skupino. Najlažje je dovoliti, da Power Apps samodejno ustvari spremenljivko okolja namesto vas. (Če ste tabelo predhodno dodali svoji aplikaciji, nato vklopite stikalo za nastavitve, spustite zunanjo tabelo in jo dodajte nazaj.)

Ko v aplikacijo dodate zunanjo tabelo, izberite zavihek Napredno , da izberete spremenljivko okolja.

SharePoint

SharePoint podpira le povezave z Microsoft Entra. Tako je za SharePoint poleg veljavne povezave potrebna ločena spremenljivka okolja za Site in List.

Za uspešno uporabo okoljskih spremenljivk s seznami SharePoint:

• Prikazno ime in logično ime za vsak ustrezen stolpec v izvornem in ciljnem okolju se morata ujemati.
• Okoljske spremenljivke za SharePoint morajo imeti ustrezne metapodatke. SharePoint ima notranje identifikatorje, ki se morda ne ujemajo med ciljnimi okolji. Če na primer ustvarite seznam z istim imenom in stolpci v ciljnem okolju, se notranja imena ne bodo ujemala. Metapodatki se vedno ujemajo, če podvojite SharePoint stran in jo kopirate v ciljno okolje.

SQL Server

SQL Server podpira različne vrste avtentikacije in povezav. Uporabljajte okoljske spremenljivke za Microsoft Entra povezave. Za strežnik in bazo podatkov je potrebna ločena spremenljivka okolja. Aplikacija je vezana na določena imena tabel, zato se domneva, da so enaka med okolji.

Ne uporabljajte okoljskih spremenljivk za skupne povezave, kot je osnovna SQL avtentikacija s SQL Server. Uporabite reference povezav za informacije, ki se tradicionalno prenašajo kot del connection string. Osnovni SQL parametri avtentikacije so vsi del connection string. Ime strežnika in zbirke podatkov je na primer na voljo pri ustvarjanju povezave in zato vedno izhaja iz povezave.

Spremenljivke okolja virov podatkov se uporabljajo za konektorje z avtentikacijo, kot je Microsoft Entra. Pri takšnih povezavah ima Power Apps le identificiranega uporabnika. Power Apps ne more iz povezave izpeljati, s katero storitvijo ali tabelo želite delati.

Vnesite nove vrednosti med uvozom rešitev

Sodoben vmesnik za uvoz rešitev vključuje možnost vnosa vrednosti za spremenljivke okolja. To nastavi lastnost vrednosti v environmentvariablevalue tabeli.

Vrednosti spremenljivk okolja so vidne pri uvažanju rešitev ali pri uporabi cevovodov za uvajanje. Spremenljivke okolja brez privzete vrednosti ali vrednosti zahtevajo vrednost, tiste sicer pa so vnaprej izpolnjene z oznako pod besedilnim območjem, ki označuje izvor vrednosti: vrednost rešitve, vrednost ciljnega okolja ali privzeto vrednost.

opomba,

• V nekaterih primerih se lahko za določene vrednosti spremenljivke okolja podatkovnega vira prikaže opozorilo Dostop zavrnjen če izdelovalec uvoza nima dostopa do povezave ali vira, uporabljenega za spremenljivko okolja. To je opozorilo, ki ne blokira, vendar je nekaj, kar morate upoštevati glede na to, kako nameravate uporabiti spremenljivko okolja v ciljnem okolju.
• Vrednost lahko odstranite iz svoje rešitve, preden izvozite rešitev. To zagotavlja, da obstoječa vrednost ostane v vašem razvojnem okolju, vendar ne bo izvožena v rešitev. Ta pristop omogoča zagotovitev nove vrednosti med uvozom rešitve v druga okolja. Več informacij: Kako odstranim vrednost iz spremenljivke okolja?

Notifications

Obvestilo se prikaže, če spremenljivke okolja nimajo nobenih vrednosti. Vrednosti nastavite tako, da komponente, odvisne od spremenljivk okolja, ne odpovejo.

Varnost

Tabela environmentvariabledefinition je v lasti uporabnika ali ekipe. Ko ustvarite aplikacijo, ki uporablja spremenljivke okolja, pazite, da dodelite uporabnikom primerno raven pravic za to tabelo. Dovoljenje za environmentvariablevalue tabelo je podedovano od nadrejene environmentvariabledefinition tabele in zato ne zahteva ločenih privilegijev. Privilegiji za environmentvariabledefinition tabele so privzeto vključeni v varnostni vlogi Environment Maker in Basic User. Več informacij: Varnost v Dataverse.

Poimenovanje

Zagotovite edinstvenost imen spremenljivk okolja, da je omogočeno natančno sklicevanje. Podvojena prikazna imena spremenljivk okolja otežujejo razlikovanje in uporabo spremenljivk okolja. Zagotovite edinstvenost imen spremenljivk okolja, da je omogočeno natančno sklicevanje. Imeni $authentication in $connection sta posebej rezervirana parametra za tokove in se jima je treba izogibati. Shranjevanje poteka je blokirano, če se uporabljajo spremenljivke okolja s temi imeni. Če je spremenljivka okolja uporabljena v toku in je prikazano ime spremenljivke okolja spremenjeno, potem načrtovalec prikaže tako stare kot nove žetone prikazanega imena za pomoč pri identifikaciji. Pri posodabljanju toka priporočamo, da odstranite sklic na spremenljivko okolja in ga znova dodate.

Trenutne omejitve

• Preverjanje vrednosti spremenljivk okolja se izvede znotraj uporabniških vmesnikov in komponent, ki jih uporabljajo, ne pa tudi znotraj okolja Dataverse. Zato zagotovite, da so nastavljene ustrezne vrednosti, če jih spreminjate s kodo.
• Power Platform Naloge Build Tools še niso na voljo za upravljanje spremenljivk okolja vira podatkov. Vendar to ne predstavlja ovire za njihovo uporabo v orodjih, ki jih zagotavlja Microsoft, in v sistemih za upravljanje virov.
• Interakcija s spremenljivkami okolja prek kode po meri zahteva klic API za pridobitev vrednosti; ni izpostavljenega predpomnilnika za uporabo kode, ki ni Microsoftova.
• Spremenljivke okolja so omejene na največ 2000 znakov.

Pogosta vprašanja

Zakaj ne vidim vrednosti za svojo spremenljivko okolja?

Če je spremenljivka okolja v upravljani rešitvi, vrednosti ne boste mogli videti, razen če pogledate v Privzeto rešitev. To vedenje je načrtovano, saj je vrednost spremenljivke okolja neupravljana prilagoditev.

Kako si lahko ogledam, kje se uporabljajo spremenljivke okolja?

Bodisi z izbiro Pokaži odvisnosti v vmesniku rešitve, med avtorskim delom komponent ali v nadzoru vira in v datoteki rešitve z ogledom metapodatkov aplikacije ali toka.

Ali so spremenljivke okolja vira podatkov enake povezavam?

Ne. Čeprav sta povezani, povezava predstavlja poverilnico ali avtentikacijo, potrebno za interakcijo s konektorjem. Spremenljivke okolja vira podatkov hranijo parametre, ki jih zahteva eno ali več dejanj v povezovalniku, in ti parametri se pogosto razlikujejo glede na dejanje. Na primer, povezava SharePoint Online ne shranjuje nobenih informacij o spletnih straneh, seznamih ali knjižnicah dokumentov. Zato je za klic konektorja potrebna veljavna povezava in še nekaj parametrov.

Ali lahko moj avtomatizirani prodajni lijak ALM uporablja datoteke z različnimi vrednostmi za različna okolja?

Da. Orodje za pakiranje rešitve sprejme ime datoteke kot vhodni parameter, tako da lahko vaš prodajni lijak v rešitev zapakira datoteko z različnimi vrednostmi, odvisno od vrste okolja, v katerem se izvaja.

Ali naj vrednost vključim v svojo rešitev?

Ne. Spremenljivke okolja so namenjene uporabi v aplikacijah, ki morajo imeti različne vrednosti v različnih okoljih, kjer je rešitev nameščena. Definicije spremenljivk okolja bi morale biti vključene v vašo rešitev, vendar bi morale biti vrednosti podane za ciljno okolje med razmestitvijo. Zaradi tega vedenja je definicija spremenljivke okolja upravljani objekt rešitve v ciljnem okolju, medtem ko je spremenljivka okolja neupravljan zapis.

Zakaj ne morem izbrisati vrednosti v svojem okolju?

Če je bila vrednost vključena v upravljano rešitev, je edini način za izbris vrednosti ta, da posodobite rešitev v izvornem okolju, da izključite vrednost, nato izvozite novo različico rešitve. To novo različico je nato mogoče uvoziti v okolje z operacijo nadgradnje (ne posodobitve), zaradi česar se zapis vrednosti izbriše.

Kaj se zgodi, če nekdo nehote izbriše vrednost?

Če tega še ni preprečil sistem odvisnosti, izvajalno okolje uporabi zadnjo znano vrednost kot nadomestno.

Kdaj bo uporabljena nova vrednost v aplikacijah s platnom in tokovih za oblak, če se vrednost spremeni?

Popolna objava posodobljenih spremenljivk okolja lahko traja do eno uro, ker je vrednost potisnjena v aplikacije in teče asinhrono.

Ali je treba obvezno imeti naročniško licenco?

Ne. Medtem ko ALM zahteva Dataverse (ali aplikacije Dynamics 365), uporaba premium konektorjev ni potrebna. Izjema je le, če uporabljate povezovalnik Dataverse za interakcijo s spremenljivkami okolja, kot bi ga z drugimi zapisi podatkov, na primer računi ali stiki. Prej je bil to edini način uporabe spremenljivk okolja v aplikacijah s platnom in tokovih.

Ali obstaja omejitev števila spremenljivk okolja, ki jih lahko imam?

Ne. Največja mogoča velikost rešitve pa je 95 MB. Več informacij: Ustvarite rešitev

Ali lahko spremenljivka okolja prikazuje imena in ali so lahko opisi lokalizirani?

Da.

Ali naj namesto shranjevanja konfiguracijskih podatkov v tabelah po meri uporabim spremenljivke okolja?

Da, vendar le če vaši konfiguracijski podatki niso povezani. Spremenljivke okolja je treba uporabiti za pare ključnih vrednosti in kadar se mora vrednost razlikovati v drugih okoljih. Druga orodja, kot je orodje za selitev konfiguracije, so bolj primerna za selitev relacijskih konfiguracijskih podatkov, shranjenih v tabelah po meri. V nasprotju z drugimi konfiguracijskimi podatki se spremenljivke okolja preselijo znotraj rešitev, zato so veliko enostavnejše za upravljanje in zmogljivejše za uvoz.

Zakaj moja povezava ni shranjena za spremenljivke okolja vira podatkov?

Povezave se uporabljajo samo za ustvarjanje uporabniškega vmesnika. Na primer, za pridobitev prijaznih imen za SharePoint sezname, povezane s spletnim mestom. Ko urejate spremenljivko okolja vira podatkov, se prepričajte, da ste izbrali povezavo z dostopom do vira podatkov. Če nimate več dostopa do povezave, lahko ročno vnesete vrednost. Na primer, vnesite URL SharePoint strani ali edinstveni identifikator (GUID) za seznam.

Ko je za posamezno spremenljivko okolja (vrsta podatkovnega vira) na voljo več povezav, obstaja pristranska izvedba za izbiro prve povezave na seznamu povezav. Ker je navadno samo ena povezava povezana s spremenljivko okolja, tega običajno ni treba preveriti. Poleg tega je z nedavnimi spremembami vidnosti vrednosti spremenljivke okolja to lažje preveriti pri uvozu.

Kako iz spremenljivke okolja odstraniti vrednost?

Pred izvozom rešitve boste morda iz nje želeli odstraniti vrednost spremenljivke okolja. Nato obstoječa vrednost ostane v vašem razvojnem okolju, vendar se ne izvozi v rešitev. Ta pristop omogoča, da je pri uvozu rešitve v drugo okolje zagotovljena nova vrednost.

Če želite odstraniti vrednost, upoštevajte naslednje korake:

1. V rešitvi, v kateri se nahaja spremenljivka okolja, izberite spremenljivko okolja in prikazale se bodo lastnosti.

2. Pod Trenutna vrednost izberite ...>Odstrani iz te rešitve.

   

Ali lahko v povezovalnikih po meri uporabljam spremenljivke okolja?

Da. Podpora za spremenljivke okolja v spojnikih po meri

Glejte tudi

Uporaba spremenljivk okolja vira podatkov v aplikacijah platna
Uporabite okoljske spremenljivke v Power Automate oblačnih tokovih
EnvironmentVariableDefinition tabela/referenca na entiteto
Web API vzorci
Uporabite okoljske spremenljivke podatkovnega vira v Canvas aplikacijah
Uporabite okoljske spremenljivke v Power Automate Cloud Flows
Uporabite Azure Key Vault secrets
Podpora za okoljske spremenljivke v prilagojenih konektorjih
Power Apps Blog: Okoljske spremenljivke so na voljo v predogledu!