Környezeti változók az áttekintéshez Power Platform

A környezeti változók lehetővé teszik az alkalmazások környezetek közötti Power Platform áthelyezésének alapszintű alkalmazáséletciklus-kezelési (ALM) forgatókönyvét. Ebben a forgatókönyvben az alkalmazás pontosan ugyanaz marad, kivéve néhány kulcsfontosságú külső alkalmazáshivatkozást (például táblákat, kapcsolatokat és kulcsokat), amelyek különböznek a forráskörnyezet és a célkörnyezet között. Az alkalmazás megköveteli, hogy a táblák vagy kapcsolatok szerkezete pontosan ugyanaz legyen a forrás- és a célkörnyezet között, néhány különbséggel. A környezeti változók segítségével megadhatja, hogy a különböző külső hivatkozások közül melyeket kell frissíteni az alkalmazás környezetek közötti áthelyezésekor.

A környezetváltozók tárolják a paraméterkulcsokat és értékeket, amelyek majd számos egyéb alkalmazásobjektum bemeneti adataként szolgálnak. A paramétereknek a fogyasztó objektumoktól való elválasztása lehetővé teszi az értékek módosítását ugyanazon a környezeten belül, illetve más környezetbe való áttelepítéskor. A másik lehetőség, hogy az azokat használó összetevőkben hagyják a kódolt paraméterértékeket. Ez gyakran problémás; különösen akkor, ha az értékeket módosítani kell az ALM műveletek során. Mivel a környezet változók megoldás-összetevők, a hivatkozások (kulcsok) átvihetők és módosíthatók az értékek a megoldások más környezetbe való áttelepítésekor.

Megjegyzés

Az adatforrások új képességei jelenleg éppen telepítés alatt vannak, és előfordulhat, hogy még nem érhetők el az adott régióban.

Környezeti változók használatának előnyei:

• Adja meg az új paraméterértékeket, amikor megoldásokat importál más környezetbe.
• Tárolhatja a vászonalapú alkalmazásokban és folyamatokban használt adatforrások konfigurációját. A SharePoint online webhelyek és listaparaméterek például környezetváltozóként tárolhatók, így az alkalmazások és folyamatok módosítása nélkül kapcsolódhat a különböző környezetekben található különböző telephelyekhez és listákhoz.
• A testreszabások és beállítások együtt csomagolhatók és átvihetők, és azokat egyetlen helyen kezelheti.
• Csomagolja különállóan a csomagokat és a szállítási titkos kódokat (például a különböző összetevők által használt azonosító adatokat) az őket használó összetevőktől.
• Egy környezetváltozó számos megoldás-összetevő esetében használható – függetlenül attól, hogy ugyanolyan típusúak-e, vagy eltérőek. Egy vászalapú alkalmazás és egy folyamat például ugyanazt a környezetváltozót használhatja. Ha a környezetváltozó értékét módosítani kell, csak egy értéket kell módosítani.
• Ezenkívül, ha éles környezetben ki kell vonnia egy adatforrás, frissítheti a környezeti változók értékeit az új adatforrás adataival. Az alkalmazások és folyamatok nem igényelnek módosítást, és elkezdik használni az új adatforrás.
• A SolutionPackager és a DevOps által támogatott eszközök lehetővé teszik a folyamatos integrációt és szállítást (CI/CD).
• A környezetváltozók kicsomagolhatóak és tárolhatók a forrásvezérlőben. Különböző környezeti változókat, értékeket, fájlokat is tárolhat a különböző környezetekben szükséges külön konfigurációhoz. A Solution Packager ezután elfogadhatja annak a környezetnek megfelelő fájlt, amelybe a megoldást importálta.

Hogyan működnek a környezeti változók?

A környezeti változók a modern megoldási felületen belül is létrehozhatók és módosíthatók, automatikusan létrejönnek, ha vászonalapú alkalmazásokban egyes adatforráshoz csatlakoznak, vagy kód használatával. Megoldások segítségével is importálhatók egy környezetbe. Ha a környezeti változók jelen vannak egy környezetben, bemenetként használhatók vászonalapú alkalmazások, Power Automate folyamatok létrehozásakor, beépülő modulok fejlesztésekor és sok más helyen, például irányítópult Power BI modellvezérelt alkalmazáshoz való hozzáadásakor. Amikor ezek a típusú objektumok környezeti változókat használnak, akkor az értékek a környezeti változókból származnak, és módosíthatók, amikor megoldásokat importálnak más környezetekbe.

Környezeti változó létrehozása egy alkalmazásban

