Översikt över miljövariabler för Power Platform

Miljövariabler möjliggör det grundläggande scenariot för hantering av appens livscykel (ALM) för att flytta en applikation mellan Power Platform-miljöer. I det här scenariot förblir programmet exakt samma förutom några viktiga externa programreferenser (t.ex. tabeller, anslutningar och nycklar) som skiljer sig mellan källmiljön och målmiljön. Programmet kräver att tabellerna och anslutningarna är exakt samma struktur mellan käll- och målmiljöerna, med vissa skillnader. Med miljövariabler kan du ange vilka av dessa olika externa referenser som ska uppdateras när programmet flyttas över miljöer.

Miljövariabler lagrar parameternycklarna och värdena som sedan används som indata för olika andra programobjekt. Genom att separera parametrarna från de tidskrävande objekten kan du ändra värdena i samma miljö eller när du migrerar lösningar till andra miljöer. Alternativet är att lämna hårdkodade parametervärden i de komponenter som använder dem. Detta är ofta ett problem som ofta uppstår särskilt när värdena måste ändras under ALM-åtgärder. Eftersom miljövariabler är lösningskomponenter kan du transportera referenserna (nycklarna) och ändra värdena när lösningar migreras till andra miljöer.

Anteckning

Nya funktioner för datakällor har just nu distribuerats och kanske inte är tillgängliga i din region ännu.

Fördelar med att använda miljövariabler:

• Tillhandahåll nya parametervärden medan du importerar lösningar till andra miljöer.
• Lagra konfiguration för datakällor som används i arbetsyteappar och flöden. Exempelvis kan SharePoint Online-webbplatser och listparametrar lagras som miljövariabler, vilket gör att du kan ansluta till olika platser och listor i olika miljöer utan att behöva ändra apparna och flödena.
• Paketera och transportera dina anpassningar och konfigurationer tillsammans och hantera dem på en enda plats.
• Paketera och transportera hemligheter, till exempel autentiseringsuppgifter som används av olika komponenter, separat från de komponenter som använder dem.
• En miljövariabel kan användas för många olika lösningskomponenter, oavsett om de är samma typ av komponent eller olika. Exempelvis kan samma miljövariabel användas för en arbetsyteapp och ett flöde. När värdet för miljövariabeln behöver ändras behöver du bara ändra ett värde.
• Om du behöver dra tillbaka en datakälla i produktionsmiljöer kan du uppdatera miljövariabelvärdena med information för den nya datakälla. Program och flöden behöver inte ändras och kommer att börja använda den nya datakällan.
• Verktygen stöds av SolutionPackager och DevOps och möjliggör löpande integrering och kontinuerlig leverans (CI/CD).
• Miljövariablerna kan packas upp och lagras i källkontrollen. Du kan också lagra filer med olika miljövariabler för den separata konfiguration som behövs i olika miljöer. Solution Packager kan sedan godkänna filen som motsvarar den miljö lösningen importeras till.

Hur fungerar miljövariabler?

Miljövariabler kan skapas och ändras i det moderna lösningsgränssnittet, skapas automatiskt när du ansluter till vissa datakällor i appar, eller med hjälp av kod. De kan också importeras till en miljö via lösningar. När det finns miljövariabler i en miljö kan de användas som indata när du redigerar arbetsyteappar, Power Automate-flöden, när plugin-program utvecklas och många andra platser, till exempel när du lägger till en Power BI instrumentpanel till en modellbaserad app. När miljövariabler används för dessa typer av objekt härleds värdena sedan från miljövariablerna, och kan ändras när lösningar importeras till andra miljöer.

Skapa en miljövariabel i en lösning

1. Logga in på Power Apps (make.powerapps.com) och välj sedan Lösningar i det vänstra fönstret. Om objektet inte finns i sidopanelsfönstret väljer du ... Mer och markerar sedan det objekt du vill använda.
2. Öppna den lösning du vill använda eller skapa en ny.
3. I kommandofältet väljer du Ny > Mer och väljer sedan Miljövariabel.
4. Fyll i följande kolumner i den högra rutan och välj sedan Spara:

   • Visningsnamn. Ange ett namn för miljövariabeln.

   • Namn. Det unika namnet genereras automatiskt från visningsnamn, men du kan ändra det.

   • Datatyp. Välj bland Decimaltal, Text, JSON, Twå alternativ, Datakälla och Hemlighet.

     Anteckning

     • Om Datakälla är den valda typen måste du även välja anslutningsprogram, en giltig anslutning för den valda anslutningen, samt parametertyp. Anslutningen lagras emellertid inte som en del av miljövariabeln. Anslutningen används endast för att hämta tillgängliga parametervärden såsom de SharePoint-webbplatser du har åtkomst till eller listorna som är associerade med en webbplats. För vissa parametrar såsom SharePoint-listor måste du även välja en miljövariabel för överordnad datakälla, till exempel SharePoint-webbplatsen. När dessa har sparats kopplas de till databasen.
     • Om Hemlighet är vald typ krävs ytterligare information för att konfigurera Azure Key Vault för att ge Power Platform åtkomst till hemligheten.

   • Current Value. Kallas även för värdet. Den här egenskapen är valfri och är en del av miljövariabelns värdetabell. När ett värde finns används det även om det finns ett standardvärde. Avlägsna värdet från din lösning om du inte vill använda det i nästa miljö. Värdena är också separerade i separata JSON-filer i den exporterade filen solution.zip och kan redigeras offline. Mer information: Hur tar jag bort ett värde från en miljövariabel?

   • Standardvärde. Den här kolumnen ingår i definitionstabellen för miljövariabler och är inte obligatorisk. Standardvärdet används om det inte finns något aktuellt värde.

     Genom att separera standardvärdet och det aktuella värdet kan du hantera definitionen och standardvärdet separat från värdet. En programutgivare kan till exempel ange erbjudanden på AppSource med ett standardvärde. Sedan kan kunden erbjuda ett nytt värde. När programutgivaren publicerar uppdateringar för programmet skrivs inte värdet som har angetts av kunden över.

     

     Anteckning

     Ett värde kan inte existera utan definition. Gränssnittet tillåter endast att ett värde per definition skapas.

