Ympäristömuuttujien yleiskatsaus Power Platformille

Ympäristömuuttujat ottavat käyttöön sovelluksen elinkaaren hallinnan (ALM) perusskenaarion sovellusten siirtämiseksi Power Platform -ympäristöjen välillä. Tässä skenaariossa sovellus pysyy täysin samanlaisena lukuun ottamatta muutamaa tärkeää ulkoista sovellusviitettä (kuten taulukot, yhteydet ja avaimet), jotka ovat erilaisia lähde- ja kohdeympäristössä. Sovelluksen toiminta edellyttää, että taulukoiden ja yhteyksien rakenne on täysin sama lähde- ja kohdeympäristöissä muutamaa eroa lukuun ottamatta. Ympäristömuuttujien avulla vodaan määrittää, mitkä näistä erilaisista ulkoisista viitteistä on päivitettävä, kun sovellus siirtyy ympäristöstä toiseen.

Ympäristömuuttujat tallentavat parametrin avaimet ja arvot, jotka tämän jälkeen toimivat muiden sovellusobjektien syötteinä. Kun parametrit erotetaan kuluttavista objekteista, voit muuttaa arvoja samassa ympäristössä tai silloin, kun ratkaisuja siirretään muihin ympäristöihin. Vaihtoehto on jättää kiinteät parametriarvot niitä käyttäville osille. Tämä on usein ongelmallista, etenkin silloin, kun arvoja on muutettava ALM-toimintojen aikana. Koska ympäristömuuttujat ovat ratkaisun osia, voit siirtää viitteet (avaimet) ja muuttaa arvoja, kun ratkaisuja siirretään muihin ympäristöihin.

Muistiinpano

Tietolähteiden uudet ominaisuudet on juuri otettu käyttöön. Ne eivät ehkä ole vielä saatavilla alueellasi.

Ympäristömuuttujien käytön edut:

• Anna uusia parametrien arvoja samalla, kun tuot ratkaisuja muihin ympäristöihin.
• Tallenna pohjaan perustuvissa sovelluksissa ja työnkuluissa käytettävä tietolähteiden määritys. Esimerkiksi SharePoint Online -sivustoa ja luetteloparametreja ei voi tallentaa ympäristömuuttujina. Tämän vuoksi voit muodostaa yhteyden eri sivustoihin ja luetteloihin erilaisissa ympäristöissä ilman sovellusten ja työnkulkujen muokkaamista.
• Pakkaa ja siirrä mukauttamiset ja määritys yhdessä ja hallinnoi niitä yhdessä sijainnissa.
• Pakkaa ja kuljeta salaisuuksia, kuten eri komponenttien käyttämiä tunnistetietoja, erillään komponenteista, jotka käyttävät niitä.
• Yhtä ympäristömuuttujaa voi käyttää useissa eri ratkaisuosissa siitä riippumatta, ovatko osien tyypit samat. Esimerkiksi pohjaan perustuva sovellus ja työnkulku voivat käyttää samaa ympäristömuuttujaa. Kun ympäristömuuttujan arvo pitää muuttaa, vain yhden arvo muuttaminen riittää.
• Jos myös tietolähde tulee poistaa käytöstä tuotantoympäristöissä, voit vain päivittää ympäristömuuttujat uuden tietolähteen tiedoilla. Sovellukset ja työnkulut eivät edellytä muokkausta, ja ne alkavat käyttää uutta tietolähdettä.
• Ratkaisun paketointityökalun ja DevOpsin tukemat työkalut mahdollistavat jatkuvan integroinnin ja jatkuvan toimituksen (CI/CD).
• Ympäristömuuttujat voidaan purkaa ja tallentaa lähdeohjausobjektiin. Voit tallentaa myös eri ympäristömuuttujien arvojen tiedostot erilliseen määritykseen, jota tarvitaan eri ympäristöissä. Ratkaisun paketointityökalu voi tämän jälkeen hyväksyä tiedoston, joka vastaa ympäristöä, johon ratkaisu tuodaan.

Kuinka ympäristömuuttujat toimivat?

