Делите путем


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

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

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

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

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

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

Варијабле окружења могу се креирати и модификовати у оквиру модерног интерфејса решења. Они се такође могу аутоматски креирати приликом повезивања са одређеним изворима података у апликацијама платна или са кодом. Такође се могу увести у окружење путем решења. Варијабле окружења могу се користити као улази приликом креирања апликација, токова, Power Automate додатака и додавања Power BI контролних табли у апликације засноване на моделу. Када користите системске променљиве, вредности се затим изводе из варијабли окружења, и могу се мењати када се решења увозе у друга окружења.

Ручно креирајте променљиву окружења у решењу

  1. Пријавите се на Power Apps (#пии_ијфидејз), а затим у левом окну изаберите Решења. Ако ставка није у панелу бочног панела, изаберите ... Више , а затим изаберите ставку коју желите.
  2. Отворите решење које желите или направите ново.
  3. На командној траци, изаберите Ново > више , а затим изаберите Системска променљива.
  4. У десном окну, попуните следеће колоне, а затим изаберите Сачувај:
    • Име за приказ. Унесите назив за променљиву окружења.

    • Име и презиме. Јединствено име се аутоматски генерише из Приказ имена , али можете да га промените.

    • Тип података. Изаберите из Децимални број , Текст , ЈСОН, Две опције , Извор података или Тајна.

      Белешка

      • Ако је извор података изабрани тип, потребно је да изаберете конектор , важећу везу за изабрани конектор и тип параметра. Веза се не чува као део променљиве окружења. Променљива окружења чува информације које нису у вези која је неопходна за повезивање Power Apps са правим сервером и табелом. Веза се користи само за преузимање доступних вредности параметара као што су SharePoint локације којима имате приступ или листе повезане са локацијом.
      • Ако је Тајна изабрани тип, потребне су додатне информације за подешавање и конфигурисање Азуре Кеи Ваулт-а како би се омогућио Power Platform приступ тајни.
    • Тренутна вредност. Такође је позната као вредност. Ово својство је опционо и део је табеле вредности променљиве окружења. Дефинисана вредност се користи чак и ако је подразумевана вредност такође присутна. Уклоните вредност из решења ако не желите да је користите у следећем окружењу. Вредности су такође раздвојене у засебне JSON датотеке у извезеној датотеци solution.zip и могу се уређивати ван мреже. Више информација: Како да уклоним вредност из променљиве окружења?

    • Подразумевана вредност. Ова колона је део табеле дефиниције променљиве окружења и није потребна. Подразумевана вредност се користи ако нема тренутне вредности.

      Раздвајање подразумеване вредности и тренутне вредности омогућава вам да сервисирате дефиницију и подразумевану вредност одвојено од вредности. На пример, издавач апликације може да наведе своју понуду са AppSource подразумеваном вредношћу. Затим клијент може опционално да пружи нову вредност. Када издавач апликације објави ажурирања апликације, вредност коју је поставио купац се не преписује.

      Нова променљива окружења.

      Белешка

      Вредност не може да постоји без дефиниције. Интерфејс омогућава креирање само једне вредности по дефиницији.

Power Apps може аутоматски креирати променљиве окружења

На картици Опште Power Apps подешавања:

  • Омогућите Аутоматски креирајте системске променљиве приликом додавања извора података опција. Сада, када додате нови извор података у вашу апликацију, он додаје променљиву окружења за вас.

    Аутоматско креирање променљиве окружења.

Различити извори података

Различити извори података омогућавају различите врсте варијабли окружења.

Мицрософт Датаверсе

Power Apps повезује изворно са. Dataverse Не треба вам променљива окружења за табеле у вашем тренутном окружењу. Када се повежете са Dataverse, ваша апликација аутоматски тражи потпуно исто име табеле у било ком окружењу које га портујете. Докле год је структура имена табеле иста у циљном окружењу као што је у оригиналном окружењу, она функционише.

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

Када додате спољну табелу у апликацију, изаберите картицу Напредно да бисте изабрали променљиву окружења.

Спољно окружење  Dataverse  променљива окружења.

SharePoint

SharePoint Подржава само Microsoft Entra везе. Дакле, за SharePoint, поред важеће везе, потребна је посебна променљива окружења за Сите и Листу.

Да бисте успешно користили системске променљиве са SharePoint списковима:

  • Име за приказ и логичко име за сваку одговарајућу колону у изворном и циљном окружењу морају да се поклапају.
  • Системске променљиве за SharePoint морају имати одговарајуће метаподатке. SharePoint има интерне идентификаторе који се можда не подударају између циљних окружења. На пример, ако креирате листу са истим именом и колонама у циљном окружењу, интерна имена се неће подударати. Метаподаци се увек поклапају ако дуплирате SharePoint сајт и копирате га у циљно окружење.

SQL Server

СКЛ Сервер подржава много различитих типова аутентификације и веза. Користите системске променљиве за Microsoft Entra везе. Посебна променљива окружења је потребна за сервер и базу података. Апликација је везана за одређене називе табела, тако да се претпоставља да су исти између окружења.

Немојте користити променљиве окружења за дељене везе као што је основна СКЛ аутентификација са СКЛ Сервером. Користите референце везе за информације које се традиционално прослеђују као део ниска везе. Основни СКЛ аутх параметри су део низа повезивања. На пример, име сервера и базе података даје се приликом креирања везе и стога се увек изводи из везе.

Променљиве окружења извора података користе се за конекторе са аутентификацијом као што су Microsoft Entra. У овим врстама веза, Power Apps има само идентификованог корисника. Power Apps Не могу да извучете коју услугу или табелу намеравате да радите из везе.

Унесите нове вредности док увозите решења

Савремени интерфејс за увоз решења укључује могућност уноса вредности за променљиве окружења. Ово поставља вредност особину на табели environmentvariablevalue .

Вредности варијабли окружења су видљиве приликом увоза решења или када се користе цевоводи за примену. Системске променљиве без подразумеване вредности или вредности траже вредност, али оне које су иначе унапред попуњене ознаком испод текстуалне области која означава извор вредности: вредност решења, вредност циљног окружења или подразумевану вредност.

Видљивост променљиве окружења током увоза решења.

Белешка

  • У неким случајевима, за одређене вредности променљиве окружења извора података, упозорење о одбијености приступа може се појавити ако произвођач увоза нема приступ вези или извору који се користи за променљиву окружења. Ово је упозорење које не блокира, али нешто што треба узети у обзир у зависности од тога како планирате да користите променљиву окружења у циљном окружењу.
  • Можете уклонити вредност из вашег решења пре извоза решења. Ово осигурава да постојећа вредност остане у вашем развојном окружењу, али се неће извозити у решење. Овај приступ омогућава навођење нове вредности при увозу решења у друга окружења. Више информација: Како да уклоним вредност из променљиве окружења?

Обавештења

Обавештење се приказује када променљиве окружења немају никакве вредности. Подесите вредности тако да компоненте које зависе од променљивих окружења не пропадну.

Безбедност

Табела environmentvariabledefinition је у власништву корисника или тима. Када креирате апликацију која користи променљиве окружења, обавезно доделите корисницима одговарајући ниво привилегија овој табели. Дозвола за табелу environmentvariablevalue је наслеђена од родитељске environmentvariabledefinition табеле и стога не захтева посебне привилегије. Привилегије за environmentvariabledefinition табеле су подразумевано укључене у безбедносне улоге Енвиронмент Макер и Басиц Усер. Више информација: Безбедност у Dataverse.

Именовање

Уверите се да су имена променљивих окружења јединствена тако да се на она могу прецизно референцирати. Дуплирана имена за приказ променљивих окружења отежавају њихово разликовање и коришћење. Уверите се да су имена променљивих окружења јединствена тако да се на она могу прецизно референцирати. Имена $ аутхентицатион и $ цоннецтион су посебно резервисани параметри за токове и треба их избегавати. Чување протока је блокирано ако се користе системске променљиве са тим именима. Ако се променљива окружења користи у току и име за приказ променљиве окружења се мења, онда дизајнер приказује и старе и нове токене за приказ имена како би помогао у идентификацији. Када ажурирате ток, препоручујемо да уклоните референцу променљиве окружења и додате је поново.

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

  • Провера ваљаности променљивих окружења се дешава унутар корисничког интерфејса и унутар компоненти које их користе, али не и унутар услуге Dataverse. Стога осигурајте да су постављене одговарајуће вредности ако се оне мењају помоћу кода.
  • Power Platform Задаци алата за изградњу још увек нису доступни за управљање променљивим окружења извора података. Међутим, ово не блокира њихову употребу у алатима које нуди Microsoft и у системима за контролу извора.
  • Интеракција са променљивим окружења преко прилагођеног кода захтева АПИ позив за дохваћање вредности; не постоји кеш изложен за не-Мицрософт код за коришћење.
  • Варијабле окружења су ограничене на максимално 2.000 знакова.

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

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

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

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

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

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

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

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

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

Да ли треба да укључим вредност у моје решење?

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

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

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

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

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

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

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

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

Не. Док АЛМ захтева Dataverse (или Дyнамицс 365 апликације), употреба премиум конектора није потребна. Једини изузетак је ако користите Dataverse конектор за интеракцију са променљивима окружења као што бисте то учинили са другим записима података попут налога или контаката. Раније је ово био једини начин коришћења променљивих окружења у апликацијама са подлогом и токовима.

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

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

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

Да.

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

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

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

Везе се користе само за генерисање корисничког интерфејса. На пример, да бисте преузели пријатељска имена за SharePoint листе повезане са сајтом. Када уређујете променљиву окружења извора података, обавезно изаберите везу са приступом извору података. Ако више немате приступ вези, можете ручно унети вредност. На пример, унесите УРЛ сајта или јединствени SharePoint идентификатор (ГУИД) за листу.

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

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

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

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

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

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

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

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

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

Погледајте и

Користите варијабле окружења извора података у апликацијама платна
Користите варијабле окружења у Power Automate токовима облака решења
Референца табеле/ентитета ЕнвиронментВариаблеДефинитион<а2>Узорци веб АПИ-ја<а3>Користите променљиве окружења извора података у Цанвас апликацијама<а4>Користите променљиве окружења у<а5>токовима облака решења<а6>Користите променљиве Азуре7<> Прилагођене тајне трезора кључева за Азуре7>Блог: Променљиве окружења доступне у прегледу!
...
...
Power Automate
...
...
Power Apps