Keskkonnamuutujad ülevaate saamiseks Power Platform

Keskkonnamuutujad võimaldavad rakenduse elutsükli halduse (ALM) põhistsenaariumi rakenduse teisaldamiseks keskkondade vahel Power Platform . Selle stsenaariumi korral jääb rakendus täpselt samaks, välja arvatud mõned peamised välised rakenduseviited (nt tabelid, ühendused ja võtmed), mis on lähtekeskkonna ja sihtkeskkonna vahel erinevad. Rakendus nõuab, et tabelite või ühenduste struktuur oleks lähte- ja sihtkeskkonna vahel täpselt sama, mõningate erinevustega. Keskkonnamuutujad võimaldavad teil määrata, millist neist erinevatest välistest viidetest tuleks rakenduse keskkondade vahel teisaldamisel värskendada.

Keskkonna muutujad talletavad parameetrite võtmeid ja väärtusi, mis seejärel esitatakse sisendina erinevatele muudele rakenduse objektidele. Parameetrite eraldamine aeganõudvatest objektidest võimaldab teil väärtusi muuta samas keskkonnas või lahenduste migreerimisel muudesse keskkondadesse. Alternatiiv jätab hard-coded parameetri väärtused nendesse komponentidesse, mis neid kasutavad. See on sageli problemaatiline; eriti siis, kui väärtusi tuleb ALM-i toimingute ajal muuta. Kuna keskkonna muutujad on lahendusekomponendid, saate viiteid (võtmeid) transpordida ja väärtusi muudesse keskkondades migreerimisel muuta.

Märkus

Andmeallikate uued võimalused on alles juurutatud ja need ei pruugi olla teie piirkonnas veel saadaval.

Keskkonnamuutujate kasutamise eelised.

• Pakub uusi parameetriväärtusi lahenduste importimisel muudesse keskkondadesse.
• Talletamise konfiguratsiooni andmeallikate jaoks kasutatakse lõuendirakendustes ja voogudes. Näiteks veebisaidi SharePoint ja loendi parameetreid saab salvestada keskkonna muutujanatena, mis võimaldab teil luua ühenduse erinevate lehtede ja loenditega erinevates keskkondades, ilma et oleks vaja rakendusi ja voogusid muuta.
• Pakkige ja transpordige oma kohandus ja konfiguratsioon kokku ning haldage neid ühes kohas.
• Pakendi- ja transpordisaladused, nagu eri komponentide kasutatavad mandaadid, neid kasutavatest komponentidest eraldi.
• Ühe keskkonna muutujat saab kasutada paljude erinevate lahendusekomponentide puhul – olenemata sellest, kas need on sama tüüpi komponendid või erinevad. Näiteks lõuendirakendus ja voog võivad kasutada sama keskkonna muutujat. Kui keskkonna muutuja väärtust on vaja muuta, peate muutma ainult ühte väärtust.
• Lisaks, kui teil on vaja tootmiskeskkondades andmeallikas kasutuselt kõrvaldada, saate värskendada keskkonnamuutuja väärtusi uue andmeallikas teabega. Rakendused ja vood ei vaja muutmist ja hakkavad kasutama uut andmeallikas.
• SolutionPackageri ja DevOpsi tööriistade toetus võimaldab pidevat integreerimist ja pidevat tarnet (CI/CD).
• Keskkonna muutujaid saab lahti pakkida ja säilitada keskkonna juhtelemendis. Võite salvestada ka erinevaid keskkonnamuutujate väärtuste faile erinevates keskkondades vajaliku eraldi konfiguratsiooni jaoks. Lahenduse pakendaja saab seejärel aktsepteerida faili, mis vastab keskkonnale, kuhu lahendus imporditakse.

Kuidas keskkonnamuutujad töötavad?

Keskkonna muutujaid saab luua ja muuta modernse lahenduse liidese kaudu, mis luuakse automaatselt teatud andmeallikatega ühendamisel lõuendirakendustes või kasutades koodi. Neid saab lahenduste kaudu ka keskkonda importida. Kui keskkonnamuutujad on keskkonnas olemas, saab neid kasutada sisenditena lõuendirakenduste, Power Automate voogude loomisel, lisandmoodulite arendamisel ja paljudes muudes kohtades, näiteks armatuurlaua lisamisel Power BI mudelipõhisele rakendusele. Kui seda tüüpi objektid kasutavad keskkonna muutujaid, siis tuletatakse väärtused keskkonna muutujatest ja neid saab muuta lahenduste importimisel muudesse keskkondades.

Loo keskkonnamuutujalahendustes