Ympäristömuuttujat voidaan luoda ja niitä voidaan muokata modernin ratkaisun käyttöliittymän avulla, joka luodaan automaattisesti muodostettaessa yhteys tiettyihin tietolähteisiin pohjaan perustuvissa sovelluksissa tai käyttämällä koodia. Niitä voidaan tuoda ympäristöön myös ratkaisujen kautta. Kun ympäristömuuttujat näkyvät ympäristössä, niitä voidaan käyttää syötteinä mallipohjaisten sovellusten, Power Automate -työnkulkujen, muokkaamisessa laajennusten kehittämisen yhteydessä, sekä useissa muissa tapauksissa, kuten Power BI -koontinäytön lisäämisessä mallipohjaiseen sovellukseen. Kun tällaiset objektit käyttävät ympäristömuuttujia, arvot johdetaan ympäristömuuttujista. Niitä voidaan muuttaa, kun ratkaisuja tuodaan toisiin ympäristöihin.

Ympäristömuuttujan luominen ratkaisuun

1. Kirjaudu Power Appsiin (make.powerapps.com) ja valitse vasemmassa ruudussa Ratkaisut. Jos nimikettä ei ole sivupaneelissa, valitse ... Lisää ja valitse sitten haluamasi nimike.
2. Avaa haluamasi ratkaisu tai luo uusi ratkaisu.
3. Valitse komentopalkissa Uusi>Lisää ja sitten Ympäristömuuttuja.
4. Täytä oikeanpuoleisessa ruudussa seuraavat sarakkeet ja valitse Tallenna seuraavasti:

   • Näyttönimi. Anna ympäristömuuttujalle nimi.

   • Nimi. Yksilöivä nimi luodaan automaattisesti Näyttönimi-kentästä, mutta sitä voi muuttaa.

   • Tietotyyppi. Valitse seuraavista: Desimaaliluku, Teksti, JSON, Kaksi vaihtoehtoa, Tietolähde tai Salaisuus.

     Muistiinpano

     • Jos valittu tyyppi on Tietolähde, valitse myös yhdistin, sallittu yhteys valitulle yhdistimelle ja parametrin tyyppi. Yhteyttä ei kuitenkaan tallenneta ympäristön muuttujan osana. Yhteyttä käytetään vain haettaessa käytettävissä olevia parametriarvoja, kuten SharePoint-sivustoja, joiden käyttöoikeus sinulla on, tai sivustoihin liittyvistä luetteloista. Tietyille parametreille, esimerkiksi SharePoint-luetteloiden parametreille, on valittava myös päätietolähteen ympäristömuuttuja, kuten SharePoint-sivusto. Kun tiedot on tallennettu, ne liitetään tietokantaan.
     • Jos valittu tyyppi on Salaisuus, tarvitaan Azure-avainsäilön määrittämiseen ja määrittämiseen tarvittavia lisätietoja, jotta Power Platform voi käyttää salaisuutta.

   • Current Value. Tätä kutsutaan myös arvoksi. Tämä ominaisuus on valinnainen ja osa ympäristömuuttujan arvotaulukkoa. Kun arvo on olemassa, sitä käytetään, vaikka myös oletusarvo olisi olemassa. Poista arvo ratkaisusta, jos et halua käyttää sitä seuraavassa ympäristössä. Arvot on myös erotettu erillisiksi JSON-tiedostoiksi viedyssä solution.zip-tiedostossa. Niitä voi muokata offline-tilassa. Lisätietoja: Arvon poistaminen ympäristömuuttujasta

   • Oletusarvo. Sarake on osa ympäristömuuttujan määritystaulukkoa, eikä se ole pakollinen. Oletusarvoa käytetään, jos nykyistä arvoa ei ole.

     Oletusarvon ja nykyisen arvon erottaminen mahdollistaa määrityksen ja oletusarvon muokkaamisen arvosta riippumatta. Esimerkiksi sovelluksen julkaisija voi antaa tarjouksen AppSourcessa oletusarvon kanssa. Vaihtoehtoisesti asiakas voi antaa uuden arvon. Kun sovelluksen julkaisija julkaisee sovellukseen päivityksiä, asiakkaan asettamaa arvoa ei korvata.

     

     Muistiinpano

     Arvoa ei voi olla, jos määritystä ei ole. Liittymä sallii vain yhden arvon luonnin määritystä kohti.

Uusien arvojen antaminen ratkaisuja tuotaessa

Moderni ratkaisun tuontiliittymä sisältää mahdollisuuden antaa ympäristömuuttujien arvoja. Tämä määrittää arvo-ominaisuuden environmentvariablevalue-taulukossa.