Ange nya värden när du importerar lösningar

Importgränssnittet i den moderna lösningen innehåller funktioner för att ange värden för miljövariabler. Detta anger värdeegenskapen i environmentvariablevalue tabellen.

Från och med en uppdatering den 7 december 2023 är alla miljövariabelvärden synliga vid import av lösningar (eller när du använder Pipelines för att distribuera). Miljövariabler utan ett standardvärde eller ett standardvärde kommer att tillfrågas om ett värde, men de i övrigt är förifyllda med en etikett under textområdet som anger värdets källa: lösningsvärde, målmiljövärde eller standardvärde.

Anteckning

• I vissa fall, för specifika datakälla miljövariabelvärden, kan en åtkomst nekad-varning visas om den importerande tillverkaren inte har tillgång till anslutningen eller källan som används för miljövariabeln. Detta är en icke-blockerande varning, men något att notera beroende på hur du planerar att använda miljövariabeln i målmiljön.
• Du kan ta bort värdet från lösningen innan du exporterar lösningen. På så sätt finns det befintliga värdet kvar i utvecklingsmiljön, men exporteras inte i lösningen. Den här metoden gör det möjligt att tillhandahålla ett nytt värde när lösningen importeras till andra miljöer. Mer information: Hur tar jag bort ett värde från en miljövariabel?

Aviseringar

En avisering visas när miljövariablerna saknar värden. Det här är en påminnelse om att ange värden så att komponenter som är beroende av miljövariabler inte misslyckas.

Säkerhet

Tabellen environmentvariabledefinition är användar- eller teamägd. När du skapar ett program som använder miljövariabler måste du tilldela användarna rätt behörighetsnivå till den här tabellen. Behörighet till tabellen environmentvariablevalue ärvs från den överordnade environmentvariabledefinition tabellen och kräver därför inga separata privilegier. Privilegier för environmentvariabledefinition-tabeller ingår som standard i säkerhetsrollerna Miljöskapare och Grundläggande användare. Mer information: Säkerhet i Dataverse.

Namngivning

Se till att miljövariabelnamnen är unika så att de kan refereras till korrekt. Dublicering av visningsnamn för miljövariabler gör det svårt att åtskilja och använda miljövariabler. Se till att miljövariabelnamnen är unika så att de kan refereras till korrekt. Namnen $authentication och $connection är särskilt reserverade parametrar för flöden och bör undvikas. Flödes-sparandet blockeras om miljövariabler med dessa namn används. Om en miljövariabel används i ett flöde och visningsnamnet för miljövariabeln ändras, visas både gamla och nya visningsnamn som hjälp vid identifiering. När du uppdaterar flödet bör du ta bort referensen till miljövariabeln och sedan lägga till den igen.

Aktuella begränsningar

• Validering av värden för miljövariabler sker i användargränssnittet och i de komponenter som använder dem, men inte i Dataverse. Se därför till att rätt värden anges om de ändras via kod.
• Power Platform Build Tools uppgifter är ännu inte tillgängliga för datakälla för miljövariabler. Detta blockerar emellertid inte deras användning inom verktyg som tillhandahålls av Microsoft och i källkontrollsystem.
• Att interagera med miljövariabler via anpassad kod kräver ett API-anrop för att hämta värdena. Det finns inte ett cacheminne som är synligt för koden som inte är från Microsoft att använda.
• För att framgångsrikt använda miljövariabler med SharePoint-listor, visningsnamn och det logiska namnet för varje motsvarande kolumn i käll- och målmiljön måste matcha.
• Miljövariabler får ha högst 2 000 tecken.

Vanliga frågor och svar

Varför kan jag inte se värdet för min miljövariabel?

Om miljövariabeln finns i en hanterad lösning kommer du inte att kunna se värdet om du inte tittar inuti Standardlösningen. Detta beteende är designat eftersom miljövariabelns värde är en ohanterad anpassning.

Hur visar jag var miljövariabler används?

