Varijable okruženja za Power Platform pregled

Varijable okruženja omogućuju osnovni scenarij upravljanja životnim ciklusom aplikacije (ALM) premještanja aplikacije između Power Platform okruženja. U ovom scenariju aplikacija ostaje potpuno ista osim nekoliko ključnih vanjskih referenci aplikacija (kao što su tablice, veze i ključevi) koje se razlikuju između izvornog okruženja i odredišnog okruženja. Aplikacija zahtijeva da struktura tablica ili veza bude potpuno ista između izvornog i odredišnog okruženja, uz neke razlike. Varijable okruženja omogućuju vam da odredite koje od tih različitih vanjskih referenci treba ažurirati dok se aplikacija premješta između okruženja.

Varijable okruženja pohranjuju parametarske ključeve i vrijednosti, koji zatim služe kao ulaz u razne druge objekte aplikacije. Odvajanje parametara od objekata koji troše omogućuje vam promjenu vrijednosti unutar istog okruženja ili kada migrirate rješenja u druga okruženja. Alternativa je ostavljanje čvrsto kodiranih vrijednosti parametara unutar komponenata koje ih koriste. Ovaj je pristup često problematičan; posebno kada je potrebno promijeniti vrijednosti tijekom operacija ALM-a. Budući da su varijable okruženja komponente rješenja, možete prenijeti reference (ključeve) i mijenjati vrijednosti kada se rješenja migriraju u druga okruženja.

Prednosti upotrebe varijabli okruženja:

• Navedite nove vrijednosti parametara tijekom uvoza rješenja u druga okruženja.
• Pohranite konfiguraciju za izvore podataka koji se koriste u aplikacijama radnog područja i tijekovima. Na primjer, parametri stranice i popisa SharePoint Online mogu se pohraniti kao varijable okoline. Ovaj pristup omogućuje vam povezivanje s različitim web-mjestima i popisima u različitim okruženjima bez potrebe za izmjenom aplikacija i tijekova.
• Spakirajte i prenesite vaše prilagođavanje i konfiguraciju zajedno i upravljajte njima na jednom mjestu.
• Tajne paketa i transporta, kao što su vjerodajnice koje koriste različite komponente, zasebno od komponenti koje ih koriste.
• Jedna varijabla okruženja može se koristiti u mnogim različitim komponentama rješenja - bilo da se radi o istoj vrsti komponenti ili se razlikuju. Na primjer, aplikacija od gotovih gradivnih elemenata i tok mogu koristiti istu varijablu okruženja. Kada se vrijednost varijable okruženja treba promijeniti, trebate promijeniti samo jednu vrijednost.
• Osim toga, ako trebate povući izvor podataka u proizvodnim okruženjima, možete ažurirati vrijednosti varijabli okruženja informacijama za novi izvor podataka. Aplikacije i tijekovi ne zahtijevaju izmjene i počinju koristiti novi izvor podataka.
• Podržani od strane SolutionPackager i DevOps alati omogućuju kontinuiranu integraciju i kontinuiranu isporuku (CI/CD).
• Varijable okruženja mogu se raspakirati i pohraniti u kontrolu izvora. Također možete pohraniti različite datoteke vrijednosti varijabli okruženja za zasebnu konfiguraciju potrebnu u različitim okruženjima. Solution Packager tada može prihvatiti datoteku koja odgovara okruženju u koje je rješenje uvezeno.

Kako funkcioniraju varijable okoline?

Varijable okruženja mogu se kreirati i mijenjati unutar modernog sučelja rješenja. Također se mogu automatski stvoriti prilikom povezivanja s određenim izvorima podataka u aplikacijama radnog područja ili kodom. Također se mogu uvesti u okruženje putem rješenja. Varijable okruženja mogu se koristiti kao ulazi pri izradi canvas aplikacija, Power Automate tokova, dodataka i dodavanju Power BI nadzornih ploča u aplikacije vođene modelima. Kada koristite varijable okruženja, vrijednosti se tada izvode iz varijabli okruženja i mogu se promijeniti kada se rješenja uvoze u druga okruženja.

Ručno stvaranje varijable okruženja u rješenju