Vuoden 2023 joulukuun 7. päivästä alkaen kaikki ympäristömuuttujien arvot näkyvät ratkaisuja tuotaessa (tai kun käyttöönotossa käytetään putkia). Ympäristömuuttujille, joilla ei ole oletusarvoa tai arvoa, pyydetään antamaan arvo. Muussa tapauksessa niille annetaan tekstialueen alle etukäteen tunniste, jossa on arvon lähde, joka voi olla ratkaisun arvo, kohdeympäristön arvo tai oletusarvo.

Muistiinpano

• Joissakin tapauksissa tietyille tietolähteen ympäristömuuttujien arvoille voi tulla näkyviin Käyttö kielletty -varoitussanoma, jos tuontia tekevällä tekijällä ei ole ympäristömuuttujassa käytettävän yhteyden tai lähteen käyttöoikeutta. Tämä on varoitus, joka ei estä toimimasta, mutta joka tulee ottaa huomioon riippuen siitä, miten ympäristömuuttujaa suunnitellaan käytettäväksi kohdeympäristössä.
• Voit poistaa arvon ratkaisusta ennen ratkaisun vientiä. Näin voit varmistaa, että aiemmin luotu arvo säilyy kehitysympäristössä, mutta sitä ei viedä ratkaisuun. Tämä tapa mahdollistaa uuden arvon antamisen, kun ratkaisu tuodaan muihin ympäristöihin. Lisätietoja: Arvon poistaminen ympäristömuuttujasta

Ilmoitukset

Kun ympäristömuuttujilla ei ole arvoja, näkyviin tulee ilmoitus. Tämä muistuttaa arvojen määrittämisestä niin, että ympäristömuuttujista riippuvat osat eivät epäonnistu.

Suojaus

Taulukko environmentvariabledefinition on käyttäjän tai ryhmän omistama. Kun luot sovelluksen, joka käyttää ympäristömuuttujia, muista määrittää käyttäjille asianmukainen oikeustaso tähän taulukkoon. Taulukon environmentvariablevalue käyttöoikeus peritään päätaulukosta environmentvariabledefinition. Tämän vuoksi erillisiä käyttöoikeuksia ei vaadita. Taulukoiden environmentvariabledefinition oikeudet sisältyvät oletusarvon mukaan Ympäristön tekijä- ja Peruskäyttäjä-käyttöoikeusrooleihin. Lisätietoja: Tietoturva Dataversessä.

Nimeäminen

Varmista, että ympäristön muuttujien nimet ovat yksilöllisiä, jotta niihin voidaan viitata tarkasti. Jos ympäristömuuttujien näyttönimistä on kaksoiskappaleita, ympäristömuuttujia on vaikea erottaa ja käyttää. Varmista, että ympäristön muuttujien nimet ovat yksilöllisiä, jotta niihin voidaan viitata tarkasti. Nimet $authentication ja $connection ovat erityisesti varattuja parametrejä työnkuluille, ja niitä tulee välttää. Työnkulkujen tallentaminen estetään, jos käytössä on ympäristömuuttujia, joilla on kyseiset nimet. Jos ympäristömuuttujaa käytetään työnkulussa ja ympäristömuuttujan näyttönimeä muutetaan, suunnitteluohjelma näyttää sekä vanhan että uuden näyttönimitunnuksen, jotta tunnistaminen olisi helpompaa. Työnkulkua päivitettäessä on suositeltavaa poistaa ympäristömuuttujaviittaus ja lisätä se uudelleen.

Nykyiset rajoitukset

• Ympäristömuuttujan arvojen vahvistus tapahtuu käyttöliittymissä niitä käyttävissä osissa, ei Dataversessa. Varmista siksi, että oikeat arvot määritetään, jos niitä muokataan koodin avulla.
• Power Platform Build Tools -tehtävät eivät vielä ole käytettävissä tietolähteen hallintaa varten. Tämä ei kuitenkaan estä niiden käyttämistä Microsoftin toimittamassa työkaluissa ja lähdehallintajärjestelmissä.
• Ympäristömuuttujien käyttäminen mukautetun koodin avulla edellyttää ohjelmointirajapintakutsua arvojen noutamiseksi. Muilla kuin Microsoftin koodeilla ei ole hyödynnettävää välimuistia.
• Jotta ympäristömuuttujia voi käyttää SharePoint-luetteloissa, lähde- ja kohdeympäristöjen kunkin sarakkeen näyttönimen ja loogisen nimen on vastattava toisiaan.
• Ympäristömuuttujissa voi olla enintään 2 000 merkkiä.

