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 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 plátna a tok 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í lze 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 modelem řízených aplikací. 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í proměnné prostředí v řešení

1. Přihlaste se do Power Apps (make.powerapps.com) a v levém podokně vyberte Řešení. 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 (Název): 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í uchovává informace, které nejsou součástí připojení a které jsou nutná pro připojení Power Apps ke správnému serveru a tabulce. Připojení se používá pouze pro načítání dostupných hodnot parametrů, jako jsou weby SharePoint, ke kterým máte přístup, nebo seznamy spojené s webem.

     • Pokud je vybraný typ Tajný kód, jsou třeba další informace k nastavení a konfiguraci Azure Key Vault, aby měal Power Platform přístup k tajnému kódu.

   • Current Value. 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 svoji nabídku v AppSource 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. Když teď do aplikace přidáte nový zdroj dat, přidá 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í (volbou Změnit prostředí), Power Apps předpokládá, že chcete vždy odkazovat na úplně stejnou tabulku. Proměnnou prostředí potřebujete, pokud má být tato externí tabulka jinou externí tabulkou, když přecházíte z vývojového do testovacího nebo provozního prostředí. Nejjednodušší je povolit aplikaci Power Apps automatické vytvoření proměnné prostředí za vás. (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 v případě SharePoint je kromě platného připojení vyžadována samostatná proměnná prostředí pro Web a Seznam.

Úspěšné použití proměnných 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 shodují, pokud duplikujete web SharePoint a zkopírujete ho do cílového prostředí.

SQL Server

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

Proměnné prostředí nepoužívejte pro sdílená připojení, jako je základní ověřování SQL pomocí SQL Serveru? Odkazy na připojení použijte pro informace, které se tradičně předávají jako součást připojovacího řetězce. Základní SQL parametry ověřování jsou součástí připojovacího řetězce. 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 s ověřováním typu Microsoft Entra. V těchto typech připojení má Power Apps pouze identifikovaného uživatele. Z připojení Power Apps nemůže odvodit, s jakou službou nebo tabulkou chcete pracovat.

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í kanálů k nasazení. Proměnné prostředí bez výchozí hodnoty nebo hodnoty vyzvou k zadání hodnoty, ale ty jinak jsou předvyplněny popiskem pod textovou oblastí označujícím zdroj hodnoty: hodnotu řešení, hodnotu cílového prostředí nebo výchozí hodnotu.

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í?

Všechna 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 toku doporučujeme odebrat odkaz na proměnnou prostředí a znovu ji 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ů.

Nejčastější 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 nespravované vlastní nastavení.

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 zdroj dat proměnné prostředí stejné jako připojení?

Č. 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í parametry, takže váš kanál může zabalit soubor různých hodnot do řešení v závislosti na typu prostředí, proti kterému se provádí.

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

Č. 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?

Č. Zatímco ALM vyžaduje Dataverse (nebo aplikace Dynamics 365), použití konektorů Premium není nutné. 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?

Č. 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í moje připojení uloženo pro proměnné prostředí zdroje dat?

Připojení se používají pouze pro generování uživatelského rozhraní. Například k načtení popisných názvů seznamů SharePoint 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 je umístěna proměnná prostředí, vyberte proměnnou prostředí, čímž zobrazíte vlastnosti.

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 cloudových tocích řešení Power Automate
Odkaz na tabulku/entitu EnvironmentVariableDefinition
ukázka Web 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 řešení Power Automate
Použití tajných kódů Azure Key Vault
Podpora proměnných prostředí ve vlastních konektorech
Power Apps Blog: Proměnné prostředí jsou dostupné ve verzi preview!