Oversikt over miljøvariabler for Power Platform

Miljøvariabler muliggjør det grunnleggende scenarioet for administrasjon av applivssyklus (ALM) for flytting av en app mellom Power Platform-miljøer. I dette scenarioet forblir appen nøyaktig den samme bortsett fra noen få viktige eksterne appreferanser (for eksempel tabeller, tilkoblinger og nøkler) som er forskjellige mellom kildemiljøet og målmiljøet. Appen krever at strukturen på tabellene eller tilkoblingene er nøyaktig den samme mellom kilde- og målmiljøene, med noen forskjeller. Med miljøvariabler kan du angi hvilke av disse forskjellige eksterne referansene som skal oppdateres etter hvert som programmet flyttes på tvers av miljøer.

Miljøvariabler lagrer parameternøklene og verdiene, som deretter fungerer som inndata til forskjellige andre programobjekter. Hvis du skiller parameterne fra forbrukerobjektene, kan du endre verdiene i det samme miljøet eller når du overfører løsninger til andre miljøer. Alternativet er å la hardkodede parameterverdier være igjen i komponentene som bruker dem. Dette er ofte problematisk, spesielt når verdiene må endres under ALM-operasjoner. Siden miljøvariabler er løsningskomponenter kan du transportere referansene (nøklene) og endre verdiene når løsninger overføres til andre miljøer.

Obs!

Nye funksjoner for datakilder blir akkurat nå distribuert og er kanskje ikke tilgjengelig ennå i ditt område.

Fordeler ved å bruke miljøvariabler:

• Angi nye parameterverdier når du importerer løsninger til andre miljøer.
• Lagre konfigurasjon for datakildene som brukes i lerretsapper og flyter. SharePoint Online-området og listeparamenere kan eksempelvis lagres som miljøvariabler, og dermed kan du koble til ulike steder og lister i forskjellige miljøer uten å måtte endre appene og flytene.
• Pakk og transporter tilpasningen og konfigurasjonen sammen, og administrer dem på ett enkelt sted.
• Pakke og transporter hemmeligheter, for eksempel legitimasjoner som brukes av forskjellige komponenter, atskilt fra komponentene som bruker dem.
• Én miljøvariabel kan brukes på tvers av mange forskjellige løsningskomponenter – enten de er samme komponenttype eller forskjellige. En lerretsapp og en flyt kan for eksempel bruke samme miljøvariabel. Når verdien for miljøvariabelen må endres, trenger du bare å endre én verdi.
• Hvis du i tillegg trenger å trekke tilbake en datakilde i produksjonsmiljøer, kan du oppdatere verdiene for miljøvariabelen med informasjon for den nye datakilden. Appene og flytene krever ikke endringer og begynner å bruke den nye datakilden.
• Verktøy støttes av SolutionPackager og DevOps og muliggjør kontinuerlig integrasjon og kontinuerlig levering (CI/CD).
• Miljøvariablene kan pakkes ut og lagres i kildekontrollen. Du kan også lagre forskjellige verdifiler for miljøvariabler for den separate konfigurasjonen som kreves i forskjellige miljøer. Løsningspakkeren kan deretter godta filen som svarer til miljøet løsningen blir importert til.

Hvordan fungerer miljøvariabler?

Miljøvariabler kan opprettes og endres i det moderne løsningsgrensesnittet, og opprettes automatisk ved tilkobling til bestemte datakilder i lerretsapper eller ved hjelp av kode. De kan også importeres til et miljø via løsninger. Når det finnes miljøvariabler i et miljø, kan de brukes som inndata når du redigerer lerretsapper, Power Automate-flyter, ved utvikling av programtillegg og mange andre steder, for eksempel ved tilføying av et Power BI-instrumentbord i en modelldrevet app. Når disse objekttypene bruker miljøvariabler, avledes verdiene deretter fra miljøvariablene og kan endres når løsninger importeres til andre miljøer.

Opprett en miljøvariabel i en løsning

