Sistemske varijable za Power Platform pregled

Varijable okruženja omogućavaju osnovni scenario upravljanja životnim ciklusom aplikacija (ALM) za premeštanje aplikacije između Power Platform okruženja. U ovom scenariju, aplikacija ostaje potpuno ista, osim nekoliko ključnih spoljnih referenci aplikacija (kao što su tabele, veze i ključevi) koji se razlikuju između izvornog okruženja i odredišnog okruženja. Aplikacija zahteva da struktura tabela ili veza bude potpuno ista između izvornog i odredišnog okruženja, sa nekim razlikama. Sistemske promenljive vam omogućavaju da odredite koje od ovih različitih spoljnih referenci treba da se ažuriraju kako se aplikacija pomera preko okruženja.

Promenljive okruženja čuvaju ključeve i vrednosti parametara, koji zatim služe kao ulaz za razne druge objekte aplikacija. Odvajanje parametara od objekata koji troše omogućava vam da promenite vrednosti unutar istog okruženja ili kada migrirate rešenja u druga okruženja. Alternativa je ostavljanje čvrsto kodiranih vrednosti parametara unutar komponenata koje ih koriste. Ovo je često problematično; posebno kada je potrebno promeniti vrednosti tokom operacija ALM-a. Budući da su promenljive okruženja komponente rešenja, možete preneti reference (ključeve) i promeniti vrednosti kada se rešenja migriraju u druga okruženja.

Belešku

Nove mogućnosti za izvore podataka su tek u primeni i možda još uvek nisu dostupne u vašem regionu.

Prednosti korišćenja promenljivih okruženja:

• Obezbedite nove vrednosti parametara prilikom uvoza rešenja u drugim okruženjima.
• Čuvajte konfiguraciju za izvore podataka koji se koriste u aplikacijama i tokovima platna. Na primer, parametri SharePoint Online lokacija i lista mogu se čuvati kao promenljive okruženja, što vam omogućava povezivanje sa različitim lokacijama i listama u različitim okruženjima bez potrebe za modifikovanjem aplikacija i tokova.
• Zapakujte i prenesite prilagođavanje i konfiguraciju zajedno i upravljajte njima na jednom mestu.
• Pakovanje i transport tajni, kao što su akreditivi koje koriste različite komponente, odvojeno od komponenti koje ih koriste.
• Jedna promenljiva okruženja može se koristiti u mnogim različitim komponentama rešenja – bilo da se radi o istoj ili različitoj vrsti komponenti. Na primer, aplikacija sa podlogom i tok mogu da koriste istu promenljivu okruženja. Kada vrednost promenljive okoline treba da se promeni, treba da promenite samo jednu vrednost.
• Pored toga, ako želite da povučete izvor podataka u proizvodnim okruženjima, možete ažurirati vrednosti promenljive okruženja sa informacijama za novi izvor podataka. Aplikacije i tokovi ne zahtevaju modifikaciju i počinju da koriste novi izvor podataka.
• Podržani od strane SolutionPackager i DevOps alati omogućavaju kontinuiranu integraciju i kontinuiranu isporuku (CI / CD).
• Promenljive okruženja mogu se raspakovati i sačuvati u kontroli izvora. Takođe možete da sačuvate različite vrednosti promenljivih okruženja za odvojenu konfiguraciju potrebnu u različitim okruženjima. Solution Packager tada može da prihvati datoteku koja odgovara okruženju u koje se uvozi rešenje.

Kako funkcionišu varijable okruženja?

Varijable okruženja mogu biti kreirane i modifikovane u okviru modernog interfejsa rešenja, automatski kreirane prilikom povezivanja sa određenim izvorima podataka u aplikacijama platna ili korišćenjem koda. Takođe se mogu uvesti u okruženje putem rešenja. Kada su varijable okruženja prisutne u okruženju, mogu se koristiti kao ulazi prilikom kreiranja aplikacija platna, tokova, Power Automate razvoja dodataka i mnogih drugih mesta kao što je dodavanje kontrolne Power BI table u aplikaciju zasnovanu na modelu. Kada ove vrste objekata koriste promenljive okruženja, vrednosti se izvode iz promenljivih okruženja i mogu se promeniti kada se rešenja uvezu u druga okruženja.

Kreiranje promenljive okruženja u rešenju