Usein kysyttyjä kysymyksiä

Miksi arvo ei näy ympäristömuuttujassa?

Jos ympäristömuuttuja on hallittu ratkaisu, arvo on näkyvissä vain oletusratkaisussa. Tämä toiminta on suunniteltua, koska ympäristömuuttujan arvo on hallitsematon mukautus.

Miten näen, missä ympäristömuuttujia käytetään?

Näet tiedot ratkaisun käyttöliittymässä Näytä riippuvuudet -vaihtoehdon osien muokkaamisen yhteydessä tai lähteenhallinnassa ja ratkaisutiedostossa tarkastelemalla sovellusta tai työnkulun metatietoja.

Ovatko tietolähteen ympäristömuuttujat yhdistimiä?

Ei. Vaikka ne liittyvät toisiinsa, yhteys edustaa tunnistetietoa tai todennusta, joka vaaditaan yhdistimen kanssa toimimiseen. Tietolähteen ympäristömuuttujat tallentavat parametrit, jotka vähintään yksi toiminto vaatii yhdistimessä. Nämä parametrit vaihtelevat usein toiminnon mukaan. Esimerkiksi SharePoint Online -yhteys ei tallenna tietoja sivustosta, luetteloista tai tiedostokirjastoista. Tämän vuoksi yhdistimen kutsuminen edellyttää sekä sallitun yhteyden että lisäparametreja.

Voiko tietolähteen ympäristömuuttujia käyttää jaetuissa yhteyksissä, kuten SQL Serverissä ja SQL-todennuksessa?

Yleensä ei. Jaetut yhteydet SQL Serveriin tallentavat parametrit, joita tarvitaan yhteyden muodostamisessa yhteyden tietoihin. Esimerkiksi palvelimen ja tietokannan nimet annetaan, kun luodaan yhteys. Tämän vuoksi ne johdetaan aina yhteydestä.

Tietolähteen ympäristömuuttujia käytetään yhdistimissä, joissa käytetään käyttäjään perustuvaa todennusta, kuten Microsoft Entra ID:tä, koska parametreja ei voi johtaa yhteydestä. Näistä syistä SQL Server -todennus, joka on jaettu yhteys, ei käytä tietolähteen ympäristömuuttujia.

Voiko automatisoitu ALM-putki käyttää eri arvojen tiedostoja eri ympäristöissä?

Kyllä. Ratkaisun paketointityökalu hyväksyy tiedostonimen syöteparametreiksi, joten putki voi pakata eri arvojen tiedoston ratkaisuun riippuen sen ympäristön tyypistä, jossa suoritus tehdään.

Pitäisikö minun sisällyttää tämä arvo ratkaisuuni?

Ei. Ympäristömuuttujat on tarkoitettu sellaisten sovellusten käyttöön, joilla on oltava eri arvot eri ympäristöissä, joissa ratkaisu otetaan käyttöön. Ympäristömuuttujien määritykset on sisällytettävä ratkaisuun, mutta arvot on annettava kohdeympäristön mukaan käyttöönoton aikana. Tämä toiminnallisuus johtaa siihen, että ympäristömuuttujan määritys on hallittu ratkaisuobjekti kohdeympäristössä, kun taas ympäristömuuttuja on ei-hallittu tietue.

Miksi en voi poistaa arvoa ympäristöstäni?

Jos arvo sisällytettiin hallittuun ratkaisuun, ainoa tapa poistaa arvo on päivittää ratkaisu lähdeympäristössä niin, että arvo jätetään pois, ja viedä sitten ratkaisun uusi versio. Tämä uusi versio voidaan sitten tuoda ympäristöön versiopäivitystoiminnolla (ei päivityksellä), jolloin arvotietue poistetaan.

Mitä tapahtuu, jos joku poistaa arvon vahingossa?

Jos riippuvuusjärjestelmä ei ole jo estänyt sitä, suorituspalvelu käyttää viimeistä tunnettua arvoa vara-arvona.

Jos arvoa muutetaan, milloin uutta arvoa käytetään pohjaan perustuvissa sovelluksissa ja pilvityönkuluissa?

Päivitettyjen ympäristömuuttujien julkaiseminen kokonaan voi kestää jopa tunnin, koska arvo lähetetään sovelluksiin ja työnkulkuihin asynkronisesti.

Ovatko Premium-käyttöoikeudet pakollisia?

