Променливи на средата за Power Platform общ преглед

Променливите на средата позволяват основния сценарий за управление на жизнения цикъл на приложението (ALM) за преместване на приложение между Power Platform среди. В този сценарий приложението остава абсолютно същото, с изключение на няколко ключови външни препратки към приложения (като таблици, връзки и ключове), които са различни между средата източник и средата местоназначение. Приложението изисква структурата на таблиците или връзките да бъде абсолютно еднаква между изходната и целевата среда, с някои разлики. Променливите на средата ви позволяват да укажете кои от тези различни външни препратки трябва да се актуализират, докато приложението се премества между среди.

Променливите на средата съхраняват ключовете и стойностите на параметрите, които след това служат като вход за различни други обекти на приложения. Разделянето на параметрите от консумиращите обекти ви позволява да променяте стойностите в една и съща среда или когато мигрирате решения към други среди. Алтернативата е оставянето на твърдо кодирани стойности на параметрите в компонентите, които ги използват. Този подход често е проблематичен; особено когато стойностите трябва да се променят по време на ALM операции. Тъй като променливите на средата са компоненти на решението, можете да транспортирате препратките (ключове) и да променяте стойностите, когато решенията се мигрират в друга среда.

Предимства от използването на променливи на средата:

• Предоставяне на нови стойности на параметри, докато импортирате решения в други среди.
• Съхранявайте конфигурацията за източниците на данни, използвани в приложенията и потоци на платно. Например, SharePoint параметрите на онлайн сайта и списъка могат да се съхраняват като променливи на средата. Този подход ви позволява да се свързвате с различни сайтове и списъци в различни среди, без да е необходимо да променяте приложенията и потоците.
• Опаковайте и транспортирайте вашите персонализиране и конфигурация заедно и ги управлявайте на едно място.
• Пакетни и транспортни тайни, като идентификационни данни, използвани от различни компоненти, отделно от компонентите, които ги използват.
• Една променлива на средата може да се използва в много различни компоненти на решението - независимо дали те са един и същи компонент или различни. Например приложение за платно и поток могат да използват една и съща променлива на средата. Когато стойността на променливата на средата трябва да се промени, трябва да промените само една стойност.
• Освен това, ако трябва да пенсионирате източник на данни в производствени среди, можете да актуализирате стойностите на променливите на средата с информация за новия източник на данни. Приложенията и потоците не изискват промяна и започват да използват новия източник на данни.
• Поддържани от SolutionPackager и DevOps инструментите позволяват непрекъсната интеграция и непрекъсната доставка (CI/CD).
• Променливите на средата могат да бъдат разопаковани и съхранени в контрола на източника. Можете също така да съхранявате различни файлове със стойности на променливи на средата за отделната конфигурация, необходима в различни среди. След това Solution Packager може да приеме файла, съответстващ на средата, в която е импортирано решението.

Как работят променливите на средата?

Променливите на средата могат да бъдат създадени и модифицирани в рамките на интерфейса на съвременното решение. Те могат също така да се създават автоматично при свързване към определени източници на данни в приложения за платно или с код. Те също могат да бъдат импортирани в среда чрез решения. Променливите на средата могат да се използват като входни данни при създаване на приложения за платно, Power Automate потоци, плъгини и добавяне Power BI на табла към приложения, управлявани от модел. Когато използвате променливи на средата, стойностите се извличат от променливите на средата и могат да бъдат променени, когато решенията се импортират в други среди.

Ръчно създаване на променлива на средата в решение

