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 parametre stránky a zoznamu SharePoint 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 môžu byť použité ako vstupy pri tvorbe canvas aplikácií, Power Automate flow, plug-inov a pridávaní Power BI dashboardov do modelovo riadených aplikácií. 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í

1. Prihláste sa do Power Apps (make.powerapps.com) a potom v ľavom paneli vyberte Riešenia. Ak sa položka nenachádza na bočnom paneli, vyberte možnosť...Viac...a potom vyberte požadovanú položku. ...
2. Otvorte požadované riešenie alebo vytvorte nové.
3. Na paneli príkazov vyberte Nové>Viac a potom vyberte Premenná prostredia.
4. Na pravej table vyplňte nasledujúce stĺpce a potom vyberte Uložiť:

   • Zobrazovaný názov. Zadajte názov premennej prostredia.

   • Meno. 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 pripojení, ktoré je potrebné na pripojenie Power Apps k správnemu serveru a stolu. Toto spojenie sa používa iba na získavanie dostupných hodnôt parametrov, ako sú SharePoint stránky, ku ktorým máte prístup, alebo zoznamy spojené so stránkou.
     • Ak je zvolený typ Secret je potrebný dodatočný Azure Key Vault na nastavenie a konfiguráciu, aby Power Platform mohla mať prístup 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. Napríklad vydavateľ aplikácie môže uviesť svoju ponuku na Marketplace 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ť environmentálne premenné

Na záložke General v nastaveniach 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 sa natívne 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žijete externú tabuľku z iného prostredia (cez Change Environment), Power Apps predpokladá, že chcete vždy odkazovať na tú istú tabuľku. Potrebuješ environmentálnu premennú, ak chceš, aby tá externá tabuľka bola iná externá tabuľka pri prechode z vývoja na testovanie alebo produkciu. Najjednoduchšie je dovoliť Power Apps, aby automaticky vytvorili premennú 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. Pre SharePoint je okrem platného pripojenia potrebná samostatná premenná prostredia pre Site a List.

Na úspešné použitie environmentálnych premenných 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 obsahovať 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 SharePoint stránku a skopírovate ju do cieľového prostredia.

SQL Server

SQL Server podporuje mnoho rôznych typov autentifikácie a pripojení. Používajte environmentálne premenné 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 environmentálne premenné pre zdieľané spojenia, ako je základná SQL autentifikácia so SQL Server. Použite connection reference pre informácie, ktoré sa tradične prenášajú ako súčasť connection string. Základné SQL autentifikačné parametre sú všetky súčasťou connection string. 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 dát sa používajú pre konektory s autentifikáciou, ako je Microsoft Entra. Pri týchto typoch pripojení má Power Apps len identifikovaného používateľa. Power Apps nedokáže odvodiť, s akou službou alebo tabuľkou chcete pracovať z tohto pripojenia.

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?

Notifications

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ť.

Súčasné 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 stránkach, zoznamoch alebo 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. Hoci ALM vyžaduje Dataverse (alebo aplikácie Dynamics 365), použitie prémiových konektorov nie je potrebné. 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. Viac informácií: 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 mien pre zoznamy SharePoint spojené so stránkou. 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. Napríklad zadajte URL stránky SharePoint 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:

1. V riešení, kde sa nachádza premenná prostredia, vyberte premennú prostredia, aby sa zobrazili vlastnosti.

2. 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 tiež

Použite premenné prostredia zdroja údajov v aplikáciách plátna
Používajte environmentálne premenné v Power Automate cloudových tokoch
EnvironmentVariableDefinition tabuľka/entity referencia
Web API samples
Použite premenné prostredia dátového zdroja v Canvas aplikáciách
Použite environmentálne premenné v Power Automate cloud flows
Použite Azure Key Vault secrets
Podpora premenných prostredia v vlastných konektoroch
Power Apps Blog: Premenné prostredia dostupné v náhľade!