Oversigt over miljøvariabler til Power Platform

Miljøvariabler aktiverer det grundlæggende ALM-scenario (Application Lifecycle Management) med at flytte et program mellem Power Platform-miljøer. I dette scenario forbliver programmet nøjagtigt det samme med undtagelse af nogle få eksterne nøgleprogramreferencer (f.eks. tabeller, forbindelser og nøgler), der er forskellige mellem kildemiljøet og destinationsmiljøet. I programmet kræves det, at strukturen af tabellerne eller forbindelserne er nøjagtig den samme mellem kilden og destinationsmiljøet, med visse forskelle. Du kan bruge miljøvariabler til at angive, hvilke af disse forskellige eksterne referencer der skal opdateres, når programmet flyttes på tværs af miljøer.

I miljøvariabler lagres parameternøglerne og -værdierne, som derefter fungerer som input til forskellige andre programobjekter. Hvis du adskiller parametrene fra de forbrugende objekter, kan du ændre værdierne i det samme miljø, eller når du overfører løsninger til andre miljøer. Alternativet lader de hard-coded parameterværdier være inden for de komponenter, der bruger dem. Denne fremgangsmåde er ofte problematisk, især når værdierne skal ændres i forbindelse med ALM-handlinger. Da miljøvariabler er løsningskomponenter, kan du transportere referencerne (nøglerne) og ændre værdierne, når løsninger overføres til andre miljøer.

Fordele ved at bruge miljøvariabler:

• Giv nye parameterværdier, mens du importerer løsninger til andre miljøer.
• Gem konfiguration for de datakilder, der bruges i lærredapps og flows. SharePoint-onlinewebsteds- og listeparametre kan f.eks. gemmes som miljøvariabler. Denne fremgangsmåde giver dig mulighed for at oprette forbindelse til forskellige websteder og lister i forskellige miljøer uden at skulle ændre apps og flows.
• Pak og transporter tilpasningerne og konfigurationen sammen, og administrer dem på ét sted.
• Pak og transporter hemmeligheder, f.eks. legitimationsoplysninger, der bruges af forskellige komponenter, separat fra de komponenter, der bruger dem.
• En miljøvariabel kan bruges på tværs af mange forskellige løsningskomponenter – uanset om de er den samme type komponent eller forskellige. En lærredapp og et flow kan f.eks. bruge den samme miljøvariabel. Når værdien af miljøvariablen skal ændres, skal du kun ændre én værdi.
• Og hvis du skal lade en datakilde gå på arbejde i produktionsmiljøer, kan du ganske opdatere miljøvariabelværdierne med oplysninger om den nye datakilde. Appsene og flowene kræver ikke ændringer og begynder at bruge den nye datakilde.
• Understøttes af SolutionPackager- og DevOps-værktøjer, der muliggør løbende integration og kontinuerlig levering (CI/CD).
• Miljøvariablerne kan pakkes ud og gemmes i kildekontrolelementet. Du kan også gemme forskellige filer med værdier for miljøvariabler for den separate konfiguration, der er nødvendig i forskellige miljøer. Løsningspakker kan derefter acceptere den fil, der svarer til det miljø, løsningen importeres til.

Hvordan fungerer miljøvariabler?

Miljøvariabler kan oprettes og ændres via den moderne løsningsgrænseflade. De kan også oprettes automatisk, når du opretter forbindelse til bestemte datakilder i lærredapps, eller med kode. De kan også importeres til et miljø via løsninger. Miljøvariabler kan bruges som input, når du opretter lærredapps, Power Automate-flow, plug-ins og føjer Power BI-dashboards til modelbaserede apps. Når du bruger miljøvariabler, afledes værdierne derefter fra miljøvariablerne og kan ændres, når løsninger importeres til andre miljøer.

Oprette en miljøvariabel i en løsning manuelt