1. Prijavite se na Power Apps (make.powerapps.com), a zatim u lijevom panelu odaberite Solutions. Ako stavka nije u oknu bočne ploče, odaberite ... Više , a zatim odaberite željenu stavku.
2. Otvorite željeno rješenje ili stvorite novo.
3. Na naredbenoj traci odaberite Novo>više, a zatim odaberite Varijabla okruženja.
4. U desnom oknu dovršite sljedeće stupce, a zatim odaberite Spremi:

   • Zaslonsko ime. Unesite naziv varijable okruženja.

   • Ime. Jedinstveni naziv automatski se generira iz zaslonskog naziva, ali ga možete promijeniti.

   • Vrsta podataka. Odaberite između Decimalni broj,Tekst,JSON,Dvije mogućnosti,Izvor podataka ili Tajna.

     Napomena

     • Ako je izvor podataka odabrana vrsta, morate odabrati poveznik, valjanu vezu za odabrani poveznik i vrstu parametra. Veza se ne pohranjuje kao dio varijable okruženja. Varijabla okruženja pohranjuje informacije koje nisu u vezi potrebne za povezivanje Power Apps-a s pravim serverom i stolom. Veza se koristi samo za dohvat dostupnih vrijednosti parametara kao što su SharePoint stranice kojima imate pristup ili popisi povezani sa stranicom.
     • Ako je Secret odabrana vrsta, potrebne su dodatne informacije za postavljanje i konfiguraciju Azure Key Vault kako bi Power Platform mogao pristupiti tajni.

   • Trenutna vrijednost. Poznata i kao vrijednost. Ovo svojstvo je izborno i dio je tablice vrijednosti varijable okruženja. Definirana vrijednost koristi se čak i ako je prisutna i zadana vrijednost. Uklonite vrijednost iz rješenja ako ga ne želite koristiti u sljedećem okruženju. Vrijednosti su također odvojene u zasebne JSON datoteke u izvezenoj datoteci solution.zip i mogu se uređivati izvan mreže. Dodatne informacije: Kako ukloniti vrijednost iz varijable okruženja?

   • Zadana vrijednost. Ovaj je stupac dio tablice definicija varijabli okruženja i nije obavezan. Zadana vrijednost koristi se ako nema trenutne vrijednosti.

     Odvajanje zadane i trenutne vrijednosti omogućuje vam održavanje definicije i zadane vrijednosti odvojeno od vrijednosti. Na primjer, izdavač aplikacije može navesti svoju ponudu na Marketplaceu s zadanom vrijednošću. Tada klijent može, ako želi, dati novu vrijednost. Kada izdavač aplikacije objavi ažuriranja aplikacije, vrijednost koju je postavio klijent ne prepisuje se.

     

     Napomena

     Vrijednost ne može postojati bez definicije. Sučelje omogućuje stvaranje samo jedne vrijednosti po definiciji.

Power Apps može automatski stvarati varijable okruženja

Na kartici General u Power Apps postavkama:

• Omogućite mogućnost Automatski stvori varijable okruženja prilikom dodavanja izvora podataka. Sada, kada dodate novi izvor podataka u svoju aplikaciju, on dodaje varijablu okruženja za vas.

  

Različiti izvori podataka

Različiti izvori podataka omogućuju različite vrste varijabli okruženja.

Microsoft Dataverse

Power Apps se nativno povezuje s Dataverseom. Ne treba vam varijabla okruženja za tablice u trenutnom okruženju. Kada se povežete Dataverse, vaša aplikacija automatski traži potpuno isti naziv tablice u bilo kojem okruženju u kojem je prenesete. Sve dok je struktura naziva tablice ista u ciljnom okruženju kao i u izvornom okruženju, ona funkcionira.

Ako koristite vanjsku tablicu iz drugog okruženja (putem Change Environment), tada Power Apps pretpostavlja da uvijek želite koristiti potpuno istu tablicu. Trebaš varijablu okruženja ako želiš da ta vanjska tablica bude druga vanjska tablica kad prelaziš s razvoja na testiranje ili produkciju. Najlakše je dopustiti Power Apps-u da automatski kreira varijablu okruženja za vas. (Ako ste tablicu prethodno dodali u aplikaciju, uključite prekidač postavki, ispustite vanjsku tablicu, a zatim je ponovno dodajte.)