1. Logg deg på Power Apps (make.powerapps.com) og velg Løsninger i den venstre ruten. Hvis elementet ikke finnes i sideruten, velger du ...Mer og deretter elementet du vil ha.
2. Åpne løsningen du ønsker, eller opprett en ny.
3. Velg Ny > Mer på kommandolinjen, og velg deretter Miljøvariabel.
4. Fyll ut følgende kolonner i ruten til høyre, og velg deretter Lagre:

   • Visningsnavn. Angi et navn for miljøvariabelen.

   • Name. Det unike navnet genereres automatisk fra Visningsnavn, men du kan endre det.

   • Datatype. Velg blant desimaltall, tekst, JSON, to alternativer, datakilde eller hemmelighet.

     Obs!

     • Hvis Datakilde er den valgte typen, må du også velge tilkobling, en gyldig tilkobling for den valgte tilkoblingen, og parametertype. Tilkoblingen lagres imidlertid ikke som en del av miljøvariabelen. Tilkoblingen brukes bare til å hente tilgjengelige parameterverdier, for eksempel SharePoint-områdene du har tilgang til, eller listene som er tilknyttet et område. For visse parametere, for eksempel SharePoint-lister, må du også velge en overordnet datakilde, for eksempel SharePoint-området. Når disse er lagret, relateres de i databasen.
     • Hvis Hemmelig er den valgte typen, kreves ytterligere informasjon for å konfigurere Azure Key Vault for å gi Power Platform tilgang til hemmeligheten.

   • Current Value. Kalles også verdien. Denne egenskapen er valgfri og en del av tabellen for miljøvariabelverdi. Når en verdi finnes, blir den brukt, selv om det også finnes en standardverdi. Fjern verdien fra løsningen hvis du ikke vil bruke den i det neste miljøet. Verdiene er også delt opp i separate JSON-filer i den eksporterte .zip-filen for løsning og kan redigeres i frakoblet modus. Mer informasjon: Hvordan fjerner jeg en verdi fra en miljøvariabel?

   • Standardverdi. Denne kolonnen er en del av definisjonstabellen for miljøvariabelen og er ikke nødvendig. Standardverdien brukes hvis det ikke er noen gjeldende verdi.

     Atskillelse av standardverdi og gjeldende verdi gjør det mulig å vedlikeholde definisjonen og standardverdien atskilt fra verdien. En programutgiver kan for eksempel vise tilbudene på AppSource med en standardverdi. Eventuelt kan kunden oppgi en ny verdi. Når programutgiveren publiserer oppdateringer til programmet, blir ikke verdien som er angitt av kunden, overskrevet.

     

     Obs!

     En verdi kan ikke eksistere uten en definisjon. Grensesnittet tillater bare opprettelse av én verdi per definisjon.

Angi nye verdier under import av løsninger

Grensesnittet for import av moderne løsninger inkluderer muligheten til å angi verdier for miljøvariabler. Dette angir verdiegenskapen for environmentvariablevalue-tabellen.

Fra og med en oppdatering 7. desember 2023 vises alle miljøvariabelverdier ved import av løsninger (eller når du bruker pipeliner til distribusjon). Når miljøvariabler er uten en standardverdi eller verdi, blir du bedt om å angi en verdi, men ellers blir de forhåndsutfylt med en etikett nedenfor tekstområdet som angir verdiens kilde: løsningsverdi, målmiljøverdi eller standardverdi.

Obs!

• Når det gjelder spesifikke verdier for miljøvariabler for datakilder, kan det i enkelte tilfeller vises en advarsel om Ingen tilgang hvis den importerende utvikleren ikke har tilgang til tilkoblingen eller kilden som bruks for miljøvariabelen. Dette er en ikke-blokkerende advarsel, men noe å du bør merke deg, avhengig av hvordan du planlegger å bruke miljøvariabelen i målmiljøet.
• Du kan fjerne verdien fra løsningen før du eksporterer løsningen. Dette sikrer at den eksisterende verdien blir værende i utviklingsmiljøet, men at den ikke eksporteres i løsningen. Med denne metoden kan du oppgi en ny verdi når du importerer løsningen til andre miljøer. Mer informasjon: Hvordan fjerner jeg en verdi fra en miljøvariabel?

Varsler

Et varsel vises når miljøvariablene ikke har noen verdier. Dette er en påminnelse om å angi verdiene slik at komponenter som er avhengige av miljøvariabler, ikke mislykkes.

