A Power Platform környezeti változói áttekintése

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 a megközelítés gyakran problematikus; 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.

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

• Új paraméterértékeket adhat meg a megoldások más környezetekbe való importálásakor .
• Tárolja a vászonalapú alkalmazásokban és folyamatokban használt adatforrások konfigurációját. Például SharePoint online webhely- és listaparaméterek környezeti változókként tárolhatók. Ez a megközelítés lehetővé teszi, hogy különböző környezetekben lévő különböző webhelyekhez és listákhoz csatlakozzon anélkül, hogy módosítania kellene az alkalmazásokat és a folyamatokat.
• 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.
• Ha pedig éles környezetben kell adatforrást kivezetni, frissítheti a környezeti változó é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ást.
• A SolutionPackager és a DevOps által támogatott eszközök lehetővé teszik a folyamatos integrációt és a folyamatos teljesí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 hozhatók létre és módosíthatók. Automatikusan is létrehozhatók, amikor bizonyos adatforrásokhoz csatlakoznak vászonalapú alkalmazásokban vagy kóddal. Megoldások segítségével is importálhatók egy környezetbe. A környezeti változók bemenetként használhatók vászonalapú alkalmazások, Power Automate folyamatok, beépülő modulok készítésekor, valamint Power BI irányítópultok modellalapú alkalmazásokhoz való hozzáadásakor. Környezeti változók használata esetén az értékek a környezeti változókból származnak, és a megoldások más környezetekbe való importálásakor módosíthatók.

Környezeti változó manuális létrehozása egy megoldásban

1. Jelentkezzen be a Power Apps (make.powerapps.com), majd a bal oldali panelen válassza a Solutions lehetőséget. Ha az elem nem szerepel az oldalsó panel paneljén, válassza a ... Tovább, 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 az Új>továbbiak, majd a Környezeti változó lehetőséget.
4. A jobb oldali panelen 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.

   • Name. 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 lehetőség,Adatforrás vagyTitkos lehetőségek közül.

     Megjegyzés

     • Ha az adatforrás a kiválasztott típus, ki kell választania az összekötőt, a kiválasztott összekötő érvényes kapcsolatát és a paraméter típusát. A kapcsolat nem a környezeti változó részeként van tárolva. A környezeti változó nem a megfelelő kiszolgálóhoz és táblához Power Apps való csatlakozáshoz szükséges adatokat tárolja a kapcsolaton belül. A kapcsolat csak a rendelkezésre álló paraméterértékek, például a SharePoint webhelyek vagy a webhelyhez társított listák lekérésére használható.
     • Ha Secret a kiválasztott típus, további információkra van szükség a Azure Key Vault beállításához és konfigurálásához, hogy a Power Platform hozzáférhessen a titkos kódhoz.

   • 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. A rendszer akkor is definiált értéket használ, 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íthatok el értéket 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. Egy alkalmazás közzétevője például alapértelmezett értékkel listázhatja az ajánlatát a Marketplace-en. 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.

Power Apps automatikusan létrehozhat környezeti változókat

A Power Apps beállítások General lapján:

• Engedélyezze a Környezeti változók automatikus létrehozása adatforrások hozzáadásakor beállítást. Most, amikor új adatforrást ad hozzá az alkalmazáshoz, az hozzáad egy környezeti változót.

  

Különböző adatforrások

A különböző adatforrások különböző típusú környezeti változókat tesznek lehetővé.

Microsoft Dataverse

Power Apps natív módon csatlakozik a Dataverse-hez. Az aktuális környezetben lévő táblákhoz nincs szükség környezeti változóra. Amikor csatlakozik a Dataverse-hez, az alkalmazás automatikusan pontosan ugyanazt a táblanevet keresi bármilyen környezetben, ahová áthelyezi. Mindaddig, amíg a táblanév struktúrája ugyanaz a célkörnyezetben, mint az eredeti környezetben, működik.

