Overzicht van omgevingsvariabelen voor Power Platform

Omgevingsvariabelen maken het basisscenario voor Application Lifecycle Management (ALM) mogelijk waarbij een applicatie tussen Power Platform-omgevingen wordt verplaatst. In dit scenario blijft de toepassing precies hetzelfde, met uitzondering van enkele belangrijke externe toepassingsreferenties (zoals tabellen, verbindingen en sleutels) die verschillen tussen de bronomgeving en de doelomgeving. De toepassing vereist dat de structuur van de tabellen of verbindingen exact hetzelfde is tussen de bron- en de doelomgeving, met enkele verschillen. Met omgevingsvariabelen kunt u specificeren welke van deze verschillende externe verwijzingen moeten worden bijgewerkt wanneer de toepassing naar een andere omgeving wordt verplaatst.

Omgevingsvariabelen slaan de parametersleutels en waarden op, die vervolgens dienen als invoer voor verschillende andere toepassingsobjecten. Door de parameters te scheiden van de verbruikende objecten, kunt u de waarden binnen dezelfde omgeving wijzigen of wanneer u oplossingen naar andere omgevingen migreert. Het alternatief is om hardgecodeerde parameterwaarden te laten in de componenten die ze gebruiken. Dit is vaak problematisch; vooral wanneer de waarden moeten worden gewijzigd tijdens ALM-bewerkingen. Omdat omgevingsvariabelen oplossingsonderdelen zijn, kunt u de verwijzingen (sleutels) transporteren en de waarden wijzigen wanneer oplossingen naar andere omgevingen worden gemigreerd.

Notitie

Nieuwe mogelijkheden voor gegevensbronnen worden sinds kort geïmplementeerd en zijn mogelijk nog niet beschikbaar in uw regio.

Voordelen van het gebruik van omgevingsvariabelen:

• Geef nieuwe parameterwaarden op tijdens het importeren van oplossingen naar andere omgevingen.
• Bewaar de configuratie voor de gegevensbronnen die worden gebruikt in canvas-apps en stromen. Bijvoorbeeld: SharePoint Online site- en lijstparameters kunnen worden opgeslagen als omgevingsvariabelen; hierdoor kunt u verbinding maken met verschillende sites en lijsten in verschillende omgevingen zonder dat u de apps en stromen hoeft te wijzigen.
• Verpak en transporteer uw aanpassing en configuratie samen en beheer ze op één locatie.
• Verpak en transporteer geheimen, zoals referenties die door verschillende componenten worden gebruikt, gescheiden van de componenten die ze gebruiken.
• Eén omgevingsvariabele kan voor veel verschillende oplossingsonderdelen worden gebruikt, of ze nu van hetzelfde type onderdeel zijn of verschillend. Een canvas-app en een stroom kunnen bijvoorbeeld dezelfde omgevingsvariabele gebruiken. Als de waarde van de omgevingsvariabele moet worden gewijzigd, hoeft u slechts één waarde te wijzigen.
• Als u bovendien een gegevensbron in productieomgevingen buiten gebruik moet stellen, kunt u de waarden van de omgevingsvariabelen bijwerken met informatie voor de nieuwe gegevensbron. De apps en stromen hoeven niet te worden aangepast en zullen de nieuwe gegevensbron gaan gebruiken.
• Ondersteuning door SolutionPackager- en DevOps-hulpmiddelen zorgen voor continue integratie en continue levering (CI/CD).
• De omgevingsvariabelen kunnen worden uitgepakt en opgeslagen in bronbeheer. U kunt ook verschillende bestanden voor waarden voor omgevingsvariabelen opslaan voor de afzonderlijke configuratie die nodig is in verschillende omgevingen. Oplossingspakketten maken kan vervolgens het bestand accepteren dat overeenkomt met de omgeving waarin de oplossing wordt geïmporteerd.

Hoe werken omgevingsvariabelen?

