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. Šis požiūris dažnai yra problemiškas; 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.

Aplinkos kintamųjų naudojimo pranašumai:

• Pateikite naujas parametrų reikšmes importuodami sprendimus į kitas aplinkas.
• Saugokite duomenų šaltinių , naudojamų drobės programose ir srautuose, konfigūraciją. Pavyzdžiui, SharePoint internetinės svetainės ir sąrašo parametrai gali būti saugomi kaip aplinkos kintamieji. Šis metodas leidžia prisijungti prie skirtingų svetainių ir sąrašų skirtingose aplinkose, nekeičiant 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ų šaltinį gamybos aplinkose, galite atnaujinti aplinkos kintamųjų reikšmes naujo duomenų šaltinio informacija. Programų ir srautų nereikia keisti ir pradėti naudoti naują duomenų šaltinį.
• Palaikomi SolutionPackager ir DevOps įrankiai leidžia nuolat integruoti ir nuolat pristatyti (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 šiuolaikinio sprendimo sąsają. Jie taip pat gali būti automatiškai sukurti jungiantis prie tam tikrų duomenų šaltinių drobės programose arba naudojant kodą. Jie taip pat gali būti importuojami į aplinką naudojant sprendimus. Aplinkos kintamieji gali būti naudojami kaip įvestys kuriant drobės programas, Power Automate srautus, papildinius ir įtraukiant Power BI ataskaitų sritis į modeliu pagrįstas programas. Kai naudojate aplinkos kintamuosius, reikšmės gaunamos iš aplinkos kintamųjų ir gali būti keičiamos, kai sprendimai importuojami į kitas aplinkas.

Neautomatinis aplinkos kintamojo kūrimas sprendime

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

   • Rodomas vardas. Įveskite aplinkos kintamojo pavadinimą.

   • Vardas. Unikalus pavadinimas automatiškai sugeneruojamas pagal rodomą pavadinimą, bet jūs galite jį pakeisti.

   • Duomenų tipas. Pasirinkite iš dešimtainio skaičiaus, teksto, JSON, dviejų parinkčių, duomenų šaltinio arba slapto.

     Pastaba.

     • Jei duomenų šaltinis yra pasirinktas tipas, turite pasirinkti jungtį, tinkamą pasirinktos jungties ryšį ir parametro tipą. Ryšys nėra saugomas kaip aplinkos kintamojo dalis. Aplinkos kintamasis saugo informaciją, kuri nėra ryšyje, kuri yra būtina norint prisijungti Power Apps prie tinkamo serverio ir lentelės. Ryšys naudojamas tik siekiant gauti galimas parametrų reikšmes, pvz., „SharePoint“ svetaines, prie kurių turite prieigą, arba su svetaine susietus sąrašus.

     • Jei pasirinktas tipas yra paslaptis , norint pasiekti paslaptį, reikia papildomos informacijos, kad būtų galima Power Platform nustatyti ir konfigūruoti "Azure Key Vault".

   • Dabartinė vertė. Taip pat vadinama reikšme. Ši ypatybė yra pasirinktinė ir yra aplinkos kintamųjų reikšmių lentelės dalis. Apibrėžta reikšmė 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.

Power Apps gali automatiškai kurti aplinkos kintamuosius

Nustatymų skirtuke Bendra Power Apps :

• Įjunkite parinktį Automatiškai kurti aplinkos kintamuosius, kai pridedate duomenų šaltinių . Dabar, kai prie programos pridedate naują duomenų šaltinį, jis prideda aplinkos kintamąjį.

  

Skirtingi duomenų šaltiniai

Skirtingi duomenų šaltiniai įgalina skirtingų tipų aplinkos kintamuosius.

Microsoft Dataverse

Power Apps jungiasi savaime Dataverse. Dabartinėje aplinkoje lentelėms nereikia aplinkos kintamojo. Kai prisijungiate Dataverse, jūsų programa automatiškai ieško to paties lentelės pavadinimo bet kurioje aplinkoje, kurioje ją perkeliate. Kol jūsų lentelės pavadinimo struktūra tikslinėje aplinkoje yra tokia pati, kaip ir pradinėje aplinkoje, ji veikia.

Jei naudojate išorinę lentelę iš kitos aplinkos (naudodami Keisti aplinką), daroma prielaida, Power Apps kad norite visada nurodyti tą pačią lentelę. Jums reikia aplinkos kintamojo, jei jums reikia, kad išorinė lentelė būtų kita išorinė lentelė, kai pereinate iš kūrėjo į testą arba į prod. Lengviausia leisti Power Apps automatiškai sukurti aplinkos kintamąjį už jus. (Jei anksčiau įtraukėte lentelę į programą, įjunkite parametrų jungiklį, numeskite išorinę lentelę ir vėl ją įtraukite.)

Kai į programą įtraukiate išorinę lentelę, pasirinkite skirtuką Išsamiau , kad pasirinktumėte aplinkos kintamąjį.

SharePoint

SharePoint palaiko tik Microsoft Entra ryšius. Taigi, be SharePoint galiojančio ryšio, svetainei ir sąrašui reikalingas atskiras aplinkos kintamasis.

Norėdami sėkmingai naudoti aplinkos kintamuosius su SharePoint sąrašais:

• Rodomas pavadinimas ir loginis kiekvieno atitinkamo stulpelio šaltinio ir paskirties aplinkoje pavadinimas turi sutapti.
• Aplinkos kintamieji SharePoint turi turėti atitinkančius metaduomenis. SharePoint turi vidinius identifikatorius, kurie gali nesutapti tikslinėse aplinkose. Pavyzdžiui, jei paskirties aplinkoje sukursite sąrašą tuo pačiu pavadinimu ir stulpeliais, vidiniai pavadinimai nesutaps. Metaduomenys visada atitinka, jei dubliuojate SharePoint svetainę ir kopijuojate ją į tikslinę aplinką.

„SQL Server“

SQL serveris palaiko daug skirtingų autentifikavimo ir ryšių tipų. Ryšiams Microsoft Entra naudokite aplinkos kintamuosius. Serveriui ir duomenų bazei reikalingas atskiras aplinkos kintamasis. Programa yra susieta su konkrečiais lentelių pavadinimais, todėl daroma prielaida, kad skirtingose aplinkose jie yra vienodi.

Nenaudokite aplinkos kintamųjų bendrai naudojamiems ryšiams, pvz., pagrindiniam SQL autentifikavimui su SQL serveriu. Naudokite ryšio nuorodas informacijai, kuri tradiciškai perduodama kaip jungimosi eilutės dalis. Pagrindiniai SQL auth parametrai yra ryšio eilutės dalis. Pavyzdžiui, kuriant ryšį pateikiamas serverio ir duomenų bazės pavadinimas, todėl jis visada sukuriamas iš ryšio.

Duomenų šaltinio aplinkos kintamieji naudojami jungtims, kurių autentifikavimas pvz Microsoft Entra. Šių tipų ryšiuose Power Apps yra tik identifikuotas vartotojas. Power Apps Negalite nustatyti, su kokia paslauga ar stalu ketinate dirbti iš ryšio.

Įverskite naujas vertes importuodami sprendimus į kitas aplinkas.

Modernaus sprendimo importavimo sąsaja apima galimybę įvesti vertes aplinkos kintamiesiems. Taip lentelėje nustatoma reikšmės environmentvariablevalue ypatybė.

Aplinkos kintamosios reikšmės matomos importuojant sprendimus arba diegiant naudojant vamzdynus. Aplinkos kintamieji be numatytosios reikšmės arba reikšmės raginimo reikšmei, bet kitu atveju iš anksto užpildomi etikete po teksto sritimi, nurodančia reikšmės šaltinį: sprendimo reikšmę, tikslinės aplinkos reikšmę arba numatytąją reikšmę.

Pranešimai

Pranešimas rodomas, kai aplinkos kintamieji neturi jokių reikšmių. Nustatykite reikšmes taip, kad komponentai, priklausantys nuo aplinkos kintamųjų, nesugestų.

Sauga

Lentelė environmentvariabledefinition priklauso vartotojui arba komandai. Kai sukuriate taikomąją programą, kuri naudoja aplinkos kintamuosius, nepamirškite priskirti vartotojams tinkamo prieigos lygio šiai lentelei. Teisė į environmentvariablevalue lentelę paveldima iš pirminės environmentvariabledefinition lentelės, todėl nereikia atskirų teisių. Lentelių teisės environmentvariabledefinition pagal numatytuosius nustatymus įtraukiamos į aplinkos kūrėjo ir pagrindinio vartotojo saugos vaidmenis. Daugiau informacijos: Sauga Dataverse.

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 srautų parametrai ir jų reikėtų vengti. 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 Kūrimo įrankių užduotys dar nepasiekiamos duomenų šaltinio aplinkos kintamiesiems valdyti. 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ą.
• Aplinkos kintamieji ribojami iki 2 000 simbolių.

Dažnai užduodami klausimai

Kodėl nematau aplinkos kintamojo vertės?

Jei aplinkos kintamasis yra valdomajame sprendime, 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?

Arba pasirinkdami Rodyti priklausomybes sprendimo sąsajoje, kurdami komponentus, arba šaltinio valdiklyje ir sprendimo faile, peržiūrėdami programą 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 norint paskambinti į jungtį reikia ir galiojančio ryšio, ir dar kelių parametrų.

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.

Ar turėčiau įtraukti vertę į savo sprendimą?

Nr. Aplinkos kintamieji skirti naudoti programoms, kurios turi turėti skirtingas reikšmes skirtingose aplinkose, kuriose įdiegtas sprendimas. Aplinkos kintamųjų aprašai turėtų būti įtraukti į jūsų sprendimą, tačiau tikslinės aplinkos reikšmės turėtų būti pateiktos diegimo metu. Dėl tokio veikimo aplinkos kintamojo apibrėžimas yra valdomo sprendimo objektas paskirties aplinkoje, o aplinkos kintamasis yra nevaldomas įrašas.

Kodėl negaliu panaikinti reikšmės savo aplinkoje?

Jei reikšmė buvo įtraukta į valdomąjį sprendimą, vienintelis būdas panaikinti reikšmę yra atnaujinti sprendimą šaltinio aplinkoje, kad ji nebūtų įtraukta, tada eksportuoti naują sprendimo versiją. Tada šią naują versiją galima importuoti į aplinką naudojant naujinimo operaciją (ne naujinimą), todėl reikšmės įrašas panaikinamas.

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 reikalingos Dataverse (arba "Dynamics 365" programos), aukščiausios kokybės jungčių naudoti nereikia. 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 95 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 mano ryšys neišsaugotas duomenų šaltinio aplinkos kintamiesiems?

Ryšiai naudojami tik vartotojo sąsajai generuoti. Pavyzdžiui, norėdami gauti draugiškus sąrašus, susietus SharePoint su svetaine. Redaguodami duomenų šaltinio aplinkos kintamąjį, būtinai pasirinkite ryšį su prieiga prie duomenų šaltinio. Jei nebeturite prieigos prie ryšio, galite rankiniu būdu įvesti reikšmę. Pavyzdžiui, įveskite SharePoint sąrašo svetainės URL arba unikalų identifikatorių (GUID).

Kai yra keli ryšiai vienam (duomenų šaltinio tipo) aplinkos kintamajam, yra numatytas diegimas, leidžiantis pasirinkti pirmąjį ryšį 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ė pasirinkite ...>Pašalinkite iš šio tirpalo.

   

Ar galiu naudoti aplinkos kintamuosius pasirinktinėse jungtyse?

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

Taip pat žr.

Duomenų šaltinio aplinkos kintamųjų naudojimas drobės programose
Aplinkos kintamųjų naudojimas sprendimų debesų srautuose Power Automate
EnvironmentVariableDefinition lentelė / objekto nuoroda
Žiniatinklio API pavyzdžiai
Duomenų šaltinio aplinkos kintamųjų naudojimas "Canvas" programose
Aplinkos kintamųjų Power Automate naudojimas sprendimų debesų srautuose
...
Naudokite "Azure Key Vault" paslaptis Aplinkos kintamųjų palaikymas pasirinktinėse jungtyse
Power Apps Interneto dienoraštis: Aplinkos kintamieji galimi peržiūros versijoje!