Bruk miljøvariabler med nettstedsinnstillinger

Miljøvariabler for områdeinnstillinger lar utviklere og administratorer administrere konfigurasjonsverdier fleksibelt på tvers av miljøer. De muliggjør jevnere administrasjon av programlivssyklus (ALM) og distribusjonsprosesser. Finn ut mer i Miljøvariabler for Power Platform.

Løsning for forbedret datamodell

Bruk miljøvariabler til å definere verdier for områdeinnstillinger på tvers av ulike miljøer med den forbedrede datamodellen. Mens standard datamodell er avhengig av distribusjonsprofiler, tillater den forbedrede modellen dynamisk konfigurasjon av miljøspesifikke innstillinger ved hjelp av miljøvariabler.

Nøkkeldefinisjoner

Hvis du vil forstå hvordan miljøvariabler kan brukes med områdeinnstillinger, må du gjøre deg kjent med følgende nøkkeldefinisjoner:

• Miljøvariabel: En variabel som inneholder konfigurasjonsverdier som er spesifikke for et miljø som programmet eller funksjonene kan henvise til.

• Nettstedsinnstillinger: Egenskaper som kan konfigureres og påvirke funksjonaliteten til et nettsted, for eksempel nettstedsinnstillinger for identitetsleverandør, progressive nettprogrammer og avanserte innstillinger i sikkerhetsarbeidsområdet.

• Referanse for miljøvariabel: En peker mot en miljøvariabel i en nettstedsinnstilling som aktiverer dynamisk verdiløsning ved kjøretid.

Fordeler

Miljøvariabler for områdeinnstillinger har flere fordeler, inkludert:

• Effektiviser ALM ved å unngå hardkodede verdier i områdeinnstillingene.
• Forenkle distribusjoner med flere miljøer med miljøspesifikke konfigurasjoner.
• Aktiver dynamiske oppdateringer av nettstedets virkemåte uten å distribuere løsninger på nytt.

Slik fungerer det

Denne artikkelen beskriver hvordan miljøvariabler fungerer med områdeinnstillinger. Følgende beskrivelse er en oversikt på høyt nivå:

1. Utviklere definerer miljøvariabler i appen Power Pages Management eller løsningsutformingen.
2. Nettstedsinnstillinger refererer til disse miljøvariablene i stedet for statiske verdier.
3. Når området åpnes, løser systemet verdien for den refererte miljøvariabelen og bruker den.

Konfigurer miljøvariabler for nettstedsinnstillinger

Forutsetning

Hvis du vil bruke miljøvariabler med områdeinnstillinger, må du oppfylle følgende forutsetninger:

• Nettstedet må være i et miljø der den forbedrede datamodellen er aktivert.
• Du må ha følgende versjoner for at miljøvariabler skal kunne fungere i Power Pages:
  • Dataverse-server versjon 9.2.25013.x
  • Power Pages-pakke versjon 1.0.2501.x
  • Kjøretidsversjon 9.7.1.x av Power Pages

Bruk miljøvariabler i nettstedsinnstillinger

Slik bruker du miljøvariabler i nettstedsinnstillinger:

1. Åpne appen Power Pages Management og gå til Nettstedsinnstillinger.

2. Velg den bestemte nettstedsinnstillingen du vil konfigurere med en miljøvariabel.

3. Bruk Miljøvariabel som kilde.

   

4. Hvis en miljøvariabeldefinisjon allerede er opprettet, velger du oppslaget Miljøvariabel. En rullegardinmeny vises for valg.

   

5. Hvis det ikke finnes noen miljøvariabeldefinisjon, velger du Ny miljøvariabeldefinisjon og fyller ut de obligatoriske feltene, for eksempel Eier, Skjemanavn, Visningsnavn og Type. Legg merke til verdien for skjemanavn, siden dette er det du må bruke når du knytter en miljøvariabel til en områdeinnstilling.

   

6. Etter at du har opprettet miljøvariabeldefinisjonen, kan du velge den i oppslagskontrollen Miljøvariabel. Søk etter og velg skjemanavnet for å relatere det til områdeinnstillingen.

Notat

• Datatypen som er satt til datakilde, støttes ikke.
• Miljøvariabler med datatypen angitt som "hemmelig" kan ikke konfigureres uten å oppgi Key Vault-detaljer.
• Når det gjelder nettstedsinnstillingen PWAFeature, bruker du verdien {"status":"disable"} for false og {"status":"enable"} for true.

Oppdater verdier som er spesifikke for miljøet

Du kan sikre at nettstedsinnstillingene er riktig konfigurert for hvert miljø, ved å følge denne fremgangsmåten for å oppdatere de miljøspesifikke verdiene i appen Power Pages Management eller utformingsstudioet.

Notat

Ikke alle områdeinnstillinger har et tilsvarende konfigurasjonsalternativ i utformingsstudio.

Appen Power Pages Management

