Přehled proměnných prostředí pro Power Platform

Proměnné prostředí umožňují základní scénář správy životního cyklu aplikace (ALM) pro přesun aplikace mezi prostředími Power Platform. V tomto scénáři zůstává aplikace přesně stejná s výjimkou několika klíčových externích aplikací (jako jsou tabulky, připojení a klíče), které se liší mezi zdrojovým a cílovým prostředím. Aplikace vyžaduje, aby struktura tabulek nebo spojení byla mezi zdrojovým a cílovým prostředím naprosto stejná, s určitými rozdíly. Proměnné prostředí vám umožňují určit, které z těchto různých externích odkazů by se měly aktualizovat, když je aplikace přesouvána mezi prostředími.

Proměnné prostředí ukládají klíče a hodnoty parametrů, které pak slouží jako vstup do různých dalších objektů aplikace. Oddělení parametrů od spotřebovávajících objektů umožňuje měnit hodnoty ve stejném prostředí nebo při migraci řešení do jiných prostředí. Alternativou je ponechání napevno kódovaných hodnot parametrů uvnitř komponent, které je používají. Tento přístup je často problematický; zvláště když je třeba hodnoty změnit během operací ALM. Protože proměnné prostředí jsou součástmi řešení, můžete přenést odkazy (klíče) a změnit hodnoty při migraci řešení do jiných prostředí.

Výhody použití proměnných prostředí:

• Zadejte nové hodnoty parametrů při importu řešení do jiných prostředí.
• Uložit konfiguraci pro zdroje dat použité v aplikacích plátna a tocích. Například parametry webu a seznamu SharePoint Online lze uložit jako proměnné prostředí. Tento přístup umožňuje připojit se k různým webům a seznamům v různých prostředích, aniž byste museli upravovat aplikace a toky.
• Zabalte a přepravte své přizpůsobení a konfiguraci společně a spravujte je na jednom místě.
• Zabalte a přepravujte tajné údaje, jako jsou přihlašovací údaje používané různými komponentami, odděleně od komponent, které je používají.
• Jedna proměnná prostředí může být použita v mnoha různých komponentách řešení – ať už jde o stejný typ komponenty nebo různé. Například aplikace typu canvas a proces mohou používat stejnou proměnnou prostředí. Když je třeba změnit hodnotu proměnné prostředí, stačí změnit pouze jednu hodnotu.
• Pokud navíc potřebujete vyřadit zdroj dat v provozním prostředí, můžete aktualizovat hodnoty proměnných prostředí informacemi pro nový zdroj dat. Aplikace a toky nevyžadují úpravy a začnou používat nový zdroj dat.
• S podporou nástrojů SolutionPackager a DevOps umožňuje nepřetržitou integraci a trvalé doručení (CI/CD).
• Proměnné prostředí lze rozbalit a uložit do zdrojového ovládacího prvku. Můžete také ukládat různé soubory hodnot proměnných prostředí pro samostatnou konfiguraci potřebnou v různých prostředích. Nástroj pro balení řešení pak může přijmout soubor odpovídající prostředí, do kterého bude řešení importováno.

Jak fungují proměnné prostředí?

Proměnné prostředí lze vytvářet a měnit v moderním rozhraní řešení. Mohou být také automaticky vytvořeny při připojení k určitým zdrojům dat v aplikacích plátna nebo pomocí kódu. Lze je také importovat do prostředí prostřednictvím řešení. Proměnné prostředí je možné použít jako vstupy při vytváření aplikací plátna, toků Power Automate, modulů plug-in a přidávání řídicích panelů Power BI do aplikací řízených modelem. Když použijete proměnné prostředí, hodnoty se poté odvozují z proměnných prostředí a lze je změnit při importu řešení do jiných prostředí.

Ruční vytvoření systémové proměnné v řešení