Kada dodate vanjsku tablicu u aplikaciju, odaberite karticu Napredno da biste odabrali varijablu okruženja.

SharePoint

SharePoint podržava samo Microsoft Entra veze. Dakle, za SharePoint, osim valjane veze, potrebna je zasebna varijabla okruženja za Site i List.

Za uspješno korištenje varijabli okruženja sa SharePoint listama:

• Zaslonski naziv i logički naziv za svaki odgovarajući stupac u izvornom i ciljnom okruženju moraju se podudarati.
• Varijable okruženja za SharePoint moraju imati odgovarajuće metapodatke. SharePoint ima interne identifikatore koji se možda ne podudaraju između ciljanih okruženja. Ako, primjerice, stvorite popis s istim nazivom i stupcima u ciljnom okruženju, interni nazivi se neće podudarati. Metapodaci se uvijek podudaraju ako dupliciraš SharePoint stranicu i kopiraš je u ciljno okruženje.

SQL Server

SQL Server podržava mnoge različite vrste autentifikacije i veza. Koristite varijable okruženja za Microsoft Entra veze. Za poslužitelj i bazu podataka potrebna je zasebna varijabla okruženja. Aplikacija je vezana za određene nazive tablica pa se pretpostavlja da su isti u različitim okruženjima.

Nemojte koristiti varijable okruženja za dijeljene veze poput osnovne SQL autentifikacije sa SQL Server-om. Koristite connection reference za informacije koje se tradicionalno prosljeđuju kao dio connection string-a. Osnovni SQL parametri autentifikacije svi su dio connection string-a. Na primjer, poslužitelj i naziv baze podataka navode se prilikom stvaranja veze i stoga se uvijek izvode iz veze.

Varijable okruženja izvora podataka koriste se za konektore s autentifikacijom poput Microsoft Entra. U ovakvim vezama, Power Apps ima samo identificiranog korisnika. Power Apps ne može izvesti s kojim servisom ili tablicom želite raditi iz te veze.

Unesite nove vrijednosti tijekom uvoza rješenja

Suvremeno sučelje za uvoz rješenja uključuje mogućnost unosa vrijednosti za varijable okruženja. Time se postavlja svojstvo value u tablici environmentvariablevalue .

Vrijednosti varijabli okruženja vidljive su prilikom uvoza rješenja ili kada koristite kanale za implementaciju. Varijable okruženja bez zadane vrijednosti ili vrijednosti traže vrijednost, ali one su inače unaprijed ispunjene oznakom ispod tekstnog područja koja označava izvor vrijednosti: vrijednost rješenja, vrijednost ciljnog okruženja ili zadana vrijednost.

Napomena

• U nekim slučajevima, za određene vrijednosti varijabli okruženja izvora podataka, može se pojaviti upozorenje o odbijanju pristupa ako proizvođač uvoza nema pristup vezi ili izvoru koji se koristi za varijablu okruženja. Ovo je upozorenje koje ne blokira, ali nešto što treba uzeti u obzir ovisno o tome kako planirate koristiti varijablu okruženja u ciljnom okruženju.
• Vrijednost možete ukloniti iz rješenja prije izvoza rješenja. Time se osigurava da postojeća vrijednost ostane u vašem razvojnom okruženju, ali se neće izvesti u rješenje. Ovaj pristup omogućuje davanje nove vrijednosti tijekom uvoza rješenja u druga okruženja. Dodatne informacije: Kako ukloniti vrijednost iz varijable okruženja?

Obavijesti

Obavijest se prikazuje kada varijable okruženja nemaju vrijednosti. Postavite vrijednosti tako da komponente koje ovise o varijablama okruženja ne zakažu.

Sigurnost

Stol environmentvariabledefinition je u vlasništvu korisnika ili tima. Kada stvorite aplikaciju koja koristi varijable okruženja, svakako korisnicima dodijelite odgovarajuću razinu privilegija za ovu tablicu. Dozvola za tablicu environmentvariablevalue nasljeđuje se od nadređene environmentvariabledefinition tablice i stoga ne zahtijeva zasebne privilegije. Privilegije za environmentvariabledefinition tablice prema zadanim su postavkama uključene u sigurnosne uloge Environment Maker i Basic User. Više informacija: Sigurnost u Dataverse.

Imenovanja