Omgevingsvariabelen kunnen worden gemaakt en gewijzigd binnen de moderne oplossingsinterface, automatisch worden gemaakt bij het verbinden met bepaalde gegevensbronnen in canvas-apps, of door code te gebruiken​. Ze kunnen ook via oplossingen in een omgeving worden geïmporteerd. Zodra omgevingsvariabelen aanwezig zijn in een omgeving, kunnen ze worden gebruikt als invoer bij het ontwerpen van canvas-apps, Power Automate-stromen, bij het ontwikkelen van invoegtoepassingen, evenals op vele andere plaatsen, zoals het toevoegen van een Power BI-dashboard aan een modelgestuurde app. Wanneer deze typen objecten omgevingsvariabelen gebruiken, worden de waarden afgeleid van de omgevingsvariabelen en kunnen ze worden gewijzigd wanneer oplossingen worden geïmporteerd in andere omgevingen.

Een omgevingsvariabele maken in een oplossing

1. Meld u aan bij Power Apps (make.powerapps.com) en selecteer Oplossingen in het linkerdeelvenster. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
2. Open de gewenste oplossing of maak een nieuwe.
3. Selecteer op de opdrachtbalk Nieuw>Meer en vervolgens Omgevingsvariabele.
4. Vul in het rechterdeelvenster de volgende kolommen in en selecteer vervolgens Opslaan:

   • Weergavenaam. Voer een naam in voor de omgevingsvariabele.

   • Naam. De unieke naam wordt automatisch gegenereerd op basis van de weergavenaam, maar u kunt deze wijzigen.

   • Gegevenstype. Selecteer uit Decimaal getal, Tekst, JSON, Twee opties, Gegevensbron of Geheim.

     Notitie

     • Als Gegevensbron het geselecteerde type is, moet u ook de connector, een geldige verbinding voor de geselecteerde connector en het parametertype selecteren. De verbinding wordt echter niet opgeslagen als onderdeel van de omgevingsvariabele. De verbinding wordt alleen gebruikt voor het ophalen van beschikbare parameterwaarden zoals de SharePoint-sites waartoe u toegang hebt of de lijsten die aan een site zijn gekoppeld. Voor bepaalde parameters, zoals SharePoint-lijsten, moet u ook een variabele voor een bovenliggende gegevensbronomgeving selecteren, zoals de SharePoint-site. Eenmaal opgeslagen, worden deze gerelateerd in de database.
     • Als Geheim het geselecteerde type is, is aanvullende informatie nodig om Azure Key Vault in te stellen en te configureren om toe te staan dat Power Platform toegang krijgt tot het geheim.

   • Current Value. Ook wel bekend als de waarde. Deze eigenschap is optioneel en maakt deel uit van de tabel met omgevingsvariabelen waarden. Als een waarde aanwezig is, wordt deze gebruikt, zelfs als er ook een standaardwaarde aanwezig is. Verwijder de waarde uit uw oplossing als u deze niet in de volgende omgeving wilt gebruiken. De waarden worden ook gescheiden in afzonderlijke JSON-bestanden binnen het geëxporteerde solution.zip-bestand en kunnen offline worden bewerkt. Meer informatie: Hoe verwijder ik een waarde uit een omgevingsvariabele?

   • Standaardwaarde. Deze kolom maakt deel uit van de definitietabel van de omgevingsvariabele en is niet vereist. De standaardwaarde wordt gebruikt als er geen huidige waarde is.

     Door de standaardwaarde en de huidige waarde te scheiden, kunt u de definitie en de standaardwaarde afzonderlijk van de waarde onderhouden. Een uitgever van een toepassing kan bijvoorbeeld zijn aanbieding vermelden op AppSource met een standaardwaarde. Dan kan de klant optioneel een nieuwe waarde aanleveren. Wanneer de uitgever van de toepassing updates voor de toepassing publiceert, wordt de door de klant ingestelde waarde niet overschreven.

     

     Notitie

     Een waarde kan niet bestaan zonder een definitie. Met de interface kan slechts één waarde per definitie worden gemaakt.

Nieuwe waarden invoeren tijdens het importeren van oplossingen

De moderne interface voor het importeren van oplossingen biedt de mogelijkheid om waarden voor omgevingsvariabelen in te voeren. Dit stelt de waarde-eigenschap in op de tabel environmentvariablevalue.