1. Přihlaste se k Power Apps (make.powerapps.com) a v levém podokně vyberte Solutions. Pokud se položka nenachází v bočním podokně, vyberte možnost …Více a poté vyberte požadovanou položku.
2. Otevřete požadované řešení nebo vytvořte nové.
3. V panelu příkazů vyberte Nový>Další a poté vyberte Proměnná prostředí.
4. V pravém podokně vyplňte následující sloupce a poté vyberte Uložit:

   • Zobrazovaný název. Zadejte název proměnné prostředí.

   • Name. Jedinečný název je automaticky generován z pole Zobrazovaný název, ale můžete jej změnit.

   • Typ dat. Vyberte z možností Desetinné číslo, Text, JSON, Dvě možnosti, Zdroj dat nebo Tajný kód.

     Poznámka:

     • Je-li vybraný typ Zdroj dat, musíte vybrat konektor, platné připojení pro vybraný konektor a typ parametru. Připojení se neukládá jako součást proměnné prostředí. Proměnná prostředí ukládá informace, které nejsou uloženy v připojení, ale jsou nezbytné pro připojení Power Apps ke správnému serveru a tabulce. Připojení se používá pouze k načtení dostupných hodnot parametrů, jako jsou SharePoint weby, ke kterým máte přístup, nebo seznamy přidružené k webu.
     • Pokud je vybraný typ Secret, jsou potřeba další informace pro nastavení a konfiguraci Azure Key Vault, aby služba Power Platform mohla získat přístup k tajnému kódu.

   • Aktuální hodnota Také se nazývá hodnota. Tato vlastnost je volitelná a je součástí tabulky hodnot proměnných prostředí. Definovaná hodnota je použita, i když je k dispozici také výchozí hodnota. Pokud ji nechcete použít v dalším prostředí, odeberte hodnotu z vašeho řešení. Hodnoty jsou také rozděleny do samostatných souborů JSON v exportovaném souboru solution.zip a lze je upravovat offline. Další informace: Jak odeberu hodnotu z proměnné prostředí?

   • Výchozí hodnota. Tento sloupec je součástí tabulky definice proměnných prostředí a není vyžadován. Pokud není aktuální hodnota, použije se výchozí hodnota.

     Oddělení výchozí hodnoty a aktuální hodnoty umožňuje obsluhovat definici a výchozí hodnotu odděleně od hodnoty. Vydavatel aplikace může například uvést svou nabídku na Marketplace s výchozí hodnotou. Pak může zákazník poskytnout novou hodnotu. Když vydavatel aplikace publikuje aktualizace aplikace, hodnota nastavená zákazníkem není přepsána.

     

     Poznámka:

     Hodnota nemůže existovat bez definice. Rozhraní umožňuje vytvořit pouze jednu hodnotu pro definici.

Power Apps může automaticky vytvářet proměnné prostředí

Na kartě Obecné v nastavení Power Apps.

• Povolte možnost Automatické vytváření proměnných prostředí při přidávání zdrojů dat. Nyní, když do své aplikace přidáte nový zdroj dat, vytvoří se za vás proměnná prostředí.

  

Různé zdroje dat

Různé zdroje dat umožňují různé typy proměnných prostředí.

Microsoft Dataverse

Power Apps se nativně připojuje k Dataverse. Pro tabulky v aktuálním prostředí nepotřebujete proměnnou prostředí. Když se připojíte k Dataverse, vaše aplikace automaticky vyhledá přesně stejný název tabulky v jakémkoli prostředí, které portujete. Pokud je struktura názvů tabulek v cílovém prostředí stejná jako v původním prostředí, funguje to.

Pokud používáte externí tabulku z jiného prostředí (prostřednictvím příkazu Změnit prostředí), Power Apps předpokládá, že chcete vždy odkazovat na stejnou tabulku. Pokud potřebujete, aby externí tabulka byla při přechodu z vývoje na testování nebo do produkce jinou externí tabulkou, potřebujete proměnnou prostředí. Nejjednodušší je nechat Power Apps automaticky vytvořit proměnnou prostředí. (Pokud jste tabulku do aplikace přidali už dříve, zapněte přepínač nastavení, přetáhněte externí tabulku a pak ji znovu přidejte.)

Když do aplikace přidáte externí tabulku, zvolte kartu Rozšířené a vyberte proměnnou prostředí.

SharePoint

