Prehľad premenných prostredia

Premenné prostredia umožňujú základný scenár správy životného cyklu aplikácie (ALM) premiestňovania 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 pripojení 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ú. Toto 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í.

Poznámka

Nové funkcie pre zdroje údajov sa práve nasadzujú a vo vašej oblasti ešte nemusia byť k dispozícii.

Výhody použitia premenných prostredia:

• Zadanie nových hodnôt parametrov pri importe riešení do iných prostredí.
• Uloženie konfigurácií pre zdroje údajov použité v aplikáciách a postupoch. Napríklad lokalitu SharePoint a zoznamov parametrov možno uložiť ako premenné prostredia; teda umožňuje vám pripojiť sa k rôznym lokalitám a zoznamom v rôznych prostrediach bez toho, aby ste museli upravovať aplikácie a postupy.
• 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 zrušiť zdroj údajov v produkčných prostrediach, môžete aktualizovať hodnoty premenných prostredia informáciami pre nový zdroj údajov. Aplikácie a postupy nevyžadujú úpravy a začnú používať nový zdroj údajov.
• Podpora nástrojmi SolutionPackager a DevOps umožňuje nepretržitú integráciu a nepretržité poskytovanie (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. Balíčkovač riešenia potom môže prijať súbor zodpovedajúci prostrediu, do ktorého bude riešenie importované.

Ako fungujú?

Premenné prostredia je možné vytvárať a upravovať v rámci rozhrania moderného riešenia, automaticky ich vytvárať pri pripojení k určitým zdrojom údajov v aplikáciách plátna alebo pomocou kódu. Môžu byť tiež importované do prostredia prostredníctvom riešení. Keď sú premenné prostredia prítomné v prostredí, možno ich použiť ako vstupy pri vytváraní aplikácií plátna, Power Automate tokov, pri vývoji doplnkov a na mnohých iných miestach, ako je napríklad pridávanie Power BI dashboard do modelom riadenej aplikácie. Keď tieto typy objektov používajú premenné prostredia, hodnoty sa potom odvodia z premenných prostredia a môžu sa zmeniť pri importe riešení do iných prostredí.

Vytvorenie premennej prostredia v riešení

1. Prihláste sa do Power Apps (make.powerapps.com), a na ľavej navigačnej table vyberte Riešenia. Ak sa položka nenachádza na table bočného panela, vyberte položku … Viac a potom vyberte požadovanú položku.
2. Otvorte požadované riešenie alebo vytvorte nové.
3. V paneli príkazov vyberte položku Nové > Viac a potom vyberte možnosť 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.

   • Názov. Jedinečný názov je automaticky vygenerovaný na základe položky Zobrazované meno, ale môžete to zmeniť.

   • Typ údajov. Vyberte Desatinné číslo, Text, JSON, Dve možnosti, Zdroj údajov alebo Tajný kľúč.

     Poznámka

     • Ak je vybraný typ Zdroj údajov, musíte tiež zvoliť konektor, platné spojenie pre vybraný konektor a typ parametra. Pripojenie však nie je uložené ako súčasť premennej prostredia. 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. Pre určité parametre, ako napr. zoznamy SharePoint, budete musieť zvoliť aj nadradenú premennú prostredia zdroja údajov, napríklad lokality SharePoint. Po uložení budú spojené v databáze.
     • Ak je vybraný typ Tajný kľúč, sú potrebné ďalšie informácie na nastavenie a konfiguráciu trezoru kľúčov Azure, aby platforma Power Platform mohla získať prístup k tajnému kľúču.

   • 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. Keď je prítomná hodnota, použije sa, 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. Viac informácií: 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.

Počas importovania riešení zadajte nové hodnoty

Rozhranie importu moderného riešenia obsahuje možnosť zadávať hodnoty pre premenné prostredia. Tým sa nastaví vlastnosť hodnoty v tabuľke environmentvariablevalue.

Počnúc aktualizáciou zo 7. decembra 2023 sú všetky hodnoty premenných prostredia viditeľné pri importovaní riešení (alebo pri nasadzovaní pomocou Pipelines). Premenné prostredia bez predvolenej hodnoty alebo hodnoty budú vyzvané 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 premennej prostredia zdroj údajov môže zobraziť upozornenie Prístup odmietnutý, ak výrobca 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 riešenia odstrániť. Tým je zaistené, že existujúca hodnota zostane vo vašom vývojovom prostredí, ale nebude exportovaná v riešení. Tento prístup umožňuje poskytnúť novú hodnotu pri importovaní riešenia do iných prostredí. Viac informácií: Ako odstránim hodnotu z premennej prostredia?

Oznámenia

Ak premenné prostredia nemajú žiadne hodnoty, zobrazí sa upozornenie. Toto je pripomienka, aby ste nastavili hodnoty tak, aby komponenty závislé od premenných prostredia nezlyhali.

Zabezpečenie

Tabuľku environmentvariabledefinition vlastní používateľ alebo tím. 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 pre tabuľku environmentvariablevalue sa dedí po nadradenej tabuľke environmentvariabledefinition a preto nevyžaduje samostatné oprávnenia. Oprávnenia pre tabuľky environmentvariabledefinition sú štandardne zahrnuté v rolách zabezpečenia Tvorca prostredia a Základný používateľ. Ďalšie informácie: Zabezpečenie 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 postupy a treba 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.
• Úlohy nástrojov Power Platform 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.
• 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ť.

Najčastejšie otázky

Prečo nevidím hodnotu pre moju premennú prostredia?

Ak je premenná prostredia v spravované riešenie, hodnotu neuvidíte, pokiaľ 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 Zobraziť závislosti v rozhraní riešenia, pri vytváraní komponentov alebo v ovládaní zdroja a v súbore riešenia zobrazením metaúdajov aplikácie alebo postupu.

Sú premenné prostredia zdroja údajov rovnaké ako pripojenia?

Nie. Aj keď 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.

Dajú sa premenné prostredia zdroja údajov použiť so zdieľanými pripojeniami, ako je napríklad SQL Server s overením SQL?

Spravidla nie. Zdieľané pripojenia s SQL serverom ukladajú parametre potrebné na pripojenie k údajom v rámci 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 zdroj údajov sa používajú pre konektory, ktoré sa spoliehajú na autentifikáciu založenú na používateľovi, ako napríklad Microsoft Entra ID, pretože parametre nemožno odvodiť z pripojenia. Z týchto dôvodov sa pri overovaní pomocou servera SQL, ktorý je zdieľaným pripojením, nepoužívajú premenné prostredia zdroja údajov.

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.

Č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 Dynamics 365 for Customer Engagement), 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 120 MB. Pozri 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 sa pri importe automaticky priradí iná hodnota pripojenia ako tá, ktorú chcem?

V niektorých prípadoch, keď sú k dispozícii viaceré pripojenia pre jednu premennú prostredia (typ zdroja údajov), existuje implementácia podľa návrhu na výber prvého pripojenia v zozname pripojení dostupných pre premennú prostredia. 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 si tiež

Použite zdroj údajov premenné prostredia 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
Ukážky webového rozhrania API
Použite zdroj údajov premenné prostredia v aplikáciách Canvas
Použite premenné prostredia v Power Automate toky cloud riešenia
Použite tajné kľúče Azure Key Vault
Podpora premenných prostredia vo vlastných konektoroch
Power Apps Blog: Premenné prostredia sú k dispozícii vo verzie Preview!

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).