Aplinkos kintamieji apžvalgai Power Platform

Aplinkos kintamieji įgalina pagrindinį programos gyvavimo ciklo valdymo (ALM) scenarijų perkelti programą iš vienos aplinkos į kitą Power Platform . Pagal šį scenarijų programa išlieka visiškai tokia pati, išskyrus kelias pagrindines išorines programos nuorodas (pvz., lenteles, ryšius ir raktus), kurios skiriasi šaltinio aplinkoje ir paskirties aplinkoje. Programa reikalauja, kad lentelių ar ryšių struktūra būtų visiškai vienoda tarp šaltinio ir paskirties aplinkų, su tam tikrais skirtumais. Aplinkos kintamieji leidžia nurodyti, kuri iš šių skirtingų išorinių nuorodų turėtų būti atnaujinta, kai programa perkeliama iš vienos aplinkos į kitą.

Aplinkos kintamieji saugo parametrų raktus ir reikšmes, kurios tada yra įvairių kitų taikomosios programos objektų įvestis. Parametrų perkėlimas iš sunaudojančių objektų leidžia pakeisti reikšmes toje pačioje aplinkoje arba perkeliant sprendimus į kitas aplinkas. Alternatyvą gali pateikti juos naudojantys komponentai, pvz., užkoduotas parametrų reikšmes. Tai dažnai yra problemiška; ypač kai reikšmes reikia keisti ALM operacijų metu. Kadangi aplinkos kintamieji yra sprendimų komponentai, galite perkelti nuorodas (raktus) ir pakeisti reikšmes, kai sprendimai perkeliami į kitas aplinkas.

Pastaba

Naujos duomenų šaltinių galimybės dabar diegiamos ir gali būti, kad jų dar nėra jūsų regione.

Aplinkos kintamųjų naudojimo pranašumai:

• Suteikite naujų parametrų reikšmių importuodami sprendimus į kitas aplinkas.
• Išsaugokite duomenų šaltinių, naudojamų drobės programose ir srautuose, konfigūraciją. Pavyzdžiui, interneto svetainės ir sąrašo parametrai gali būti saugomi kaip aplinkos kintamieji; todėl galite prisijungti prie skirtingų svetainių ir sąrašų skirtingose aplinkose nekeiskite „SharePoint“ programų ir srautų.
• Supakuokite ir transportuokite tinkinimus bei konfigūracijas kartu ir valdykite juos vienoje vietoje.
• Supakuokite ir transportuokite slaptuosius raktus, pavyzdžiui, kredencialus, kuriuos naudoja skirtingi komponentai, atskirai nuo komponentų, kurie juos naudoja.
• Vieną aplinkos kintamąjį galima naudoti daugelyje skirtingų sprendimo komponentų – neatsižvelgiant į tai, ar jie yra to paties tipo, ar skirtingi. Pavyzdžiui, drobės programa ir eiga gali naudoti tą patį aplinkos kintamąjį. Kai reikia pakeisti aplinkos kintamojo vertę, turėsite pakeisti tik vieną reikšmę.
• Be to, jei jums reikia pašalinti duomenų šaltinis gamybos aplinkose, galite atnaujinti aplinkos kintamųjų reikšmes naudodami naujos duomenų šaltinis informaciją. Programų ir srautų nereikia keisti ir pradėti naudoti naująjį duomenų šaltinis.
• „SolutionPackager“ ir „DevOps“ palaikomi įrankiai įgalina nuolatinio integravimo ir nuolatinio pristatymo funkcijas (CI / CD).
• Aplinkos kintamieji gali būti nenuostobūs ir saugomi šaltinio valdiklyje. Taip pat galite saugoti skirtingų aplinkos kintamųjų reikšmių failus, skirtus atskirai konfigūracijai, reikalingai skirtingose aplinkose. Tada sprendimo pakuotojas gali priimti failą, atitinkantį aplinką, į kurią importuojamas sprendimas.

Kaip veikia aplinkos kintamieji?