1. Gå til appen Power Pages Management for hvert miljø (for eksempel utvikling, kvalitetssikring og produksjon).
2. Finn miljøvariabelen ved å åpne den tilknyttede områdeinnstillingen.
3. Velg Miljøvariabel.
4. Velg Ny miljøvariabelverdi i Verdier-delen.
5. Angi en Verdi, og velg Lagre og lukk.

Utformingsstudio

1. Gå til utformingsstudio for hvert miljø (for eksempel utvikling, kvalitetssikring og produksjon).

2. Finn konfigurasjonsalternativet som tilsvarer områdeinnstillingen.

3. Oppdater verdien.

4. Lagre konfigurasjonen.

   

Viktig!

• Når du er i utformingsstudio og viser en områdeinnstilling, vises et varsel hvis det brukes en miljøvariabel. Hvis du redigerer verdien, oppdateres alle refererte områdeinnstillinger på tvers av miljøet.
• Hvis datatypen for en områdeinnstilling er merket som hemmelig, deaktiveres feltet i utformingsstudioet, noe som hindrer opprettere i å redigere verdiene. I tillegg støttes ikke lesing eller skriving av Key Vault-hemmeligheter i innstillingene for utformingsstudio.

Når du har angitt miljøvariabelen, følger du disse tilleggstrinnene:

1. Naviger til en løsning og legg til det eksisterende nettstedet, og kontroller at de relevante miljøvariablene også er inkludert.
2. Eksporter og deretter importer løsningen i ønsket målmiljø.

Under importprosessen til målmiljøet tilordner du en verdi til miljøvariabelen. Når du endrer verdien, oppdateres de tilsvarende områdeinnstillingene i målmiljøet.

Behandle miljøvariabler

Du kan administrere nettstedsinnstillinger med miljøvariabler enten du ruller ut løsninger manuelt eller via kanaler.

Løsninger

Konfigurer miljøvariablene og nettstedene på tvers av ulike miljøer ved å følge disse trinnene:

1. Konfigurer miljøvariabler i kildemiljøet:

   1. Åpne Power Pages-portalen eller Power Apps-portalen.

   2. Gå til Løsninger i kildemiljøet.

   3. Legg til en ny miljøvariabel i en løsning ved å angi de nødvendige detaljene og lagre den.

      

      

   4. Legg til det eksisterende nettstedet i løsningen.

2. Konfigurer nettstedsinnstillinger:

   1. Åpne appen Power Pages Management, og gå til Nettstedsinnstillinger.
   2. Velg nettstedsinnstillingen du vil definere for miljøet.
   3. Bruk rullegardinmenyen til å velge eller opprette en miljøvariabel. Brukere kan vise og velge miljøvariabler som er opprettet via løsningsflyten i denne rullegardinlisten.

Notat

I områdeinnstillingene viser rullegardinmenyen navnene på miljøvariabler som er opprettet ved hjelp av løsningsflyten, slik at brukerne enkelt kan velge og knytte dem til.

• Under importprosessen til målmiljøet blir du bedt om å tilordne en verdi til miljøvariabelen.
• Eventuelle endringer som gjøres i miljøvariabelen, oppdaterer de tilsvarende områdeinnstillingene med den nye verdien i målmiljøet.

Forløp

Hvis du bruker kanaler til å rulle ut løsninger, angir du verdien for miljøvariabelen for målmiljøet. Hvis du oppdaterer den, oppdaterer du de tilsvarende nettstedsinnstillingene for å gjenspeile den nye verdien.

Overflater som støtter miljøvariabler for nettstedsinnstillinger

Du kan bruke miljøvariabler for nettstedsinnstillinger på følgende overflater:

• Appen Power Pages Management: Opprett og behandle miljøvariabler.
• Utformingsstudioet: Vis eller rediger nettstedsinnstillingene med miljøvariabler.
• Løsningsutformingen: Ta med miljøvariabler i ALM-prosessen.
• Kanalutrullinger: Administrer og valider miljøspesifikke konfigurasjoner under utrulling.

Tøm hurtigbuffer etter oppdateringer

Når det gjøres endringer i verdien eller standardverdien for miljøvariabelen, tømmer du hurtigbufferen manuelt ved hjelp av en av følgende metoder:

1. Velg Synkroniser i utformingsstudioet.

   

2. Tøm hurtigbufferen fra portalen:

   1. Logg deg på portalen som administrator, og gå til nettstedet med /_services/about føyd til nettadressen. Eksempel: https://contoso.powerappsportals.com/_services/about.

      

   2. Velg Tøm hurtigbuffer på siden med portaldetaljer.

3. Start portalen fra administrasjonssenteret for Power Platform.

Feilsøking

Nedenfor finner du noen ulike årsaker til at det kan oppstå feil når du bruker miljøvariabler med områdeinnstillinger:

• Manglende samsvar i miljøvariabelverdi og forventet type

  Hvis en nettstedsinnstilling som Search/Enabled for eksempel forventer en boolsk verdi (true/false), men miljøvariabelen inneholder en ugyldig verdi (for eksempel «abc») eller mangler, oppstår det problemer.

• Kildetype for miljøvariabel som ikke støttes

  Dette problemet oppstår når miljøvariabelen er konfigurert på en måte som ikke støttes, for eksempel å sette kildetypen til "datalagring".

