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 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. Az online webhely és lista paraméterei például SharePoint 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.
• Ezenkívül, ha éles környezetben ki kell vonnia egy adatforrást, 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á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, folyamatok, Power Automate beépülő modulok létrehozásakor, valamint irányítópultok modellvezérelt alkalmazásokhoz való hozzáadásakor Power BI . 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 (make.powerapps.com) webhelyre Power Apps , majd a bal oldali panelen válassza a Megoldások lehetőséget. Ha az elem nem az oldalsó panel ablaktábláján található, válassza a ... Továbbiak elemre, 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.

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

     Feljegyzé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ó olyan információkat tárol, amelyek nem a megfelelő kiszolgálóhoz és táblához való csatlakozáshoz Power Apps szükséges kapcsolatban vannak. 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).

     • Ha a Titkos kulcs 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 Power Platform a titkos kulcs eléréséhez.

   • 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. 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.

     

     Feljegyzé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 beállítások Általános lapján Power Apps :

• 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 Dataverse csatlakozik. Az aktuális környezetben lévő táblákhoz nincs szükség környezeti változóra. Amikor csatlakozik Dataverse, az alkalmazás automatikusan pontosan ugyanazt a táblanevet keresi minden olyan környezetben, amelyben portolja. 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 Környezet módosítása funkción keresztül), akkor Power Apps feltételezze, hogy mindig pontosan ugyanarra a táblára szeretne hivatkozni. Szüksége van egy környezeti változóra, 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 prod-ra vált. A legegyszerűbb, ha engedélyezi Power Apps a környezeti változó automatikus létrehozásá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 a kapcsolatokat támogatja. SharePointTehát az érvényes kapcsolat mellett külön környezeti változóra van szükség a Webhely és a Lista számára.

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

• A forrás- és célkörnyezet minden egyes megfelelő oszlopa megjelenítendő nevének és logikai nevének egyeznie kell.
• A környezeti változóinak SharePoint egyező metaadatokkal kell rendelkezniük. SharePoint olyan belső azonosítókkal rendelkezik, amelyek esetleg nem 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 egyeznek, ha duplikál egy SharePoint webhelyet, és átmásolja a célkörnyezetbe.

SQL-kiszolgáló

Az SQL Server számos különböző típusú hitelesítést és kapcsolatot támogat. Környezeti változók használata a kapcsolatokhoz Microsoft Entra . 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. Használjon kapcsolathivatkozásokat olyan információkhoz, amelyek hagyományosan a kapcsolati sztring részeként vannak átadva. Az alapszintű SQL-hitelesítési paraméterek mind a kapcsolati sztring részét képezik. 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 például Microsoft Entra. Az ilyen típusú kapcsolatokban csak azonosított felhasználóval Power Apps rendelkezik. Power Apps nem származtathatja a kapcsolatból, hogy milyen szolgáltatással vagy táblával kíván dolgozni.

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

A környezeti változók értékei megoldások importálásakor vagy folyamatok üzembe helyezésekor 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.

Feljegyzé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ági

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. 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ő 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 A 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 nem felügyelt 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 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 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 Dataverse ALM megköveteli (vagy Dynamics 365 alkalmazások), a prémium ö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ók az Megoldás létrehozása részben találhatók.

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 egy webhelyhez társított listák rövid nevének lekéréséhez SharePoint . 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 SharePoint lista webhelyének 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

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ábla-/entitásreferencia
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
Azure Key Vault titkos kulcsok
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 a környezeti változók!