Делите путем

Системске варијабле за Power Platform преглед

  • Чланак

Варијабле окружења омогућавају основни сценарио управљања животним циклусом апликација (АЛМ) за премештање апликације између Power Platform окружења. У овом сценарију, апликација остаје потпуно иста, осим неколико кључних спољних референци апликација (као што су табеле, везе и кључеви) који се разликују између изворног окружења и одредишног окружења. Апликација захтева да структура табела или веза буде потпуно иста између изворног и одредишног окружења, са неким разликама. Системске променљиве вам омогућавају да одредите које од ових различитих спољних референци треба да се ажурирају како се апликација помера преко окружења.

Променљиве окружења чувају кључеве и вредности параметара, који затим служе као улаз за разне друге објекте апликација. Одвајање параметара од објеката који троше омогућава вам да промените вредности унутар истог окружења или када мигрирате решења у друга окружења. Алтернатива је остављање чврсто кодираних вредности параметара унутар компонената које их користе. Ово је често проблематично; посебно када је потребно променити вредности током операција АЛМ-а. Будући да су променљиве окружења компоненте решења, можете пренети референце (кључеве) и променити вредности када се решења мигрирају у друга окружења.

Напомена

Нове могућности за изворе података су тек у примени и можда још увек нису доступне у вашем региону.

Предности коришћења променљивих окружења:

  • Наведите нове вредности параметара док увозите решења у друга окружења.
  • Сачувајте конфигурацију за изворе података који се користе у апликацијама са подлогом и токовима. На пример, параметри SharePoint Online локација и листа могу се чувати као променљиве окружења, што вам омогућава повезивање са различитим локацијама и листама у различитим окружењима без потребе за модификовањем апликација и токова.
  • Запакујте и пренесите прилагођавање и конфигурацију заједно и управљајте њима на једном месту.
  • Паковање и транспорт тајни, као што су акредитиви које користе различите компоненте, одвојено од компоненти које их користе.
  • Једна променљива окружења може се користити у многим различитим компонентама решења – било да се ради о истој или различитој врсти компоненти. На пример, апликација са подлогом и ток могу да користе исту променљиву окружења. Када вредност променљиве околине треба да се промени, треба да промените само једну вредност.
  • Поред тога, ако желите да повучете < ДИЦТ__извор података > дата соурце </ДИЦТ__извор података > у производним окружењима, можете ажурирати вредности променљиве окружења са информацијама за нови < ДИЦТ__извор података > дата соурце</ДИЦТ__извор података >. Апликације и токови не захтевају модификацију и почињу да користе нови < ДИЦТ__извор података > дата соурце</ДИЦТ__извор података >.
  • Подржавано алатима SolutionPackager и DevOps, омогућава се континуирана интеграција и континуирана испорука (CI/CD).
  • Променљиве окружења могу се распаковати и сачувати у контроли извора. Такође можете да сачувате различите вредности променљивих окружења за одвојену конфигурацију потребну у различитим окружењима. Солутион Пацкагер тада може да прихвати датотеку која одговара окружењу у које се увози решење.

Како функционишу варијабле окружења?

Променљиве окружења могу се креирати и модификовати у модерном интерфејсу решења, које се аутоматски креира приликом повезивања са одређеним изворима података у апликацијама са подлогом или помоћу кода. Такође се могу увести у окружење путем решења. Када су варијабле окружења присутне у окружењу, могу се користити као улази приликом креирања апликација платна, токова, 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 су подразумевано укључене у безбедносне улоге Аутор окружења и Основни корисник. Још информација: Безбедност у услузи Dataverse.

Именовање

Уверите се да су имена променљивих окружења јединствена тако да се на она могу прецизно референцирати. Дуплирана имена за приказ променљивих окружења отежавају њихово разликовање и коришћење. Уверите се да су имена променљивих окружења јединствена тако да се на она могу прецизно референцирати. Називи $authentication и $connection су нарочито резервисани параметри за токове и треба их избегавати. Чување протока је блокирано ако се користе системске променљиве са тим именима. Ако се променљива окружења користи у току и < ДИЦТ__име за приказ > дисплаy наме </ДИЦТ__име за приказ > променљиве окружења се мења, онда дизајнер приказује и старе и нове < ДИЦТ__име за приказ > дисплаy наме </ДИЦТ__име за приказ > токене како би помогао у идентификацији. Када ажурирате ток, препоручујемо да уклоните референцу променљиве окружења и додате је поново.

Тренутна ограничења

  • Провера ваљаности променљивих окружења се дешава унутар корисничког интерфејса и унутар компоненти које их користе, али не и унутар услуге Dataverse. Стога осигурајте да су постављене одговарајуће вредности ако се оне мењају помоћу кода.
  • Power Platform Build Tools задаци још нису доступни за управљање променљивим окружења за извор података. Међутим, ово не блокира њихову употребу у алатима које нуди Microsoft и у системима за контролу извора.
  • Интеракција са променљивим окружења преко прилагођеног кода захтева АПИ позив за дохваћање вредности; не постоји кеш изложен за не-Мицрософт код за коришћење.
  • Да би се успешно користиле системске променљиве са SharePoint списковима, < ДИЦТ__име за приказ > дисплаy наме </ДИЦТ__име за приказ > и логичко име за сваку одговарајућу колону у изворном и циљном окружењу морају да се поклапају.
  • Варијабле окружења су ограничене на максимално 2.000 знакова.

Најчешћа питања

Зашто не могу да видим вредност за моју променљиву окружења?