1. Log på Power Apps (make.powerapps.com), og vælg Løsninger i venstre rude. Hvis elementet ikke findes i sidepanelruden, skal du vælge ...Flere og derefter vælge det ønskede element.
2. Åbn den ønskede løsning, eller opret en ny.
3. Vælg Ny>Mere og Miljøvariabel på kommandolinjen.
4. Udfyld følgende kolonner i ruden til højre, og vælg derefter Gem:

   • Vis navn. Angiv et navn for miljøvariablen.

   • Navn. Det entydige navn oprettes automatisk fra Vist navn, men du kan ændre det.

   • Datatype. Vælg mellem Decimaltal, Tekst, JSON, To indstillinger, Datakilde eller Hemmelighed.

     Bemærk

     • Hvis Datakilde er den valgte type, skal du vælge connectoren, en gyldig forbindelse til den valgte connector og parametertypen. Forbindelsen gemmes ikke som en del af miljøvariablen. Miljøvariablen gemmer oplysninger, der ikke er i forbindelsen, som er nødvendige for at oprette forbindelse mellem Power Apps og den rigtige server og tabel. Forbindelsen bruges kun til at hente tilgængelige parameterværdier, f.eks. de SharePoint-websteder, du har adgang til, eller de lister, der er knyttet til et websted.

     • Hvis Hemmelighed er den valgte type, er det nødvendigt med flere oplysninger, hvis du vil konfigurere Azure Key Vault for at tillade at Power Platform får adgang til hemmeligheden.

   • Current Value. Kaldes også værdien. Denne egenskab er valgfri og er en del af tabellen over værdier i miljøvariabler. En defineret værdi bruges, også selvom der også findes en standardværdi. Fjern værdien fra løsningen, hvis du ikke vil bruge den i det næste miljø. Værdierne er også adskilt i separate JSON-filer i den eksporterede solution.zip-fil og kan redigeres offline. Flere oplysninger: Hvordan fjerner jeg en værdi fra en miljøvariabel?

   • Standardværdi. Denne kolonne er en del af miljøvariablers definitionstabel og er ikke nødvendig. Standardværdien bruges, hvis der ikke er nogen aktuel værdi.

     Separation af standardværdi og aktuel værdi giver dig mulighed for at servicere definitionen og standardværdien separat fra værdien. En programudgiver kan f.eks. angive tilbuddet AppSource med en standardværdi. Kunden kan også angive en ny værdi. Når programudgiveren udgiver opdateringer til programmet, overskrives den værdi, der er angivet af kunden, ikke.

     

     Bemærk

     Der kan ikke findes en værdi uden en definition. Der kan kun oprettes én værdi pr. definition i grænsefladen.

Power Apps kan oprette miljøvariabler automatisk

På fanen Generelt i Power Apps-indstillingerne:

• Aktivér indstillingen Opret automatisk miljøvariabler, når datakilder tilføjes. Når du nu føjer en ny datakilde til din app, tilføjes der en miljøvariabel for dig.

  

Forskellige datakilder

Forskellige datakilder muliggør forskellige typer miljøvariabler.

Microsoft Dataverse

Power Apps opretter indbygget forbindelse til Dataverse. Du behøver ikke en miljøvariabel til tabeller i det aktuelle miljø. Når du opretter forbindelse til Dataverse, søger programmet automatisk efter nøjagtigt det samme tabelnavn i ethvert miljø, hvor du porterer det. Så længe tabelnavnestrukturen er den samme i destinationsmiljøet som i det oprindelige miljø, fungerer det.

Hvis du bruger en ekstern tabel fra et andet miljø (via Skift miljø), antager Power Apps, at du altid vil referere til nøjagtig den samme tabel. Du skal bruge en miljøvariabel, hvis du har brug for, at den eksterne tabel skal være en anden ekstern tabel, når du skifter fra udvikling til test eller til produktion. Det er nemmest at give Power Apps tilladelse til automatisk at oprette miljøvariablen for dig. (Hvis du tidligere har føjet tabellen til din app, skal du slå indstillingen til, ophæve den eksterne tabel og derefter tilføje den igen).

Når du føjer den eksterne tabel til appen, skal du vælge fanen Avanceret for at vælge miljøvariablen.

SharePoint

