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. To je pogosto problematično; 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.

Opomba

Nove zmogljivosti za vire podatkov se trenutno še uvajajo in morda še ne bodo na voljo v vaši regiji.

Prednosti uporabe spremenljivk okolja:

• Zagotovite nove vrednosti parametrov med uvažanjem rešitev v druga okolja.
• Shranite konfiguracijo za uporabljene vire podatkov v aplikacijah s platnom in tokovih. Parametre spletnega mesta SharePoint Online in seznama lahko shranite kot spremenljivke okolja; s tem boste omogočili povezovanje na različna spletna mesta in sezname v različnih okoljih, ne da bi bilo treba 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 spremenljivk okolja z informacijami za novi vir podatkov. Programov in tokov ni treba spreminjati in začnite uporabljati novi vir podatkov.
• Orodja, ki jih podpirata SolutionPackager in DevOps, omogočajo stalno integracijo in izvajanje.
• 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, samodejno ustvariti pri povezovanju z določenimi viri podatkov v aplikacijah s platnom ali z uporabo kode. Prav tako jih je mogoče uvoziti v okolje prek rešitev. Ko so spremenljivke okolja prisotne v okolju, jih je mogoče uporabiti kot vnose pri ustvarjanju aplikacij za platno, Power Automate tokov, pri razvoju vtičnikov in na mnogih drugih mestih, kot je dodajanje Power BI nadzorno ploščo v aplikacijo, ki temelji na modelu. Kadar te vrste predmetov uporabljajo spremenljivke okolja, se vrednosti izpeljejo iz spremenljivk okolja in jih je mogoče spremeniti, ko se rešitve uvažajo v druga okolja.

Ustvarjanje spremenljivke okolja v rešitvi

1. Vpišite se v storitev Power Apps (make.powerapps.com), in v levem podoknu izberite Rešitve. Če elementa ni v podoknu leve plošče, 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 izberite Shrani:

   • Prikazano ime. Vnesite ime za spremenljivko okolja.

   • Ime. Enolično ime je samodejno ustvarjeno iz možnosti Prikazno ime, vendar ga lahko spremenite.

   • Vrsta podatkov. Izberite eno od možnosti Decimalno število, Besedilo, JSON, Dve možnosti, Vir podatkov, ali Skrivnost.

     Opomba

     • Če je izbrana vrsta Vir podatkov, boste morali izbrati tudi povezovalnik, veljavno povezavo za izbrani povezovalnik in vrsto parametra. Vendar povezava ni shranjena kot del spremenljivke okolja. Povezava se uporablja samo za pridobivanje razpoložljivih vrednosti parametrov, kot so spletna mesta SharePoint, do katerih imate dostop, ali seznamov, povezanih s spletnim mestom. Za nekatere parametre, kot so seznami SharePoint, boste morali izbrati tudi nadrejeno spremenljivko okolja vira podatkov, kot je spletno mesto SharePoint. Ko bodo shranjeni, bodo povezani v zbirko podatkov.
     • Če je Skrivnost izbrana vrsta, so dodatne informacije potrebne za nastavitev in konfiguracijo Azure Key Vault z namenem dovoliti storitvi Power Platform dostop do skrivnosti.

   • Trenutna vrednost. Znana tudi kot vrednost. Ta lastnost ni obvezna in je del tabele z vrednostjo spremenljivke okolja. Ko je vrednost prisotna, 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 iz spremenljivke okolja odstraniti vrednost?

   • 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, izdajatelj aplikacije lahko navede svojo ponudbo na AppSource s 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.

Vnesite nove vrednosti med uvozom rešitev

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

Od posodobitve 7. decembra 2023 so vse vrednosti spremenljivk okolja vidne pri uvažanju rešitev (ali pri uporabi cevovodov za uvajanje). Spremenljivke okolja brez privzete vrednosti ali vrednosti bodo pozvane k vnosu vrednosti, tiste, ki so 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 vir podatkov 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 iz rešitve odstranite še pred izvozom rešitve. S tem boste zagotovili, da bo obstoječa vrednost ostala v vašem razvojnem okolju, vendar ne bo izvožena v rešitvi. Ta pristop omogoča zagotovitev nove vrednosti med uvozom rešitve v druga okolja. Več informacij: Kako iz spremenljivke okolja odstraniti vrednost?