Ha egy másik környezetből származó külső táblát használ (a Change Environment használatával), akkor Power Apps feltételezi, hogy mindig pontosan ugyanarra a táblára szeretne hivatkozni. Környezeti változóra akkor van szüksége, ha azt szeretné, hogy a külső tábla egy másik külső tábla legyen, amikor a fejlesztésről a tesztelésre vagy a próbaüzemre vált. A legegyszerűbb, ha lehetővé teszi Power Apps számára, hogy automatikusan létrehozza a környezeti változót. (Ha korábban hozzáadta a táblázatot az alkalmazáshoz, kapcsolja be a beállítások kapcsolót, dobja el a külső táblázatot, majd adja hozzá újra.)

Amikor hozzáadja a külső táblát az alkalmazáshoz, válassza a Speciális lapot a környezeti változó kiválasztásához.

SharePoint

SharePoint csak Microsoft Entra kapcsolatokat támogat. Így az SharePoint esetében az érvényes kapcsolaton kívül egy külön környezeti változóra is szükség van a Hely és a Lista esetében.

Környezeti változók sikeres használata SharePoint listákkal:

• A forrás- és célkörnyezet minden egyes megfelelő oszlopa megjelenítendő nevének és logikai nevének egyeznie kell.
• A SharePoint környezeti változóinak egyező metaadatokkal kell rendelkezniük. SharePoint olyan belső azonosítókkal rendelkezik, amelyek nem feltétlenül egyeznek a célkörnyezetek között. Ha például egy célkörnyezetben azonos nevű és oszlopú listát hoz létre, a belső nevek nem fognak egyezni. A metaadatok mindig megegyeznek, ha egy SharePoint webhelyet duplikál, és a célkörnyezetbe másolja.

SQL Server

SQL Server számos különböző típusú hitelesítést és kapcsolatot támogat. Környezeti változók használata Microsoft Entra kapcsolatokhoz. A kiszolgálóhoz és az adatbázishoz külön környezeti változó szükséges. Az alkalmazás adott táblanevekhez van kötve, így a rendszer feltételezi, hogy azonosak a környezetek között.

Ne használjon környezeti változókat megosztott kapcsolatokhoz, például alapszintű SQL-hitelesítéshez SQL Server. A hagyományosan a connection string részeként átadott információkhoz használjon kapcsolati hivatkozásokat. Az alapszintű SQL-hitelesítési paraméterek mind a connection string részei. 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.

Az adatforrás környezeti változói olyan hitelesítéssel rendelkező összekötőkhöz használatosak, mint Microsoft Entra. Az ilyen típusú kapcsolatokban Power Apps csak azonosított felhasználóval rendelkezik. Power Apps nem tudja levezetni, hogy milyen szolgáltatással vagy táblával kíván dolgozni a kapcsolatból.

Ú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 a value tulajdonságát a táblázaton environmentvariablevalue.

A környezeti változók értékei megoldások importálásakor vagy Pipelines segítségével történő üzembe helyezéskor láthatók. Az alapértelmezett érték nélküli környezeti változók értéket kérnek, de egyébként az érték forrását jelölő szövegmező alatti címkével vannak kitöltve: megoldásérték, célkörnyezet értéke vagy alapértelmezett érték.

Megjegyzés

• Bizonyos esetekben az adatforrás környezeti változóértékei esetén hozzáférés-megtagadási figyelmeztetés jelenhet meg, ha az importáló készítő nem fér hozzá a környezeti változóhoz használt kapcsolathoz vagy forráshoz. Ez egy blokkolást nem engedélyező figyelmeztetés, de figyelembe kell venni attól függően, hogy hogyan tervezi használni a környezeti változót a célkörnyezetben.
• A megoldás exportálása előtt eltávolíthatja az értéket a megoldásból. Ez biztosítja, hogy a meglévő érték megmaradjon a fejlesztési környezetben, 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ás környezetbe való importálása során. További információ: Hogyan távolíthatok el értéket 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. Állítsa be az értékeket úgy, hogy a környezeti változóktól függő összetevők ne hibásodjanak meg.