Aplinkos kintamuosius galima kurti ir modifikuoti naudojant moderniąją sprendimų sąsają, automatiškai sukuriami jungiantis prie tam tikrų duomenų šaltinių drobės programose arba naudojant kodą. Jie taip pat gali būti importuojami į aplinką naudojant sprendimus. Kai aplinkoje yra aplinkos kintamųjų, jie gali būti naudojami kaip įvestys kuriant drobės programas, Power Automate srautus, kuriant papildinius ir daugelyje kitų vietų, pvz., pridedant prietaisų skydelį Power BI prie modeliu pagrįstos programos. Kai šių tipų objektai naudoja aplinkos kintamuosius, reikšmės gaunamos iš aplinkos kintamųjų ir gali būti pakeistos, kai sprendimai importuojami į kitas aplinkas.

Kurkite aplinkos kintamąjį sprendime

1. Prisijunkite prie „Power Apps“ (make.powerapps.com) ir kairiojoje srityje pasirinkite Sprendimai. Jei elemento šoninio skydelio srityje nėra, pasirinkite …Daugiau ir pasirinkite norimą elementą.
2. Atidarykite norimą sprendimą arba sukurkite naują.
3. Komandų juostoje pasirinkite Naujas > Daugiau, tada parinkite Aplinkos kintamasis.
4. Dešinioje srityje užpildykite šiuos stulpelius ir pažymėkite Įrašyti:

   • Rodomas pavadinimas. Įveskite aplinkos kintamojo pavadinimą.

   • Pavadinimas. Unikalus pavadinimas automatiškai generuojamas pagal Rodomas pavadinimas, tačiau jį galite keisti.

   • Duomenų tipas. Pasirinkite Dešimtainis skaičius, Tekstas, JSON, Dvi parinktys, Duomenų šaltinis arba Slaptasis raktas.

     Pastaba

     • Jei duomenų šaltinis yra pažymėtas tipas, taip pat reikės pažymėti jungtį, tinkamą pažymėtos jungties ryšį ir parametro tipą. Tačiau ryšys neišsaugomas kaip aplinkos kintamojo dalis. Ryšys naudojamas tik siekiant gauti galimas parametrų reikšmes, pvz., „SharePoint“ svetaines, prie kurių turite prieigą, arba su svetaine susietus sąrašus. Tam tikriems parametrams, „SharePoint“ pvz., sąrašams, taip pat turėsite pažymėti pirminį duomenų šaltinis aplinkos kintamąjį, pvz., „SharePoint“ svetainę. Įrašius jie bus susiję duomenų bazėje.
     • Jei pasirinktas tipas yra Slaptasis raktas, reikia papildomos informacijos, kad būtų galima nustatyti ir konfigūruoti „Azure Key Vault“, kad „Power Platform“ galėtų pasiekti slaptąjį raktą.

   • Dabartinė reikšmė. Taip pat vadinama reikšme. Ši ypatybė yra pasirinktinė ir yra aplinkos kintamųjų reikšmių lentelės dalis. Kai reikšmė yra, ji naudojama, net jei yra ir numatytoji reikšmė. Pašalinkite reikšmę iš savo sprendimo, jei nenorite jos naudoti kitoje aplinkoje. Reikšmės taip pat atskiriamos į atskirus JSON failus eksportuotame solution.zip faile ir jas galima redaguoti neprisijungus. Daugiau informacijos: kaip pašalinti reikšmę iš aplinkos kintamojo?

   • Numatytoji reikšmė. Šis stulpelis yra aplinkos kintamojo apibrėžimo lentelės dalis ir nėra būtinas. Numatytoji reikšmė naudojama, jei nėra dabartinės reikšmės.

     Numatytosios reikšmės ir dabartinės reikšmės patogumas leidžia aptarnavimo aprašą ir numatytąją reikšmę atskirai nuo reikšmės. Pavyzdžiui, programos leidėjas gali pateikti savo pasiūlymą AppSource su numatytąja reikšme. Tada klientas gali pasirinktinai pateikti naują reikšmę. Kai programos leidėjas publikuoja programos naujinimus, kliento nustatyta reikšmė neperrašoma.

     

     Pastaba

     Negalima sukurti reikšmės nenaudojant apibrėžimo. Sąsaja leidžia sukurti tik vieną reikšmę vienam apibrėžimui.