1. Logige sisse rakendusse Power Apps (make.powerapps.com), ja tehke vasakpoolsel navigeerimispaanil valik Lahendused. Kui üksust pole külgpaneeli paanil, valige ...Rohkem ja seejärel valige soovitud üksus.
2. Avage soovitud lahendus või looge uus.
3. Valige käsuribal suvandid Uus > Rohkem ja valige suvand Keskkonnamuutuja.
4. Täitke parempoolsel paanil järgmised veerud ja seejärel valige Salvesta:

   • Kuvatav nimi. Sisestage keskkonnamuutuja nimi.

   • Nimi. Kordumatu nimi luuakse automaatselt Kuvatava nime alusel, aga te saate seda muuta.

   • Andmete tüüp. Valige Kümnendarv, Tekst, JSON, Kaks suvandit, Andmeallikas või Saladus.

     Märkus

     • Kui Andmeallikas on valitud tüüp, peate valima ka konnektori, kehtiva ühenduse valitud ühendajale ja parameetri tüübi. Kuid ühendust ei salvestata keskkonna muutuja osana. Ühendust kasutatakse ainult selliste parameetrite väärtuste toomiseks SharePointi, millega teil on juurdepääs, või saidiga seostatud loendite toomiseks. Teatud parameetrite jaoks nagu SharePoint -i loendid, peate valima ka peamise andmeallika keskkonna muutuja (nt SharePoint saidi). Pärast salvestamist seostuvad need andmebaasis.
     • Kui valitud tüüp on Saladus, on vaja lisateavet Azure’i võtmehoidla häälestamiseks ja konfigureerimiseks, et Power Platform pääseks juurde saladusele.

   • Praegune väärtus. Nimetatakse ka väärtuseks. See atribuut on valikuline ja see on osa keskkonna muutuvväärtuse tabelist. Kui väärtus on olemas, kasutatakse seda, isegi kui on olemas ka vaikeväärtus. Eemaldage väärtus oma lahendusest, kui te ei soovi seda järgmises keskkonnas kasutada. Väärtused eraldatakse ka eraldi JSON failideks eksporditud failis solution.zip ja ja neid saab redigeerida võrguühenduseta. Lisateave: Kuidas eemaldada väärtus keskkonna muutujast?

   • Vaikeväärtus. See veerg on osa keskkonnamuutuja definitsioonitabelist ja pole nõutav. Vaikeväärtust kasutatakse juhul, kui praegust väärtust pole.

     Vaikeväärtuse ja praeguse väärtuse eraldamine annab võimaluse serveerida määratlust ja vaikeväärtust väärtusest eraldi. Näiteks võib rakenduse avaldaja loetleda oma pakkumise vaikeväärtusega AppSource . Seejärel saab klient anda uue väärtuse. Kui rakenduse avaldaja avaldab rakenduse värskendused, ei kirjutata kliendi määratud väärtust üle.

     

     Märkus

     Väärtus ei eksisteerida saa ilma määratluseta. Liides võimaldab luua ainult ühe väärtuse määratluse kohta.

Uute väärtuste sisestamine lahenduste importimisel

Modernne lahenduse importimise kasutajaliides hõlmab võimalusi keskkonnamuutujate jaoks väärtuste sisestamiseks. See määrab atribuudi väärtuse environmentvariablevaluetabelis.

Alates 7. detsembri 2023. aasta värskendusest on kõik keskkonnamuutuja väärtused lahenduste importimisel (või juurutamisel torujuhtmete kasutamisel) nähtavad. Vaikeväärtuse või -väärtuseta keskkonnamuutujatelt küsitakse väärtust, kuid need on muidu eeltäidetud sildiga tekstiala all, mis tähistab väärtuse allikat: lahenduse väärtus, sihtkeskkonna väärtus või vaikeväärtus.

Märkus

• Mõnel juhul võidakse konkreetsete andmeallikas keskkonnamuutuja väärtuste puhul kuvada hoiatus Juurdepääs keelatud , kui importival koostajal pole juurdepääsu keskkonnamuutuja jaoks kasutatavale ühendusele või allikale. See on mitteblokeeriv hoiatus, kuid midagi, mida tuleb arvestada sõltuvalt sellest, kuidas kavatsete keskkonnamuutujat sihtkeskkonnas kasutada.
• Enne lahenduse eksportimist võite väärtuse lahendusest eemaldada. Nii tagatakse, et olemasolev väärtus jääb teie arenduskeskkonda, kuid seda ei ekspordita lahenduses. See meetod võimaldab anda lahenduse importimisel muudesse keskkondades uue väärtuse. Lisateave: Kuidas eemaldada väärtus keskkonna muutujast?

Teavitused

Kui keskkonnamuutujatel pole väärtusi, kuvatakse teatis. Tuletame meelde, et väärtused seatakse nii, et keskkonna muutujatest sõltuvaid komponente ei nurjuks.

Turve

