Varijable okruženja za Power Platform pregled

Varijable okruženja omogućuju osnovni scenarij upravljanja životnim ciklusom aplikacije (ALM) za premještanje 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 tipke) koje se razlikuju između izvorišnog okruženja i odredišnog okruženja. Aplikacija zahtijeva da struktura tablica ili veza bude potpuno ista između izvorišnog i odredišnog okruženja, s nekim razlikama. Varijable okruženja omogućuju vam da odredite koja od ovih različitih vanjskih referenci treba ažurirati kako se aplikacija premješta kroz 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. To je često problematično; pogotovo kada je potrebno mijenjati vrijednosti tijekom ALM operacija. 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.

Napomena

Nove mogućnosti za izvore podataka se upravo uvode i možda još nisu dostupne u vašoj regiji.

Prednosti upotrebe varijabli okruženja:

• Navedite nove vrijednosti parametara tijekom uvoza rješenja u druga okruženja.
• Spremite konfiguraciju za izvore podataka korištene u aplikacijama od gotovih gradivnih elemenata i tokovima. Na primjer, web-mjesto sustava SharePoint Online i parametri popisa mogu se pohraniti kao varijable okruženja; to vam omogućava povezivanje s različitim web-mjestima i popisima u različitim okruženjima bez potrebe za izmjenom aplikacija i tokova.
• 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 promjenjive vrijednosti okruženja informacijama za novu izvor podataka. Aplikacije i tokovi ne zahtijevaju izmjene i počinju koristiti novu izvor podataka.
• Podržavaju alati SolutionPackager i DevOps koji 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. Paket rješenja tada može prihvatiti datoteku koja odgovara okruženju u koje se rješenje uvozi.

Kako funkcioniraju varijable okruženja?

Varijable okruženja mogu se stvarati i mijenjati u suvremenom sučelju rješenja, stvarati automatski prilikom povezivanja s određenim izvorima podataka u aplikacijama od gotovih gradivnih elemenata ili pomoću koda. Također se mogu uvesti u okruženje putem rješenja. Nakon što su varijable okruženja prisutne u okruženju, mogu se koristiti kao ulazi prilikom stvaranja aplikacija radnog područja, Power Automate tijekova, pri razvoju dodataka i mnogih drugih mjesta, poput dodavanja Power BI nadzorne ploče u aplikaciju stvorenu prema modelu. Kada ove vrste objekata koriste varijable okruženja, vrijednosti se tada izvode iz varijabli okruženja i mogu se mijenjati kada se rješenja uvoze u druga okruženja.

Stvaranje varijable okruženja u rješenju

1. Prijavite se u servis Power Apps (make.powerapps.com), a zatim u lijevom navigacijskom oknu odaberite Rješenja. Ako stavka nije u bočnom oknu, 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 Varijabla okruženja.
4. U desnom oknu popunite sljedeće stupce, a zatim odaberite Spremi:

   • Zaslonski naziv. Unesite naziv varijable okruženja.

   • Naziv. Jedinstveno ime automatski se generira iz stavke Zaslonsko ime, ali to možete promijeniti.

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

     Napomena

     • Ako je Izvor podataka odabrana vrsta, također ćete morati odabrati poveznik, valjanu vezu za odabrani poveznik i vrstu parametra. Međutim, veza nije pohranjena kao dio varijable okruženja. Veza se koristi samo za dohvaćanje dostupnig vrijednosti parametra, kao što su web-mjesta SharePoint kojima imate pristup ili popisi povezani s web-mjestom. Za određene parametre kao što su popisi sustava SharePoint, morat ćete odabrati i varijablu okruženja nadređenog izvora podataka, poput web-mjesta sustava SharePoint. Nakon spremanja, bit će povezani u bazi podataka.
     • Ako je odabrana vrsta Tajna, dodatne informacije za postavlje i konfiguriranje značajke Azure Key Vault potrebe su za dopuštenje značajki Power Platform da pristupi tajni.

   • Trenutačna vrijednost. Poznata i kao vrijednost. Ovo svojstvo je izborno i dio je tablice vrijednosti varijable okruženja. Kada je vrijednost prisutna, 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. Više informacija: Kako mogu ukloniti vrijednost iz varijable okruženja?

   • Zadana vrijednost. Ovaj je stupac dio tablice definicija varijable okruženja i nije potreban. 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 sa AppSource 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će se prebrisati.

     

     Napomena

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

Unesite nove vrijednosti tijekom uvoza rješenja

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

Počevši od ažuriranja 7. prosinca 2023., sve vrijednosti varijabli okruženja vidljive su pri uvozu rješenja (ili pri korištenju kanala za implementaciju). Varijable okruženja bez zadane vrijednosti ili vrijednosti zatražit će se vrijednost, ali one se inače unaprijed popunjavaju natpisom ispod područja teksta koji označava izvor vrijednosti: vrijednost rješenja, vrijednost ciljnog okruženja ili zadana vrijednost.

Napomena

• U nekim slučajevima, za određene varijabilne vrijednosti izvor podataka okruženja, upozorenje o odbijenom pristupu može se pojaviti ako proizvođač uvoznik 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. To osigurava da postojeća vrijednost ostane u vašem razvojnom okruženju, ali da se ne izveze u rješenju. Ovaj pristup omogućuje davanje nove vrijednosti tijekom uvoza rješenja u druga okruženja. Više informacija: Kako mogu ukloniti vrijednost iz varijable okruženja?