1. Prijavite se na Power Apps (make.powerapps.com), a zatim u levom oknu izaberite Rešenja. Ako stavka nije u panelu bočnog panela, izaberite ... Više , a zatim izaberite stavku koju želite.
2. Otvorite rešenje koje želite ili napravite novo.
3. Na komandnoj traci, izaberite Novo>više, a zatim izaberite Sistemska promenljiva.
4. U desnom oknu, popunite sledeće kolone, a zatim izaberite Sačuvaj:

   • ime za prikaz. Unesite naziv za promenljivu okruženja.

   • Ime i prezime. Jedinstveno ime se automatski generiše izime za prikaz, ali možete ga promeniti.

   • Tip podataka. Izaberite iz Decimalni broj, Tekst, JSON, Dve opcije, izvor podataka ili Tajna.

     Belešku

     • Ako je izvor podataka izabrani tip, takođe ćete morati da izaberete konektor ,važeću vezu za izabrani konektor i tip parametra. Međutim, veza nije uskladištena kao deo promenljive okruženja. Veza se koristi samo za preuzimanje dostupnih vrednosti parametara kao što su SharePoint lokacije kojima imate pristup ili liste povezane sa lokacijom. Za određene parametre kao što su SharePoint liste, takođe ćete morati da izaberete nadređenu promenljivu okruženja za izvor podataka kao što je SharePoint lokacija. Kada ih sačuvate, oni će biti povezani u bazi podataka.
     • Ako je Tajna izabrani tip, potrebne su dodatne informacije za podešavanje i konfigurisanje Azure Kei Vault-a kako bi se omogućio Power Platform pristup tajni.

   • Trenutna vrednost. Takođe je poznata kao vrednost. Ovo svojstvo je opciono i deo je tabele vrednosti promenljive okruženja. Kada je vrednost prisutna, ona se koristi, čak i ako je podrazumevana vrednost takođe prisutna. Uklonite vrednost iz rešenja ako ne želite da je koristite u sledećem okruženju. Vrednosti su takođe razdvojene u zasebne JSON datoteke u izvezenoj datoteci solution.zip i mogu se uređivati van mreže. Više informacija: Kako da uklonim vrednost iz promenljive okruženja?

   • Podrazumevana vrednost. Ova kolona je deo tabele definicije promenljive okruženja i nije potrebna. Podrazumevana vrednost se koristi ako nema trenutne vrednosti.

     Razdvajanje podrazumevane vrednosti i trenutne vrednosti omogućava vam da servisirate definiciju i podrazumevanu vrednost odvojeno od vrednosti. Na primer, izdavač aplikacije može da navede svoju ponudu sa AppSource podrazumevanom vrednošću. Zatim klijent može opcionalno da pruži novu vrednost. Kada izdavač aplikacije objavi ažuriranja aplikacije, vrednost koju je postavio kupac se ne prepisuje.

     

     Belešku

     Vrednost ne može da postoji bez definicije. Interfejs omogućava kreiranje samo jedne vrednosti po definiciji.

Unesite nove vrednosti dok uvozite rešenja

Savremeni interfejs za uvoz rešenja uključuje mogućnost unosa vrednosti za promenljive okruženja. Ovo postavlja vrednost osobinu na tabeli environmentvariablevalue .

Počevši od ažuriranja 7. decembra 2023. godine, sve vrednosti varijabli okruženja vidljive su prilikom uvoza rešenja (ili kada se koriste cevovodi za primenu). Sistemske promenljive bez podrazumevane vrednosti ili vrednosti će biti zatražene za vrednost, ali one koje su inače unapred popunjene oznakom ispod tekstualne oblasti koja označava izvor vrednosti: vrednost rešenja, vrednost ciljne okoline ili podrazumevanu vrednost.

Belešku

• U nekim slučajevima, za određene vrednosti promenljive okruženja izvor podataka, upozorenje o odbijanju pristupa može se pojaviti ako proizvođač uvoza nema pristup vezi ili izvoru koji se koristi za promenljivu okruženja. Ovo je upozorenje koje ne blokira, ali nešto što treba uzeti u obzir u zavisnosti od toga kako planirate da koristite promenljivu okruženja u ciljnom okruženju.
• Vrednost možete ukloniti iz rešenja pre izvoza rešenja. Ovo osigurava da će postojeća vrednost ostati u vašem razvojnom okruženju, ali neće biti izvezena u rešenje. Ovaj pristup omogućava navođenje nove vrednosti pri uvozu rešenja u druga okruženja. Više informacija: Kako da uklonim vrednost iz promenljive okruženja?

Obaveštenja

Obaveštenje se prikazuje kada promenljive okruženja nemaju nikakve vrednosti. Ovo je podsetnik da postavite vrednosti tako da komponente koje zavise od promenljivih okruženja ne budu neuspešne.

Bezbednost

Tabela environmentvariabledefinition je u vlasništvu korisnika ili tima. Kada kreirate aplikaciju koja koristi promenljive okruženja, obavezno dodelite korisnicima odgovarajući nivo privilegija ovoj tabeli. Dozvola za tabelu environmentvariablevalue je nasleđena od roditeljske environmentvariabledefinition tabele i stoga ne zahteva posebne privilegije. Privilegije za environmentvariabledefinition tabele su podrazumevano uključene u bezbednosne uloge autor okruženja i osnovnog korisnika. Više informacija: Bezbednost u Dataverse.