1. Jelentkezzen be a Power Apps (make.powerapps.com) rendszerbe és a bal oldali panelen válassza a Megoldások lehetőséget. Ha az elem nem látható az oldalsó panelben, akkor válassza a ...Továbbiak lehetőséget, majd válassza ki a kívánt elemet.
2. Nyissa meg a kívánt megoldást, vagy hozzon létre újat.
3. A parancssávon válassza ki az Új > Továbbiak, majd a Környezeti változó lehetőséget.
4. A jobb oldali ablaktáblában töltse ki a következő oszlopokat, majd válassza a Mentés lehetőséget:

   • Megjelenítendő név Adja meg a környezet változó nevét.

   • Név. Az egyedi név automatikusan létrejön a Megjelenítendő névből, de ez módosítható.

   • Adattípus. Válasszon a Decimális szám, Szöveg, JSON, Két beállítás, Adatforrás vagy Titkos kód közül.

     Megjegyzés

     • Ha az Adatforrás típus van kijelölve, ki kell választania az összekötőt, egy érvényes kapcsolatot a kiválasztott összekötőhöz, és a paraméter típusát. A rendszer azonban nem tárolja a kapcsolatot a környezeti változó részeként. A kapcsolatokat csak az elérhető paraméterértékek lekérésére használja a rendszer (ilyenek például azok a SharePoint-honlapok, amelyekhez hozzáférése van, illetve a honlaphoz társított listák). Bizonyos paraméterek (például SharePoint-listák) esetében ki kell választania egy szülő adatforrás környezeti változót, például a SharePoint-webhelyet. Mentés után ezek az adatbázisban egymáshoz kapcsolódnak.
     • Ha a Titkos kód típust választotta, további információkra van szükség az Azure Key Vault olyan módon történő beállításához és konfigurálásához, hogy az engedélyezze a Power Platform szolgáltatásnak a titkos kódokhoz való hozzáférést.

   • Aktuális érték: Más néven az érték. Ez a tulajdonság nem kötelező, és a környezeti változó értéktáblájának része. Ha van érték, a rendszer azt használja, még akkor is, ha alapértelmezett érték is jelen van. Ha nem kívánja használni a következő környezetben, akkor távolítsa el az értéket a megoldásból. Az értékek külön JSON-fájlokra vannak választva az exportált solution.zip fájlon belül, és kapcsolat nélküli módban szerkeszthetők. További információ: Hogyan távolítható el egy érték egy környezeti változóból?

   • Alapértelmezett érték. Ez az oszlop a környezetiváltozó-definíciós tábla része, és nem kötelező. Az alapértelmezett érték akkor használatos, ha nincs aktuális érték.

     Az alapértelmezett érték és az aktuális érték különválasztása lehetővé teszi a definíció és az alapértelmezett érték külön szolgáltatását az értéktől. Előfordulhat például, hogy egy alkalmazás-közzétevő alapértelmezett értékkel listázza az AppSource ajánlatát. Ezt követően az ügyfél új értéket is meg tud adni. Amikor az alkalmazás közzétevője frissítéseket tesz közzé az alkalmazáshoz, az ügyfél által beállított érték nem lesz felülírva.

     

     Megjegyzés

     Definíció nélkül nem létezhet érték. Az interfész csak egy érték létrehozását teszi lehetővé definíciónként.

Új értékek megadása a megoldások importálása során

A korszerű megoldásimportálási felület tartalmazza a környezeti változók értékeinek megadásának lehetőségét. Ezzel beállítja az érték tulajdonságot a environmentvariablevalue táblán.

A 2023. december 7-i frissítéstől kezdve minden környezeti változó értéke látható a megoldások importálásakor (vagy ha folyamatokat használ az üzembe helyezéshez). Az alapértelmezett érték vagy érték nélküli környezeti változók értéket kérnek, de az egyébként kitöltött címkék előre ki vannak töltve az érték forrását jelölő szövegmező alatt: megoldásérték, célkörnyezet értéke vagy alapértelmezett érték.

Megjegyzés

• Bizonyos esetekben adott adatforrás környezeti változóértékek esetén hozzáférés-megtagadási figyelmeztetés jelenhet meg, ha az importáló készítője nem fér hozzá a környezeti változóhoz használt kapcsolathoz vagy forráshoz. Ez egy nem blokkoló figyelmeztetés, de érdemes megjegyezni attól függően, hogy hogyan tervezi használni a környezeti változót a célkörnyezetben.
• Előfordulhat, hogy a megoldás exportálása előtt eltávolíthatja a megoldás értékét. Ez biztosítja, hogy a meglévő érték a fejlesztői környezetben maradjon, de nem lesz exportálva a megoldásba. Ez a megközelítés lehetővé teszi új érték megadását a megoldás más környezetbe való importálása során. További információ: Hogyan távolítható el egy érték egy környezeti változóból?

Értesítések

