Променливи на средата за 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, Две опции, Източник на данни или Тайна.

     Бележка

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

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

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

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

     

     Бележка

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

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

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

Започвайки с актуализация на 7 декември 2023 г., всички стойности на променливите на средата са видими при импортиране на решения (или при използване на тръбопроводи за разполагане). Променливите на средата без стойност или стойност по подразбиране ще бъдат подканени за стойност, но тези, които иначе са предварително попълнени с етикет под текстовата област, обозначаващ източника на стойността: стойност на решението, стойност на целевата среда или стойност по подразбиране.

Бележка

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

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

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

Защита

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

Именуване

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

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

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

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

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

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

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

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

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

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

Могат ли променливите на средата източник на данни да се използват със споделени връзки като SQL Server с SQL удостоверяване?

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

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

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

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

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

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

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

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

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

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

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

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

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

Да.

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

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

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

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

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

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

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

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

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

   

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

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

Вижте също

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

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).