1. влезте в Power Apps (make.powerapps.com) и след това в левия прозорец изберете Решения. Ако елементът не е в страничния панел, изберете ... Още и след това изберете желания елемент.
2. Отворете желаното решение или създайте ново.
3. В командната лента изберете Нов още>, след което изберетеПроменлива на средата.
4. В десния прозорец попълнете следните колони и след това изберете Запиши:

   • Показвано име. Въведете име за променливата на средата.

   • Име. Уникалното име се генерира автоматично от показваното име, но можете да го промените.

   • Тип данни. Изберете от Десетично число, Текст, JSON, Две опции, Източник на данни или Тайна.

     Бележка

     • Ако източникът на данни е избраният тип, трябва да изберете конектора , валидна връзка за избрания конектор и типа на параметъра. Връзката не се съхранява като част от променливата на средата. Променливата на средата съхранява информацията не във връзката, която е необходима за свързване Power Apps към правилния сървър и таблица. Връзката се използва само за извличане на налични стойности на параметри като SharePoint сайтове, до които имате достъп, или списъците, свързани със сайт.

     • Ако Secret е избраният тип, е необходима допълнителна информация за настройване и конфигуриране на Azure Key Vault, за да се позволи Power Platform достъп до тайната.

   • Текуща стойност. Известен още като стойност. Това свойство е по избор и е част от таблицата със стойности на променливите на средата. Дефинирана стойност се използва дори ако е налице и стойност по подразбиране. Премахнете стойността от решението си, ако не искате да го използвате в следващата среда. Стойностите също са разделени на отделни JSON файлове в експортирания файл solution.zip и могат да бъдат редактирани офлайн. Повече информация: Как да премахна стойност от променлива на средата?

   • Стойност по подразбиране. Тази колона е част от таблицата с дефиниции на променливата на средата и не е задължителна. Стойността по подразбиране се използва, ако няма текуща стойност.

     Разделянето на стойността по подразбиране и текущата стойност ви позволява да обслужвате дефиницията и стойността по подразбиране отделно от стойността. Например, издател на приложение може да изброи своята оферта на AppSource със стойност по подразбиране. След това по желание клиентът може да предостави нова стойност. Когато издателят на приложението публикува актуализации на приложението, стойността, зададена от клиента, не се презаписва.

     

     Бележка

     Стойност не може да съществува без дефиниция. Интерфейсът позволява създаване само на една стойност на дефиниция.

Power Apps може автоматично да създава променливи на средата

В раздела Общи на Power Apps настройки:

• Активирайте опцията Автоматично създаване на променливи на средата при добавяне на източници на данни . Сега, когато добавите нов източник на данни към вашето приложение, той добавя променлива на средата за вас.

  

Различни източници на данни

Различните източници на данни позволяват различни типове променливи на средата.

Microsoft Dataverse

Power Apps свързва се естествено към Dataverse. Не се нуждаете от променлива на средата за таблици в текущата ви среда. Когато се свържете с Dataverse, вашето приложение автоматично търси точно същото име на таблица във всяка среда, в която го пренесете. Докато структурата на името на вашата таблица е същата в целевата среда, както е в оригиналната среда, тя работи.

Ако използвате външна таблица от различна среда (чрез Промяна на среда), тогава Power Apps предполага, че искате винаги да препращате към точно същата таблица. Нуждаете се от променлива на средата, ако имате нужда тази външна таблица да бъде различна външна таблица, когато преминете от dev към test или към prod. Най-лесно е да позволите на Power Apps автоматично да създаде променливата на средата вместо вас. (Ако преди това сте добавили таблицата към приложението си, след това включете превключвателя за настройки, пуснете външната таблица и след това я добавете обратно.)

Когато добавите външната таблица към вашето приложение, изберете раздела Разширени , за да изберете променливата на средата.

SharePoint

SharePoint поддържа само Microsoft Entra връзки. Така че за SharePoint, в допълнение към валидна връзка, се изисква отделна променлива на средата за сайт и списък.

За да използвате успешно променливи на средата с SharePoint списъци:

• Показваното име и логическото име за всяка съответстваща колона в изходната и целевата среда трябва да съвпадат.
• Променливите на средата за SharePoint трябва да имат съответстващи метаданни. SharePoint има вътрешни идентификатори, които може да не съвпадат между целевите среди. Например, ако създадете списък със същото име и колони в целева среда, вътрешните имена няма да съвпадат. Метаданните винаги съвпадат, ако дублирате SharePoint сайт и го копирате във вашата целева среда.

SQL Server

SQL Server поддържа много различни видове удостоверяване и връзки. Използвайте променливи на средата за Microsoft Entra връзки. Необходима е отделна променлива на средата за сървъра и базата данни. Приложението е обвързано с конкретни имена на таблици, така че се приема, че те са еднакви в различните среди.

Не използвайте променливи на средата за споделени връзки като основно SQL удостоверяване с SQL Server. Използвайте препратки към свързване за информация, която традиционно се предава като част от низа за свързване. Всички основни параметри за удостоверяване на SQL са част от низа за свързване. Например името на сървъра и базата данни се предоставят при създаването на връзката и следователно винаги се извличат от връзката.