SharePoint podporuje pouze připojení Microsoft Entra. Takže pro SharePoint je kromě platného připojení vyžadována samostatná proměnná prostředí pro web a seznam.

Jak úspěšně používat proměnné prostředí se seznamy SharePoint:

• Zobrazovaný název a logický název pro každý odpovídající sloupec ve zdrojovém a cílovém prostředí se musí shodovat.
• Proměnné prostředí pro SharePoint musí mít odpovídající metadata. SharePoint má interní identifikátory, které se nemusí shodovat mezi cílovými prostředími. Pokud například vytvoříte seznam se stejným názvem a sloupci v cílovém prostředí, interní názvy se nebudou shodovat. Metadata se vždy shoduje, pokud duplikujete SharePoint web a zkopírujete je do cílového prostředí.

SQL Server

SQL Server podporuje mnoho různých typů ověřování a připojení. Pro propojení s Microsoft Entra použijte systémové proměnné. Pro server a databázi je potřeba samostatná systémová proměnná. Aplikace je vázána na konkrétní názvy tabulek, takže se předpokládá, že jsou stejné mezi prostředími.

Nepoužívejte proměnné prostředí pro sdílená připojení, jako je základní ověřování SQL s SQL Server. Odkazy na připojení použijte pro informace, které se tradičně předávají jako součást řetězce připojení. Základní parametry ověřování SQL jsou součástí připojovací řetězec. Například název serveru a databáze jsou uvedeny při vytváření připojení, a proto jsou vždy odvozeny od připojení.

Proměnné prostředí zdroje dat se používají pro konektory využívající ověřování, jako je Microsoft Entra. V těchto typech připojení Power Apps má pouze identifikovaného uživatele. Power Apps nemůžete odvodit, s jakou službou nebo tabulkou chcete pracovat z připojení.

Při importu řešení zadejte nové hodnoty

Moderní rozhraní importu řešení zahrnuje možnost zadávat hodnoty pro proměnné prostředí. Tím se nastaví vlastnost hodnoty v tabulce environmentvariablevalue.

Hodnoty proměnných prostředí jsou viditelné při importu řešení nebo při použití Pipelines k nasazení. Proměnné prostředí bez výchozí hodnoty nebo zadané hodnoty vyžadují zadání hodnoty, ale ostatní jsou předvyplněné popiskem pod textovou oblastí, která označuje zdroj hodnoty: hodnota řešení, hodnota cílového prostředí nebo výchozí hodnota.

Poznámka:

• V některých případech se pro konkrétní hodnoty proměnných prostředí zdroje dat může zobrazit upozornění Přístup odepřen, pokud tvůrce importu nemá přístup k připojení nebo zdroji použitému pro proměnnou prostředí. Toto je neblokující upozornění, ale něco, co je potřeba vzít na vědomí v závislosti na tom, jak plánujete použít proměnnou prostředí v cílovém prostředí.
• Před exportováním řešení můžete hodnotu z řešení odebrat. Tím zajistíte, že existující hodnota zůstane ve vašem vývojovém prostředí, ale nebude exportována do řešení. Tento přístup umožňuje poskytnout novou hodnotu při importu řešení do jiných prostředí. Další informace: Jak odeberu hodnotu z proměnné prostředí?

Oznámení

Pokud proměnné prostředí nemají žádné hodnoty, zobrazí se upozornění. Nastavte hodnoty tak, aby komponenty závislé na proměnných prostředí neselhaly.

Zabezpečení

Tabulku environmentvariabledefinitionvlastní uživatel nebo tým. Když vytváříte aplikaci, která používá proměnné prostředí, nezapomeňte přiřadit uživatelům příslušnou úroveň oprávnění k této tabulce. Oprávnění k tabulce environmentvariablevalue je zděděno z nadřazené tabulky environmentvariabledefinition, a proto nevyžaduje samostatná oprávnění. Oprávnění pro tabulky environmentvariabledefinition jsou standardně zahrnuty v rolích zabezpečení Tvůrce prostředí a Základní uživatel. Další informace: Zabezpečení ve službě Dataverse.

Pojmenování