SharePoint understøtter kun Microsoft Entra-forbindelser. Så for SharePoint kræves der en separat miljøvariabel til Websted og Liste ud over en gyldig forbindelse.

Sådan kan du bruge miljøvariabler med SharePoint-lister:

• Det viste navn og det logiske navn for hver tilsvarende kolonne i kilde- og destinationsmiljøet skal stemme overens.
• Miljøvariabler for SharePoint skal have matchende metadata. SharePoint har interne id'er, der muligvis ikke stemmer overens mellem destinationsmiljøer. Hvis du f.eks. opretter en liste med samme navn og kolonner i et destinationsmiljø, stemmer de interne navne ikke overens. Metadataene matcher altid, hvis du dublerer et SharePoint websted og kopierer det til dit destinationsmiljø.

SQL Server

SQL Server understøtter mange forskellige typer godkendelse og forbindelser. Brug miljøvariabler til Microsoft Entra-forbindelser. Der kræves en separat miljøvariabel til serveren og databasen. Programmet er bundet til bestemte tabelnavne, så de antages at være de samme mellem miljøer.

Brug ikke miljøvariabler til delte forbindelser, f.eks. grundlæggende SQL-godkendelse med SQL Server. Brug forbindelsesreferencer til oplysninger, der traditionelt overføres som en del af forbindelsesstrengen. Grundlæggende SQL-godkendelsesparametre er alle en del af forbindelsesstrengen. Navnet på serveren og databasen er f.eks. angivet under oprettelse af forbindelsen og afledt af forbindelsen derfor altid.

Datakildemiljøvariabler bruges til connectorer med godkendelse som Microsoft Entra. I disse typer forbindelser har Power Apps kun en identificeret bruger. Power Apps kan ikke udlede, hvilken tjeneste eller tabel du vil arbejde med, ud fra forbindelsen.

Angive nye værdier under import af løsninger

Den moderne grænseflade til import af løsninger inkluderer muligheden for at angive værdier for miljøvariabler. Dette angiver værdiegenskaben i environmentvariablevalue-tabellen.

Miljøvariabelværdier er synlige, når du importerer løsninger, eller når du bruger pipelines til at udrulle. Miljøvariabler uden en standardværdi eller en værdi, der beder om en værdi, men som ellers er forhåndsudfyldt med et navn under tekstområdet, der angiver værdiens kilde: løsningsværdi, målmiljøværdi eller standardværdi.

Bemærk

• I visse tilfælde vises der muligvis en advarsel om adgang nægtet for bestemte datakildemiljøvariabelværdier, hvis den udvikler, der importerer, ikke har adgang til den forbindelse eller kilde, der bruges til miljøvariablen. Dette er en advarsel, der ikke blokerer, men noget, du skal være opmærksom på, afhængigt af hvordan du planlægger at bruge miljøvariablen i destinationsmiljøet.
• Du kan fjerne værdien fra løsningen, før du eksporterer løsningen. Derved sikres, at den eksisterende værdi forbliver i dit udviklingsmiljø, men ikke eksporteres til løsningen. Denne fremgangsmåde gør det muligt at angive en ny værdi, når løsningen importeres til andre miljøer. Flere oplysninger: Hvordan fjerner jeg en værdi fra en miljøvariabel?

Beskeder

Der vises en meddelelse, når der ikke er nogen værdier for miljøvariablerne. Angiv værdierne, så komponenter, der er afhængige af miljøvariabler, ikke mislykkes.

Sikkerhed

Tabellen environmentvariabledefinition er en bruger- eller teamejet. Når du opretter et program, der bruger miljøvariabler, skal du sørge for at tildele brugerne det rette rettighedsniveau til denne tabel. Tilladelsen til environmentvariablevalue-tabellen nedarves fra den overordnede environmentvariabledefinition-tabel og kræver derfor ikke separate rettigheder. Rettigheder til environmentvariabledefinition-tabeller er som standard inkluderet i sikkerhedsrollerne Miljøoprettelse og Grundlæggende bruger. Flere oplysninger: Sikkerhed i Dataverse.

Navngivning