Obvestila

Obvestilo se prikaže, če spremenljivke okolja nimajo nobenih vrednosti. To je opomnik, da nastavite vrednosti tako, da komponente, odvisne od spremenljivk okolja, ne bodo neuspele.

Varnost

Lastnik tabele environmentvariabledefinition je uporabnik ali ekipa. Ko ustvarite aplikacijo, ki uporablja spremenljivke okolja, pazite, da dodelite uporabnikom primerno raven pravic za to tabelo. Dovoljenje za tabelo environmentvariablevalue je podedovan od nadrejene tabele environmentvariabledefinition in zato ne zahteva ločenih privilegijev. Privilegiji za tabele environmentvariabledefinition so privzeto vključeni v varnostne vloge Ustvarjalca okolja in Osnovnega uporabnika. Več informacij: Varnost v storitvi 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 posebna parametra za tokove in se jim je treba izogibati. Shranjevanje poteka je blokirano, če se uporabljajo spremenljivke okolja s temi imeni. Če je spremenljivka okolja uporabljena v toku in je spremenljivka okolja prikazno ime spremenjena, potem načrtovalec prikaže stare in nove žetone prikazno ime 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.
• Opravila Power Platform 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.
• Za uspešno uporabo spremenljivk okolja s seznami SharePoint se morata prikazno ime in logično ime za vsak ustrezen stolpec v izvornem in ciljnem okolju ujemati.
• Spremenljivke okolja so omejene na največ 2000 znakov.

Pogosto zastavljena vprašanja

Zakaj ne vidim vrednosti za svojo spremenljivko okolja?

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

Kako si lahko ogledam, kje se uporabljajo spremenljivke okolja?

Bodisi tako, da izberete Pokaži odvisnosti v vmesniku rešitve med ustvarjanjem komponent, ali v kontrolniku 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. Povezava SharePoint Online na primer ne hrani nobenih informacij o spletnih mestih, seznamih ali knjižnicah dokumentov. Zato klic konektorja zahteva veljavno povezavo in nekatere dodatne parametre.

Ali je mogoče spremenljivke okolja vira podatkov uporabiti s povezavami v skupni rabi, kot je SQL Server s preverjanjem pristnosti SQL?

Praviloma ne. Povezavi v skupni rabi s strežnikom SQL Server shranjenjujo parametre, potrebne za povezavo s podatki znotraj povezave. Ime strežnika in zbirke podatkov je na primer na voljo pri ustvarjanju povezave in zato vedno izhaja iz povezave.

Spremenljivke okolja vir podatkov se uporabljajo za konektorje, ki se zanašajo na avtentikacijo na podlagi uporabnika, kot je Microsoft Entra ID, ker parametrov ni mogoče izpeljati iz povezave. Zaradi teh razlogov preverjanje prisotnosti s strežnikom SQL, ki je skupna povezava, ne bo uporabljala spremenljivke okolja vira podatkov.

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.

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 uporabo Dataverse (ali Dynamics 365 for Customer Engagement), uporaba naročniških povezovalnikov 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 120 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 je pri uvozu samodejno dodeljena druga vrednost povezave od tiste, ki jo želim?

V nekaterih primerih, ko je za eno samo spremenljivko okolja (vrsta vira podatkov) na voljo več povezav, obstaja implementacija pri načrtovanju, da se izbere prva povezava na seznamu povezav, ki so na voljo za spremenljivko okolja. 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 možnostjo Trenutna vrednost izberite ... > Odstrani iz te rešitve.

   

Ali lahko v povezovalnikih po meri uporabljam spremenljivke okolja?

Da. Podpora za spremenljivke okolja v povezovalnikih po meri

Glejte tudi

Uporabite spremenljivke okolja vir podatkov v aplikacijah platna
Uporabite spremenljivke okolja v Power Automate tokovi oblaka rešitev
Sklic za tabelo/entiteto EnvironmentVariableDefinition
Vzorci spletnega API-ja
Uporabite spremenljivke okolja vir podatkov v aplikacijah Canvas
Uporabite spremenljivke okolja v Power Automate tokovi oblaka rešitev
Uporabite skrivnosti Azure Key Vault
Podpora za spremenljivke okolja v povezovalnikih po meri
Spletni dnevnik Power Apps: spremenljivke okolja, ki so na voljo v predogledu!

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).