Obavijesti

Obavijest se prikazuje kada varijable okruženja nemaju vrijednosti. Ovo je podsjetnik za postavljanje vrijednosti tako da komponente koje ovise o varijablama okruženja uspiju.

Sigurnost

Tablica 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 se nasljeđuje od nadređene tablice environmentvariabledefinition i stoga ne zahtijeva zasebne privilegije. Privilegije za tablice environmentvariabledefinition uključene su u autor okruženja i sigurnosne uloge osnovnog korisnika prema zadanim vrijednostima. Dodatne informacije: Sigurnost na usluzi Dataverse.

Imenovanje

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 tijekove 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 mijenja se varijabla zaslonsko ime okruženja, dizajner prikazuje i stare i nove zaslonsko ime tokene koji pomažu u identifikaciji. Prilikom ažuriranja tijeka preporučujemo da uklonite referencu varijable 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.
• Zadaci alata za izgradnju servisa Power Platform 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 kôd koji nije Microsoftov.
• Da biste uspješno koristili varijable okruženja s SharePoint popisima, zaslonsko ime i logički naziv za svaki odgovarajući stupac u izvorišnom i ciljnom okruženju moraju se podudarati.
• Varijable okruženja ograničene su na najviše 2000 znakova.

Najčešća pitanja

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

Ako je varijabla okruženja u upravljano rješenje, nećete moći vidjeti vrijednost ako ne pogledate unutar rješenja Zadano. To je ponašanje dizajnirano jer je varijabilna vrijednost okruženja neupravljana prilagodba.

Kako mogu vidjeti gdje se koriste varijable okruženja?

Bilo putem odabira Prikaz ovisnosti u sučelju rješenja, tijekom autoriziranja komponenata ili u kontroli izvora i u datoteci rješenja pregledavanjem metapodataka aplikacije ili toka.

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, veza sustava SharePoint Online ne pohranjuje nikakve informacije o web-mjestima, popisima ili bibliotekama dokumenata. Stoga pozivanje priključka zahtijeva i valjanu vezu i neke dodatne parametre.

Mogu li se varijable okruženja izvora podataka koristiti sa zajedničkim vezama kao što je SQL Server sa SQL provjerom autentičnosti?

Općenito ne. Zajedničke veze kao što je SQL Server pohranjuju parametre potrebne za povezivanje s podacima unutar veze. Na primjer, poslužitelj i naziv baze podataka navode se prilikom stvaranja veze i stoga se uvijek izvode iz veze.

Izvor podataka varijable okruženja koriste se za poveznike koji se oslanjaju na provjeru autentičnosti utemeljenu na korisnicima, kao što su Microsoft Entra :ID jer se parametri ne mogu izvesti iz veze. Iz tog se razloga provjera autentičnosti s vezom SQL Server, koji koristi zajedničku vezu, neće koristiti varijable okruženja izvora podataka.

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.

Što ako netko nehotice izbriše vrijednost?

Ako sustav ovisnosti već nije spriječio, vrijeme izvođenja koristi posljednju poznatu vrijednost kao rezervnu verziju.

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

Potpuno objavljivanje ažuriranih varijabli okruženja može potrajati do sat vremena jer se vrijednost gura u aplikacije i asinkrono teče.

Jesu li potrebne premium licence?

Ne. Dok ALM zahtijeva Dataverse (ili Dynamics 365 for Customer Engagement), upotreba premium poveznika nije potrebna. 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 120 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 se vrijednost veze razlikuje od one koju želim automatski dodijeliti prilikom uvoza?

U nekim slučajevima kada je dostupno više veza za jednu varijablu okruženja (vrsta izvora podataka), postoji implementacija po dizajnu za odabir prve veze na popisu veza dostupnih za varijablu okruženja. Budući da je obično povezana samo jedna veza s varijablom okruženja, to nije nešto što obično treba provjeriti. Osim toga, s nedavnim promjenama vidljivosti promjenjive vrijednosti okruženja, to je lakše provjeriti nakon 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. Pod Trenutna vrijednost odaberite ... > Ukloni iz ovog rješenja.

   

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

Da. Podrška varijabli okruženja u prilagođenim konektorima

Pogledajte

Korištenje varijabli okruženja izvor podataka u aplikacijama od gotovih gradivnih elemenata
Korištenje varijabli okruženja u tokovima Power Automate oblaka rješenja
Referenca tablice/entiteta EnvironmentVariableDefinition
Uzorci API-ja na webu
Korištenje varijabli okruženja izvor podataka u aplikacijama od gotovih gradivnih elemenata
Korištenje varijabli okruženja u tokovima Power Automate oblaka rješenja
Korištenje tajni trezora za ključeve servisa Azure
Podrška varijabli okruženja u prilagođenim konektorima
Power Apps Blog: Varijable okruženja dostupne u pretpregledu!

Napomena

Možete li nam reći više o željenim jezicima za dokumentaciju? Ispunite kratki upitnik. (imajte na umu da je upitnik na engleskom jeziku)

Ispunjavanje upitnika će trajati otprilike sedam minuta. Osobni podaci se ne prikupljaju (izjava o zaštiti privatnosti).