Variabile de mediu pentru Power Platform vizualizare generală

Variabilele de mediu permit scenariul de bază al managementului ciclului de viață al aplicației (ALM) de mutare a unei aplicații între Power Platform medii. În acest scenariu, aplicația rămâne exact aceeași, cu excepția câtorva referințe cheie ale aplicației externe (cum ar fi tabele, conexiuni și chei) care sunt diferite între mediul sursă și mediul destinație. Aplicația cere ca structura tabelelor sau conexiunilor să fie exact aceeași între mediul sursă și cel de destinație, cu unele diferențe. Variabilele de mediu vă permit să specificați care dintre aceste referințe externe diferite ar trebui actualizate pe măsură ce aplicația este mutată în medii.

Variabilele de mediu stochează cheile și valorile parametrilor, care servesc apoi ca intrare pentru diferite alte obiecte ale aplicației. Separarea parametrilor de obiectele consumatoare vă permite să modificați valorile din același mediu sau atunci când migrați soluțiile în alte medii. Alternativa este lăsarea valorilor parametrilor codificați greu în componentele care îi utilizează. Acest lucru este adesea problematic; mai ales atunci când valorile trebuie modificate în timpul operațiunilor ALM. Deoarece variabilele de mediu sunt componente ale soluției, puteți transporta referințele (cheile) și puteți modifica valorile atunci când soluțiile sunt migrate în alte medii.

Notă

Abia acum sunt implementate noi capacități pentru sursele de date și este posibil să nu fie disponibile încă în regiunea dvs.

Avantajele utilizării variabilelor de mediu:

• Furnizați valori noi ale parametrilor în timp ce importați soluții către alte medii.
• Stocați configurația pentru surse de date utilizate în aplicații și fluxuri de tip pânză. De exemplu, parametrii site-ului și ai listei online SharePoint pot fi stocați ca variabile de mediu; prin urmare, permițându-vă să vă conectați la diferite site-uri și liste în medii diferite, fără a fi nevoie să modificați aplicațiile și fluxurile.
• Împachetați și transportați personalizarea și configurația împreună și gestionați-le într-o singură locație.
• Împachetați și transportați secrete, cum ar fi acreditările utilizate de diferite componente, separat de componentele care le folosesc.
• O variabilă de mediu poate fi utilizată în mai multe componente diferite ale soluției - indiferent dacă este același tip de componentă sau componente diferite. De exemplu, o aplicație de tip pânză și un flux pot utiliza aceeași variabilă de mediu. Când valoarea variabilei de mediu trebuie să se schimbe, trebuie doar să schimbați o valoare.
• În plus, dacă trebuie să retrageți un sursă de date în medii de producție, puteți actualiza valorile variabilei de mediu cu informații pentru noul sursă de date. Aplicațiile și fluxurile nu necesită modificare și încep să folosească noul sursă de date.
• Susținut de SolutionPackager și DevOps instrumentele permit integrarea continuă și livrarea continuă (CI/CD).
• Variabilele de mediu pot fi despachetate și stocate în controlul sursei. De asemenea, puteți stoca diferite fișiere de valori ale variabilelor de mediu pentru configurația separată necesară în diferite medii. Solution Packager poate accepta apoi fișierul corespunzător mediului în care este importată soluția.

Cum funcționează variabilele de mediu?

Variabilele de mediu pot fi create și modificate în interfața modernă a soluției, create automat la conectarea la anumite surse de date în aplicațiile tip soluție sau prin folosirea codului. De asemenea, pot fi importate într-un mediu prin intermediul soluțiilor. Odată ce variabilele de mediu sunt prezente într-un mediu, ele pot fi folosite ca intrări atunci când creați aplicații canvas, Power Automate fluxuri, când dezvoltați pluginuri și multe alte locuri, cum ar fi adăugarea unui Power BI tabloul de bord la o aplicație bazată pe model. Atunci când aceste tipuri de obiecte utilizează variabile de mediu, valorile sunt apoi derivate din variabilele de mediu și pot fi modificate atunci când soluțiile sunt importate în alte medii.

Creați o variabilă de mediu într-o soluție