Tabel environmentvariabledefinition kuulub kasutajale või meeskonnale. Kui loote rakendust, mis kasutab keskkonna muutujaid, määrake kindlasti kasutajatele sellele tabelile vastav õiguste tase. Tabeli õigus environmentvariablevalue päritakse peamisest tabelist environmentvariabledefinition ja seetõttu pole vaja eraldi õigusi. Tabelite environmentvariabledefinition õigused on vaikimisi kaasatud keskkonna koostaja ja põhikasutaja turberollide hulka. Lisateave: Turvalisus Dataverse'is.

Nimetamine

Veenduge, et keskkonna muutujate nimed on kordumatud, et neid saaks täpselt viidata. Topeltkeskkonna muutuja kuvatavad nimed muudavad keskkonna muutujad keeruliseks ning muudavad nende kasutamise keerukaks. Veenduge, et keskkonna muutujate nimed on kordumatud, et neid saaks täpselt viidata. $authentication ja $connection nimed on spetsiaalselt voogude jaoks reserveeritud parameetrid ja neid tuleks vältida Voo salvestamine blokeeritakse, kui kasutatakse nende nimedega keskkonnamuutujaid. Kui voos kasutatakse keskkonnamuutujat ja keskkonnamuutuja kuvatavat nime muudetakse, kuvab kujundaja tuvastamisel abiks nii vanad kui ka uued kuvatava nime märgid. Voo värskendamisel soovitame eemaldada keskkonnamuutuja viite ja lisada see uuesti.

Praegused piirangud

• Keskkonna muutuvväärtuste valideerimine toimub kasutajaliideses ja neid kasutavate komponentide sees, kuid mitte Dataverse -is. Seetõttu veenduge, et koodi kaudu muutmisel seatakse õiged väärtused.
• Power Platform Ehitatud Tööriistade ülesanded pole veel haldava andmeallika keskkonna muutujates saadaval. Kuid see ei blokeeri nende kasutamist Microsofti pakutavates tööriistades ja lähte juhtelementide süsteemides.
• Keskkonnamuutujatega kohandatud koodi kaudu suhtlemine nõuab väärtuste toomiseks API-kõnet; mitte-Microsofti koodi kasutamiseks pole vahemälu avatud.
• Loenditega keskkonnamuutujate SharePoint edukaks kasutamiseks peavad lähte- ja sihtkeskkondade iga vastava veeru kuvatav nimi ja loogiline nimi ühtima.
• Keskkonnamuutujad on piiratud maksimaalselt 2,000 tähemärgiga.

Korduma kippuvad küsimused

Miks ma ei näe oma keskkonnamuutuja väärtust?

Kui keskkonnamuutuja on hallatav lahendus, ei näe te seda väärtust, kui te ei vaata vaikelahenduse sisse. See käitumine on kavandatud, kuna keskkonnamuutuja väärtus on mittehallatav kohandus.

Kuidas vaadata, kus keskkonna muutujaid kasutatakse?

Kas valides Kuva sõltuvused lahenduse liidesesest , komponentide autoriks olemise ajal või lähte juhtelemendis ja lahendusefailis, vaadates rakendust või voo metaandmeid.

Kas andmeallika keskkonna muutujad on samad, mis ühendused?

Ei. Kuigi ühendus on omavahel seotud, tähistab see konnektoriga suhtlemiseks vajalikku mandaati või autentimist. Andmeallika keskkonna muutujad, mis on nõutud ühe või mitme tegevuse jaoks ühenduses ja need parameetrid sõltuvad sageli toimingust. Näiteks SharePoint veebiühenduses ei talletata teavet saitide, loendite ega dokumenditeekide kohta. Seetõttu nõuab pistiku kutsumine nii kehtivat ühendust kui ka mõningaid täiendavaid parameetreid.

Kas andmeallikas keskkonna muutujaid saab kasutada ühiskasutuses ühendustega, nagu SQL Serveri koos SQL-autentimisega?

Üldiselt mitte. Ühiskasutuses ühendused SQL Serveriga talletavad ühenduse andmetega ühenduse loomiseks vajalikud parameetrid. Näiteks serveri ja andmebaasi nimi antakse ühenduse loomisel ja seetõttu tuletatakse need alati ühendusest.

Andmeallikas keskkonnamuutujaid kasutatakse konnektorite jaoks, mis tuginevad kasutajapõhisele autentimisele, näiteks: Microsoft Entra ID, kuna parameetreid ei saa ühendusest tuletada. Nendel põhjustel ei kasuta autentimine SQL Serveriga, mis on jagatud ühendus, andmeallika keskkonnamuutujaid.

Kas minu automaatne ALM-i konveier saab erinevates keskkondades kasutada erinevaid väärtuste faile?

