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 SharePoint saab veebisaidi 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 voogude, lisandmoodulite loomisel ja mudelipõhistele rakendustele armatuurlaudade lisamisel Power BI . Kui kasutate keskkonnamuutujaid, tuletatakse väärtused keskkonnamuutujatest ja neid saab muuta, kui lahendused imporditakse teistesse keskkondadesse.

Keskkonnamuutuja käsitsi loomine lahenduses

1. Logige sisse asukohta( Power Apps make.powerapps.com) ja seejärel valige vasakpoolsel paanil Lahendused. Kui üksust pole külgpaneeli paanil, valige ... Veel 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 teavet, mis ei ole ühenduses, mis on vajalik õige serveri ja tabeliga ühenduse loomiseks Power Apps . Ühendust kasutatakse ainult selliste parameetrite väärtuste toomiseks SharePointi, millega teil on juurdepääs, või saidiga seostatud loendite toomiseks.
     • Kui valitud tüüp on Salajane , on saladusele juurdepääsu lubamiseks Power Platform vaja lisateavet Azure Key Vaulti seadistamiseks ja konfigureerimiseks.

   • 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 saab automaatselt luua keskkonnamuutujaid

Seadete vahekaardil Üldine Power Apps tehke järgmist.

• 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 loomulikult Dataverse. 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 kasutate välist tabelit teisest keskkonnast (keskkonna muutmise kaudu), siis eeldab, Power Apps et soovite alati viidata täpselt samale tabelile. Teil on vaja keskkonnamuutujat, kui vajate, et see väline tabel oleks arenduselt testile või prodile üleminekul erinev väline tabel. Kõige lihtsam on lubada Power Apps endale automaatselt keskkonnamuutuja luua. (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, lisaks SharePoint kehtivale ühendusele on saidi ja loendi jaoks vaja eraldi keskkonnamuutujat.

Loenditega keskkonnamuutujate SharePoint edukaks kasutamiseks:

• Lähte- ja sihtkeskkonna iga vastava veeru kuvatav nimi ja loogiline nimi peavad ühtima.
• Keskkonnamuutujatel SharePoint peavad olema vastavad metaandmed. SharePoint sisaldab sisemisi identifikaatoreid, mis ei pruugi sihtkeskkondade vahel ühtida. Näiteks kui loote sihtkeskkonnas sama nime ja veergudega loendi, siis sisemised nimed ei ühti. Metaandmed ühtivad alati, kui dubleerite SharePoint saidi ja kopeerite selle oma sihtkeskkonda.

SQL Server

SQL Server toetab paljusid erinevaid autentimise ja ühenduste tüüpe. Kasutage ühenduste jaoks Microsoft Entra keskkonnamuutujaid. Serveri ja andmebaasi jaoks on vaja eraldi keskkonnamuutujat. Rakendus on seotud konkreetsete tabelinimedega, nii et eeldatakse, et need on keskkondade vahel samad.

Ärge kasutage keskkonnamuutujaid jagatud ühenduste jaoks, näiteks SQL-i põhiautentimiseks SQL Serveriga. Kasutage ühendusviiteid teabe jaoks, mida tavaliselt edastatakse ühendusstringi osana. Põhilised SQL auth parameetrid on kõik ühendusstringi osad. Näiteks serveri ja andmebaasi nimi antakse ühenduse loomisel ja seetõttu tuletatakse need alati ühendusest.

Andmeallika keskkonnamuutujaid kasutatakse konnektorite jaoks, millel on näiteks Microsoft Entra autentimine. Seda tüüpi ühendustes Power Apps on ainult tuvastatud kasutaja. Power Apps ei saa ühendusest tuletada, millise teenuse või tabeliga kavatsete töötada.

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 SharePoint veebiühenduses ei talletata 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 (või Dynamics 365 rakendused), pole premium-konnektorite kasutamine nõutav. Ü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 saidiga seotud loendite SharePoint sõbralike nimede toomiseks. 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 sisestage SharePoint loendi jaoks saidi URL või kordumatu identifikaator (GUID).

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
Keskkonnamuutujate kasutamine lahendusepilvevoogudes Power Automate
EnvironmentVariableDefinition tabeli/olemi viide
Web API näidised
Andmeallika keskkonnamuutujate kasutamine Canvase rakendustes
Keskkonnamuutujate kasutamine lahenduse pilvevoogudes Power Automate
Kasutage Azure Key Vault saladusi
Keskkonnamuutujate tugi kohandatud konnektorites
Power Apps Ajaveeb: Keskkonnamuutujad on saadaval eelvaates!