Osigurajte da su nazivi varijabli okruženja jedinstveni kako bi se mogli točno referencirati. Duplicirani nazivi varijabli okruženja otežavaju razlikovanje i korištenje varijabli okruženja. Osigurajte da su nazivi varijabli okruženja jedinstveni kako bi se mogli točno referencirati. Nazivi $authentication i $connection posebno su rezervirani parametri za tokove i treba ih izbjegavati. Spremanje tijeka blokirano je ako se koriste varijable okruženja s tim nazivima. Ako se varijabla okruženja koristi u tijeku i promijeni se zaslonski naziv varijable okruženja, dizajner prikazuje i stari i novi token zaslonskog naziva kako bi vam pomogao pri identifikaciji. Prilikom ažuriranja tijeka preporučujemo da uklonite referencu na varijablu okruženja i ponovno je dodate.

Trenutačna ograničenja

• Provjera vrijednosti varijabli okruženja događa se unutar korisničkog sučelja i unutar komponenata koje ih koriste, ali ne i unutar servisa Dataverse. Stoga osigurajte da su postavljene odgovarajuće vrijednosti ako se one mijenjaju pomoću koda.
• Power Platform Zadaci alata za izradu još nisu dostupni za upravljanje varijablama okruženja izvora podataka. Međutim, to ne blokira njihovu upotrebu unutar alata koje nudi Microsoft i unutar sustava za kontrolu izvora.
• Interakcija s varijablama okruženja putem prilagođenog koda zahtijeva API poziv za dohvaćanje vrijednosti; ne postoji predmemorija izložena za korištenje koda koji nije Microsoft.
• Varijable okruženja ograničene su na najviše 2.000 znakova.

Najčešća pitanja

Zašto ne vidim vrijednost za varijablu okruženja?

Ako je varijabla okruženja u upravljanom rješenju, nećete moći vidjeti vrijednost ako ne pogledate unutar zadanog rješenja. Ovo ponašanje je dizajnirano jer je vrijednost varijable okruženja neupravljana prilagodba.

Kako mogu vidjeti gdje se koriste varijable okruženja?

Odabirom Prikaži ovisnosti u sučelju rješenja, tijekom stvaranja komponenti ili u kontroli izvornog koda i u datoteci rješenja pregledom metapodataka aplikacije ili tijeka.

Jesu li varijable okruženja izvora podataka iste kao veze?

Ne. Iako su povezani, veza predstavlja vjerodajnicu ili provjeru autentičnosti potrebnu za interakciju s poveznikom. Varijable okruženja izvora podataka pohranjuju parametre potrebne jednoj ili više radnji u povezniku, a ti se parametri često razlikuju ovisno o radnji. Na primjer, SharePoint Online veza ne pohranjuje nikakve informacije o web stranicama, listama ili bibliotekama dokumenata. Stoga pozivanje konektora zahtijeva i valjanu vezu i još neke parametre.

Može li moj automatizirani ALM kanal koristiti datoteke različitih vrijednosti za različita okruženja?

Da. Alat za pakiranje rješenja prihvaća naziv datoteke kao ulazne parametre, tako da vaš kanal može spakirati datoteku različitih vrijednosti u rješenje, ovisno o vrsti okruženja prema kojem se izvršava.

Trebam li uključiti vrijednost u svoje rješenje?

Ne. Varijable okruženja namijenjene su aplikacijama koje moraju imati različite vrijednosti u različitim okruženjima u kojima je rješenje implementirano. Definicije varijabli okruženja trebaju biti uključene u vaše rješenje, ali vrijednosti trebaju biti navedene za ciljno okruženje tijekom implementacije. Ovo ponašanje rezultira time da je definicija varijable okruženja objekt upravljanog rješenja u ciljnom okruženju, dok je varijabla okruženja neupravljani zapis.

Zašto ne mogu izbrisati vrijednost u svom okruženju?

Ako je vrijednost uključena u upravljano rješenje, jedini način brisanja vrijednosti je ažuriranje rješenja u izvornom okruženju kako bi se izuzela vrijednost, a zatim izvoz nove verzije rješenja. Ova nova verzija se zatim može uvesti u okruženje pomoću operacije nadogradnje (ne ažuriranja), što rezultira brisanjem zapisa vrijednosti.