Vanaf een update op 7 december 2023 zijn alle waarden van omgevingsvariabelen zichtbaar bij het importeren van oplossingen (of bij het gebruik van Pipelines voor implementatie). Omgevingsvariabelen zonder een standaardwaarde of waarde worden naar een waarde gevraagd, maar die zijn anders vooraf gevuld met een label onder het tekstgebied dat de bron van de waarde aangeeft: oplossingswaarde, doelomgevingswaarde of standaardwaarde.

Notitie

• In sommige gevallen kan voor specifieke gegevensbron-waarden van omgevingsvariabelen een waarschuwing toegang geweigerd verschijnen als de importerende maker geen toegang heeft tot de verbinding of bron die voor de omgevingsvariabele wordt gebruikt. Dit is een niet-blokkerende waarschuwing, maar wel een om rekening mee te houden, afhankelijk van hoe u de omgevingsvariabele in de doelomgeving wilt gebruiken.
• U kunt de waarde uit uw oplossing verwijderen voordat u de oplossing exporteert. Dit zorgt ervoor dat de bestaande waarde in uw ontwikkelomgeving blijft, maar niet wordt geëxporteerd in de oplossing. Met deze aanpak kan een nieuwe waarde worden geboden terwijl de oplossing in andere omgevingen wordt geïmporteerd. Meer informatie: Hoe verwijder ik een waarde uit een omgevingsvariabele?

Meldingen

Er wordt een melding weergegeven wanneer de omgevingsvariabelen geen waarden hebben. Dit is een herinnering om de waarden zo in te stellen dat onderdelen die afhankelijk zijn van omgevingsvariabelen werken.

Beveiliging

De environmentvariabledefinition-tabel is eigendom van de gebruiker of het team. Als u een toepassing maakt die omgevingsvariabelen gebruikt, moet u ervoor zorgen dat u gebruikers het juiste bevoegdheidsniveau toewijst voor deze tabel. Toestemming voor de environmentvariablevalue-tabel wordt overgenomen van de bovenliggende environmentvariabledefinition-tabel en vereist daarom geen aparte bevoegdheden. Privileges voor environmentvariabledefinition-tabellen zijn standaard opgenomen in de beveiligingsrollen Omgevingsmaker en Basisgebruiker. Meer informatie: Beveiliging in Dataverse.

Naamgeving

Zorg ervoor dat de namen van omgevingsvariabelen uniek zijn, zodat er nauwkeurig naar kan worden verwezen. Dubbele weergavenamen van omgevingsvariabelen maken het moeilijk om omgevingsvariabelen te onderscheiden en te gebruiken. Zorg ervoor dat de namen van omgevingsvariabelen uniek zijn, zodat er nauwkeurig naar kan worden verwezen. De namen $authentication en $connection zijn speciaal gereserveerde parameters voor stromen en moeten worden vermeden. Een stroom wordt geblokkeerd als omgevingsvariabelen met die namen worden gebruikt. Als een omgevingsvariabele in een stroom wordt gebruikt en de weergavenaam van de omgevingsvariabele wordt gewijzigd, toont de ontwerper zowel de oude als de nieuwe weergavenaamtokens om te helpen bij de identificatie. Bij het bijwerken van de stroom raden we u aan de verwijzing naar de omgevingsvariabele te verwijderen en opnieuw toe te voegen.

Huidige beperkingen

• Validatie van waarden van omgevingsvariabelen gebeurt binnen de gebruikersinterfaces en binnen de onderdelen die ze gebruiken, maar niet binnen Dataverse. Zorg er daarom voor dat de juiste waarden worden ingesteld als ze door middel van code worden gewijzigd.
• Power Platform Build Tools-taken zijn nog niet beschikbaar voor het beheren van variabelen voor de gegevensbronomgeving. Dit blokkeert echter niet het gebruik ervan binnen door Microsoft verstrekte hulpprogramma's en binnen bronbeheersystemen.
• Interactie met omgevingsvariabelen via aangepaste code vereist een API-aanroep om de waarden op te halen; er is geen cache beschikbaar om code te gebruiken die niet van Microsoft is.
• Om omgevingsvariabelen met SharePoint-lijsten te kunnen gebruiken, moeten de weergavenaam en de logische naam voor elke corresponderende kolom in de bron- en doelomgeving overeenkomen.
• Omgevingsvariabelen zijn beperkt tot maximaal 2.000 tekens.

Veelgestelde vragen

