Oversigt over miljøvariabler til Power Platform

  • Artikel

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. Dette er ofte problematisk. især når værdierne skal ændres i forbindelse med ALM-handlinger (Application Lifecycle Management). 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.

Bemærk

Nye funktioner til datakilder installeres lige nu og er muligvis ikke tilgængelige i dit område endnu.

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. F.eks. kan SharePoint Online-websteds- og listeparametre gemmes som miljøvariabler, så du kan oprette forbindelse til forskellige websteder og lister i forskellige miljøer uden at skulle ændre apps og flow.
  • 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 i den moderne løsningsgrænseflade, der oprettes automatisk, når der oprettes forbindelse til bestemte datakilder i lærredapps eller ved hjælp af kode. De kan også importeres til et miljø via løsninger. Når miljøvariablerne er til stede i et miljø, kan de bruges som input, når de opretter lærredapps, Power Automate-flows, når der udvikles plug-ins, og mange andre steder, f.eks. tilføjelse af et Power BI-dashboard til en modelbaseret app. Når disse objekttyper bruger miljøvariabler, afledte 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

  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 også vælge connector, en gyldig forbindelse til den valgte connector og parametertypen. Forbindelsen lagres dog ikke som en del af miljøvariablen. 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. I forbindelse med visse parametre, f.eks. SharePoint-lister, skal du også vælge en overordnet datakilde-miljøvariabel, f.eks. SharePoint-webstedet. Når de er gemt, relateres de til databasen.
      • 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. Når der findes en værdi, bruges den, 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.

      Ny miljøvariabel.

      Bemærk

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

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.

Fra og med en opdatering d. 7. december 2023 er alle miljøvariabelværdier synlige ved import af løsninger (eller når du bruger Pipelines til at udrulle). Miljøvariabler uden en standardværdi eller en værdi vil blive bedt om at levere en værdi, men dem uden er på forhånd udfyldt med en etiket under tekstområdet, der angiver værdiens kilde: løsningsværdi, målmiljøværdi eller standardværdi.

Miljøvariabelsynlighed under løsningsimport.

Bemærk

  • I nogle tilfælde kan der for specifikke datakilde miljøvariabelværdier vises en Adgang nægtet advarsel, hvis den importerende producent ikke har adgang til forbindelsen eller kilden, der bruges til miljøvariablen. Dette er en ikke-blokerende advarsel, men noget at være opmærksom på, afhængigt af hvordan du planlægger at bruge miljøvariablen i målmiljøet.
  • Du kan fjerne værdien fra løsningen, før du eksporterer løsningen. Derved sikres, at den eksisterende værdi forbliver i udviklingsmiljøet, 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. Dette er en påmindelse om at angive 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.
  • Hvis du vil bruge miljøvariabler med succes med SharePoint-lister, skal visningsnavn og det logiske navn for hver tilsvarende kolonne i kilde- og målmiljøet matche.
  • 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?

Nej. Selvom de er relateret, kræves der en forbindelse, som repræsenterer en legitimationsoplysning eller 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 ringer til connectoren, kræves der derfor både en gyldig forbindelse og nogle ekstra parametre.

Kan datakildemiljøvariabler bruges sammen med delte forbindelser, f.eks. SQL Server med SQL-godkendelse?

Generelt nej. I delte forbindelser til SQL Server lagres de parametre, der kræves for at oprette forbindelse til data i forbindelsen. Navnet på serveren og databasen er f.eks. angivet under oprettelse af forbindelsen og afledt af forbindelsen derfor altid.

Datakildemiljøvariabler bruges til forbindelser, der er afhængige af brugerbaseret godkendelse, f.eks. Microsoft Entra ID, fordi parametrene ikke kan udledes af forbindelsen. Godkendelse med SQL Server, som er en delt forbindelse, bruger derfor ikke datakilde-miljøvariabler.

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.

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 for Customer Engagement), 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ærredapps 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 120 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 tildeles der automatisk er en anden forbindelsesværdi end den, jeg ønsker, når jeg importerer?

I nogle tilfælde, hvor der er flere forbindelser tilgængelige for en enkelt (datakildetype) miljøvariabel, er der en standardimplementering, som gør det muligt at vælge den første forbindelse på listen over forbindelser, der er tilgængelige for miljøvariablen. 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.

    Fjerne værdien fra en miljøvariabel

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
Reference til EnvironmentVariableDefinition-tabel/-objekt
Web API-eksempler
Brug datakildemiljøvariabler i Lærredsapps
Bruge miljøvariabler i Power Automate-løsningens cloudflows
Brug Azure Key Vault-hemmeligheder
Miljøvariablen understøttes i brugerdefinerede connectorer
Power Apps-blog: Miljøvariabler findes i forhåndsversion!

Bemærk

Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)

Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).