Įverskite naujas vertes importuodami sprendimus į kitas aplinkas.

Modernaus sprendimo importavimo sąsaja apima galimybę įvesti vertes aplinkos kintamiesiems. Šis rinkinys nustato ypatybės vertę environmentvariablevalue lentelėje.

Pradedant nuo atnaujinimo 7 m. gruodžio 2023 d., visos aplinkos kintamųjų reikšmės matomos importuojant sprendimus (arba diegiant naudojant vamzdynus). Aplinkos kintamieji, neturintys numatytosios reikšmės arba reikšmės, bus paraginti įvesti reikšmę, tačiau kitu atveju jie bus iš anksto užpildyti etikete po teksto sritimi, nurodančia reikšmės šaltinį: sprendimo reikšmę, tikslinės aplinkos reikšmę arba numatytąją reikšmę.

Pastaba

• Kai kuriais atvejais tam tikroms duomenų šaltinis aplinkos kintamojo reikšmėms gali būti rodomas įspėjimas Uždrausta prieiga , jei importuojantis gamintojas neturi prieigos prie ryšio arba šaltinio, naudojamo aplinkos kintamajam. Tai yra neblokuojantis įspėjimas, tačiau į tai reikia atkreipti dėmesį, atsižvelgiant į tai, kaip planuojate naudoti aplinkos kintamąjį tikslinėje aplinkoje.
• Galite pašalinti vertę iš savo sprendimo prieš sprendimo eksportavimą. Taip užtikrinama, kad esama reikšmė išliks jūsų programavimo aplinkoje, tačiau nebus eksportuojama į sprendimą. Šis metodas leidžia pateikti naują vertę importuojant sprendimą į kitas aplinkas. Daugiau informacijos: kaip pašalinti reikšmę iš aplinkos kintamojo?

Pranešimai

Pranešimas rodomas, kai aplinkos kintamieji neturi jokių reikšmių. Tai yra priminimas nustatyti reikšmes, kad komponentai, priklausomi nuo aplinkos kintamųjų, nebūtų nesėkmingi.

Sauga

environmentvariabledefinition ši lentelė priklauso vartotojui arba komandai. Kai sukuriate taikomąją programą, kuri naudoja aplinkos kintamuosius, nepamirškite priskirti vartotojams tinkamo prieigos lygio šiai lentelei. Lentelės environmentvariablevalue teisė paveldėta iš pirminės lentelės environmentvariabledefinition, todėl nereikia nustatyti atskirų teisių. Lentelės environmentvariabledefinition teisės yra įtrauktos į aplinkos kūrėjo ir pagrindinio vartotojo saugos vaidmenis pagal numatytuosius parametrus. Daugiau informacijos: „Dataverse“ sauga.

Pavadinimų

Užtikrinti, kad aplinkos kintamieji pavadinimai būtų unikalūs, kad juos būtų galima tiksliai nurodyti. Kintamųjų aplinkos kintamųjų dublikatų rodiniai daro aplinkos kintamuosius, kuriuos sunku atskirti ir naudoti. Užtikrinti, kad aplinkos kintamieji pavadinimai būtų unikalūs, kad juos būtų galima tiksliai nurodyti. Pavadinimai $authentication ir $connection yra specialiai rezervuoti srautams parametrai, todėl jie turi būti išsamūs. Srauto įrašymas blokuojamas, jei naudojami aplinkos kintamieji su šiais pavadinimais. Jei sraute naudojamas aplinkos kintamasis ir pakeičiamas aplinkos kintamojo rodomas pavadinimas, dizaino įrankis rodo ir senus, ir naujus rodomo vardo atpažinimo ženklus, kurie padeda identifikuoti. Atnaujinant srautą rekomenduojame pašalinti aplinkos kintamojo nuorodą ir vėl ją pridėti.

Dabartiniai apribojimai