Az értesítés akkor jelenik meg, ha a környezeti változók nem rendelkeznek semmilyen értékkel. Ez egy emlékeztető, hogy az értékeket úgy állítsa be, hogy a környezeti változóktól függő összetevők ne hiúsuljanak meg.

Biztonsági

Az environmentvariabledefinition táblázat felhasználó vagy csoport által birtokolt. Ha környezeti változókat használó alkalmazást hoz létre, mindenképpen rendelje hozzá a felhasználókhoz a megfelelő szintű jogosultságot ehhez a táblához. Az environmentvariablevalue táblára vonatkozó jogosultság a fölérendelt environmentvariabledefinition táblából örökölt, ezért nem igényel külön jogosultságokat. Az environmentvariabledefinition táblák jogosultságait a Környezetfejlesztő és az Alapszintű felhasználó biztonsági szerepkörök alapértelmezés szerint tartalmazzák. További információ: Biztonság a Dataverse megoldásban.

Elnevezés

Gondoskodjon róla, hogy a környezet változók nevei egyediek legyenek, hogy pontosan hivatkozni tudjanak rájuk. A környezetváltozók ismétlődő megjelenítendő nevei miatt a környezet változói nehezen megkülönböztethetőek és használhatók lesznek. Gondoskodjon róla, hogy a környezet változók nevei egyediek legyenek, hogy pontosan hivatkozni tudjanak rájuk. A $authentication és $connection nevek folyamatok különlegesen fenntartott paraméterei, amelyeket kerülni kell. A folyamat mentése le van tiltva, ha ilyen nevű környezeti változókat használ. Ha környezeti változót használ egy folyamatban, és a környezeti változó megjelenítendő név megváltozik, akkor a tervező a régi és az új megjelenítendő név tokeneket is megjeleníti az azonosítás elősegítése érdekében. A folyamat frissítésekor javasoljuk, hogy távolítsa el a környezeti változó hivatkozását, majd adja hozzá újra.

Jelenlegi korlátozások

• A környezetváltozók értékeinek ellenőrzése a felhasználói felületen belül és az azokat használó összetevőkben történik, de nem a Dataverse-en belül. Ezért gondoskodjon róla, hogy helyes értékek legyenek beállítva, ha kódon keresztül módosítják őket.
• A Power Platform Build Tools feladatai még nem érhetők el adatforrás környezeti változók kezeléséhez. Ez azonban nem tiltja a Microsoft által biztosított eszközökön és a forrásvezérlő rendszereken belüli használatot.
• A környezeti változókkal egyéni kódon keresztüli interakcióhoz API-hívásra van szükség az értékek lekéréséhez; nincs elérhető gyorsítótár a nem Microsoft-kód számára.
• A környezeti változók listákkal való SharePoint sikeres használatához a forrás- és célkörnyezet minden egyes megfelelő oszlopának megjelenítendő név és logikai nevének egyeznie kell.
• A környezeti változók legfeljebb 2 000 karakterből állhatnak.

Gyakori kérdések

Miért nem látom a környezeti változó értékét?

Ha a környezeti változó egy felügyelt megoldás van, csak akkor láthatja az értéket, ha belenéz az Alapértelmezett megoldásba. Ez a viselkedés szándékos, mivel a környezeti változó értéke nem felügyelt testreszabás.

Hogyan lehet megtekinteni, hogy hol vannak használatban a környezeti változók?

A Függőségek megjelenítése lehetőség kiválasztásával a megoldás felületén az összetevők készítése közben, vagy a forrásvezérlőben és a megoldásfájlban az alkalmazás vagy a folyamat metaadatainak megtekintésével.

Az adatforrás a környezeti változók ugyanazok, mint a kapcsolatok?

Nem. Bár kapcsolódnak egymáshoz, a kapcsolat az összekötővel való interakcióhoz szükséges hitelesítő adatokat vagy hitelesítést jelöli. Az adatforrás környezeti változók tárolják az összekötő egy vagy több művelete által megkövetelt paramétereket, és ezek a paraméterek gyakran a művelettől függően változhatnak. A SharePoint Online kapcsolat például nem tárol semmilyen információt a webhelyekről, listákról és dokumentumtárakról. Ezért az összekötő hívásához érvényes kapcsolatra és néhány további paraméterre is szükség van.

Használhatók adatforrás környezeti változók megosztott kapcsolatokkal, például SQL-hitelesítéses SQL Serverrel?

Általában nem. Az SQL Serverrel megosztott kapcsolatok tárolják a kapcsolaton belül az adatokhoz való kapcsolódáshoz szükséges paramétereket. A kapcsolat létrehozásakor például a kiszolgáló és az adatbázis neve kerül megadásra, ezért ezek mindig a kapcsolatból származnak.