Kontrollér, at navnene på miljøvariabler er entydige, så der kan refereres nøjagtigt til dem. Vis navne med duplikerede miljøvariabler gør det vanskeligt at skelne mellem miljøvariabler og bruge dem. Kontrollér, at navnene på miljøvariabler er entydige, så der kan refereres nøjagtigt til dem. Navnene på $authentication og $connection er særlige reserverede parametre for flow og skal være klar til brug. Lagring af flow blokeres, hvis der bruges miljøvariabler med disse navne. Hvis der bruges en miljøvariabel i et flow, og visningsnavn for miljøvariablen ændres, viser designeren både de gamle og nye visningsnavn-tokener for at hjælpe med identifikationen. Under opdatering af flowet anbefales det, at du fjerner referencen til miljøvariablen og tilføjer den igen.

Gældende begrænsninger

• Validering af værdier for miljøvariabler sker i brugergrænsefladen og i de komponenter, der bruger dem, men ikke i Dataverse. Sørg derfor for, at de korrekte værdier er angivet, hvis de ændres via kode.
• Power Platform Build Tools-opgaver er endnu ikke tilgængelige til administration datakildemiljøvariabler. Dette blokerer dog ikke brugen af dem i de Microsoft-angivne værktøjer og i kildekontrolsystemer.
• Interaktion med miljøvariabler via brugerdefineret kode kræver et API-opkald for at hente værdierne. Der er ikke en cache, der kan bruges af kode, som ikke er fra Microsoft.
• Miljøvariabler kan højst indeholde 2.000 tegn.

Ofte stillede spørgsmål

Hvorfor kan jeg ikke se værdien for min miljøvariabel?

Hvis miljøvariablen er i en administreret løsning, vil du ikke kunne se værdien, medmindre du ser inde i Standardløsningen. Denne adfærd er designet, da miljøvariabelværdien er en ikke-administreret tilpasning.

Hvordan kan jeg få vist, hvor miljøvariabler bruges?

Enten via valg af Vis afhængigheder i løsningsgrænsefladen, mens du skriver komponenter, eller i kildekontrolelementet og i løsningsfilen ved at få vist appen eller flow-metadata.

Er datakilde miljøvariabler det samme som forbindelser?

Antal Selvom de er relateret, kræves der en forbindelse, som repræsenterer legitimationsoplysninger eller en godkendelse, for at kunne arbejde med connectoren. Datakildemiljøvariabler lagres parametre, der kræves af en eller flere handlinger i forbindelsen, og disse parametre varierer ofte, afhængigt af handlingen. F.eks. gemmer en SharePoint Online-forbindelsen ikke oplysninger om websteder, lister eller dokumentbiblioteker. Når du kalder connectoren, kræves der derfor både en gyldig forbindelse og nogle ekstra parametre.

Kan min automatiserede ALM-pipeline bruge forskellige værdifiler til forskellige miljøer?

Ja. Løsningspakker accepterer filnavnet som inputparametre, så pipelinen kan pakke en anden værdifil i løsningen, afhængigt af den miljøtype den køres imod.

Skal jeg inkludere værdien i min løsning?

Nej. Miljøvariabler er beregnet til brug af programmer, der skal have forskellige værdier i forskellige miljøer, hvor løsningen er installeret. Definitioner af miljøvariabler skal inkluderes i løsningen, men værdierne skal angives for destinationsmiljøet under udrulningen. Denne funktionsmåde medfører, at definitionen af miljøvariablen er et administreret løsningsobjekt i destinationsmiljøet, mens miljøvariablen er en ikke-administreret post.

Hvorfor kan jeg ikke slette en værdi i mit miljø?

Hvis værdien er inkluderet i en administreret løsning, kan du kun slette værdien ved at opdatere løsningen i kildemiljøet for at udelukke værdien og derefter eksportere en ny version af løsningen. Denne nye version kan derefter importeres til miljøet ved hjælp af en opgraderingshandling (ikke en opdatering), hvilket medfører, at værdiposten slettes.

Hvad skal jeg gøre, hvis en person ved en fejl sletter en værdi?