• Aplinkos kintamųjų reikšmių tikrinimas vyksta vartotojo sąsajose ir komponentuuose, kurie jas naudoja, bet ne „Dataverse“ viduje. Todėl įsitikinkite, kad kode modifikuojamas tinkamas reikšmes.
• „Power Platform Build Tools“ užduočių dar negalima naudoti duomenų šaltinio aplinkos kintamiesiems tvarkyti. Tačiau tai nereiškia, kad jų negalima naudoti „Microsoft“ pateiktų įrankių ir šaltinio valdymo sistemose.
• Norint sąveikauti su aplinkos kintamaisiais naudojant pasirinktinį kodą, reikia API skambučio, kad gautumėte reikšmes; nėra talpyklos, kurioje būtų galima naudoti ne "Microsoft" kodą.
• Norint sėkmingai naudoti aplinkos kintamuosius su SharePoint sąrašais, kiekvieno atitinkamo šaltinio ir paskirties aplinkų stulpelio rodomas pavadinimas ir loginis pavadinimas turi sutapti.
• Aplinkos kintamieji ribojami iki 2 000 simbolių.

Dažnai užduodami klausimai

Kodėl nematau aplinkos kintamojo vertės?

Jei aplinkos kintamasis yra valdomasis sprendimas, negalėsite matyti reikšmės, nebent pažvelgsite į numatytojo sprendimo vidų. Toks veikimas yra suplanuotas, nes aplinkos kintamojo reikšmė yra nevaldomas tinkinimas.

Kaip peržiūrėti, kur naudojami aplinkos kintamieji?

Pasirinkdami Rodyti priklausomybes sprendimo sąsajoje, kūrimo komponentus arba šaltinio valdiklyje ir sprendimo faile peržiūrėdami programos arba srauto metaduomenis.

Ar duomenų šaltinis aplinkos kintamieji tokie patys kaip ryšiai?

Nr. Nors jie yra susiję, ryšys reiškia kredencialą arba autentifikavimą, kurio reikia norint sąveikauti su jungtimi. Duomenų šaltinis aplinkos kintamieji saugo parametrus, kurių reikia vienam ar daugiau jungties veiksmų, o šie parametrai dažnai skirsis atsižvelgiant į veiksmą. Pavyzdžiui, „SharePoint Online“ ryšys neišsaugo jokios informacijos apie svetaines, sąrašus ar dokumentų bibliotekas. Todėl skambinant į jungtį reikia ir galiojančio ryšio, ir kai kurių papildomų parametrų.

Ar duomenų šaltinis aplinkos kintamuosius galima naudoti su bendrai naudojamais ryšiais, pvz., SQL serveriu naudojant SQL autentifikavimą?

Paprastai ne. Bendrai su „SQL Server“ naudojami ryšiai išsaugo parametrus, kurių reikia siekiant prisijungti prie ryšyje esančių duomenų. Pavyzdžiui, kuriant ryšį pateikiamas serverio ir duomenų bazės pavadinimas, todėl jis visada sukuriamas iš ryšio.

Duomenų šaltinis aplinkos kintamieji naudojami jungtims, kurios priklauso nuo vartotojo autentifikavimo, pvz., Microsoft Entra ID, nes parametrų negalima gauti iš ryšio. Dėl šių priežasčių vykdant „SQL Server“ autentifikavimą, o tai yra bendrai naudojamas ryšys, nebus naudojami duomenų šaltinio aplinkos kintamieji.

Ar mano automatizuotas ALM srautas gali naudoti skirtingų reikšmių failus skirtingoms aplinkose?

Taip. Sprendimų paketas priima failo pavadinimą kaip įvesties parametrus, kad jūsų srautas galėtų į sprendimą supakuoti kitą reikšmių failą, atsižvelgiant į tai, su kokio tipo aplinka jis vykdomas.

Ką daryti, jei kas nors netyčia panaikins reikšmę?

Jei to dar neužkirto priklausomybės sistema, vykdymo laikas naudoja paskutinę žinomą reikšmę kaip atsarginį variantą.

Jei reikšmė pakeičiama, kada nauja reikšmė naudojama drobės programose ir debesies srautuose?

Visiškai paskelbti atnaujintus aplinkos kintamuosius gali užtrukti iki valandos, nes reikšmė įstumiama į programas ir teka asinchroniškai.

Ar reikia "windows" licencijų?

