Споделяне чрез

Променливи на средата за 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 г., всички стойности на променливите на средата са видими при импортиране на решения (или при използване на Pipelines за внедряване). Променливите на средата без стойност или стойност по подразбиране ще бъдат подканени за стойност, но тези в противен случай са предварително попълнени с етикет под текстовата област, обозначаващ източника на стойността: стойност на решението, целева стойност на средата или стойност по подразбиране.

Видимост на променливата на средата по време на импортиране на решение.

Бележка

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

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

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

Защита

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

Именуване

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Да.

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

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

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

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

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

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

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

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

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

    Премахнете стойността от променлива на средата

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

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

Вижте също

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

Бележка

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

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