Imenovanje

Uverite se da su imena promenljivih okruženja jedinstvena tako da se na ona mogu precizno referencirati. Duplirana imena za prikaz promenljivih okruženja otežavaju njihovo razlikovanje i korišćenje. Uverite se da su imena promenljivih okruženja jedinstvena tako da se na ona mogu precizno referencirati. Imena $authentication i $connection su posebno rezervisani parametri za tokove i treba ih izbegavati. Čuvanje protoka je blokirano ako se koriste sistemske promenljive sa tim imenima. Ako se promenljiva okruženja koristi u toku i ime za prikaz promenljive okruženja se menja, onda dizajner prikazuje i stare i nove tokene ime za prikaz kako bi pomogao u identifikaciji. Kada ažurirate tok, preporučujemo da uklonite referencu promenljive okruženja i dodate je ponovo.

Trenutna ograničenja

• Provera valjanosti promenljivih okruženja se dešava unutar korisničkog interfejsa i unutar komponenti koje ih koriste, ali ne i unutar usluge Dataverse. Stoga osigurajte da su postavljene odgovarajuće vrednosti ako se one menjaju pomoću koda.
• Power Platform Zadaci alata za izradu još uvek nisu dostupni za upravljanje promenljivim okruženja izvor podataka. Međutim, ovo ne blokira njihovu upotrebu u alatima koje nudi Microsoft i u sistemima za kontrolu izvora.
• Interakcija sa promenljivim okruženja preko prilagođenog koda zahteva API poziv za dohvaćanje vrednosti; ne postoji keš izložen za ne-Microsoft kod za korišćenje.
• Da bi se uspešno koristile sistemske promenljive sa SharePoint spiskovima, ime za prikaz i logičko ime za svaku odgovarajuću kolonu u izvornom i ciljnom okruženju moraju da se poklapaju.
• Varijable okruženja su ograničene na maksimalno 2.000 znakova.

Najčešća pitanja

Zašto ne mogu da vidim vrednost za moju promenljivu okruženja?

Ako je promenljiva okruženja u kompletno rešenje, nećete moći da vidite vrednost osim ako ne pogledate unutar podrazumevanog rešenja. Ovo ponašanje je po dizajnu, jer je vrednost promenljive okruženja neupravljano prilagođavanje.

Kako mogu da vidim gde se koriste promenljive okruženja?

Ili odabirom Prikaži zavisnosti u interfejsu rešenja, dok kreirate komponente, ili u kontroli izvornog koda i u datoteci rešenja pregledom metapodataka aplikacije ili protoka.

Da li su promenljive okruženja za izvor podataka iste kao veze?

Ne. Iako su povezani, veza predstavlja akreditivu ili autentifikaciju potrebnu za interakciju sa konektorom. Promenljive okruženja za izvor podataka čuvaju parametre koji su potrebni za jednu ili više radnji u konektoru i ti parametri se često razlikuju u zavisnosti od radnje. Na primer, SharePoint Online veza ne čuva nikakve informacije o lokacijama, listama ili bibliotekama dokumenata. Zbog toga pozivanje konektora zahteva i validnu vezu i neke dodatne parametre.

Mogu li se promenljive okruženja za izvor podataka koristiti sa deljenim vezama kao što je SQL Server sa SQL potvrdom identiteta?

U principu, ne. Deljene veze kao što je SQL Server čuvaju parametre potrebne za povezivanje sa podacima unutar veze. Na primer, ime servera i baze podataka daje se prilikom kreiranja veze i stoga se uvek izvodi iz veze.

Promenljive okruženja izvor podataka se koriste za konektore koji se oslanjaju na autentifikaciju zasnovanu na korisniku, kao što su Microsoft Entra ID jer parametri ne mogu biti izvedeni iz veze. Iz tih razloga, potvrda identiteta pomoću usluge SQL Server neće koristiti promenljive okruženja za izvor podataka.

Da li moj automatizovani ALM kanal koristi datoteke različitih vrednosti za različita okruženja?

Da. Alatka za pravljenje paketa rešenja prihvata ime datoteke kao ulazne parametre, tako da vaš kanal može spakovati datoteku različitih vrednosti u rešenje, u zavisnosti od tipa okruženja na kojem se izvršava.

Da li treba da uključim vrednost u moje rešenje?

Ne. Varijable okruženja su namenjene da ih koriste aplikacije koje moraju imati različite vrednosti u različitim okruženjima u kojima je rešenje raspoređeno. Definicije promenljivih okruženja treba da budu uključene u vaše rešenje, ali vrednosti treba da budu obezbeđene za ciljno okruženje tokom primene. Ovo ponašanje rezultira u definiciji promenljive okruženja kao kompletno rešenje objekat u ciljnom okruženju, dok je promenljiva okruženja neupravljani zapis.