Hvis afhængighedssystemet ikke allerede fungerer som afhængighedssystem, bruges den sidste kendte værdi som reserve under kørsel.

Hvornår bruges den nye værdi i lærredapps og i cloudflows, hvis værdien ændres?

Det kan tage op til en time at udgive opdaterede miljøvariabler fuldt ud, fordi værdien skubbes ind i apps og flyder asynkront.

Kræves der premiumlicenser?

Nej. Selvom ALM kræver Dataverse (eller Dynamics 365-apps), er det ikke nødvendigt at bruge premium-connectorer. Problemet er, at du bruger Dataverse-connectoren til at kommunikere med miljøvariabler på samme måde som med andre dataposter, f.eks. konti eller kontakter. Tidligere var det den eneste måde at bruge miljøvariabler på i lærredsapps og flows.

Er der en grænse for, hvor mange miljøvariabler, jeg kan have?

Nej. Den maksimale størrelse på en løsning er dog 95 MB. Flere oplysninger: Oprette en løsning

Kan viste navne og beskrivelser i miljøvariabler være oversatte?

Ja.

Skal jeg bruge miljøvariabler i stedet for at gemme konfigurationsdata i brugerdefinerede tabeller?

Ja, hvis konfigurationsdataene ikke er relationsbestemte. Miljøvariabler skal bruges til nøgle: værdipar, og når værdien sandsynligvis skal ændres i andre miljøer. Andre værktøjer, f.eks. værktøjet til konfigurationsoverførsel, er bedre egnede til overførsel af relationskonfigurationsdata, der er lagret i brugerdefinerede tabeller. I modsætning til andre konfigurationsdata overføres miljøvariabler i løsninger og er derfor meget mere simple at administrere og mere effektive til at importere.

Hvorfor gemmes min forbindelse ikke for datakildemiljøvariabler?

Forbindelser bruges kun til at oprette brugergrænsefladen. Du kan f.eks. hente brugervenlige navne til SharePoint-lister, der er knyttet til et websted. Når du redigerer en datakildemiljøvariabel, skal du sørge for at vælge en forbindelse med adgang til datakilden. Hvis du ikke længere har adgang til forbindelsen, kan du angive en værdi manuelt. Du kan f.eks. indtaste webstedets SharePoint-URL-adresse eller entydige id (GUID) for en liste.

Når der er flere tilgængelige forbindelser for en enkelt miljøvariabel (datakildetype), er der en indbygget implementering for at vælge den første forbindelse på listen over forbindelser. Da der som regel kun er én forbindelse knyttet til en miljøvariabel, er det ikke noget, der som regel skal valideres. Og med de seneste ændringer af synligheden af værdier for miljøvariabler er det nemmere at validere dem ved importen.

Hvordan fjerner jeg en værdi fra en miljøvariabel?

Du kan fjerne værdien af værdien i en miljøvariabel fra løsningen, før du eksporterer løsningen. Derefter forbliver den eksisterende værdi i udviklingsmiljøet, men den eksporteres ikke i løsningen. Denne fremgangsmåde gør det muligt at angive en ny værdi, når løsningen importeres til et andet miljø.

Benyt følgende fremgangsmåde for at fjerne værdien:

1. Vælg den miljøvariabel, der skal vises egenskaber for, i den løsning, hvor miljøvariablen er placeret.

2. Vælg ...>Fjern fra denne løsning under Aktuel værdi.

   

Kan jeg bruge miljøvariabler i brugerdefinerede connectorer?

Ja. Miljøvariablen understøttes i brugerdefinerede connectorer

Se også

Brug datakildemiljøvariabler i lærredapps
Bruge miljøvariabler i Power Automate-løsningens cloudflows
EnvironmentVariableDefinition-tabel-/objektreference
Web API-eksempler
Bruge datakildemiljøvariabler i lærredapps
Bruge miljøvariabler i Power Automate-løsningens cloudflow
Bruge Azure Key Vault-hemmeligheder
Understøttelse af miljøvariabler i brugerdefinerede connectorer
Power Apps Blog: Miljøvariabler tilgængelige i forhåndsvisning!