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í. To je často problematické; zvláště když je třeba během operací (ALM) změnit hodnoty. 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í.

Poznámka:

Právě se nasazují nové funkce pro zdroje dat a ve vaší oblasti ještě nemusí být k dispozici.

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 web SharePoint Online a parametry seznamu lze uložit jako proměnné prostředí; proto vám umožní 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 upravovat v rámci moderního rozhraní řešení, automaticky vytvářet 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í. Jakmile jsou proměnné prostředí přítomny v prostředí, lze je použít jako vstupy při vytváření aplikací plátna, toků Power Automate při vývoji modulů plug-in a na mnoha dalších místech, jako je přidání řídicího panelu Power BI do modelem řízené aplikace. Když tyto typy objektů používají 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í.

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 také vybrat konektor, platné připojení pro vybraný konektor a typ parametru. Připojení však není uloženo jako součást proměnné prostředí. 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. Pro určité parametry, jako jsou seznamy SharePoint, budete také muset vybrat nadřazenou proměnnou prostředí zdroje dat, například web SharePoint. Po uložení budou v databázi související.
     • 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í. Pokud je hodnota k dispozici, bude 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.

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.

Počínaje aktualizací ze 7. prosince 2023 jsou všechny hodnoty proměnných prostředí viditelné při importu řešení (nebo při používání kanálu k nasazení). Proměnné prostředí bez výchozí hodnoty nebo hodnoty budou vyzvány k zadání hodnoty, ale jinak jsou předvyplněny pod textovou oblastí popiskem označujícím 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 varová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í varování, ale je třeba jej vzít na vědomí podle toho, jak plánujete používat 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 stávající hodnota zůstane ve vašem vývojovém prostředí, ale nebude exportována v ř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í. Toto je připomenutí k nastavení hodnot tak, aby komponenty závislé na proměnných prostředí neselhaly.

Zabezpečení

Tabulku environmentvariabledefinition vlastní 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ěť.
• Chcete-li úspěšně používat proměnné prostředí se seznamy SharePoint, zobrazovaný a logický název každého odpovídajícího sloupce ve zdrojovém a cílovém prostředí se musí shodovat.
• 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.

Lze zdroj dat proměnné prostředí použít se sdílenými připojeními, jako je například SQL Server s ověřováním SQL?

Obecně ne. Sdílená připojení se serverem SQL ukládají parametry potřebné pro připojení k datům v rámci připojení. 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í zdroj dat se používají pro konektory, které se spoléhají na ověřování založené na uživateli, jako je Microsoft Entra ID, protože parametry nelze odvodit z připojení. Z těchto důvodů nebude ověřování pomocí serveru SQL Server, což je sdílené připojení, používat proměnné prostředí zdroj dat.

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!