Waarom kan ik de waarde van mijn omgevingsvariabele niet zien?

Als de omgevingsvariabele zich in beheerde oplossing bevindt, kunt u de waarde niet zien, tenzij u in de Standaardoplossing kijkt. Dit gedrag is zo ontworpen, aangezien de waarde van de omgevingsvariabele een onbeheerde aanpassing is.

Hoe kan ik zien waar omgevingsvariabelen worden gebruikt?

Ofwel door Afhankelijkheden weergeven te selecteren in de oplossingsinterface, tijdens het ontwerpen van onderdelen of in bronbeheer en in het oplossingsbestand door de app- of stroommetagegevens te bekijken.

Zijn variabelen voor de gegevensbronomgeving hetzelfde als verbindingen?

Nee Hoewel ze gerelateerd zijn, vertegenwoordigt een verbinding een referentie of verificatie die vereist is om te communiceren met de connector. Variabelen voor een gegevensbronomgeving slaan parameters op die vereist zijn voor een of meer acties in de connector en deze parameters variëren vaak afhankelijk van de actie. Een SharePoint Online-verbinding slaat bijvoorbeeld geen informatie op over sites, lijsten of documentbibliotheken. Het aanroepen van de connector vereist daarom zowel een geldige verbinding als enkele aanvullende parameters.

Kunnen variabelen voor de gegevensbronomgeving worden gebruikt met gedeelde verbindingen zoals SQL Server met SQL-authenticatie?

Over het algemeen niet. Gedeelde verbindingen met SQL Server slaan de parameters op die nodig zijn om verbinding te maken met gegevens binnen de verbinding. De server- en databasenaam worden bijvoorbeeld opgegeven bij het maken van de verbinding en worden daarom altijd afgeleid van de verbinding.

Variabelen voor de gegevensbronomgeving worden gebruikt voor connectoren die afhankelijk zijn van gebruikersgebaseerde verificatie, zoals Microsoft Entra ID, omdat de parameters niet kunnen worden afgeleid uit de verbinding. Om deze redenen worden bij verificatie met SQL Server, wat een gedeelde verbinding is, geen omgevingsvariabelen voor gegevensbron gebruikt.

Kan mijn geautomatiseerde ALM-pijplijn verschillende waardenbestanden gebruiken voor verschillende omgevingen?

Ja. Oplossingspakketten maken accepteert de bestandsnaam als invoerparameters, zodat uw pijplijn een ander waardenbestand in de oplossing kan inpakken, afhankelijk van het omgevingstype waarvoor het wordt uitgevoerd.

Moet ik de waarde in mijn oplossing opnemen?

Nee Omgevingsvariabelen zijn bedoeld voor toepassingen die verschillende waarden nodig hebben in verschillende omgevingen waarin de oplossing wordt geïmplementeerd. Definities van omgevingsvariabelen moeten in uw oplossing worden opgenomen, maar de waarden voor de doelomgeving moeten tijdens de implementatie worden opgegeven. Dit gedrag resulteert erin dat de definitie van de omgevingsvariabele een beheerd oplossingsobject is in de doelomgeving, terwijl de omgevingsvariabele een onbeheerd record is.

Waarom kan ik een waarde niet verwijderen uit mijn omgeving?

Als de waarde is opgenomen in een beheerde oplossing, kunt u de waarde alleen verwijderen door de oplossing in de bronomgeving bij te werken om de waarde uit te sluiten en vervolgens een nieuwe versie van de oplossing te exporteren. Deze nieuwe versie kan vervolgens via een upgradebewerking (geen update) in de omgeving worden geïmporteerd, waardoor het waarderegister wordt verwijderd.

Wat moet ik doen als iemand per ongeluk een waarde verwijdert?

Als dit niet al wordt voorkomen door het afhankelijkheidssysteem, gebruikt runtime de laatst bekende waarde als terugval.

Als een waarde wordt gewijzigd, wanneer wordt de nieuwe waarde dan gebruikt in canvas-apps en cloudstromen?

Het kan een uur duren voordat de bijgewerkte omgevingsvariabelen volledig zijn gepubliceerd, omdat de waarde naar de apps wordt gepusht en asynchroon stroomt.

Zijn premium licenties vereist?