Sikkerhet

Tabellen environmentvariabledefinition er bruker- eller teameid. Når du oppretter en app som bruker miljøvariabler, må du tilordne brukerne riktig rettighetsnivå til denne tabellen. Tillatelsen til environmentvariablevalue-tabellen arves fra den overordnede tabellen environmentvariabledefinition og krever derfor ikke separate rettigheter. Rettigheter for tabellene environmentvariabledefinition er inkludert i sikkerhetsrollene Miljøoppretter og Basic-bruker som standard. Mer informasjon: Sikkerhet i Dataverse.

Navngiving

Kontroller at navn på miljøvariabler er unike, slik at de kan refereres nøyaktig. Visningsnavn for duplikate miljøvariabler gjør det vanskelig å skille mellom og bruke miljøvariabler. Kontroller at navn på miljøvariabler er unike, slik at de kan refereres nøyaktig. Navnene $authentication og $connection er spesielt reserverte parametere for flyter og bør unngås. Lagring av flyter blokkeres hvis miljøvariabler med disse navnene brukes. Hvis en miljøvariabel brukes i en flyt og visningsnavnet for miljøvariabelen endres, viser utformingen både gamle og nye visningsnavntokener som hjelp til identifisering. Når du oppdaterer flyten, anbefaler vi at du fjerner referansen for miljøvariabelen og legger den til på nytt.

Gjeldende begrensninger

• Validering av miljøvariabelverdier skjer i brukergrensesnittene og i komponentene som bruker dem, men ikke i Dataverse. Kontroller derfor at riktige verdier angis hvis de endres via kode.
• Power Platform Build Tools-oppgaver er ennå ikke tilgjengelige for administrasjon av datakildemiljøvariabler. Dette blokkerer imidlertid ikke bruken i Microsoft-verktøy og kildekontrollsystemer.
• Samhandling med miljøvariabler via tilpasset kode krever et API-kall for å hente verdiene, fordi det finnes ikke en hurtigbuffer som kan brukes av ikke-Microsoft-kode.
• For å lykkes med å bruke miljøvariabler med SharePoint-lister må visningsnavnet og det logiske navnet for hver korresponderende kolonne i kilde- og målmiljøet samsvare.
• Miljøvariabler kan ikke overskride 2000 tegn.

Vanlige spørsmål

Hvorfor ser jeg ikke verdien for miljøvariabelen?

Hvis miljøvariabelen er i en administrert løsning, kan du ikke se verdien med mindre du ser i Standardløsning. Denne funksjonaliteten er slik med hensikt, siden miljøvariabelverdien er en uadministrert tilpassing.

Hvordan kan jeg vise hvor miljøvariabler brukes?

Enten ved å velge Vis avhengigheter i løsningsgrensesnittet, under redigering av komponenter, eller i kildekontrollen og i løsningsfilen ved å vise appen eller flytmetadataene.

Er datakildemiljøvariabler det samme som tilkoblinger?

Nei. Selv om de er relatert, representerer en tilkobling en legitimasjon eller godkjenning som kreves for å samhandle med koblingen. Datakildemiljøvariabler lagrer parametere som kreves av én eller flere handlinger i tilkoblingen, og disse parameterne varierer ofte avhengig av handlingen. En SharePoint Online-tilkobling lagrer for eksempel ikke informasjon om områder, lister eller dokumentbiblioteker. Derfor krever oppkall av koblingen både en gyldig tilkobling og enkelte tilleggsparametere.

Kan datakildemiljøvariabler brukes med delte tilkoblinger, for eksempel SQL Server med SQL-godkjenning?

Vanligvis nei. Delte tilkoblinger med SQL Server lagrer parameterne som kreves for å koble til data i tilkoblingen. Navnet på serveren og databasen angis for eksempel når du oppretter tilkoblingen, og avledes derfor alltid av tilkoblingen.

Datakildemiljøvariabler brukes for tilkoblinger som er avhengige av brukerbasert godkjenning, for eksempel Microsoft Entra ID, fordi parameterne ikke kan avledes fra tilkoblingen. Godkjenning med SQL Server, som er en delt tilkobling, bruker derfor ikke miljøvariabler for datakilde.