Antingen genom att välja Visa beroenden i lösningsgränssnittet, medan du skapar komponenter, eller i källkontroll och i lösningsfilen genom att visa appen eller flödesmetadata.

Är datakälla miljövariabler samma som anslutningar?

Nej Fastän de är relaterade representerar en anslutning en merit eller autentisering som krävs för att interagera med anslutningsprogrammet. Datakälla miljövariabler lagrar parametrar som krävs av en eller flera åtgärder i kontakten och dessa parametrar varierar ofta beroende på åtgärden. En SharePoint Online-anslutning lagrar till exempel ingen information om webbplatser, listor eller dokumentbibliotek. Därför kräver anrop till anslutningen både en giltig anslutning och några ytterligare parametrar.

Kan datakälla miljövariabler användas med delade anslutningar, till exempel SQL Server med SQL-autentisering?

Vanligtvis nej. Delade anslutningar med SQL Server lagrar de parametrar som krävs för att ansluta till data i anslutningen. Exempelvis anges namnet på Server och Databas när anslutningen skapas och skapas därför alltid från anslutningen.

Datakälla miljövariabler används för anslutningar som är beroende av användarbaserad autentisering, till exempel Microsoft Entra ID för att parametrarna inte kan härleds från anslutningen. Av den anledningen används inte autentisering med SQL Server, som är en delad anslutning, datakälla av miljövariabler.

Kan min automatiska ALM-pipeline använda olika värdefiler för olika miljöer?

Ja. Lösningsförpackaren accepterar filnamn som indataparametrar så att pipelinen kan packa en fil med olika värden i lösningen beroende på vilken miljötyp den körs mot.

Tänk om någon oavsiktligt tar bort ett värde?

Om det inte redan har förhindrats av beroendesystemet används det senaste kända värdet som en återställning under körning.

När används det nya värdet i arbetsyteappar och molnflöden om ett värde ändras?

Det kan ta upp till en timme att fullständigt publicera uppdaterade miljövariabler eftersom värdet skjuts in i apparna och flödar asynkront.

Krävs förstklassiga licenser?

Nej Medan ALM krävs Dataverse (eller Dynamics 365 för Customer Engagement), användning av premiumkontakter krävs inte. Den enda frågan är om du använder Dataverse kopplingen för att interagera med miljövariabler på samma sätt som med andra dataposter som konton eller kontakter. Tidigare var detta det enda sättet att använda miljövariabler i appar och flöden.

Finns det en gräns för antalet miljövariabler jag kan ha?

Nej Maxstorleken för en lösning är dock 95 MB. Mer information: Skapa en lösning

Kan visningsnamn och beskrivningar för miljövariabler lokaliseras?

Ja.

Ska jag använda miljövariabler i stället för att lagra konfigurationsdata i anpassade tabeller?

Ja om dina konfigurationsdata inte är relationsdata. Miljövariabler ska användas för nyckel: värdepar och när värdet troligen behöver skiljer sig i andra miljöer. Andra verktyg, till exempel verktyget Konfigurationsmigrering, passar bättre för migrering av relationskonfigurationsdata som lagras i anpassade tabeller. Till skillnad från andra konfigurationsdata migreras miljövariabler inom lösningar, vilket gör det mycket enklare att hantera och importera effektivare.

Varför tilldelas ett annat anslutningsvärde än det jag vill automatiskt när jag importerar?

I vissa fall där det finns flera anslutningar tillgängliga för en enskild miljövariabel av typen (datakälla), finns det en avsiktlig implementering för att välja den första anslutningen i listan över tillgängliga anslutningar för miljövariabeln. Eftersom det vanligtvis bara finns en anslutning som är associerad med en miljövariabel, är detta inget som vanligtvis måste verifieras. Med de senaste ändringarna av synligheten för miljövariabler är det lättare att verifiera vid import.

Hur tar jag bort ett värde från en miljövariabel?

Du kanske vill ta bort värdet för en miljövariabel från lösningen innan du exporterar lösningen. På så sätt finns det befintliga värdet kvar i utvecklingsmiljön, men exporteras inte i lösningen. Den här metoden gör det möjligt att tillhandahålla ett nytt värde när lösningen importeras till en annan miljö.

För att ta bort värdet, följ stegen nedan.

1. I lösningen där miljövariabeln finns väljer du den miljövariabel som ska visa egenskaperna.

2. Under Aktuellt värde, välj …   > Ta bort från den här lösningen.

   

Kan jag använda lösningsanpassade i anslutningsprogram?

Ja. Stöd för miljövariabel i anpassade kontakter

Se även

Använda datakälla miljövariabler i appar
Använda miljövariabler i Power Automate-lösningens molnflöden
EnvironmentVariableDefinition table/entity referens
Webb-API-exempel
Använda datakälla miljövariabler i arbetsyteappar
Använda miljövariabler i Power Automate-lösningens molnflöden
Använd hemligheter för Azure Key Vault
Stöd för miljövariabel i anpassade kontakter
Power Apps Blogg: Tillgängliga miljövariabler i förhandsversionen!

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).