Jah. Lahenduse pakendaja aktsepteerib faili nime sisendparameetritena, et teie konveier saaks pakkida lahendusse erineva väärtuste faili, olenevalt sellest, millist tüüpi keskkonda see käivitab.

Mis siis, kui keegi kustutab väärtust tahtmatult?

Kui sõltuvussüsteem seda juba ei takista, kasutab käitusaeg varuvariandina viimast teadaolevat väärtust.

Kui väärtus muutub, siis millal uut väärtust lõuendirakendustes ja pilvevoogudes kasutatakse?

Värskendatud keskkonnamuutujate täielikuks avaldamiseks võib kuluda kuni tund, kuna väärtus lükatakse rakendustesse ja voolab asünkroonselt.

Kaspremium litsetsid vajalikud?

Ei. Kuigi ALM nõuab Dataverse (või Dynamics 365 for Customer Engagement), ei pea kasutamapremium ühendajaid. Üks vastuväide on see, kui kasutate Dataverse konnektorit keskkonna muutujatega suhtlemiseks, nagu teeksite teiste andmekirjetega, nagu ettevõtted või kontaktid. Varem oli see ainus võimalus kasutada keskkonna muutujaid lõuendi rakendustes ja voogudes.

Kas on olemas piirang selle kohta et, mitu keskkonna muutujat võib mul olla?

Ei. Kuigi lahenduse maksimummaht on 120 MB. Lisateave: Lahenduse loomine

Kas keskkonna muutuja kuvatavaid nimesid ja kirjeldusi saab lokaliseerida?

Jah.

Kas peaksin kasutama keskkonna muutujaid konfiguratsiooniandmete kohandatud tabelites talletamise asemel?

Jah, kui teie konfiguratsiooniandmed pole relationalsed. Keskkonnaväärtused peaksid olema kasutatud võtme jaoks: väärtusepaaride puhul ja juhul, kui muudes keskkondades on väärtus tõenäoliselt erinev, tuleks kasutada keskkonna muutujaid. Muud tööriistad, nagu näiteks konfiguratsiooni migreerimise utiliit, on kohandatud tabelites talletatavate relational-konfiguratsiooni andmete migreerimiseks paremini kohandatud. Erinevalt muudest konfiguratsiooniandmetest migreeritakse keskkonna muutujad lahendustes ja seetõttu on neid palju lihtsam hallata ja teostada imporditavamaks.

Miks määratakse importimisel automaatselt ühenduse väärtus sellest erinev?

Mõnel juhul, kui ühe (andmeallika tüüpi) keskkonnamuutuja jaoks on saadaval mitu ühendust, on olemas disainipõhine rakendamine, et valida keskkonnamuutuja jaoks saadaolevate ühenduste loendist esimene ühendus. Kuna keskkonnamuutujaga on tavaliselt seotud ainult üks ühendus, ei ole see midagi, mida tavaliselt tuleb valideerida. Lisaks, kuna keskkonnamuutuja väärtuse nähtavus on hiljuti muutunud, on seda importimisel lihtsam valideerida.

Kuidas eemaldada väärtus keskkonna muutujast?

Enne lahenduse eksportimist võiksite lahendusest eemaldada keskkonna muutuja väärtuse. Seejärel jääb olemasolev väärtus teie arenduskeskkonda, kuid seda ei ekspordita lahendusse. See meetod võimaldab lahenduse teise keskkonda importimisel anda uue väärtuse.

Väärtuse eemaldamiseks toimige järgmiselt:

1. Valige lahenduses, kus keskkonna muutuja asub, keskkonna muutuja, et atribuudid kuvada.

2. Jaotises Praegune väärtus, valige ... > Eemaldage sellest lahendusest.

   

Kas ma saan kohandatud konnektorites kasutada keskkonnamuutujaid?

Jah. Keskkonnamuutujate kasutamine kohandatud konnektorites

Vaata ka

andmeallikas keskkonnamuutujate kasutamine lõuendirakendustes
Keskkonnamuutujate kasutamine lahendusepilvevoogudes Power Automate
EnvironmentVariableDefinition tabel/olemi referents
Veebi API näidised
andmeallikas keskkonnamuutujate kasutamine Canvase rakendustes
Keskkonnamuutujate kasutamine lahendusepilvevoogudes Power Automate
Azure Key Vaulti saladuste kasutamine
Keskkonnamuutujate kasutamine kohandatud konnektorites
Power Apps Ajaveeb: eelvaatena saadaolevad keskkonna muutujad!

Märkus

Kas saaksite meile dokumentatsiooniga seotud keele-eelistustest teada anda? Osalege lühikeses uuringus. (Uuring on ingliskeelne.)

Uuringus osalemine võtab umbes seitse minutit. Isikuandmeid ei koguta (privaatsusavaldus).