Променливите на средата на източника на данни се използват за конектори с удостоверяване като Microsoft Entra. При тези типове връзки Power Apps има само идентифициран потребител. Power Apps не може да извлече от връзката с каква услуга или таблица възнамерявате да работите.

Въведете нови стойности, докато импортирате решения

Съвременният интерфейс за импортиране на решения включва възможност за въвеждане на стойности за променливи на околната среда. Това задава свойството стойност на environmentvariablevalue таблицата.

Стойностите на променливите на средата са видими при импортиране на решения или при използване на конвейери за внедряване. Променливите на средата без стойност по подразбиране или подкана за стойност, но тези, които иначе са предварително попълнени с етикет под текстовата област, обозначаващ източника на стойността: стойност на решението, стойност на целевата среда или стойност по подразбиране.

Уведомявания

Известие се показва, когато променливите на средата нямат никакви стойности. Задайте стойностите така, че компонентите, зависещи от променливите на средата, да не се провалят.

Защита

Масата environmentvariabledefinition е собственост на потребител или екип. Когато създавате приложение, което използва променливи на средата, не забравяйте да присвоите на потребителите подходящото ниво на привилегии на тази таблица. Разрешението за таблицата environmentvariablevalue се наследява от родителската таблица environmentvariabledefinition и следователно не изисква отделни привилегии. Привилегиите за environmentvariabledefinition таблици са включени в ролите за защита на Environment Maker и Basic User по подразбиране. Повече информация: Сигурност в Dataverse.

Именуване

Уверете се, че имената на променливите на средата са уникални, за да могат да бъдат препращани точно. Дублиращите се показвани имена на променливи на средата правят променливите на средата трудни за разграничаване и използване. Уверете се, че имената на променливите на средата са уникални, за да могат да бъдат препращани точно. Имената $authentication и $connection са специално запазени параметри за потоци и трябва да се избягват. Запазването на потока се блокира, ако се използват променливи на средата с тези имена. Ако променлива на обкръжението се използва в поток и екранното име на променливата на обкръжението е променено, тогава дизайнерът показва както старите, така и новите токени за показвано име, за да помогне при идентифицирането. Когато актуализирате потока, ви препоръчваме да премахнете препратката към променливата на средата и да я добавите отново.

Текущи ограничения

• Проверката на стойностите на променливите на средата се случва в потребителските интерфейси и в компонентите, които ги използват, но не и в Dataverse. Затова се уверете, че са зададени правилни стойности, ако те се модифицират чрез код.
• Power Platform Задачите на инструментите за изграждане все още не са налични за управление на променливи на средата на източник на данни. Това обаче не блокира тяхното използване в рамките на предоставените от Microsoft инструменти и в системите за контрол на източника.
• Взаимодействието с променливите на средата чрез потребителски код изисква извикване на API за извличане на стойностите; няма кеш, изложен за използване на код, който не е на Microsoft.
• Променливите на средата са ограничени до максимум 2000 знака.

Често задавани въпроси

Защо не мога да видя стойността на моята променлива на средата?

Ако променливата на средата е в управлявано решение, няма да можете да видите стойността, освен ако не погледнете вътре в разрешението по подразбиране. Това поведение е проектирано, тъй като стойността на променливата на средата е неуправляема персонализация.

Как мога да видя къде се използват променливи на средата?

Или чрез избиране на Показване на зависимости в интерфейса на решението, докато създавате компоненти, или в контрола на източника и във файла на решението, като прегледате метаданните на приложението или потока.

Същите ли са променливите на околната среда източник на данни като връзките?

Не. Въпреки че са свързани, връзката представлява идентификационни данни или удостоверяване, необходими за взаимодействие с конектора. източник на данни променливите на средата съхраняват параметри, които се изискват от едно или повече действия в съединителя и тези параметри често варират в зависимост от действието. Например, връзката на SharePoint Online не съхранява никаква информация за сайтове, списъци или библиотеки с документи. Следователно извикването на конектора изисква както валидна връзка, така и още някои параметри.

Може ли моят автоматизиран ALM конвейер да използва файлове с различни стойности за различни среди?

Да. Опаковчикът на решения приема името на файла като входни параметри, така че вашият конвейер може да пакетира различен файл със стойности в решението в зависимост от типа среда, срещу която се изпълнява.

Трябва ли да включа стойността в моето решение?