1. Conectați-vă la Power Apps (make.powerapps.com) și apoi, din panoul de navigare din stânga, selectați Soluții. Dacă elementul nu se află în panoul lateral, selectați …Mai multe, apoi selectați elementul dorit.
2. Deschideți soluția dorită sau creați una nouă.
3. Pe bara de comenzi, selectați Nou > Mai multe și apoi selectați Variabilă de mediu.
4. În panoul din dreapta, completați următoarele coloane, apoi selectați Salvați:

   • Nume afișat Introduceți un nume pentru variabila de mediu.

   • Nume. Numele unic este generat automat din Numele afișat, dar îl puteți schimba.

   • Tip de date. Alegeți dintre Număr zecimal, Text, JSON, Două opțiuni, Sursă de date sau Secret.

     Notă

     • Dacă Sursă de date este tipul selectat, va trebui, de asemenea, să selectați conector, un conector valabil pentru conectorul selectat și tipul de parametru. Cu toate acestea, conexiunea nu este stocată ca parte a variabilei de mediu. Conexiunea este utilizată numai pentru preluarea valorilor parametrilor disponibile, cum ar fi site-urile SharePoint la care aveți acces sau listele asociate unui site. Pentru anumiți parametri precum liste SharePoint, va trebui, de asemenea, să selectați o variabilă de mediu părinte sursă de date, cum ar fi site-ul SharePoint. Odată salvate, acestea vor fi corelate în baza de date.
     • Dacă Secret este tipul selectat, sunt necesare informații suplimentare pentru setarea și configurarea Azure Key Vault pentru a permite Power Platform să acceseze secretul.

   • Valoare curentă. Cunoscută și sub numele de valoare. Această proprietate este opțională și face parte din tabelul valorilor variabilelor de mediu. Când o valoare este prezentă, este utilizată, chiar dacă este prezentă și o valoare implicită. Eliminați valoarea din soluția dvs. dacă nu doriți să o utilizați în următorul mediu. Valorile sunt, de asemenea, separate în fișiere JSON separate în fișierul exportat solution.zip și pot fi editate offline. Mai multe informații: Cum elimin o valoare dintr-o variabilă de mediu?

   • Valoare implicită. Această coloană face parte din tabelul de definire a variabilelor de mediu și nu este necesară. Valoarea implicită este utilizată dacă nu există o valoare curentă.

     Separarea valorii implicite și a valorii curente vă permite să întrețineți definiția și valoarea implicită separat de valoare. De exemplu, un editor de aplicații își poate afișa oferta pe AppSource cu o valoare prestabilită. Apoi, opțional, clientul poate oferi o nouă valoare. Când editorul aplicației publică actualizări ale aplicației, valoarea setată de client nu este suprascrisă.

     

     Notă

     O valoare nu poate exista fără o definiție. Interfața permite doar crearea unei valori pe definiție.

Introduceți valori noi în timp ce importați soluții

Interfața modernă de import a soluției include posibilitatea de a introduce valori pentru variabilele de mediu. Aceasta setează proprietatea valorii pe tabelul environmentvariablevalue.

Începând cu o actualizare din 7 decembrie 2023, toate valorile variabilelor de mediu sunt vizibile atunci când se importă soluții (sau când se folosește Pipelines pentru a implementa). Variabilele de mediu fără o valoare sau o valoare implicită vor fi solicitate pentru o valoare, dar cele altfel sunt precompletate cu o etichetă sub zona de text care indică sursa valorii: valoarea soluției, valoarea mediului țintă sau valoarea implicită.

Notă

• În unele cazuri, pentru anumite valori ale variabilei de mediu sursă de date, poate apărea un avertisment Acces refuzat dacă producătorul importator nu are acces la conexiunea sau la sursa utilizată pentru variabila de mediu. Acesta este un avertisment neblocant, dar de care trebuie să țineți cont, în funcție de modul în care intenționați să utilizați variabila de mediu în mediul țintă.
• Puteți elimina valoarea din soluția dvs. înainte de a exporta soluția. Acest lucru asigură că valoarea existentă va rămâne în mediul dvs. de dezvoltare, dar nu va fi exportată în soluție. Această abordare permite furnizarea unei noi valori în timp ce importați soluția în alte medii. Mai multe informații: Cum elimin o valoare dintr-o variabilă de mediu?

Notificări

O notificare este afișată atunci când variabilele de mediu nu au valori. Acesta este un memento pentru a seta valorile astfel încât componentele dependente de variabilele de mediu să nu eșueze.

Securitate

