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 noi valori ale parametrilor în timp ce importați soluții în alte medii.
• Stocați configurația pentru sursele de date utilizate în aplicațiile și fluxurile planșă de lucru. 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.
• Sprijinite de instrumentele SolutionPackager și DevOps permite 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 cadrul interfeței soluției moderne, create automat la conectarea la anumite surse de date în aplicațiile planșă de lucru sau folosind codul. 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 planșă de lucru, Power Automate fluxuri, când dezvoltați pluginuri și multe alte locuri, cum ar fi adăugarea unui Power BI tabloul de bord către 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), apoi în panoul din stânga selectați Soluții. Dacă articolul nu se află în panoul panoului lateral, selectați …Mai multe și apoi selectați elementul dorit.
2. Deschideți soluția dorită sau creați una nouă.
3. Pe bara de comandă, selectați Nou>Mai multe, apoi selectați Variabila de mediu.
4. În panoul din dreapta, completați următoarele coloane, apoi selectați Salvare:

   • 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 modifica.

   • Tip de date. Selectaț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 să selectați, de asemenea, conector, un conexiune 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ă tipul selectat este Secret , sunt necesare informații suplimentare pentru a configura și configura Azure Key Vault pentru a permite Power Platform să acceseze secretul.

   • Valoarea curentă. Cunoscută și sub numele de valoare. Această proprietate este opțională și face parte din tabelul valorilor variabilelor de mediu. Când este prezentă o valoare, 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 valoare 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 deținut de utilizator sau echipă. 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 environmentvariablevalue tabel este moștenită din tabelul părinte environmentvariabledefinition și, prin urmare, nu necesită privilegii separate. Privilegiile pentru environmentvariabledefinition tabele sunt incluse implicit în rolurile de securitate creator de mediu și Basic User. Mai multe informații: 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 fluxuri și ar trebui 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.
• Power Platform Sarcinile Instrumente de compilare 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 liste SharePoint , 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ă vă uitaț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 selectarea Afișați dependențe în interfața soluției, în timpul creării componentelor, fie în controlul sursei și în fișierul soluției, vizualizând metadatele aplicației sau 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ă.

Ar trebui să includ valoarea în soluția mea?

Nu. Variabilele de mediu sunt destinate să fie utilizate de aplicații care trebuie să aibă valori diferite în medii diferite în care este implementată soluția. Definițiile variabilelor de mediu ar trebui să fie incluse în soluția dvs., dar valorile trebuie furnizate pentru mediul țintă în timpul implementării. Acest comportament are ca rezultat ca definiția variabilei de mediu să fie un obiect soluție gestionată în mediul țintă, în timp ce variabila de mediu este o înregistrare negestionată.

De ce nu pot șterge o valoare din mediul meu?

Dacă valoarea a fost inclusă într-un soluție gestionată, singura modalitate de a șterge valoarea este să actualizați soluția în mediul sursă pentru a exclude valoarea, apoi exportați o nouă versiune a soluției. Această nouă versiune poate fi apoi importată în mediu folosind o operațiune de actualizare (nu o actualizare), ceea ce duce la ștergerea înregistrării valorii.

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. Deși ALM necesită Dataverse (sau aplicații Dynamics 365), utilizarea conectorilor premium nu este necesară. 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 95 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 conexiunea mea nu este salvată pentru variabilele de mediu sursă de date?

Conexiunile sunt folosite doar pentru a genera interfața cu utilizatorul. De exemplu, pentru a prelua nume prietenoase pentru SharePoint listele asociate unui site. Când editați o variabilă de mediu sursă de date, asigurați-vă că selectați o conexiune cu acces la sursă de date. Dacă nu mai aveți acces la conexiune, puteți introduce manual o valoare. De exemplu, introduceți SharePoint adresa URL a site-ului sau identificatorul unic (GUID) pentru o listă.

Când 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. 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 ...> Scoateți din această soluție.

   

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

Da. Suport pentru variabile de mediu în conectori personalizați

Consultați și

Utilizați variabilele de mediu sursă de date în aplicațiile planșă de lucru
Utilizați variabilele de mediu în Power Automate fluxurile de soluții cloud
EnvironmentVariableDefinition de referință la tabel/entitate
Eșantioane API web
Utilizați variabilele de mediu sursă de date în aplicațiile planșă de lucru
Utilizați variabilele de mediu în Power Automate soluție fluxuri cloud
Utilizați secretele Azure Key Vault
Compatibilitate cu variabilele de mediu în conectorii personalizați
Power Apps Blog: Variabilele de mediu disponibile în versiune preliminară!