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ă. Această abordare 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.

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 canvas. De exemplu, SharePoint Parametrii site-ului online și a listei pot fi stocați ca variabile de mediu. Această abordare vă permite să vă conectați la diferite site-uri și liste în diferite medii 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 o sursă de date în mediile de producție, puteți actualiza valorile variabilei de mediu cu informații pentru noua sursă de date. Aplicațiile și fluxurile nu necesită modificare și încep să utilizeze noua 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. De asemenea, pot fi create automat la conectarea la anumite surse de date în aplicații canvas sau cu codul. De asemenea, pot fi importate într-un mediu prin intermediul soluțiilor. Variabilele de mediu pot fi folosite ca intrări atunci când creați aplicații canvas, Power Automate fluxuri, pluginuri și adăugați Power BI tablouri de bord la aplicațiile bazate pe model. Când utilizați 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 manual 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, ,,ata> sau Secret.

     Notă

     • Dacă Sursa de date este tipul selectat, trebuie să selectați conector, o conexiune validă pentru conectorul selectat și tipul de parametru . Conexiunea nu este stocată ca parte a variabilei de mediu. Variabila de mediu stochează informații care nu sunt în conexiunea necesară pentru a se conecta Power Apps la serverul și tabelul potrivit. 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.

     • 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. O valoare definită 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.

Power Apps poate crea automat variabile de mediu

În fila General a Power Apps setări:

• Activați opțiunea Creați automat variabile de mediu când adăugați surse de date . Acum, când adăugați o nouă sursă de date la aplicația dvs., aceasta adaugă o variabilă de mediu pentru dvs.

  

Surse de date diferite

Surse de date diferite permit diferite tipuri de variabile de mediu.

Microsoft Dataverse

Power Apps se conectează nativ la Dataverse. Nu aveți nevoie de o variabilă de mediu pentru tabelele din mediul dvs. curent. Când vă conectați la Dataverse, aplicația dvs. caută automat exact același nume de tabel în orice mediu în care îl portați. Atâta timp cât structura numelui tabelului este aceeași în mediul țintă ca și în mediul original, funcționează.

Dacă utilizați un tabel extern dintr-un mediu diferit (prin Change Environment), atunci Power Apps se presupune că doriți să faceți întotdeauna referire la același tabel. Aveți nevoie de o variabilă de mediu dacă aveți nevoie ca tabelul extern să fie un tabel extern diferit atunci când treceți de la dev la testare sau la prod. Cel mai ușor este să permiteți Power Apps să creeze automat variabila de mediu pentru dvs. (Dacă ați adăugat anterior tabelul în aplicația dvs., apoi activați comutatorul de setări, aruncați tabelul extern, apoi adăugați-l înapoi.)

Când adăugați tabelul extern în aplicație, alegeți fila Avansat pentru a selecta variabila de mediu.

SharePoint

SharePoint acceptă numai Microsoft Entra conexiuni. Deci, pentru SharePoint, pe lângă o conexiune validă, este necesară o variabilă de mediu separată pentru Site și Listă.

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 pentru SharePoint trebuie să aibă metadate care se potrivesc. SharePoint are identificatori interni care ar putea să nu se potrivească între mediile țintă. De exemplu, dacă creați o listă cu același nume și coloane într-un mediu țintă, numele interne nu se vor potrivi. Metadatele se potrivesc întotdeauna dacă duplicați un SharePoint site și îl copiați în mediul țintă.

SQL Server

SQL Server acceptă multe tipuri diferite de autentificare și conexiuni. Folosiți variabile de mediu pentru Microsoft Entra conexiuni. Este necesară o variabilă de mediu separată pentru server și baza de date. Aplicația este legată de nume de tabel specifice, așa că se presupune că sunt aceleași între medii.

Nu utilizați variabile de mediu pentru conexiuni partajate, cum ar fi autentificarea SQL de bază cu SQL Server. Utilizați referințe de conexiune pentru informațiile care sunt transmise în mod tradițional ca parte a șirului de conexiune. Parametrii de autentificare SQL de bază fac toți parte din șirul de conexiune. De exemplu, numele serverului și bazei de date sunt furnizate la crearea conexiunii și, prin urmare, sunt întotdeauna derivate din conexiune.

Variabilele de mediu ale sursei de date sunt utilizate pentru conectori cu autentificare precum Microsoft Entra. În aceste tipuri de conexiuni, Power Apps are doar un utilizator identificat. Power Apps nu pot deriva din conexiune cu ce serviciu sau masă intenționați să lucrați.

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 .

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 implicită sau o valoare solicită 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 variabilelor de mediu surse 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ție înainte de a exporta soluția. Acest lucru asigură că valoarea existentă rămâne în mediul dumneavoastră 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. Setați valorile astfel încât componentele dependente de variabilele de mediu să nu eșueze.

Securitate

Tabelul environmentvariabledefinition este deținut de utilizator sau de 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ă de la tabelul părinte environmentvariabledefinition și, prin urmare, nu necesită privilegii separate. Privilegiile pentru environmentvariabledefinition tabele sunt incluse implicit în rolurile de securitate Environment Maker ș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 Activitățile Instrumente de compilare nu sunt încă disponibile pentru gestionarea variabilelor de mediu ale sursei 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.
• 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-o 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 mai mulți parametri.

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-o 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 ale sursei 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 sursa 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 Valoare curentă, selectați ...>Eliminaț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 ale sursei de date în aplicațiile canvas
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 Canvas
Utilizați variabilele de mediu în Power Automate fluxurile cloud de soluții
Utilizați secretele Azure Key Vault
Folosiți variabilele de mediu în conectori personalizați
Power Apps Suport variabile de mediu în conectori personalizați