Tabelul environmentvariabledefinition este utilizator sau echipă deținută. Când creați o aplicație care utilizează variabile de mediu, asigurați-vă că atribuiți utilizatorilor nivelul adecvat de privilegii pentru acest tabel. Permisiunea pentru tabelul environmentvariablevalue este moștenită de la tabelul părinte environmentvariabledefinition și, prin urmare, nu necesită privilegii separate. Privilegiile pentru tabelele environmentvariabledefinition sunt incluse implicit în rolurile de securitate Creator de mediu și Utilizator simplu. Informații suplimentare: Securitate în Dataverse.

Denumire

Asigurați-vă că numele variabilelor de mediu sunt unice, astfel încât să poată fi menționate cu precizie. Numele de afișare duplicate ale variabilelor de mediu fac variabilele de mediu dificil de diferențiat și de utilizat. Asigurați-vă că numele variabilelor de mediu sunt unice, astfel încât să poată fi menționate cu precizie. Numele $authentication și $connection sunt parametri special rezervați pentru debite și trebuie evitate. Salvarea fluxului este blocată dacă sunt utilizate variabile de mediu cu aceste nume. Dacă o variabilă de mediu este utilizată într-un flux și numele afișat al variabilei de mediu este schimbat, atunci designerul arată atât simbolurile vechi, cât și cele noi, pentru a ajuta la identificare. Când actualizați fluxul, vă recomandăm să eliminați referința variabilei de mediu și să o adăugați din nou.

Limitări actuale

• Validarea valorilor variabilelor de mediu are loc în interfețele utilizatorului și în componentele care le utilizează, dar nu în interiorul Dataverse. Prin urmare, asigurați-vă că valorile corespunzătoare sunt setate dacă sunt modificate prin cod.
• Activitățile Power Platform Build Tools nu sunt încă disponibile pentru gestionarea variabilelor de mediu sursă de date. Cu toate acestea, acest lucru nu le blochează utilizarea în cadrul instrumentelor furnizate de Microsoft și în cadrul sistemelor de control al sursei.
• Interacțiunea cu variabilele de mediu prin cod personalizat necesită un apel API pentru a prelua valorile; nu există un cache expus pentru utilizarea codului non-Microsoft.
• Pentru a utiliza cu succes variabilele de mediu cu SharePoint liste, numele afișat și numele logic pentru fiecare coloană corespunzătoare din mediile sursă și țintă trebuie să se potrivească.
• Variabilele de mediu sunt limitate la maximum 2.000 de caractere.

Întrebări frecvente

De ce nu pot vedea valoarea pentru variabila mea de mediu?

Dacă variabila de mediu se află într-un soluție gestionată, nu veți putea vedea valoarea decât dacă priviți în interiorul Soluția implicită. Acest comportament este prin proiectare, deoarece valoarea variabilei de mediu este o personalizare negestionată.

Cum pot vedea unde sunt utilizate variabilele de mediu?

Fie prin selectare Afișați dependențe în interfața soluției, în timp ce creați componente sau în controlul sursei și în fișierul soluției vizualizând aplicația sau metadatele fluxului.

Sunt variabilele de mediu sursă de date la fel ca conexiunile?

Nu. Deși sunt legate, o conexiune reprezintă o acreditare sau o autentificare necesară pentru a interacționa cu conectorul. Variabilele sursă de date de mediu stochează parametrii necesari pentru una sau mai multe acțiuni în conector și acești parametrii variază adesea în funcție de acțiune. De exemplu, o conexiune online SharePoint nu stochează nicio informație despre site-uri, liste sau biblioteci de documente. Prin urmare, apelarea conectorului necesită atât o conexiune validă, cât și câțiva parametri suplimentari.

Variabilele de mediu sursă de date pot fi utilizate cu conexiuni partajate, cum ar fi SQL Server cu autentificare SQL?

În general nu. Conexiunile partajate cu SQL Server stochează parametrii necesari pentru conectarea la date în cadrul conexiunii. De exemplu, numele serverului și bazei de date sunt furnizate la crearea conexiunii și, prin urmare, sunt întotdeauna derivate din conexiune.

Variabilele de mediu sursă de date sunt folosite pentru conectorii care se bazează pe autentificarea bazată pe utilizator, cum ar fi Microsoft Entra ID, deoarece parametrii nu pot fi derivați din conexiune. Din aceste motice, autentificarea cu SQL Server, care este o conexiune partajată, nu va utiliza variabile de mediu sursă de date.

