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 lähenemisviis 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.

Keskkonnamuutujate kasutamise eelised.

• Sisestage uued parameetriväärtused, importides samal ajal lahendusi teistesse keskkondadesse.
• Salvestage lõuendirakendustes ja -voogudes kasutatavate andmeallikate konfiguratsioon . Näiteks saab SharePoint Online'i saidi ja loendi parameetreid salvestada keskkonnamuutujatena. See lähenemine võimaldab teil luua ühenduse erinevate saitide ja loenditega erinevates keskkondades, ilma et peaksite rakendusi ja vooge muutma.
• 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 peate andmeallika tootmiskeskkondades kasutuselt kõrvaldama, saate värskendada keskkonnamuutuja väärtusi uue andmeallika teabega. Rakendused ja vood ei vaja muutmist ja hakkavad kasutama uut andmeallikat.
• Toetavad SolutionPackageri ja DevOpsi tööriistad, mis võimaldavad pidevat integreerimist ja pidevat edastamist (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?

Keskkonnamuutujaid saab luua ja muuta kaasaegse lahenduse liideses. Neid saab automaatselt luua ka siis, kui loote ühenduse teatud andmeallikatega lõuendirakendustes või koodiga. Neid saab lahenduste kaudu ka keskkonda importida. Keskkonnamuutujaid saab kasutada sisenditena lõuendirakenduste, Power Automate'i voogude, pluginate ja Power BI juhtpaneelide lisamisel mudelipõhistele rakendustele. Kui kasutate keskkonnamuutujaid, tuletatakse väärtused keskkonnamuutujatest ja neid saab muuta, kui lahendused imporditakse teistesse keskkondadesse.

Keskkonnamuutuja käsitsi loomine lahenduses

1. Logi sisse Power Apps (make.powerapps.com) ja seejärel vali vasakul paneelil Solutions. 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 Uus >rohkem ja seejärel valige Keskkonnamuutuja.
4. Täitke parempoolsel paanil järgmised veerud ja seejärel valige Salvesta.

   • Kuvatav nimi. Sisestage keskkonnamuutuja nimi.

   • Nimi. Kordumatu nimi luuakse automaatselt kuvatavast nimest, kuid saate seda muuta.

   • Andmetüüp. Valige kümnendarv, tekst, JSON, kaks suvandit, andmeallikas või Salajane.

     Märkus.

     • Kui valitud tüüp on andmeallikas , peate valima konnektori, valitud konnektori jaoks kehtiva ühenduse ja parameetri tüübi. Ühendust ei salvestata keskkonnamuutuja osana. Keskkonnamuutuja salvestab infot, mis ei ole ühenduses, mis on vajalik Power Apps'i ühendamiseks õige serveri ja tabeliga. Ühendust kasutatakse ainult saadaolevate parameetrite väärtuste leidmiseks, nagu SharePoint'i saidid, millele sul on ligipääs, või saidiga seotud nimekirjad.
     • Kui valitud tüüp on Secret, on vaja täiendavat teavet Azure Key Vault seadistamiseks ja seadistamiseks, et võimaldada Power Platformil saladusele ligipääsu.

   • Praegune väärtus. Nimetatakse ka väärtuseks. See atribuut on valikuline ja see on osa keskkonna muutuvväärtuse tabelist. Määratletud väärtust kasutatakse isegi siis, 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äärtust keskkonnamuutujast?

   • 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 väljaandja esitada oma pakkumise Marketplace'is vaikimisi väärtusega. 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.

Power Apps suudab automaatselt luua keskkonnamuutujaid

General vahekaardil Power Apps seadistustest:

• Lubage suvand Loo andmeallikate lisamisel keskkonnamuutujaid automaatselt. Nüüd, kui lisate oma rakendusse uue andmeallika, lisab see teie jaoks keskkonnamuutuja.

  

Erinevad andmeallikad

Erinevad andmeallikad võimaldavad erinevat tüüpi keskkonnamuutujaid.

Microsoft Dataverse

Power Apps ühendub natiivselt Dataverse'iga. Te ei vaja praeguses keskkonnas tabelite jaoks keskkonnamuutujat. Ühenduse loomisel Dataverse otsib rakendus automaatselt täpselt sama tabelinime mis tahes keskkonnas, kuhu selle teisaldate. Kui teie tabelinime struktuur on sihtkeskkonnas sama, mis algses keskkonnas, töötab see.

Kui kasutad välist tabelit teisest keskkonnast (Change Environment'i kaudu), eeldab Power Apps, et tahad alati viidata täpselt samale tabelile. Sul on vaja keskkonnamuutujat, kui vajad, et väline tabel oleks arendajast testi või tootmisse liikudes erinev väline tabel. Kõige lihtsam on lubada Power Apps'il automaatselt luua keskkonnamuutuja sinu eest. (Kui lisasite tabeli varem oma rakendusse, siis lülitage seadete lüliti sisse, kukutage väline tabel ja lisage see siis tagasi.)

Kui lisate rakendusse välise tabeli, valige keskkonnamuutuja valimiseks vahekaart Täpsemalt .

SharePoint

SharePoint toetab ainult Microsoft Entra ühendusi. Seega on SharePoint'i puhul lisaks kehtivale ühendusele vaja eraldi keskkonnamuutujat Site ja Listi jaoks.

Keskkonnamuutujate edukaks kasutamiseks SharePoint loenditega:

• Lähte- ja sihtkeskkonna iga vastava veeru kuvatav nimi ja loogiline nimi peavad ühtima.
• SharePoint'i keskkonnamuutujad peavad omama sobivaid metaandmeid. SharePoint-il on sisemised identifikaatorid, mis ei pruugi sihtkeskkondade vahel sobituda. Näiteks kui loote sihtkeskkonnas sama nime ja veergudega loendi, siis sisemised nimed ei ühti. Metaandmed klapivad alati, kui dubleerid SharePoint'i saidi ja kopeerid selle sihtkeskkonda.

SQL Server

SQL Server toetab mitmesuguseid autentimis- ja ühendusliike. Kasuta keskkonnamuutujaid Microsoft Entra ühenduste jaoks. Serveri ja andmebaasi jaoks on vaja eraldi keskkonnamuutujat. Rakendus on seotud konkreetsete tabelinimedega, nii et eeldatakse, et need on keskkondade vahel samad.

Ära kasuta keskkonnamuutujaid jagatud ühenduste jaoks, nagu lihtne SQL autentimine SQL Server'iga. Kasuta ühenduse viiteid info jaoks, mis traditsiooniliselt edastatakse connection string'i osana. Põhilised SQL autentimise parameetrid on kõik osa connection string'ist. Näiteks serveri ja andmebaasi nimi antakse ühenduse loomisel ja seetõttu tuletatakse need alati ühendusest.

Andmeallika keskkonna muutujaid kasutatakse ühenduste puhul, millel on autentimine nagu Microsoft Entra. Sellistes ühendustes on Power Apps'il ainult tuvastatud kasutaja. Power Apps ei suuda ühenduse põhjal tuletada, millist teenust või tabelit sa plaanid kasutada.

Uute väärtuste sisestamine lahenduste importimisel

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

Keskkonnamuutuja väärtused on nähtavad lahenduste importimisel või juurutamisel torujuhtmete kasutamisel. Keskkonnamuutujad, millel puudub väärtuse vaikeväärtus või väärtusviip, kuid mis muidu on eeltäidetud sildiga tekstiala all, mis tähistab väärtuse allikat: lahenduse väärtus, keskkonna sihtväärtus või vaikeväärtus.

Märkus.

• Mõnel juhul võidakse konkreetsete andmeallika keskkonnamuutuja väärtuste puhul kuvada hoiatus Accessi keelamine , 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.
• Väärtuse saate lahendusest eemaldada enne lahenduse eksportimist. See tagab, et olemasolev väärtus jääb teie arenduskeskkonda, kuid seda ei ekspordita lahendusse. See meetod võimaldab anda lahenduse importimisel muudesse keskkondades uue väärtuse. Lisateave: Kuidas eemaldada väärtust keskkonnamuutujast?

Teavitused

Kui keskkonnamuutujatel pole väärtusi, kuvatakse teatis. Määrake väärtused nii, et keskkonnamuutujatest sõltuvad komponendid 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 kasutusõigus environmentvariablevalue päritakse ematabelist environmentvariabledefinition ja seetõttu ei nõuta eraldi õigusi. Tabelite õigused environmentvariabledefinition kaasatakse vaikimisi turberollidesse Environment Maker ja Basic User. Lisateave: Turve sisse Dataverse.

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. Nimetused $authentication ja $connection 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 Koosteriistade ülesanded pole veel saadaval andmeallika keskkonnamuutujate haldamiseks. 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.
• 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 hallatavas lahenduses, ei näe te väärtust enne, kui vaatate 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 liideses, koostades komponente või allika juhtimises ja lahendusefailis, vaadates rakendust või voo metaandmeid.

Kas andmeallika keskkonna muutujad on samad, mis ühendused?

Ei. Kuigi need on omavahel seotud, tähistab ühendus 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 ei salvesta SharePoint Online ühendus mingit teavet saitide, loendite ega dokumenditeekide kohta. Seetõttu nõuab pistiku kutsumine nii kehtivat ühendust kui ka veel mõningaid parameetreid.

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.

Kas ma peaksin selle väärtuse oma lahendusse lisama?

Ei. Keskkonnamuutujad on mõeldud kasutamiseks rakendustes, millel peavad olema erinevad väärtused erinevates keskkondades, kus lahendus on juurutatud. Keskkonnamuutuja definitsioonid tuleks lisada teie lahendusse, kuid väärtused tuleks sihtkeskkonnale esitada juurutamise ajal. Sellise käitumise tulemuseks on see, et keskkonnamuutuja definitsioon on sihtkeskkonnas hallatav lahendusobjekt, samas kui keskkonnamuutuja on mittehallatav kirje.

Miks ma ei saa oma keskkonnas väärtust kustutada?

Kui väärtus kaasati hallatavasse lahendusse, on ainus viis väärtuse kustutamiseks värskendada lahendust lähtekeskkonnas, et väärtus välistada, seejärel eksportida lahenduse uus versioon. Selle uue versiooni saab seejärel keskkonda importida täiendustoimingu (mitte värskenduse) abil, mille tulemusena väärtusekirje kustutatakse.

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'i (või Dynamics 365 rakendusi), ei ole premium-ühenduste kasutamine kohustuslik. Ü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 95 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 minu ühendust andmeallika keskkonnamuutujate jaoks ei salvestata?

Ühendusi kasutatakse ainult kasutajaliidese loomiseks. Näiteks SharePoint'i nimekirjade sõbralike nimede hankimiseks, mis on seotud saidiga. Andmeallika keskkonnamuutuja redigeerimisel valige kindlasti ühendus, millel on juurdepääs andmeallikale. Kui teil pole enam ühendusele juurdepääsu, saate väärtuse käsitsi sisestada. Näiteks sisesta SharePoint saidi URL või unikaalne identifikaator (GUID) nimekirja jaoks.

Kui ühe (andmeallika tüüpi) keskkonnamuutuja jaoks on saadaval mitu ühendust, on olemas disainipõhine rakendamine, et valida ü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. Valige jaotises Praegune väärtus... >Eemaldage sellest lahendusest.

   

Kas ma saan kohandatud konnektorites kasutada keskkonnamuutujaid?

Jah. Keskkonnamuutuja tugi kohandatud konnektorites

Vaata ka

Andmeallika keskkonnamuutujate kasutamine lõuendirakendustes
Kasuta keskkonnamuutujaid Power Automate lahenduste pilvevoogudes
EnvironmentVariableDefinition table/entity references
Web API samples
Kasuta andmeallika keskkonnamuutujaid Canvas apps
Kasuta keskkonnamuutujaid Power Automate lahenduse pilvevoogudes
Kasuta Azure Key Vault secrets
Keskkonnamuutuja tugi kohandatud ühendustes
Power Apps Blogi: Keskkonnamuutujad saadaval eelvaates!