Kan den automatiske ALM-pipelinen min bruke forskjellige verdier for forskjellige miljøer?

Ja. Løsningspakkeprogrammet godtar filnavn som inndataparametere, slik at pipelinen kan pakke en fil med forskjellige verdier inn i løsningen, avhengig av hvilken miljøtype den kjøres mot.

Hva skjer hvis noen ved et uhell sletter en verdi?

Hvis det ikke allerede er forhindret av avhengighetssystemet, bruker kjøretiden den sist kjente verdien som en reserveverdi.

Hvis en verdi endres, når blir den nye verdien brukt i lerretsapper og skyflyter?

Det kan ta opptil en time å publisere oppdaterte miljøvariabler fullstendig fordi verdien blir lagt inn i appene og flyter asynkront.

Kreves premiumlisenser?

Nei. Selv om ALM krever Dataverse (eller Dynamics 365 for Customer Engagement), er bruk av premium-tilkoblinger ikke nødvendig. Dette skjer hvis du bruker Dataverse-tilkoblingen til å samhandle med miljøvariabler på samme måte som med andre dataoppføringer, for eksempel forretningsforbindelser eller kontakter. Tidligere var dette den eneste måten å bruke miljøvariabler på i lerretsapper og flyter.

Er det en grense for hvor mange miljøvariabler jeg kan ha?

Nei. Maksimumsstørrelsen for en løsning er imidlertid 120 MB. Mer informasjon: Opprette en løsning

Kan visningsnavn og beskrivelser for miljøvariabelen lokaliseres?

Ja.

Skal jeg bruke miljøvariabler i stedet for å lagre konfigurasjonsdata i egendefinerte tabeller?

Ja, hvis konfigurasjonsdataene ikke er relasjonsmessige. Miljøvariabler bør brukes for nøkkel: verdipar og når verdien sannsynligvis må være forskjellig i andre miljøer. Andre verktøy, for eksempel verktøyet for konfigurasjonsoverføring, er bedre egnet for overføring av relasjonskonfigurasjonsdata lagret i egendefinerte tabeller. I motsetning til andre konfigurasjonsdata overføres miljøvariabler i løsninger og blir derfor mye enklere å administrere og mer effektive å importere.

Hvorfor blir en annen tilkoblingsverdi enn den jeg ønsker, automatisk tilordnet ved import?

I noen tilfeller der det er flere tilkoblinger tilgjengelige for én enkelt miljøvariabel (datakildetype), finnes det en tilsiktet implementering der du velger den første tilkoblingen i listen over tilkoblinger som er tilgjengelige for miljøvariabelen. Siden det vanligvis bare er én tilkobling tilknyttet en miljøvariabel, er ikke dette noe som vanligvis må valideres. Med nylige endringer i synligheten for miljøvariabelverdier er det i tillegg enklere å validere dette ved import.

Hvordan fjerner jeg en verdi fra en miljøvariabel?

Det kan være lurt å fjerne verdien til en miljøvariabel fra løsningen før du eksporterer løsningen. Da beholdes den eksisterende verdien i utviklingsmiljøet, men den eksporteres ikke i løsningen. Denne fremgangsmåten gjør at en ny verdi kan angis mens løsningen importeres til et annet miljø.

Følg denne fremgangsmåten for å fjerne verdien:

1. Velg miljøvariabelen i løsningen der miljøvariabelen er plassert, for å vise egenskapene.

2. Velg ... > Fjern fra denne løsningen under Gjeldende verdi.

   

Kan jeg bruke miljøvariabler i egendefinerte koblinger?

Ja. Støtte for miljøvariabler i egendefinerte koblinger

Se også

Bruke datakildemiljøvariabler i lerretsapper
Bruk miljøvariabler i skyflyter i Power Automate-løsning
Referanse til tabellen/enheten EnvironmentVariableDefinition
Nett-API-utvalg
Bruke datakildemiljøvariabler i lerretsapper
Bruk miljøvariabler i skyflyter i Power Automate-løsning
Bruk Azure Key Vault-hemmeligheter
Støtte for miljøvariabler i egendefinerte koblinger
Power Apps-blogg: Miljøvariabler tilgjengelige i forhåndsversjon!

Obs!

Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)

Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).