Što ako netko nehotice izbriše vrijednost?

Ako sustav ovisnosti već nije spriječen, vrijeme izvođenja koristi posljednju poznatu vrijednost kao rezervu.

Ako se vrijednost promijeni, kada se nova vrijednost koristi u aplikacijama od gotovih gradivnih elemenata i tokovima oblaka?

Može potrajati do sat vremena da se u potpunosti objave ažurirane varijable okruženja jer se vrijednost asinkrono prosljeđuje u aplikacije i teče.

Jesu li potrebne premium licence?

Ne. Iako ALM zahtijeva Dataverse (ili Dynamics 365 aplikacije), korištenje premium konektora nije obavezno. Jedino upozorenje je ako koristite poveznik Dataverse za interakciju s varijablama okruženja kao što biste to učinili s drugim zapisima podataka poput računa ili kontakata. Prije je to bio jedini način korištenja varijabli okruženja u aplikacijama od gotovih gradivnih elemenata i tokovima.

Postoji li ograničenje za broj varijabli okruženja koje mogu imati?

Ne. Međutim, maksimalna veličina rješenja je 95 MB. Dodatne informacije: Stvaranje rješenja

Mogu li se zaslonski nazivi i opisi varijabli okruženja lokalizirati?

Da.

Trebam li koristiti varijable okruženja umjesto da pohranjujem podatke o konfiguraciji u prilagođene tablice?

Da, ako vaši konfiguracijski podaci nisu relacijski. Varijable okruženja treba koristiti za parove ključ: vrijednost i kada se vrijednost vjerojatno treba razlikovati u drugim okruženjima. Ostali alati poput uslužnog programa za migraciju konfiguracije prikladniji su za migraciju relacijskih konfiguracijskih podataka pohranjenih unutar prilagođenih tablica. Za razliku od ostalih konfiguracijskih podataka, varijable okruženja se migriraju unutar rješenja i stoga su puno jednostavnije za upravljanje i učinkovitije za uvoz.

Zašto moja veza nije spremljena za varijable okruženja izvora podataka?

Veze se koriste samo za generiranje korisničkog sučelja. Na primjer, za dohvat prijateljskih imena za SharePoint liste povezane sa stranicom. Prilikom uređivanja varijable okruženja izvora podataka svakako odaberite vezu s pristupom izvoru podataka. Ako više nemate pristup vezi, možete ručno unijeti vrijednost. Na primjer, unesite URL SharePoint stranice ili jedinstveni identifikator (GUID) za popis.

Kada je dostupno više veza za jednu varijablu okruženja (vrsta izvora podataka), postoji implementacija prema dizajnu za odabir prve veze na popisu veza. Budući da je obično samo jedna veza povezana s varijablom okruženja, to nije nešto što obično treba potvrditi. Osim toga, s nedavnim promjenama vidljivosti vrijednosti varijabli okruženja, to je lakše provjeriti prilikom uvoza.

Kako mogu ukloniti vrijednost iz varijable okruženja?

Možda ćete htjeti ukloniti vrijednost varijable okruženja iz svog rješenja prije izvoza rješenja. Zatim postojeća vrijednost ostaje u vašem razvojnom okruženju, ali se ne izvozi u rješenje. Taj pristup omogućuje pružanje nove vrijednosti prilikom uvoza rješenja u drugo okruženje.

Da biste uklonili vrijednost, slijedite ove korake:

1. U rješenju gdje se nalazi varijabla okruženja odaberite varijablu okruženja za prikaz svojstava.

2. U odjeljku Trenutna vrijednost odaberite ...>Uklonite iz ove otopine.

   

Mogu li koristiti varijable okruženja u prilagođenim konektorima?

Da. Podrška za varijable okruženja u prilagođenim poveznicima

Vidi također

Korištenje varijabli okruženja izvora podataka u aplikacijama radnog područja
Koristite varijable okruženja u Power Automate cloud flows
EnvironmentVariableDefinition referenca tablice/entiteta
Web API samples
Koristite varijable okruženja izvora podataka u Canvas aplikacijama
Koristite varijable okruženja u Power Automate cloud flows
Koristite Azure Key Vault secrets
Podrška za varijable okruženja u prilagođenim konektorima
Power Apps Blog: Varijable okruženja dostupne u pregledu!