Zajistěte, aby názvy proměnných prostředí byly jedinečné, aby na ně bylo možné přesně odkazovat. Duplicitní zobrazované názvy proměnných prostředí ztěžují rozlišení a použití proměnných prostředí. Zajistěte, aby názvy proměnných prostředí byly jedinečné, aby na ně bylo možné přesně odkazovat. Názvy $autentication a $connection jsou speciálně vyhrazené parametry pro toky a je třeba se jim vyhnout. Uložení toku je zablokováno při použití proměnných prostředí s těmito názvy. Pokud se v toku použije proměnná prostředí a změní se zobrazovaný název proměnné prostředí, návrhář zobrazí staré i nové tokeny zobrazovaného názvu, aby pomohl s identifikací. Při aktualizaci procesu doporučujeme odebrat odkaz na proměnnou prostředí a poté ji znovu přidat.

Aktuální omezení

• Ověření hodnot proměnných prostředí probíhá v uživatelských rozhraních a v rámci komponent, které je používají, ale ne v rámci Dataverse. Proto se ujistěte, že jsou nastaveny správné hodnoty, pokud jsou upravovány pomocí kódu.
• Úlohy Power Platform Build Tools zatím nejsou k dispozici pro správu proměnných prostředí zdroj dat. To však neblokuje jejich použití v rámci nástrojů poskytovaných společností Microsoft a v systémech řízení zdrojů.
• Interakce s proměnnými prostředí pomocí vlastního kódu vyžaduje volání API k načtení hodnot; pro využití kódu jiných společností než Microsoft není vystavena mezipaměť.
• Proměnné prostředí jsou omezeny na maximálně 2 000 znaků.

Časté dotazy

Proč nevidím hodnotu mojí proměnné prostředí?

Pokud je proměnná prostředí ve spravovaném řešení, její hodnotu neuvidíte, dokud se nepodíváte dovnitř Výchozího řešení. Toto chování je záměrné, protože hodnota proměnné prostředí představuje neřízenou úpravu.

Jak mohu zobrazit, kde se proměnné prostředí používají?

Buď výběrem Zobrazit závislosti v rozhraní řešení, při vytváření komponent nebo v řízení zdroje a v souboru řešení zobrazením metadat aplikace nebo toku.

Jsou proměnné prostředí zdroje dat stejné jako připojení?

Ne. Přestože spolu souvisí, připojení představuje pověření nebo ověření vyžadované pro interakci s konektorem. Proměnné prostředí zdroje dat ukládají parametry, které jsou vyžadovány jednou nebo více akcemi v konektoru, a tyto parametry se často liší v závislosti na akci. Například připojení SharePoint Online neukládá žádné informace o webech, seznamech nebo knihovnách dokumentů. Proto volání konektoru vyžaduje platné připojení a některé další parametry.

Může můj automatizovaný kanál ALM používat soubory různých hodnot pro různá prostředí?

Ano. Balíček řešení přijímá název souboru jako vstupní parametr, takže vaše pipeline může zabalit soubor různých hodnot do řešení v závislosti na typu prostředí, ve kterém je prováděna.

Mám tuto hodnotu zahrnout do svého řešení?

Ne. Proměnné prostředí jsou určeny pro použití aplikacemi, které potřebují mít různé hodnoty v různých prostředích, kde je řešení nasazeno. Definice proměnných prostředí by měly být zahrnuty v řešení, ale hodnoty by měly být poskytnuty pro cílové prostředí během nasazení. Toto chování má za následek, že definice proměnné prostředí je objektem spravovaného řešení v cílovém prostředí, zatímco proměnná prostředí je nespravovaným záznamem.

Proč ve svém prostředí nemůžu odstranit hodnotu?

Pokud byla hodnota zahrnuta do spravovaného řešení, jediným způsobem, jak ji odstranit, je aktualizovat řešení ve zdrojovém prostředí tak, aby byla hodnota vyloučena, a poté exportovat novou verzi řešení. Tuto novou verzi je pak možné importovat do prostředí pomocí operace upgradu (nikoli aktualizace), což má za následek odstranění záznamu hodnoty.