Ако је променљива окружења у < ДИЦТ__комплетно решење > манагед солутион </ДИЦТ__комплетно решење >, нећете моћи да видите вредност осим ако не погледате унутар подразумеваног решења. Ово понашање је по дизајну, јер је вредност променљиве окружења неуправљано прилагођавање.

Како могу да видим где се користе променљиве окружења?

Било ако одаберете Прикажи зависности у интерфејсу решења, док ауторизујете компоненте или у контроли извора и у датотеци решења прегледом метаподатака апликације или тока.

Да ли су променљиве окружења за извор података исте као везе?

Не. Иако су повезани, веза представља акредитиву или аутентификацију потребну за интеракцију са конектором. Променљиве окружења за извор података чувају параметре који су потребни за једну или више радњи у конектору и ти параметри се често разликују у зависности од радње. На пример, SharePoint Online веза не чува никакве информације о локацијама, листама или библиотекама докумената. Због тога позивање конектора захтева и валидну везу и неке додатне параметре.

Могу ли се променљиве окружења за извор података користити са дељеним везама као што је SQL Server са SQL потврдом идентитета?

У принципу, не. Дељене везе као што је SQL Server чувају параметре потребне за повезивање са подацима унутар везе. На пример, име сервера и базе података даје се приликом креирања везе и стога се увек изводи из везе.

< ДИЦТ__извор података >дата соурце </ДИЦТ__извор података > променљиве окружења се користе за конекторе који се ослањају на аутентификацију засновану на кориснику, као што су Microsoft Entra ИД јер параметри не могу бити изведени из везе. Из тих разлога, потврда идентитета помоћу услуге SQL Server неће користити променљиве окружења за извор података.

Да ли мој аутоматизовани ALM канал користи датотеке различитих вредности за различита окружења?

Да. Алатка за прављење пакета решења прихвата име датотеке као улазне параметре, тако да ваш канал може спаковати датотеку различитих вредности у решење, у зависности од типа окружења на којем се извршава.

Шта ако неко нехотично избрише вредност?

Ако већ није спречен системом зависности, рунтиме користи последњу познату вредност као резерву.

Ако се вредност промени, када се нова вредност користи у апликацијама са подлогом и у токовима у облаку?

Може потрајати и до сат времена да се у потпуности објаве ажуриране променљиве окружења, јер се вредност гура у апликације и тече асинхроно.

Да ли су потребне premium лиценце?

Не. Док ALM захтева Dataverse (или Dynamics 365 for Customer Engagement), употреба premium конектора није потребна. Једини изузетак је ако користите Dataverse конектор за интеракцију са променљивима окружења као што бисте то учинили са другим записима података попут налога или контаката. Раније је ово био једини начин коришћења променљивих окружења у апликацијама са подлогом и токовима.

Постоји ли ограничење броја променљивих окружења које могу да имам?

Не. Међутим, максимална величина решења је 95 MB. Додатне информације: Креирање решења

Могу ли се имена за приказ и описи променљивих окружења локализовати?

Да.

Да ли треба да користим променљиве окружења уместо да складиштим податке о конфигурацији у прилагођеним табелама?

Да, ако ваши подаци о конфигурацији нису релациони. Променљиве окружења треба користити за парове кључ:вредност и када вредност вероватно треба да се разликује у другим окружењима. Остале алатке попут услужног програма Миграција конфигурације погоднији су за миграцију релационих података конфигурације који се чувају у прилагођеним табелама. За разлику од осталих података о конфигурацији, променљиве окружења се мигрирају унутар решења и стога су много једноставније за управљање и лакше за увоз.

Зашто је другачија вредност везе од оне коју желим аутоматски додељује приликом увоза?

У неким случајевима када постоји више веза доступних за једну променљиву окружења (типа извора података), постоји имплементација по дизајну да изабере прву везу на листи веза доступних за променљиву окружења. Зато што обично постоји само једна веза повезана са променљивом окружења, то није нешто што обично треба да се потврди. Поред тога, са недавним променама видљивости променљиве вредности окружења, ово је лакше потврдити приликом увоза.

Како да уклоним вредност из променљиве окружења?

Можда ћете желети да уклоните вредност променљиве окружења из свог решења пре извоза решења. Затим, постојећа вредност остаје у вашем развојном окружењу, али се не извози у решење. Овај приступ омогућава да се обезбеди нова вредност при увозу решења у друго окружење.

Да бисте уклонили вредност, пратите следеће кораке:

  1. У решењу где се налази променљива окружења изаберите променљиву окружења да бисте приказали својства.

  2. У оквиру Тренутне вредности, изаберите ... > Уклони из овог решења.

    Уклањање вредности из променљиве окружења

Могу ли да користим променљиве окружења у прилагођеним конекторима?

Да. Подршка за променљиве окружења у прилагођеним конекторима

Погледајте и

Користите < ДИЦТ__извор података > дата соурце </ДИЦТ__извор података > променљиве окружења у апликацијама платна
Користите варијабле окружења у Power Automate токовима облака решења
Референца табеле/ентитета EnvironmentVariableDefinition
Примери Web API-ја
Користите < ДИЦТ__извор података > дата соурце </ДИЦТ__извор података > променљиве окружења у апликацијама Цанвас
Користите варијабле окружења у Power Automate токовима облака решења
Користите тајне Азуре Кеи Ваулт
Подршка за променљиве окружења у прилагођеним конекторима
Power Apps блог: Променљиве окружења доступне у прегледу!

Напомена

Можете ли нам рећи о својим жељеним поставкама језика у документацији? Испуните кратку анкету. (имајте на уму да је ова анкета на енглеском језику)

Анкета ће трајати око седам минута. Не прикупљају се лични подаци (изјава о приватности).