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. Denne tilnæringen er ofte problematisk, spesielt når verdiene må endres under operasjoner for administrasjon av programlivssyklusen (ALM). 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.

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. For eksempel kan nettsteds- og listeparametere i SharePoint lagres som miljøvariabler. Med denne fremgangsmåten kan du koble til forskjellige nettsteder 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. De kan også opprettes automatisk når du kobler til bestemte datakilder i lerretsapper eller med kode. De kan også importeres til et miljø via løsninger. Miljøvariabler kan brukes som inndata når du redigerer lerretsapper, Power Automate-flyter, programtillegg og legger til Power BI-instrumentbord i modelldrevne apper. Når du 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 manuelt

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.

     Notat

     • Hvis Datakilde er den valgte typen, må du velge tilkobling, en gyldig tilkobling for den valgte tilkoblingen, og parametertype. Tilkoblingen lagres ikke som en del av miljøvariabelen. Miljøvariabelen lagrer informasjon som ikke er i tilkoblingen som er nødvendig for å koble Power Apps til riktig server og tabell. Tilkoblingen brukes bare til å hente tilgjengelige parameterverdier, for eksempel SharePoint-områdene du har tilgang til, eller listene som er tilknyttet et område.

     • 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. En definert verdi brukes, 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.

     

     Merk

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

Power Apps kan opprette miljøvariabler automatisk

På Generelt-fanen i Power Apps-innstillingene:

• Aktiver alternativet Opprett miljøvariabler automatisk når datakilder legges til. Når du nå legger til en ny datakilde i appen, legges det til en miljøvariabel for deg.

  

Ulike datakilder

Ulike datakilder muliggjør ulike typer miljøvariabler.

Microsoft Dataverse

Power Apps kobles til Dataverse som standard. Du trenger ikke en miljøvariabel for tabeller i det gjeldende miljøet. Når du kobler til Dataverse, ser programmet automatisk etter nøyaktig det samme tabellnavnet i alle miljøer du porterer det til. Så lenge tabellnavnstrukturen er den samme i målmiljøet som i det opprinnelige miljøet, fungerer det.

Hvis du bruker en ekstern tabell fra et annet miljø (via Endre miljø), antar Power Apps at du alltid vil referere til nøyaktig samme tabell. Du trenger en miljøvariabel hvis du vil at den eksterne tabellen skal være en annen ekstern tabell når du flytter fra utvikling til test eller til produksjon. Det er enklest å tillate Power Apps å opprette miljøvariabelen automatisk for deg. (Hvis du tidligere har lagt til tabellen i appen, aktiverer du bryteren for innstillinger, slipper den eksterne tabellen og legger den til på nytt.)

Når du legger til den eksterne tabellen i appen, velger du Avansert-fanen for å velge miljøvariabelen.

SharePoint

SharePoint støtter bare Microsoft Entra-tilkoblinger. For SharePoint kreves derfor en egen miljøvariabel for nettsted og liste, i tillegg til en gyldig tilkobling.

Slik lykkes du med å bruke miljøvariabler med SharePoint-lister:

• Visningsnavnet og det logiske navnet for hver tilsvarende kolonne i kilde- og målmiljøene må samsvare.
• Miljøvariabler for SharePoint må ha samsvarende metadata. SharePoint har interne identifikatorer som kanskje ikke samsvarer mellom målmiljøer. Hvis du for eksempel oppretter en liste med samme navn og kolonner i et målmiljø, samsvarer ikke de interne navnene. Metadataene samsvarer alltid hvis du dupliserer et SharePoint-nettsted og kopierer det til målmiljøet.

SQL Server

SQL Server støtter mange forskjellige typer autentisering og tilkoblinger. Bruk miljøvariabler for Microsoft Entra-tilkoblinger. En separat miljøvariabel kreves for serveren og databasen. Programmet er bundet til bestemte tabellnavn, slik at de antas å være de samme mellom miljøer.

Ikke bruk miljøvariabler for delte tilkoblinger, for eksempel enkel SQL-godkjenning med SQL Server. Bruk tilkoblingsreferanser for informasjon som tradisjonelt sendes som en del av tilkoblingsstrengen. Grunnleggende SQL autentiseringsparametere er alle en del av tilkoblingsstrengen. Navnet på serveren og databasen angis for eksempel når du oppretter tilkoblingen, og avledes derfor alltid av tilkoblingen.

Datakildemiljøvariabler brukes for koblinger med godkjenning som Microsoft Entra. I disse typer tilkoblinger har Power Apps bare en identifisert bruker. Power Apps kan ikke utlede hvilken tjeneste eller tabell du har tenkt å arbeide med fra tilkoblingen.

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.

Miljøvariabelverdier er synlige når du importerer løsninger eller når du bruker pipeliner til å distribuere. Miljøvariabler uten standardverdi eller verdi ber om en verdi, men de ellers er forhåndsutfylt med en etikett under tekstområdet som angir verdiens kilde: løsningsverdi, målmiljøverdi eller standardverdi.

Merk

• I noen tilfeller kan det for bestemte variabelverdier for datakildemiljø vises en advarsel om ingen tilgang hvis importøren ikke har tilgang til tilkoblingen eller kilden som brukes 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. 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.
• 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 kall av tilkoblingen både en gyldig tilkobling og noen parametere til.

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.

Skal jeg ta med verdien i løsningen min?

Nei. Miljøvariabler er ment å brukes av programmer som må ha ulike verdier i ulike miljøer der løsningen distribueres. Definisjoner av miljøvariabler må tas med i løsningen, men verdiene må angis for målmiljøet under distribusjon. Denne funksjonaliteten gjør at definisjonen av miljøvariabelen er et administrert løsningsobjekt i målmiljøet, mens miljøvariabelen er en uadministrert oppføring.

Hvorfor kan jeg ikke slette en verdi i miljøet mitt?

Hvis verdien ble tatt med i en administrert løsning, kan du bare slette verdien ved å oppdatere løsningen i kildemiljøet for å utelate verdien, og deretter eksportere en ny versjon av løsningen. Denne nye versjonen kan deretter importeres til miljøet ved hjelp av en oppgraderingsoperasjon (ikke en oppdatering), som fører til at verdiposten blir slettet.

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-apper), 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 95 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 lagres ikke tilkoblingen for datakildemiljøvariabler?

Tilkoblinger brukes bare til å generere brukergrensesnittet. De brukes for eksempel til å hente egendefinerte navn for SharePoint-lister som er knyttet til et nettsted. Når du redigerer en datakildemiljøvariabel, må du passe på at du velger en tilkobling med tilgang til datakilden. Hvis du ikke lenger har tilgang til tilkoblingen, kan du angi en verdi manuelt. Du kan for eksempel angi nettadressen til SharePoint-nettstedet eller den unike identifikatoren (GUID) for en liste.

Når det finnes flere tilkoblinger for én miljøvariabel (av datakildetypen), blir den første tilkoblingen i listen over tilkoblinger, valgt med hensikt. 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-eksempler
Bruk datakildemiljøvariabler i lerretsapper
Bruk miljøvariabler i Power Automate-løsningsskyflyter
Bruk Azure Key Vault-hemmeligheter
Støtte for miljøvariabler i egendefinerte koblinger
Power Apps-blogg: Miljøvariabler tilgjengelige i forhåndsversjon!