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.

Feljegyzé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:

• Ú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. 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 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 létrehozhatók és módosíthatók a modern megoldási felületen, automatikusan létrehozhatók, amikor bizonyos adatforrásokhoz csatlakoznak a vászonalapú alkalmazásokban, 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 (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év, 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 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 is. 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 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. 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í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.

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

Feljegyzé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í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. 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

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ára vonatkozó environmentvariablevalue engedély a szülő environmentvariabledefinition táblától ö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örnyezetfejlesztő é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ő 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.
• Power Platform A Build Tools feladatok 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?

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

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ás 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 szerepel egy felügyelt megoldás, 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 adatforrás környezeti változókhoz?

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ó szerkesztésekor ügyeljen arra, hogy olyan kapcsolatot válasszon, amely hozzáféréssel rendelkezik a adatforrás. 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: A előzetes verzió-ben elérhető környezeti változók!