Nee Terwijl ALM Dataverse (of Dynamics 365-apps) vereist, is het gebruik van premium-connectoren niet vereist. Het enige voorbehoud is als u de Dataverse-connector gebruikt om te communiceren met omgevingsvariabelen zoals u zou doen met andere gegevensrecords zoals accounts of contacten. Voorheen was dit de enige manier om omgevingsvariabelen te gebruiken in canvas-apps en -stromen.

Geldt er een limiet voor het aantal omgevingsvariabelen dat ik kan hebben?

Nee De maximale grootte van een oplossing is echter 95 MB. Meer informatie: Een oplossing maken

Kunnen weergavenamen en beschrijvingen van omgevingsvariabelen worden gelokaliseerd?

Ja.

Moet ik omgevingsvariabelen gebruiken in plaats van configuratiegegevens op te slaan in aangepaste tabellen?

Ja, als uw configuratiegegevens niet relationeel zijn. Omgevingsvariabelen moeten worden gebruikt voor sleutel/waarde-paren en wanneer de waarde waarschijnlijk moet verschillen in andere omgevingen. Andere hulpprogramma's, zoals het hulpprogramma voor configuratiemigratie, zijn beter geschikt voor de migratie van relationele configuratiegegevens die zijn opgeslagen in aangepaste tabellen. In tegenstelling tot andere configuratiegegevens worden omgevingsvariabelen binnen oplossingen gemigreerd zodat ze veel eenvoudiger te beheren en te importeren zijn.

Waarom wordt mijn verbinding voor de omgevingsvariabelen van de gegevensbron niet opgeslagen?

Verbindingen worden alleen gebruikt om de gebruikersinterface te genereren. Bijvoorbeeld om begrijpelijke namen op te halen voor SharePoint-lijsten die aan een site zijn gekoppeld. Wanneer u een omgevingsvariabele voor een gegevensbron bewerkt, moet u ervoor zorgen dat u een verbinding selecteert met toegang tot de gegevensbron. Als u geen toegang meer hebt tot de verbinding, kunt u handmatig een waarde invoeren. Vul bijvoorbeeld de SharePoint-site-URL of unieke id (GUID) voor een lijst in.

Wanneer er meerdere verbindingen beschikbaar zijn voor één (gegevensbrontype) omgevingsvariabele, is er een ontwerpimplementatie om de eerste verbinding in de lijst met verbindingen te selecteren. Omdat er meestal maar één verbinding is gekoppeld aan een omgevingsvariabele, hoeft dit meestal niet te worden gevalideerd. Bovendien is dit, door recente wijzigingen in de zichtbaarheid van de waarde van omgevingsvariabelen, gemakkelijker te valideren bij het importeren.

Hoe verwijder ik een waarde uit een omgevingsvariabele?

Mogelijk wilt u de waarde van een omgevingsvariabele uit uw oplossing verwijderen voordat u de oplossing exporteert. De bestaande waarde blijft dan in uw ontwikkelomgeving, maar wordt niet geëxporteerd in de oplossing. Met deze aanpak kan een nieuwe waarde worden geboden terwijl de oplossing in een andere omgeving wordt geïmporteerd.

Volg deze stappen om de waarde te verwijderen:

1. Selecteer in de oplossing waar de omgevingsvariabele zich bevindt de omgevingsvariabele om de eigenschappen weer te geven.

2. Onder Huidige waarde, selecteer ...>Verwijderen uit deze oplossing.

   

Kan ik omgevingsvariabelen gebruiken in aangepaste connectors?

Ja. Ondersteuning voor omgevingsvariabelen in aangepaste connectors

Zie ook

Variabelen voor gegevensbronomgeving gebruiken in canvas-apps
Omgevingsvariabelen gebruiken in cloudstromen voor Power Automate-oplossingen
Tabel/entiteitsreferentie EnvironmentVariableDefinition
Web API-voorbeelden
Omgevingsvariabelen van gegevensbronnen gebruiken in canvas-apps
Omgevingsvariabelen gebruiken in Power Automate-cloudstromen van oplossingen
Azure Key Vault-geheimen gebruiken
Ondersteuning voor omgevingsvariabelen in aangepaste connectoren
Power Apps-blog: omgevingsvariabelen beschikbaar in preview!