Nr. Nors ALM reikia „Dataverse“ (arba „Dynamics 365 for Customer Engagement“), neprivaloma naudoti mokamų jungčių. Vienas iš jų yra, jei naudojate jungtį norėdami bendrauti su aplinkos kintamuoju kaip su kitais duomenų įrašais, pvz. „Dataverse“ klientais ar kontaktais. Anksčiau tai buvo vienintelis būdas naudoti aplinkos kintamuosius drobės programose ir srautuose.

Ar yra aplinkų kintamųjų skaičius, kurį galiu turėti?

Nr. Tačiau didžiausias sprendimo dydis yra 120 MB. Daugiau informacijos: Sprendimo kūrimas

Ar aplinkos kintamieji rodomi pavadinimai ir aprašai gali būti lokalizuojami?

Taip.

Ar reikia naudoti aplinkos kintamuosius, o ne saugoti konfigūracijos duomenis pasirinktinėse lentelėse?

Taip, jei konfigūracijos duomenys nėra sąryšiniai. Aplinkos kintamuosius reikia naudoti rakto ir reikšmės poroms ir kai reikšmė kitose aplinkose turi būti kitokia. Kiti įrankiai, pvz., Konfigūravimo perkėlimo naudingumas labiau tinka santykinės konfigūracijos duomenims, saugomims pasirinktinėse lentelėse, perkelti. Skirtingai nei naudojant kitus konfigūravimo duomenis, aplinkos kintamieji perkeliami į sprendimus, todėl juos naudoti lengviau ir efektyviau importuoti.

Kodėl kita ryšio reikšmė nei ta, kurią noriu priskirti automatiškai importuodamas?

Kai kuriais atvejais, kai yra keli ryšiai vienam (duomenų šaltinio tipo) aplinkos kintamajam, yra numatytas diegimas, leidžiantis pasirinkti pirmąjį ryšį aplinkos kintamojo galimų ryšių sąraše. Kadangi paprastai yra tik vienas ryšys, susietas su aplinkos kintamuoju, tai nėra kažkas, ką paprastai reikia patvirtinti. Be to, neseniai pakeitus aplinkos kintamosios vertės matomumą, tai lengviau patikrinti importuojant.

Daugiau informacijos: kaip pašalinti reikšmę iš aplinkos kintamojo?

Prieš eksportuodami sprendimą galite pašalinti aplinkos kintamojo reikšmę iš sprendimo. Tada esama reikšmė lieka jūsų kūrimo aplinkoje, bet nėra eksportuojama į sprendimą. Šis metodas leidžia pateikti naują vertę importuojant sprendimą į kitą aplinką.

Norėdami panaikinti šią vertę, atlikite toliau nurodytus veiksmus:

1. Sprendime, kuriame yra aplinkos kintamasis, pažymėkite aplinkos kintamąjį, kad būtų rodomos ypatybės.

2. Dalyje Dabartinė reikšmė pažymėkite ... > Pašalinti iš šio sprendimo.

   

Ar galiu naudoti aplinkos kintamuosius pasirinktinėse jungtyse?

Taip. Aplinkos kintamųjų palaikymas pasirinktinėse jungtyse

Taip pat žr.

Aplinkos kintamųjų duomenų šaltinis naudojimas drobės programose
Aplinkos kintamųjų naudojimas sprendimų debesų srautuose Power Automate
EnvironmentVariableDefinition lentelė / objekto nuoroda
Žiniatinklio API pavyzdžiai
Aplinkos kintamųjų naudojimas duomenų šaltinis Canvas" programose
Aplinkos kintamųjų naudojimas sprendimų debesų srautuose Power Automate
"Azure Key Vault" paslapčių naudojimas
Aplinkos kintamųjų palaikymas pasirinktinėse jungtyse
„Power Apps“ Interneto dienoraščio: peržiūrimi aplinkos kintamieji!

Pastaba

Ar galite mums pranešti apie dokumentacijos kalbos nuostatas? Atlikite trumpą apklausą. (atkreipkite dėmesį, kad ši apklausa yra anglų kalba)

Apklausą atliksite per maždaug septynias minutes. Asmeniniai duomenys nėra renkami (privatumo nuostatos).