Zašto ne mogu da izbrišem vrednost u mom okruženju?

Ako je vrednost uključena u kompletno rešenje, jedini način da izbrišete vrednost je da ažurirate rešenje u izvornom okruženju da biste isključili vrednost, a zatim izvozite novu verziju rešenja. Ova nova verzija se zatim može uvesti u okruženje pomoću operacije nadogradnje (ne ažuriranja), što rezultira brisanjem zapisa vrednosti.

Šta ako neko nehotično izbriše vrednost?

Ako već nije sprečen sistemom zavisnosti, runtime koristi poslednju poznatu vrednost kao rezervu.

Ako se vrednost promeni, kada se nova vrednost koristi u aplikacijama sa podlogom i u tokovima u oblaku?

Može potrajati i do sat vremena da se u potpunosti objave ažurirane promenljive okruženja, jer se vrednost gura u aplikacije i teče asinhrono.

Da li su potrebne premium licence?

Ne. Dok ALM zahteva Dataverse (ili Dynamics 365 aplikacije), upotreba premium konektora nije potrebna. Jedini izuzetak je ako koristite Dataverse konektor za interakciju sa promenljivima okruženja kao što biste to učinili sa drugim zapisima podataka poput naloga ili kontakata. Ranije je ovo bio jedini način korišćenja promenljivih okruženja u aplikacijama sa podlogom i tokovima.

Postoji li ograničenje broja promenljivih okruženja koje mogu da imam?

Ne. Međutim, maksimalna veličina rešenja je 95 MB. Još informacija: Kreiranje rešenja

Mogu li se imena za prikaz i opisi promenljivih okruženja lokalizovati?

Da.

Da li treba da koristim promenljive okruženja umesto da skladištim podatke o konfiguraciji u prilagođenim tabelama?

Da, ako vaši podaci o konfiguraciji nisu relacioni. Promenljive okruženja treba koristiti za parove ključ:vrednost i kada vrednost verovatno treba da se razlikuje u drugim okruženjima. Ostale alatke poput uslužnog programa Migracija konfiguracije pogodniji su za migraciju relacionih podataka konfiguracije koji se čuvaju u prilagođenim tabelama. Za razliku od ostalih podataka o konfiguraciji, promenljive okruženja se migriraju unutar rešenja i stoga su mnogo jednostavnije za upravljanje i lakše za uvoz.

Zašto moja veza nije sačuvana za promenljive okruženja izvor podataka?

Veze se koriste samo za generisanje korisničkog interfejsa. Na primer, da biste preuzeli prijateljska imena za SharePoint liste povezane sa sajtom. Kada uređujete promenljivu okruženja izvor podataka, obavezno izaberite vezu sa pristupom izvoru podataka. Ako više nemate pristup vezi, možete ručno uneti vrednost. Na primer, unesite URL sajta ili jedinstveni SharePoint identifikator (GUID) za listu.

Kada postoji više veza dostupnih za jednu promenljivu okruženja (tipa izvora podataka), postoji implementacija po dizajnu da biste izabrali prvu vezu na listi veza. Zato što obično postoji samo jedna veza povezana sa promenljivom okruženja, to nije nešto što obično treba da se potvrdi. Pored toga, sa nedavnim promenama vidljivosti promenljive vrednosti okruženja, ovo je lakše potvrditi prilikom uvoza.

Kako da uklonim vrednost iz promenljive okruženja?

Možda ćete želeti da uklonite vrednost promenljive okruženja iz svog rešenja pre izvoza rešenja. Zatim, postojeća vrednost ostaje u vašem razvojnom okruženju, ali se ne izvozi u rešenje. Ovaj pristup omogućava da se obezbedi nova vrednost pri uvozu rešenja u drugo okruženje.

Da biste uklonili vrednost, pratite sledeće korake:

1. U rešenju gde se nalazi promenljiva okruženja izaberite promenljivu okruženja da biste prikazali svojstva.

2. Pod Trenutna vrednost, izaberite ...>Uklonite iz ovog rešenja.

   

Mogu li da koristim promenljive okruženja u prilagođenim konektorima?

Da. Podrška za promenljivu okolinu u prilagođenim konektorima

Pogledajte i ovo

Koristite varijable okruženja izvor podataka u aplikacijama platna
Koristite varijable okruženja u Power Automate tokovima oblaka rešenja
EnvironmentVariableDefinition tabela / entitetska referenca
Veb API uzorci
Koristite promenljive okruženja izvor podataka u aplikacijama Canvas Koristite
sistemske varijable u Power Automate tokovima
oblaka rešenja Koristite Azure Kei Vault tajne
Podrška za promenljive okruženja u prilagođenim konektorima
Power Apps Blog: Sistemske varijable dostupne u verziji za pregled!