Не. Променливите на средата са предназначени да се използват от приложения, които трябва да имат различни стойности в различни среди, където е внедрено решението. Дефинициите на променливите на средата трябва да бъдат включени във вашето решение, но стойностите трябва да бъдат предоставени за целевата среда по време на внедряването. Това поведение води до това, че дефиницията на променливата на средата е управляван обект на решение в целевата среда, докато променливата на средата е неуправляван запис.

Защо не мога да изтрия стойност в моята среда?

Ако стойността е била включена в управлявано решение, единственият начин да изтриете стойността е да актуализирате решението в изходната среда, за да изключите стойността, след което да експортирате нова версия на решението. След това тази нова версия може да бъде импортирана в средата чрез операция за надграждане (не актуализация), което води до изтриване на записа на стойността.

Ами ако някой неволно изтрие стойност?

Ако вече не е предотвратено от системата за зависимост, времето за изпълнение използва последната известна стойност като резервна.

Ако дадена стойност се промени, кога новата стойност се използва в приложения на платното и облачни потоци?

Пълното публикуване на актуализираните променливи на средата може да отнеме до един час, тъй като стойността се вкарва в приложенията и протича асинхронно.

Изискват ли се премиум лицензи?

Не. Въпреки че ALM изисква Dataverse (или приложения на Dynamics 365), използването на премиум конектори не е необходимо. Единственото предупреждение е, ако използвате Dataverse конектор за взаимодействие с променливи на околната среда, както бихте направили с други записи на данни като акаунти или контакти. По-рано това беше единственият начин да се използват променливи на околната среда в приложения и потоци на платното.

Има ли ограничение на броя променливи на среди, които мога да имам?

Не. Максималният размер на решението обаче е 95 MB. Повече информация: Създаване на решение

Могат ли да се локализират имената и описанията на променливите на средата?

Да.

Трябва ли да използвам променливи на средата, вместо да съхранявам конфигурационни данни в потребителски таблици?

Да, ако данните ви за конфигурация не са релационни. Променливите на околната среда трябва да се използват за двойки ключ: стойност и когато стойността вероятно трябва да се различава в други среди. Други инструменти като помощната програма за конфигуриране на конфигурация са по-подходящи за мигриране на релационни данни за конфигурация, съхранявани в потребителски таблици. За разлика от други данни за конфигурация, променливите на средата се мигрират в рамките на решения и следователно много по-лесно за управление и по-ефективни за импортиране.

Защо връзката ми не е запазена за променливите на средата на източника на данни?

Връзките се използват само за генериране на потребителския интерфейс. Например, за да извлечете удобни имена за SharePoint списъци, свързани със сайт. Когато редактирате променлива на среда на източник на данни, не забравяйте да изберете връзка с достъп до източника на данни. Ако вече нямате достъп до връзката, можете ръчно да въведете стойност. Например въведете SharePoint URL адреса на сайта или уникалния идентификатор (GUID) за списък.

Когато има множество налични връзки за една променлива на средата (тип източник на данни), има внедряване по проект за избор на първата връзка в списъка с връзки. Тъй като обикновено има само една връзка, свързана с променлива на средата, това не е нещо, което обикновено трябва да бъде валидирано. Освен това, с последните промени в видимостта на стойността на променливата на средата, това е по-лесно за валидиране при импортиране.

Как да премахна стойност от променлива на среда?

Може да искате да премахнете стойността на променлива на околната среда от вашето решение, преди да експортирате решението. След това съществуващата стойност остава във вашата среда за разработка, но не се експортира в решението. Този подход позволява да се предостави нова стойност при импортиране на решението в друга среда.

За да премахнете стойност, изпълнете следните стъпки:

1. В решението, където се намира променливата на околната среда, изберете променливата на средата, за да покажете свойствата.

2. Под Текуща стойност изберете ...>Премахване от това решение.

   

Мога ли да използвам променливи на средата в потребителски конектори?

Да. Поддръжка на променливи на средата в потребителски конектори

Вижте също

Използвайте променливи на средата на източника на данни в приложения за платно
Използвайте променливи на средата в Power Automate облачни потоци на решение
Примери
за таблица/обект на EnvironmentVariableDefinition Примери за уеб API
Използване на променливи на средата на източника на данни в приложения
за платно Използване на променливи на средата в Power Automate потоци
в облака на решения Използване на тайни
на Azure Key Vault Поддръжка на променливи на средата в персонализирани конектори
Power Apps Блог: Променливи на средата, налични в предварителен преглед!