Adatforrás környezeti változók felhasználóalapú hitelesítésre támaszkodó összekötőkhöz használatosak, például: Microsoft Entra Azonosító, mert a paraméterek nem származtathatók a kapcsolatból. Ezen okok miatt az SQL-hitelesítéses SQL Server – amely egy megosztott kapcsolat – nem használ adatforrás környezeti változókat.

Használhat az automatizált ALM-folyamatom különböző értékfájlokat a különböző környezetekhez?

Igen. A megoldáscsomagoló bemeneti paraméterként fogadja a fájlnevet, így a folyamat egy másik értékfájlt is csomagolhat a megoldásba attól függően, hogy milyen környezettípuson hajtja ezt végre.

Mi a történik akkor, ha valaki véletlenül töröl egy értéket?

Ha a függőségi rendszer még nem akadályozta meg, a futásidő az utolsó ismert értéket használja tartalékként.

Ha módosul egy érték, mikor kerül használatra az új érték a vászonalapú alkalmazásokban és a felhőfolyamatokban?

A frissített környezeti változók teljes közzététele akár egy órát is igénybe vehet, mert az érték aszinkron módon lesz leküldve az alkalmazásokba, és aszinkron módon áramlik.

Szükségesek a prémium licencek?

Nem. Miközben az ALM használatához Dataverse (vagy a Dynamics 365 for Customer Engagement) szükséges, nem szükséges a magasabb szintű összekötők használata. Az egyetlen ellenjavallat, ha Dataverse összekötőt használ a környezeti változókkal való interakciókhoz, mint az egyéb adatrekordok, például partnerek vagy kapcsolattartók esetében. Korábban ez volt az egyetlen módja a környezeti változók használatának a vászonalapú alkalmazásokban és folyamatokban.

Korlátozott a környezeti változók száma, amelyekkel rendelkezhetek?

Nem. A megoldások maximális mérete azonban 95 MB. További információ: Megoldás létrehozása

A környezetváltozók megjelenítendő nevei és leírásai honosíthatók?

Igen.

A konfigurációs adatok egyéni táblákban való tárolása helyett inkább környezeti változókat használjak?

Igen, ha a konfigurációs adatok nem relációsak. A környezeti változókat a kulcs: értékpárok esetében kell használni, és ha más környezetben az értéknek valószínűleg eltérőnek kell lennie. Az egyéb eszközök, például a Konfiguráció áttelepítő segédprogram alkalmasabb az egyéni táblákban tárolt relációs konfigurációs adatok áttelepítéséhez. Az egyéb konfigurációs adatoktól eltérően a környezetváltozók a megoldásokon belül áttelepíthetők, ezért egyszerűbben kezelhetők, és jobb teljesítménnyel importálhatók.

Miért van más kapcsolati érték, mint amelyet importáláskor automatikusan hozzá szeretnék rendelni?

Bizonyos esetekben, amikor több kapcsolat is elérhető egyetlen (adatforrás típusú) környezeti változóhoz, van egy tervezési implementáció, amely kiválasztja az első kapcsolatot a környezeti változóhoz elérhető kapcsolatok listájában. Mivel egy környezeti változóhoz általában csak egy kapcsolat van társítva, ezt általában nem kell ellenőrizni. Emellett a környezeti változók értékének láthatóságának legutóbbi változásaival ez könnyebben ellenőrizhető importáláskor.

Hogyan távolítható el egy érték egy környezeti változóból?

Előfordulhat, hogy a megoldás exportálása előtt el szeretné távolítani egy környezeti változó értékét a megoldásból. Ezután a meglévő érték a fejlesztői környezetben marad, de nem lesz exportálva a megoldásban. Ez a megközelítés lehetővé teszi új érték megadását a megoldás másik környezetbe való importálása során.

Az érték eltávolításához tegye a következőket:

1. Abban a megoldásban, ahol a környezeti változó található, válassza ki a környezeti változót, hogy megjelenítse a tulajdonságokat.

2. A Jelenlegi érték alatt válassza a ... > Eltávolítás ebből a megoldásból lehetőséget.

   

Használhatok-e környezeti változókat egyéni összekötőkben?

Igen. A környezeti változók támogatása az egyéni összekötőkben

Kapcsolódó információk

adatforrás környezeti változók használata vászonalapú alkalmazásokban
Környezeti változók használata megoldásfelhő-folyamatokban Power Automate
EnvironmentVariableDefinition táblázat/egység hivatkozása
Webes API-minták
adatforrás környezeti változók használata vászonalapú alkalmazásokban
Környezeti változók használata megoldásfelhő-folyamatokban Power Automate
Titkos Azure Key Vault használata
A környezeti változók támogatása az egyéni összekötőkben
Power Apps Blog: A környezeti változók elérhetőek az előnézetben!

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).