Poate canalul meu automat ALM să utilizeze fișiere de valori diferite pentru medii diferite?

Da. Pachetul de soluții acceptă numele fișierului ca parametrii de intrare, astfel încât canalul dvs. poate să împacheteze un fișier de valori diferite în soluție, în funcție de tipul de mediu pe care îl execută.

Ce se întâmplă dacă cineva șterge din greșeală o valoare?

Dacă nu este deja împiedicat de sistemul de dependență, runtime folosește ultima valoare cunoscută ca alternativă.

Dacă se schimbă o valoare, când se utilizează noua valoare în aplicațiile de tip pânză și fluxurile pentru cloud?

Publicarea completă a variabilelor de mediu actualizate poate dura până la o oră, deoarece valoarea este introdusă în aplicații și curge asincron.

Sunt necesare licențe premium?

Nu. În timp ce ALM necesită Dataverse (sau Dynamics 365 for Customer Engagement), nu este necesară utilizarea conectorilor premium. Singura limitare este, dacă utilizați conectorul Dataverse pentru a interacționa cu variabilele de mediu așa cum ați face cu alte înregistrări de date, cum ar fi conturi sau contacte. Anterior, acesta era singurul mod de a utiliza variabilele de mediu în aplicațiile și fluxurile de pânză.

Există o limită a numărului de variabile de mediu pe care le pot avea?

Nu. Cu toate acestea, dimensiunea maximă a unei soluții este de 120 MB. Mai multe informații: Creați o soluție

Pot fi localizate numele și descrierile afișate ale variabilelor de mediu?

Da.

Ar trebui să folosesc variabile de mediu în loc să stochez date de configurare în tabele personalizate?

Da, dacă datele de configurare nu sunt relaționale. Variabilele de mediu ar trebui utilizate pentru perechi cheie: valori și atunci când valoarea probabilă trebuie să fie diferită în alte medii. Alte instrumente, cum ar fi utilitarul de migrare al configurației, sunt mai potrivite pentru migrarea datelor de configurație relațională stocate în tabele personalizate. Spre deosebire de alte date de configurare, variabilele de mediu sunt migrate în cadrul soluțiilor și, prin urmare, mult mai simplu de gestionat și mai performant de importat.

De ce este atribuită automat o valoare de conexiune diferită de cea pe care o vreau la import?

În unele cazuri în care există mai multe conexiuni disponibile pentru o singură variabilă de mediu (tip sursă de date), există o implementare prin proiectare pentru a selecta prima conexiune din lista de conexiuni disponibile pentru variabila de mediu. Deoarece există de obicei o singură conexiune asociată cu o variabilă de mediu, acesta nu este ceva care de obicei trebuie validat. În plus, odată cu modificările recente ale vizibilității valorii variabilelor de mediu, acest lucru este mai ușor de validat la import.

Cum elimin o valoare dintr-o variabilă de mediu?

Este posibil să doriți să eliminați valoarea unei variabile de mediu din soluția dvs. înainte de a exporta soluția. Apoi, valoarea existentă rămâne în mediul dumneavoastră de dezvoltare, dar nu este exportată în soluție. Această abordare permite furnizarea unei noi valori în timp ce importați soluția într-un alt mediu.

Pentru a elimina valoarea, urmați acești pași:

1. În soluția în care se află variabila de mediu, selectați variabila de mediu pentru a afișa proprietățile.

2. Sub Valoarea curentă, selectați ... > Eliminați din această soluție.

   

Pot folosi variabile de mediu în conectori particularizați?

Da. Compatibilitatea variabilelor de mediu cu conectorii particularizați

Consultați și

Utilizați variabilele de mediu sursă de date în aplicațiile canvas
Utilizați variabilele de mediu în Power Automate fluxurile de soluții cloud
Referință tabel/entitate EnvironmentVariableDefinition
Eșantioane pentru API web
Utilizați variabilele de mediu sursă de date în aplicațiile Canvas
Utilizați variabilele de mediu în Power Automate fluxurile de soluții cloud
Utilizați secretele Azure Key Vault
Compatibilitatea variabilelor de mediu cu conectorii particularizați
Blog Power Apps: Variabile de mediu disponibile în previzualizare!

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).