• Tilgangsproblemer med Key Vault

  Denne typen problem kan oppstå hvis kilden for miljøvariabelen er Key Vault, men kjøretiden mangler tillatelser eller hemmeligheten mangler.

Beste fremgangsmåter

Når du arbeider med miljøvariabler for nettstedinnstillinger, er det viktig å følge anbefalte fremgangsmåter for å sikre effektiv administrasjon. Her er noen viktige anbefalinger:

• Bruk

  Bruk denne funksjonen bare for ALM-relaterte innstillinger eller hemmeligheter. Unngå å bruke den til alle nettstedinnstillinger, fordi det kan føre til forringelse av ytelsen.

• Gi variabler konsekvente navn

  Bruk konsekvente navn på miljøvariabler for å gjøre dem enklere å identifisere.

• Dokumenter variabler

  Vedlikehold et referansedokument som viser alle miljøvariabler, deres formål og standardverdier.

• Foreta grundig testing

  Valider endringer i et ikke-produksjonsmiljø før du bruker dem i produksjon.

• Bruk beskrivelser

  Bruk beskrivelsesfeltet til å forklare formålet med variabelen.

Konfigurer miljøvariabler som hemmeligheter

Hvis du vil konfigurere miljøvariabler som hemmeligheter og bruke dem i Power Pages, følger du denne fremgangsmåten:

1. Konfigurer en miljøvariabel som en hemmelighet. Finn ut mer i Bruk miljøvariabler for Azure Key Vault-hemmeligheter.

2. Legg til tillatelser for å få tilgang til hemmeligheten fra portalen.

   1. Bruk navnet på appen din i Appregistreringer i Azure Portal som svarer til Power Pages-nettstedet ditt.
   2. Appnavnet er det samme som navnet på nettstedet ditt, med prefikset «Portals-». Hvis nettstedsnavnet er Woodgrove Bank Applications, er appnavnet i Azure Portal Portals-Woodgrove Bank Applications. Husk appregistreringsnavnet for senere bruk.
   3. Logg deg på Azure Portal, og gå til Key Vaults.

3. Opprett et nytt Key Vault eller bruk et eksisterende.

   Når du oppretter et nytt Key Vault, velger du en tillatelsesmodell. Velg Azure-rollebasert tilgangskontroll eller Tilgangspolicy for Key Vault. Hvis du vil se de riktige trinnene, velger du følgende kategori basert på ditt valg av tillatelsesmodell:

Azure-rollebasert tilgangskontroll

1. Gå til nøkkelhvelvet i Azure Portal.
2. Velg Tilgangskontroll (IAM) på den venstre menyen.
3. Velg + Legg til øverst på siden, og velg deretter Legg til rolletildeling.
4. Søk etter Bruker av Key Vault-hemmeligheter i fanen Jobbfunksjonsroller, velg det, og velg deretter Neste.
5. For Tilordne tilgang til velger du Bruker, gruppe eller tjenestekontohaver.
6. Velg + Velg medlemmer, og søk etter navnet på appregistreringen på nettstedet som beskrevet tidligere.
7. Velg appen for nettstedet, og velg deretter Neste.
8. Velg Se gjennom + tildel.

Nettstedet ditt har nå tillatelse til å lese hemmeligheter fra dette Key Vault.

Tilgangspolicy for Key Vault

1. Velg Tilgangspolicyer på menyen til venstre.
2. Velg + Opprett øverst på siden.
3. Velg Hent>Neste under Hemmelige tillatelser.
4. Søk etter navnet på appregistreringen på nettstedet ditt som beskrevet tidligere.
5. Velg appen for nettstedet, og velg deretter Neste.
6. Velg Opprett.

Nettstedet ditt har nå tillatelse til å lese hemmeligheter fra dette Key Vault.

4. Legg til nøkkelen din som en hemmelighet i Key Vault. Finn ut hvordan du oppretter en hemmelighet i Azure Key Vault, i Angi og hent en hemmelighet fra Azure Key Vault ved hjelp Azure Portal.

VANLIGE SPØRSMÅL

1. Kan jeg bruke miljøvariabler for alle nettstedsinnstillinger?
   Ja, alle nettstedsinnstillinger som støtter dynamiske verdier, kan bruke en miljøvariabel.

2. Hva skjer hvis en miljøspesifikk verdi ikke er definert?
   Standardverdien brukes som en reserve.

3. Kan jeg redigere miljøvariabelverdier direkte i produksjonen?
   Ja, men sørg for at endringer er testet og dokumentert for å unngå utilsiktede konsekvenser.

Konklusjon

Miljøvariabelen for funksjonen for områdeinnstillinger forenkler ALM, forbedrer konfigurerbarheten og reduserer risikoen for manuelle feil. Utviklere og administratorer som tar i bruk denne funksjonen, sikrer at områdene forblir fleksible og justerer seg etter organisasjonens distribusjonsstrategier.

Relatert informasjon

• Konfigurer innstillinger for nettsteder
• Oversikt over miljøvariabler