Biztonság

A environmentvariabledefinition tábla felhasználó vagy csapat tulajdonában van. 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. A táblához való environmentvariablevalue engedély a szülőtáblától environmentvariabledefinition öröklődik, ezért nem igényel külön jogosultságokat. A táblák jogosultságai alapértelmezés szerint szerepelnek a Környezetkészítő és az Alapszintű felhasználó biztonsági szerepkörökben environmentvariabledefinition . További információ: Biztonság itt Dataverse.

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 nevek $authentication és $connection kifejezetten az áramlások számára fenntartott paraméterek, ezért kerülendők. Ezekkel a nevekkel rendelkező környezeti változók használata blokkolja a folyamatmentést. Ha környezeti változót használ egy folyamatban, és a környezeti változó megjelenítendő neve megváltozik, akkor a tervező a régi és az új megjelenítendő név tokeneket is megjeleníti az azonosítás megkönnyí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.
• Power Platform Build Tools-feladatok még nem érhetők el az adatforrás környezeti változóinak 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 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ó felügyelt megoldásban 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 felügyelet nélküli testreszabás.

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

Vagy a Függőségek megjelenítése lehetőséget választva a megoldási felületen, az összetevők létrehozása közben, vagy a verziókövetésben és a megoldásfájlban az alkalmazás vagy a folyamat metaadatainak megtekintésével.

Az adatforrás-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. Egy SharePoint Online-kapcsolat például nem tárol webhelyekkel, listákval vagy dokumentumtárakval kapcsolatos információkat. 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 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.

Bele kell foglalnom az értéket a megoldásomba?

Nem. A környezeti változókat olyan alkalmazások használják, amelyeknek különböző értékekkel kell rendelkezniük a megoldás üzembe helyezésének különböző környezeteiben. A megoldásnak tartalmaznia kell a környezeti változók definícióit, de az értékeket az üzembe helyezés során meg kell adni a célkörnyezethez. Ez a viselkedés azt eredményezi, hogy a környezeti változó definíciója felügyelt megoldási objektum a célkörnyezetben, míg a környezeti változó nem felügyelt rekord.

Miért nem tudok törölni egy értéket a környezetemben?

Ha az érték egy felügyelt megoldásban szerepelt, az érték törlésének egyetlen módja a megoldás frissítése a forráskörnyezetben az érték kizárásához, majd a megoldás új verziójának exportálása. Ez az új verzió ezután frissítési művelettel (nem frissítéssel) importálható a környezetbe, ami az értékrekord törlését eredményezi.

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. Bár az ALM-hez Dataverse (vagy Dynamics 365 alkalmazás) szükséges, a prémium szintű összekötők használata nem szükséges. 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 nem menti a rendszer a kapcsolatomat az adatforrás környezeti változóihoz?

A kapcsolatok csak a felhasználói felület létrehozásához használhatók. Például a webhelyhez társított SharePoint listák barátságos nevének lekéréséhez. Adatforrás környezeti változójának szerkesztésekor ügyeljen arra, hogy olyan kapcsolatot válasszon, amely hozzáfér az adatforráshoz. Ha már nem fér hozzá a kapcsolathoz, manuálisan is megadhat egy értéket. Adja meg például egy lista SharePoint webhely URL-címét vagy egyedi azonosítóját (GUID).

Ha 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 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. Az Aktuális érték alatt válassza a... >Távolítsa el ezt a megoldást.

   

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

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

Lásd még

Adatforrás-környezeti változók használata vászonalapú alkalmazásokban
Környezeti változók használata Power Automate megoldásfelhő-folyamatokban
EnvironmentVariableDefinition table/entity reference
Web API-minták
Adatforrás környezeti változóinak használata vászonalapú alkalmazásokban
Környezeti változók használata Power Automate megoldás felhőfolyamataiban
Azure Key Vault titkosítások használata
Környezeti változók támogatása egyéni összekötőkben
Power Apps Blog: Előzetes verzióban elérhető környezeti változók!