Ei. Vaikka ALM vaatii Dataversen (tai Dynamics 365 -sovelluksen), Premium-yhdistimiä ei vaadita. On huomioitava Dataverse -yhdistimen käyttö yhdessä ympäristömuuttujien kanssa, kuten muiden tietueiden, kuten asiakkaiden ja yhteyshenkilöiden, kanssa. Aiemmin tämä oli ainoa tapa käyttää ympäristömuuttujia pohjaan perustuvissa sovelluksissa ja työnkuluissa.

Onko ympäristömuuttujille määritetty enimmäismäärä?

Ei. Ratkaisun enimmäiskoko on kuitenkin 95 Mt. Lisätietoja: Ratkaisun luominen

Voiko ympäristömuuttujien näyttönimet ja kuvaukset lokalisoida?

Kyllä.

Tulisiko käyttää ympäristömuuttujia sen sijaan, että määritystiedot tallennetaan mukautettuihin taulukoihin?

Kyllä, jos määritystiedot eivät ole relaatiotietoja. Ympäristömuuttujia tulisi käyttää avain-arvopareissa ja silloin, kun arvon on todennäköisesti oltava eri muissa ympäristöissä. Muut työkalut, kuten määrityksen siirtoapuohjelma, sopivat paremmin mukautettuihin taulukoihin tallennettujen määrityksen relaatiotietojen siirtoon. Toisin kuin määritystiedot, ympäristömuuttujat siirretään ratkaisujen välillä. Tämän vuoksi niiden hallinta on yksinkertaista ja tuominen tehokasta.

Miksi yhteyttäni ei tallenneta tietolähteen ympäristömuuttujiin?

Yhteyksiä käytetään vain käyttöliittymän luomiseen. Voit esimerkiksi hakea kutsumanimiä sivustoon liittyville SharePoint-luetteloille. Kun muokkaat tietolähteen ympäristömuuttujaa, muista valita yhteys, jolla on pääsy tietolähteeseen. Jos et voi enää käyttää yhteyttä, voit syöttää arvon manuaalisesti. Anna esimerkiksi luettelolle SharePoint-sivuston URL-osoite tai yksilöllinen tunnus (GUID).

Kun yhdelle (tietolähdetyyppiselle) ympäristömuuttujalle on käytettävissä useita yhteyksiä, on olemassa suunniteltu toteutus, jolla valitaan ensimmäinen yhteys yhteysluettelosta. Koska ympäristömuuttujaan liittyy yleensä vain yksi yhteys, tätä ei yleensä tarvitse tarkistaa. Lisäksi ympäristömuuttujan arvon näkyvyyteen on hiljattain tehty muutoksia, ja tämä on aiempaa helpompi tarkistaa tuonnin yhteydessä.

Arvon poistaminen ympäristömuuttujasta

Ympäristömuuttujan arvo halutaan ehkä poistaa ratkaisusta ennen ratkaisun vientiä. Nykyinen arvo jää sitten kehitysympäristöön, mutta sitä ei viedä ratkaisuun. Tämä menetelmä sallii uuden arvon antamisen, kun ratkaisu tuodaan toiseen ympäristöön.

Arvo poistetaan seuraavasti:

1. Valitse ympäristömuuttuja näyttämään ominaisuudet siinä ratkaisussa, jossa ympäristömuuttuja sijaitsee.

2. Valitse Nykyinen arvo -kohdassa ...>Poista tästä ratkaisusta.

   

Voinko käyttää ympäristömuuttujia mukautetuissa yhdistimissä?

Kyllä. Ympäristömuuttujan tuki mukautetuissa yhdistimissä

Katso myös

Tietolähteen ympäristömuuttujien käyttäminen pohjaan perustuvissa sovelluksissa
Ympäristömuuttujien käyttäminen Power Automate -ratkaisun pilvityönkuluissa
EnvironmentVariableDefinition-taulukko-/entiteettiviittaus
Verkko-ohjelmointirajapintaesimerkit
Tietolähteen ympäristömuuttujien käyttäminen pohjaan perustuvissa sovelluksissa
Ympäristömuuttujien käyttäminen Power Automate -ratkaisun pilvityönkuluissa
Azure Key Vault -salaisuuksien käyttäminen
Ympäristömuuttujien tuki mukautetuissa yhdistimissä
Power Apps Blogi: Esiversiossa on ympäristömuuttujat käytettävissä.