Premenné prostredia pre prehľad Power Platform
Premenné prostredia umožňujú základný scenár správy životného cyklu aplikácie (ALM) presúvania aplikácie medzi Power Platform prostrediami. V tomto scenári zostáva aplikácia úplne rovnaká s výnimkou niekoľkých kľúčových externých aplikačných referencií (ako sú tabuľky, pripojenia a kľúče), ktoré sa líšia medzi zdrojovým prostredím a cieľovým prostredím. Aplikácia vyžaduje, aby štruktúra tabuliek alebo spojení bola medzi zdrojovým a cieľovým prostredím úplne rovnaká, s určitými rozdielmi. Premenné prostredia vám umožňujú určiť, ktoré z týchto rôznych externých odkazov by sa mali aktualizovať, keď sa aplikácia presúva medzi prostrediami.
Premenné prostredia ukladajú kľúče parametrov a hodnoty, ktoré potom slúžia ako vstup do rôznych ďalších aplikačných objektov. Oddelenie parametrov od konzumujúcich objektov vám umožňuje meniť hodnoty v rovnakom prostredí alebo pri migrácii riešení do iných prostredí. Alternatívou je ponechanie pevne zakódovaných hodnôt parametrov v rámci komponentov, ktoré ich používajú. Tento prístup je často problematický; najmä vtedy, keď je potrebné zmeniť hodnoty počas operácií ALM. Pretože premenné prostredia sú súčasťami riešenia, môžete prenášať referencie (kľúče) a meniť hodnoty pri migrácii riešení do iných prostredí.
Výhody použitia premenných prostredia:
- Poskytujte nové hodnoty parametrov pri importovaní riešení do iných prostredí.
- Uložte konfiguráciu pre zdroje údajov používané v aplikáciách canvas a tokoch. Napríklad SharePoint Parametre webu a zoznamu online môžu byť uložené ako premenné prostredia. Tento prístup vám umožňuje pripojiť sa k rôznym stránkam a zoznamom v rôznych prostrediach bez toho, aby ste museli upravovať aplikácie a toky.
- Zbaľte a prepravte svoje prispôsobenie a konfiguráciu spoločne a spravujte ich na jednom mieste.
- Zabaľte a prepravujte tajné informácie, ako sú napríklad poverenia používané rôznymi komponentmi, oddelene od komponentov, ktoré ich používajú.
- Jednu premennú prostredia je možné použiť v mnohých rôznych súčastiach riešenia – či už ide o rovnaký alebo iný typ súčasti. Napríklad aplikácia plátna a postup môžu používať rovnakú premennú prostredia. Keď je potrebné zmeniť hodnotu premennej prostredia, stačí zmeniť iba jednu hodnotu.
- Okrem toho, ak potrebujete vyradiť zdroj údajov v produkčných prostrediach, môžete aktualizovať hodnoty premenných prostredia informáciami pre nový zdroj údajov. Aplikácie a toky nevyžadujú úpravu a začnú používať nový zdroj údajov.
- Podporované nástrojmi SolutionPackager a DevOps umožňujú nepretržitú integráciu a nepretržité doručovanie (CI/CD).
- Premenné prostredia je možné rozbaliť a uložiť v riadení zdroja. Môžete tiež uložiť rôzne súbory hodnôt premenných prostredia pre samostatnú konfiguráciu potrebnú v rôznych prostrediach. Solution Packager potom môže prijať súbor zodpovedajúci prostrediu, do ktorého je riešenie importované.
Ako fungujú premenné prostredia?
Premenné prostredia je možné vytvárať a upravovať v rámci rozhrania moderného riešenia. Môžu byť tiež automaticky vytvorené pri pripojení k určitým zdrojom údajov v aplikáciách plátna alebo s kódom. Môžu byť tiež importované do prostredia prostredníctvom riešení. Premenné prostredia možno použiť ako vstupy pri vytváraní aplikácií plátna, Power Automate tokov, doplnkov a pridávania Power BI dashboardov do aplikácií riadených modelom. Keď použijete premenné prostredia, hodnoty sa potom odvodia z premenných prostredia a možno ich zmeniť, keď sa riešenia importujú do iných prostredí.
Manuálne vytvorte premennú prostredia v riešení
- Prihláste sa do Power Apps (make.powerapps.com) a potom na ľavom paneli vyberte Riešenia. Ak položka nie je na paneli bočného panela, vyberte …Viac a potom vyberte požadovanú položku.
- Otvorte požadované riešenie alebo vytvorte nové.
- Na paneli príkazov vyberte Nové>Viac a potom vyberte Premenná prostredia.
- Na pravej table vyplňte nasledujúce stĺpce a potom vyberte Uložiť:
Zobrazovaný názov. Zadajte názov premennej prostredia.
Názov. Jedinečný názov sa automaticky generuje z Zobrazovaný názov, ale môžete ho zmeniť.
Typ údajov. Vyberte z možností Desatinné číslo, Text, JSON, Dve možnosti,, zdroj alebo Tajné.
Poznámka
- Ak je vybratý typ Zdroj údajov , musíte vybrať konektor, platné pripojenie pre vybratý konektor a typ>> Pripojenie nie je uložené ako súčasť premennej prostredia. Premenná prostredia ukladá informácie, ktoré nie sú v spojení, ktoré je potrebné na pripojenie Power Apps k správnemu serveru a tabuľke. Pripojenie sa používa iba na získanie dostupných hodnôt parametrov, ako sú napr. lokality SharePoint, ku ktorým máte prístup, alebo zoznamy priradené k lokalite.
- Ak je vybratý typ Tajné , sú potrebné ďalšie informácie na nastavenie a konfiguráciu Azure Key Vault, aby sa umožnil Power Platform pristup k tajomstvu.
Aktuálna hodnota. Známa tiež ako hodnota. Táto vlastnosť je voliteľná a je súčasťou tabuľky hodnôt premenných prostredia. Definovaná hodnota sa použije, aj keď je prítomná aj predvolená hodnota. Odstráňte hodnotu z vášho riešenia, ak ju nechcete použiť v ďalšom prostredí. Hodnoty sú tiež rozdelené do samostatných súborov JSON v rámci exportovaného súboru solution.zip a je možné ich upravovať offline. Ďalšie informácie: Ako odstránim hodnotu z premennej prostredia?
Predvolená hodnota. Tento stĺpec je súčasťou tabuľky definície premenných prostredia a nie je povinný. Predvolená hodnota sa použije, ak nie je k dispozícii žiadna aktuálna hodnota.
Oddelenie predvolenej hodnoty od aktuálnej hodnoty vám umožňuje obslúžiť definíciu a predvolenú hodnotu oddelene od hodnoty. Vydavateľ aplikácie môže napríklad uviesť svoju ponuku na AppSource s predvolenou hodnotou. Zákazník potom môže voliteľne poskytnúť novú hodnotu. Keď vydavateľ aplikácie zverejní aktualizácie aplikácie, hodnota nastavená zákazníkom sa neprepíše.
Poznámka
Hodnota nemôže existovať bez definície. Rozhranie umožňuje vytvoriť iba jednu hodnotu pre definíciu.
Power Apps dokáže automaticky vytvárať premenné prostredia
Na karte Všeobecné nastavenia Power Apps :
Povoľte možnosť Automaticky vytvárať premenné prostredia pri pridávaní zdrojov údajov . Teraz, keď do svojej aplikácie pridáte nový zdroj údajov, pridá pre vás premennú prostredia.
Rôzne zdroje údajov
Rôzne zdroje údajov umožňujú rôzne typy premenných prostredia.
Microsoft Dataverse
Power Apps natívne sa pripája k Dataverse. Pre tabuľky vo vašom aktuálnom prostredí nepotrebujete premennú prostredia. Keď sa pripojíte k Dataverse, vaša aplikácia automaticky vyhľadá presne rovnaký názov tabuľky v akomkoľvek prostredí, ktoré prenesiete. Pokiaľ je štruktúra názvu tabuľky rovnaká v cieľovom prostredí ako v pôvodnom prostredí, funguje to.
Ak používate externú tabuľku z iného prostredia (prostredníctvom Zmeniť prostredie), potom Power Apps predpokladá, že chcete vždy odkazovať na presne tú istú tabuľku. Premennú prostredia potrebujete, ak potrebujete, aby externá tabuľka bola inou externou tabuľkou, keď prechádzate z vývojára na test alebo do prod. Najjednoduchšie je povoliť Power Apps automatické vytváranie premennej prostredia za vás. (Ak ste predtým pridali tabuľku do aplikácie, potom zapnite prepínač nastavení, zrušte externú tabuľku a potom ju pridajte späť.)
Keď do aplikácie pridáte externú tabuľku, vyberte kartu Rozšírené a vyberte premennú prostredia.
SharePoint
SharePoint podporuje iba Microsoft Entra pripojenia. Takže pre SharePoint sa okrem platného pripojenia vyžaduje aj samostatná premenná prostredia pre lokalitu a zoznam.
Ak chcete úspešne použiť premenné prostredia so zoznamami SharePoint :
- Zobrazovaný názov a logický názov pre každý zodpovedajúci stĺpec v zdrojovom a cieľovom prostredí sa musia zhodovať.
- Premenné prostredia pre SharePoint musia mať zodpovedajúce metadáta. SharePoint má interné identifikátory, ktoré sa nemusia zhodovať medzi cieľovými prostrediami. Ak napríklad vytvoríte zoznam s rovnakým názvom a stĺpcami v cieľovom prostredí, interné názvy sa nebudú zhodovať. Metadáta sa vždy zhodujú, ak duplikujete stránku SharePoint a skopírujete ju do cieľového prostredia.
SQL Server
SQL Server podporuje mnoho rôznych typov autentifikácie a pripojení. Použite premenné prostredia pre Microsoft Entra pripojenia. Pre server a databázu sa vyžaduje samostatná premenná prostredia. Aplikácia je viazaná na konkrétne názvy tabuliek, takže sa predpokladá, že sú medzi prostrediami rovnaké.
Nepoužívajte premenné prostredia pre zdieľané pripojenia, ako je základná autentifikácia SQL so serverom SQL. Odkazy na pripojenie použite na informácie, ktoré sa tradične odovzdávajú ako súčasť reťazca pripojenia. Všetky základné parametre autentifikácie SQL sú súčasťou reťazca pripojenia. Napríklad názov servera a databázy sa poskytujú pri vytváraní spojenia, a preto sú vždy odvodené od spojenia.
Premenné prostredia zdroja údajov sa používajú pre konektory s autentifikáciou ako Microsoft Entra. V týchto typoch pripojení má Power Apps len identifikovaného používateľa. Power Apps z pripojenia nemožno odvodiť, s akou službou alebo tabuľkou chcete pracovať.
Počas importovania riešení zadajte nové hodnoty
Rozhranie importu moderného riešenia obsahuje možnosť zadávať hodnoty pre premenné prostredia. Toto nastaví vlastnosť value v tabuľke environmentvariablevalue .
Hodnoty premenných prostredia sú viditeľné pri importovaní riešení alebo pri nasadzovaní pomocou Pipelines. Premenné prostredia bez predvolenej hodnoty alebo hodnoty vyzývajú na zadanie hodnoty, ale inak sú predvyplnené štítkom pod oblasťou textu označujúcim zdroj hodnoty: hodnota riešenia, cieľová hodnota prostredia alebo predvolená hodnota.
Poznámka
- V niektorých prípadoch sa pre konkrétne hodnoty premenných prostredia zdroja údajov môže zobraziť upozornenie Prístup odmietnutý , ak tvorca importu nemá prístup k pripojeniu alebo zdroju použitému pre premennú prostredia. Toto je neblokujúce varovanie, ale treba si to uvedomiť v závislosti od toho, ako plánujete použiť premennú prostredia v cieľovom prostredí.
- Pred exportovaním riešenia môžete hodnotu z vášho riešenia odstrániť. To zaisťuje, že existujúca hodnota zostane vo vašom vývojovom prostredí, ale nebude exportovaná do riešenia. Tento prístup umožňuje poskytnúť novú hodnotu pri importovaní riešenia do iných prostredí. Ďalšie informácie: Ako odstránim hodnotu z premennej prostredia?
Oznámenia
Ak premenné prostredia nemajú žiadne hodnoty, zobrazí sa upozornenie. Nastavte hodnoty tak, aby komponenty závislé od premenných prostredia nezlyhali.
Zabezpečenie
environmentvariabledefinition Tabuľka je vlastnená používateľom alebo tímom. Pri vytváraní aplikácie, ktorá používa premenné prostredia, nezabudnite priradiť používateľom príslušnú úroveň oprávnení k tejto tabuľke. Povolenie k tabuľke environmentvariablevalue sa dedí z nadradenej tabuľky environmentvariabledefinition , a preto nevyžaduje samostatné privilégiá. Oprávnenia pre tabuľky environmentvariabledefinition sú štandardne zahrnuté v rolách zabezpečenia Tvorca prostredia a Základného používateľa. Viac informácií: Bezpečnosť v Dataverse.
Pomenovanie
Uistite sa, že názvy premenných prostredia sú jedinečné, aby sa na ne dalo presne odkazovať. Duplicitné zobrazované názvy premenných prostredia sťažujú rozlišovanie a použitie premenných prostredia. Uistite sa, že názvy premenných prostredia sú jedinečné, aby sa na ne dalo presne odkazovať. Názvy $authentication a $connection sú špeciálne vyhradené parametre pre toky a mali by ste sa im vyhnúť. Uloženie toku je zablokované, ak sa používajú premenné prostredia s týmito názvami. Ak sa v toku použije premenná prostredia a zmení sa zobrazovaný názov premennej prostredia, návrhár zobrazí starý aj nový token zobrazovaného názvu, aby pomohol s identifikáciou. Pri aktualizácii toku vám odporúčame odstrániť referenciu premennej prostredia a znova ju pridať.
Aktuálne obmedzenia
- Overenie hodnôt premenných prostredia sa deje v rámci používateľských rozhraní a v rámci komponentov, ktoré ich používajú, ale nie v rámci Dataverse. Preto sa uistite, že sú nastavené správne hodnoty, ak sa upravujú pomocou kódu.
- Power Platform Úlohy Build Tools zatiaľ nie sú k dispozícii na správu premenných prostredia zdroja údajov. To však nebráni ich použitiu v rámci nástrojov poskytovaných spoločnosťou Microsoft a v systémoch riadenia zdrojov.
- Interakcia s premennými prostredia prostredníctvom vlastného kódu vyžaduje volanie API na načítanie hodnôt; nie je k dispozícii vyrovnávacia pamäť, ktorú by mohol použiť kód inej spoločnosti ako Microsoft.
- Premenné prostredia sú obmedzené na maximálne 2 000 znakov.
Najčastejšie otázky
Prečo nevidím hodnotu pre moju premennú prostredia?
Ak je premenná prostredia v spravovanom riešení, hodnotu neuvidíte, kým sa nepozriete do Predvoleného riešenia. Toto správanie je zámerné, pretože hodnota premennej prostredia je nespravované prispôsobenie.
Ako môžem zistiť, kde sa používajú premenné prostredia?
Buď výberom možnosti Zobraziť závislosti v rozhraní riešenia, pri vytváraní komponentov alebo v ovládaní zdroja a v súbore riešenia zobrazením metadát aplikácie alebo toku.
Sú premenné prostredia zdroja údajov rovnaké ako pripojenia?
Nie. Hoci spolu súvisia, pripojenie predstavuje poverenie alebo overenie potrebné na interakciu s konektorom. Premenné prostredia zdroja údajov ukladajú parametre, ktoré sú vyžadované jednou alebo viacerými akciami v konektore, a tieto parametre sa často líšia v závislosti od akcie. Napríklad pripojenie SharePoint Online neukladá žiadne informácie o lokalitách, zoznamoch ani knižniciach dokumentov. Preto volanie konektora vyžaduje platné pripojenie a niektoré ďalšie parametre.
Môže môj automatizovaný kanál ALM používať súbory rôznych hodnôt pre rôzne prostredia?
Áno. Balíčkovač riešenia prijíma ako vstupné parametre názov súboru, takže váš kanál môže do riešenia zabaliť súbor s rôznymi hodnotami v závislosti od typu prostredia, proti ktorému sa vykonáva.
Mám zahrnúť hodnotu do svojho riešenia?
Nie. Premenné prostredia sú určené na použitie aplikáciami, ktoré potrebujú mať rôzne hodnoty v rôznych prostrediach, kde je riešenie nasadené. Definície premenných prostredia by mali byť zahrnuté vo vašom riešení, ale hodnoty by mali byť poskytnuté pre cieľové prostredie počas nasadenia. Toto správanie má za následok, že definícia premennej prostredia je objektom riadeného riešenia v cieľovom prostredí, zatiaľ čo premenná prostredia je nespravovaný záznam.
Prečo nemôžem odstrániť hodnotu v mojom prostredí?
Ak bola hodnota zahrnutá do spravovaného riešenia, jediný spôsob, ako odstrániť hodnotu, je aktualizovať riešenie v zdrojovom prostredí, aby sa vylúčila hodnota, a potom exportovať novú verziu riešenia. Túto novú verziu potom možno importovať do prostredia pomocou operácie inovácie (nie aktualizácie), čo má za následok vymazanie záznamu hodnoty.
Čo ak niekto chtiac-nechtiac vymaže hodnotu?
Ak tomu už nezabráni systém závislostí, runtime použije poslednú známu hodnotu ako záložnú.
Ak sa zmení hodnota, kedy sa nová hodnota zvykne používať v aplikáciách plátna a v postupoch v cloude?
Úplné zverejnenie aktualizovaných premenných prostredia môže trvať až hodinu, pretože hodnota je vložená do aplikácií a prebieha asynchrónne.
Vyžadujú sa prémiové licencie?
Nie. Zatiaľ čo ALM vyžaduje Dataverse (alebo aplikácie Dynamics 365), použitie prémiových konektorov sa nevyžaduje. Jedna výhrada je, ak používate konektor Dataverse na interakciu s premennými prostredia, ako by ste to robili s inými údajovými záznamami, ako sú obchodné vzťahy alebo kontakty. Predtým to bol jediný spôsob, ako používať premenné prostredia v aplikáciách plátna a v postupoch.
Existuje obmedzenie počtu premenných prostredia?
Nie. Maximálna veľkosť riešenia je však 95 MB. Ďalšie informácie: Vytvorenie riešenia
Dajú sa lokalizovať zobrazované názvy a popisy premenných prostredia?
Áno.
Mám namiesto ukladania konfiguračných údajov do vlastných tabuliek používať premenné prostredia?
Áno, ak vaše konfiguračné údaje nie sú relačné. Premenné prostredia by sa mali používať pre páry kľúč: hodnota a vtedy, keď je pravdepodobné, že sa hodnota bude musieť v iných prostrediach líšiť. Ostatné nástroje, ako je nástroj na migráciu konfigurácie, sú vhodnejšie na migráciu relačných konfiguračných údajov uložených vo vlastných tabuľkách. Na rozdiel od iných konfiguračných údajov sa premenné prostredia migrujú v rámci riešení, a preto sa oveľa jednoduchšie spravujú a výkonnejšie sa importujú.
Prečo nie je moje pripojenie uložené pre premenné prostredia zdroja údajov?
Pripojenia sa používajú iba na generovanie používateľského rozhrania. Napríklad na získanie priateľských názvov pre SharePoint zoznamy priradené k lokalite. Pri úprave premennej prostredia zdroja údajov nezabudnite vybrať pripojenie s prístupom k zdroju údajov. Ak už nemáte prístup k pripojeniu, môžete manuálne zadať hodnotu. Zadajte napríklad SharePoint adresu URL lokality alebo jedinečný identifikátor (GUID) pre zoznam.
Ak je pre jednu premennú prostredia (typ zdroja údajov) k dispozícii viacero pripojení, existuje implementácia podľa návrhu na výber prvého pripojenia v zozname pripojení. Pretože s premennou prostredia je zvyčajne spojené iba jedno pripojenie, nie je to niečo, čo zvyčajne treba overiť. Navyše, s nedávnymi zmenami vo viditeľnosti hodnôt premenných prostredia je toto jednoduchšie overiť pri importe.
Ako odstránim hodnotu z premennej prostredia?
Pred exportovaním riešenia možno budete chcieť z vášho riešenia odstrániť hodnotu premennej prostredia. Potom existujúca hodnota zostane vo vašom vývojovom prostredí, ale nebude exportovaná do riešenia. Tento prístup umožňuje poskytnúť novú hodnotu pri importe riešenia do iného prostredia.
Ak chcete hodnotu odstrániť, postupujte takto:
V riešení, kde sa nachádza premenná prostredia, vyberte premennú prostredia, aby sa zobrazili vlastnosti.
V časti Aktuálna hodnota vyberte ...>Odstrániť z tohto riešenia.
Môžem vo vlastných konektoroch používať premenné prostredia?
Áno. Podpora premenných prostredia vo vlastných konektoroch
Pozrite si tiež
Použite premenné prostredia zdroja údajov v aplikáciách plátna
Použite premenné prostredia v Power Automate riešení v cloudových tokoch
Odkaz na tabuľku/entitu EnvironmentVariableDefinition
Vzorky webového rozhrania API
Používanie premenných prostredia zdroja údajov v aplikáciách Canvas
Použitie premenných prostredia v Power Automate riešení v cloudových tokoch
Použitie tajomstiev kľúčov Azure Key Vault
v premennej podpory prostredia Ba8 v prostredí Ba: podpora premennej prostredia k dispozícii v ukážke!
Power Apps