Co když někdo omylem smaže hodnotu?

Pokud tomu již nebrání systém závislostí, modul runtime použije poslední známou hodnotu jako záložní.

Pokud se hodnota změní, kdy se nová hodnota začne používat v aplikacích plátna a v cloudových tocích?

Úplné publikování aktualizovaných proměnných prostředí může trvat až hodinu, protože hodnota je vložena do aplikací a teče asynchronně.

Jsou vyžadovány prémiové licence?

Ne. I když ALM vyžaduje Dataverse (nebo Dynamics 365 aplikace), použití prémiových konektorů se nevyžaduje. Jedinou výhradou je, pokud používáte konektor Dataverse pro interakci s proměnnými prostředí, jako byste to udělali s jinými datovými záznamy, jako jsou účty nebo kontakty. Dříve to byl jediný způsob, jak používat proměnné prostředí v aplikacích a tocích plátna.

Existuje limit na počet entit prostředí, které mohu mít?

Ne. Maximální velikost řešení je však 95 MB. Další informace: Vytvoření řešení

Lze lokalizovat zobrazované názvy a popisy proměnných prostředí?

Ano.

Mám místo uložení konfiguračních dat ve vlastních tabulkách použít proměnné prostředí?

Ano, pokud vaše konfigurační data nejsou relační. Proměnné prostředí by se měly používat pro páry klíč: hodnota a v případě, že se hodnota pravděpodobně potřebuje lišit v jiných prostředích. K migraci relačních konfiguračních dat uložených v uživatelských tabulkách se lépe hodí další nástroje, jako je nástroj pro migraci konfigurace. Na rozdíl od jiných konfiguračních dat se proměnné prostředí migrují v rámci řešení, a proto je jejich správa mnohem jednodušší a výkonnější při importu.

Proč není v proměnných prostředí zdroje dat uloženo moje připojení?

Připojení se používají pouze pro generování uživatelského rozhraní. Pokud chcete například načíst popisné názvy SharePoint seznamů přidružených k webu. Při úpravách proměnné prostředí zdroje dat nezapomeňte vybrat připojení s přístupem ke zdroji dat. Pokud již nemáte přístup k připojení, můžete zadat hodnotu ručně. Zadejte například adresu URL webu SharePoint nebo jedinečný identifikátor (GUID) seznamu.

Pokud je pro jednu proměnnou prostředí (typ zdroje dat) k dispozici více připojení, existuje návrhová implementace pro výběr prvního připojení v seznamu připojení. Protože s proměnnou prostředí je obvykle spojeno pouze jedno připojení, není to něco, co je obvykle potřeba ověřit. Navíc s nedávnými změnami viditelnosti hodnot proměnných prostředí je to při importu snazší ověřit.

Jak odeberu hodnotu z proměnné prostředí?

Před exportem řešení možná budete chtít z vašeho řešení odebrat hodnotu proměnné prostředí. Stávající hodnota pak zůstane ve vývojovém prostředí, ale není exportována do řešení. Tento přístup umožňuje poskytnout novou hodnotu při importu řešení do jiného prostředí.

Chcete-li hodnotu odebrat, postupujte takto:

1. V řešení, kde se nachází proměnná prostředí, vyberte tuto proměnnou pro zobrazení jejích vlastností.

2. V sekci Aktuální hodnota vyberte ...>Odebrat z tohoto řešení.

   

Mohu použít proměnné prostředí ve vlastních konektorech?

Ano. Podpora proměnných prostředí ve vlastních konektorech

Viz také

Použijte proměnné prostředí zdroje dat v aplikacích plátna
Použití proměnných prostředí v tocích cloudu řešení Power Automate
Odkaz na tabulku/entitu EnvironmentVariableDefinition
Ukázky webového rozhraní API
Použití proměnných prostředí zdroje dat v aplikacích plátna
Použití proměnných prostředí v cloudových tocích Power Automate řešení
Použití tajného kódu Azure Key Vault
Podpora proměnných prostředí ve vlastních konektorech
Power Apps Blog: Proměnné prostředí dostupné ve verzi Preview!