Instellingen gebruiken om aangepaste app-ervaringen te bieden.

Instellingen zijn oplossingsonderdelen waarmee makers en beheerders snel apps kunnen configureren om een aangepaste ervaring te bieden. Instellingen kunnen worden gebruikt om functies in of uit te schakelen of functiegedrag te configureren voor een enkele app of alle apps binnen een omgeving.

Instellingen bestaan uit drie subonderdelen: definitie van instelling, omgevingswaarde van instelling en app-waarde van instelling.

Subonderdeel	Beschrijving
Definitie instellen	Auteurs van toepassingen, beheerders of partners kunnen een instellingsdefinitie maken met eigenschappen zoals naam, beschrijving, gegevenstype, standaardwaarde en meer. Vervolgens kunnen ze, via code, de waarde van de instelling gebruiken om de te leveren functie in of uit te schakelen of te configureren. Ze kunnen de instellingsdefinitie opnemen in de oplossing die wordt gebruikt om de functie aan hun klanten te leveren. Voorbeeld: De Asynchrone save-handler voor modelgestuurde apps is een functie van Power Apps die gebruikmaakt van instellingen. De instelling is van het type Ja/nee en de standaardwaarde van deze instelling is Nee. Daarom wordt de functie Asynchrone save-handler uitgeschakeld voor alle modelgestuurde apps.
Omgevingswaarde instellen	Een omgevingswaarde van een instelling kan worden gebruikt om de standaardwaarde te overschrijven, zoals gespecificeerd in de instellingsdefinitie. Voorbeeld: Als uitbreiding op het bovenstaande voorbeeld kan een omgevingsbeheerder in de klantorganisatie een instellingsomgevingswaarde toevoegen voor de instelling Asynchrone save-handler en deze op Ja zetten. Deze omgevingswaarde voor de instelling overschrijft de standaardwaarde en is van toepassing op alle apps in die omgeving. Hiermee wordt de functie Asynchrone save-handler voor alle modelgestuurde apps in die omgeving ingeschakeld.
App-waarde van instelling	Een app-waarde van een instelling kan worden gebruikt om de standaardwaarde te overschrijven, zoals gespecificeerd in de instellingsdefinitie, en de omgevingswaarde van de instelling (indien aanwezig). Voorbeeld: Nogmaals, als aanvulling op het bovenstaande voorbeeld, kan een auteur van een toepassing in dezelfde omgeving als hierboven een app-instellingswaarde toevoegen voor de instelling Asynchrone save-handler voor een app die ze aan het maken zijn en deze instellen op Nee. Deze app-waarde voor de instelling overschrijft de omgevingswaarde van instelling en is alleen van toepassing op die ene app. Hiermee wordt de functie Asynchrone save-handler alleen voor die app ingeschakeld.

Notitie

Als u de onderstaande stappen ẁilt volgen, moet Preview van oplossing ingeschakeld zijn. Controleer in het gebied Oplossingen in Power Apps, of de opdrachtbalk Preview van oplossing ingeschakeld bevat. Als Preview van oplossing uitgeschakeld wordt weergegeven, selecteert u de optie om het voorbeeld in te schakelen. Meer informatie: Oplossingsweergave

Instellingsdefinitie

Een instellingsdefinitie specificeert de basiseigenschappen van een instelling. De volledige lijst met eigenschappen die voor een instellingsdefinitie kunnen worden geconfigureerd, wordt hieronder weergegeven. Sommige van deze eigenschappen kunnen niet worden gewijzigd nadat de instelling is gemaakt.

Eigenschap	Beschrijving
Weergavenaam	De naam die wordt weergegeven aan gebruikers van de instelling in alle gebruikersinterfaces waar instellingen worden weergegeven.
Naam	De unieke naam van de instelling in een omgeving. De naam wordt automatisch gegenereerd op basis van de opgegeven weergavenaam, maar kan worden gewijzigd voordat de instelling wordt gemaakt. Zodra een instelling is gemaakt, kan de Naam niet worden gewijzigd omdat er mogelijk naar wordt verwezen in uw toepassingen of code. Naam heeft een voorvoegsel dat overeenkomt met de uitgever van de oplossing. Dit voorvoegsel is bedoeld om de instelling een unieke naam te geven als u deze in de toekomst in een andere oplossing of omgeving wilt importeren (die een ander voorvoegsel zou hebben).
Beschrijving	De beschrijving helpt anderen begrijpen waarvoor de instelling wordt gebruikt in alle gebruikersinterfaces waar instellingen worden weergegeven.
Gegevenstype	Het gegevenstype van een instelling bepaalt hoe de waarde van de instelling wordt opgeslagen. Gegevenstype kan worden ingesteld op Nummer, Tekenreeks of Ja/nee. Het gegevenstype kan niet worden gewijzigd nadat de instelling is gemaakt.
Standaardwaarde	De standaardwaarde wordt beschikbaar als u Gegevenstype selecteert. De standaardwaarde geeft de waarde van de instelling op die wordt gebruikt, tenzij deze wordt overschreven door een omgevingswaarde of app-waarde van de instelling.
Waarde kan worden gewijzigd voor	Een instelling kan worden overschreven op een van de volgende niveaus: Omgeving en app: zowel de omgevingswaarde van de instelling als de app-waarden van de instelling kunnen de standaardwaarde negeren. Alleen omgeving: alleen de omgevingswaarde van de instelling kan de standaardwaarde negeren. Alleen app: alleen de app-waarden voor instellingen kunnen de standaardwaarde overschrijven. Geen: de instelling kan niet worden overschreven.
Releaseniveau	Het releaseniveau wordt gebruikt om het framework en andere gebruikers van de instelling te informeren over de status van de functie waarmee de instelling wordt gebruikt. Releaseniveau kan worden ingesteld op: Algemeen verkrijgbaar of Preview.
Informatie-URL	Een koppeling naar documentatie die gebruikers duidelijk maakt wat het doel van de instelling is. Wordt gebruikt als een koppeling Meer informatie in alle gebruikersinterfaces waar instellingen worden weergegeven.

Een nieuwe instellingsdefinitie toevoegen

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waaraan u de instelling wilt toevoegen.
4. Selecteer in de opdrachtbalk Nieuw > Meer > Instelling > Instellingsdefinitie.
5. Geef in het dialoogvenster Nieuwe instelling waarden op voor de eigenschappen op basis van uw vereisten. Ga voor informatie over de eigenschappen van de instellingsdefinitie naar: Instellingsdefinitie
6. Als u klaar bent met het opgeven van waarden voor de eigenschappen, selecteert u Opslaan.

Een bestaande instellingsdefinitie toevoegen

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waaraan u de instelling wilt toevoegen.
4. Selecteer in de opdrachtbalk Bestaande toevoegen > Meer > Instelling.
5. Selecteer in het dialoogvenster Bestaande instellingsdefinitie toevoegen een of meer instellingen die u wilt toevoegen.
6. Als u klaar bent met het selecteren van instellingen, selecteert u Volgende
7. In het dialoogvenster Geselecteerde instellingsdefinitie hebt u voor elke instelling die u hebt geselecteerd, de optie Instellingsdefinitie opnemen. U kunt ook Omgevingswaarde van instelling opnemen selecteren voor elke instelling, als die bestaat.
8. Selecteer Toevoegen om de instellingsdefinitie en/of omgevingswaarden voor de instelling toe te voegen.

Een instellingsdefinitie bijwerken

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waarin u de instelling hebt gemaakt.
4. Selecteer in de boomstructuur Instellingen > Instellingsdefinities.
5. Selecteer de instellingsdefinitie die u wilt bijwerken.
6. In het dialoogvenster Instelling bewerken wijzigt u de waarden voor de gewenste eigenschappen.
   Houd er rekening mee dat sommige eigenschappen niet kunnen worden bijgewerkt nadat een instelling is gemaakt. Bovendien kunt u in de meeste gevallen geen instellingsdefinities bijwerken waarvan u niet de eigenaar bent.
7. Als u klaar bent met het bijwerken van waarden voor de eigenschappen, selecteert u Opslaan.

Een instellingsdefinitie verwijderen

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waarin u de instelling hebt gemaakt of toegevoegd.
4. Selecteer in de boomstructuur Instellingen > Instellingsdefinities.
5. Selecteer de instellingsdefinitie die u wilt verwijderen.
6. Selecteer in de opdrachtbalk Verwijderen > Verwijderen uit deze oplossing.
   Met Verwijderen uit deze oplossing verwijdert u de instellingsdefinitie uit de huidige oplossing, maar blijft deze onderdeel van de standaardoplossing of een andere oplossing waaraan de definitie is toegevoegd.

Een instellingsdefinitie helemaal verwijderen

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waarin u de instelling hebt gemaakt of toegevoegd.
4. Selecteer in de boomstructuur Instellingen > Instellingsdefinities.
5. Selecteer de instellingsdefinitie die u helemaal wilt verwijderen.
6. Selecteer in de opdrachtbalk Verwijderen > Verwijderen uit deze omgeving.
   Met Verwijderen uit deze omgeving verwijdert u de instellingsdefinitie uit de huidige omgeving en maakt deze geen deel meer uit van oplossingen in die omgeving. U kunt alleen instellingsdefinities verwijderen waarvan u de eigenaar bent.

Omgevingswaarde instellen

Een omgevingswaarde voor de instelling wordt gebruikt om de standaardwaarde van de instelling voor alle apps in die omgeving te overschrijven. Gebruik een omgevingswaarde voor de instelling wanneer u niet de standaardwaarde van de instelling wilt gebruiken voor apps in uw omgeving.

Nieuwe omgevingswaarde voor instelling toevoegen

1. Meld u aan bij Power Apps.

2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.

3. Ga naar de lijst met oplossingen en open de oplossing waaraan u de omgevingswaarde voor de instelling wilt toevoegen.

4. Als de instellingsdefinitie beschikbaar is in de oplossing:

   1. Selecteer de definitie van de instelling.
   2. Selecteer in het dialoogvenster Instellingswaarde bewerken in de sectie Omgevingswaarde instelling de optie Nieuwe waarde.
   3. Geef de waarde op en selecteer vervolgens Opslaan.

   Als de instellingsdefinitie niet beschikbaar is in de oplossing:

   1. Selecteer in de opdrachtbalk Nieuw > Meer > Instelling > Omgevingswaarde instelling.
   2. Selecteer de instelling waarvoor u de omgevingswaarde wilt toevoegen en selecteer vervolgens Toevoegen.
   3. Selecteer in het dialoogvenster Nieuwe omgevingswaarde instelling in de sectie Omgevingswaarde instelling de optie Nieuwe waarde.
   4. Geef de waarde op en selecteer vervolgens Opslaan.

Een bestaande omgevingswaarde van instelling toevoegen

1. Meld u aan bij Power Apps.

2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.

3. Ga naar de lijst met oplossingen en open de oplossing waaraan u de omgevingswaarde voor de instelling wilt toevoegen.

4. Als de instellingsdefinitie beschikbaar is in de oplossing:

   1. Selecteer de definitie van de instelling.
   2. Selecteer in het dialoogvenster Instellingswaarde bewerken in de sectie Omgevingswaarde instelling de optie Bestaande waarde toevoegen.
   3. Werk de waarde zo nodig bij en selecteer vervolgens Opslaan.

   Als de instellingsdefinitie niet beschikbaar is in de oplossing:

   1. Selecteer op de opdrachtbalk Bestaande toevoegen > Meer > Instelling.
   2. Selecteer in het dialoogvenster Bestaande instellingsdefinitie toevoegen een of meer instellingen waarvoor u omgevingswaarden wilt toevoegen.
   3. Als u klaar bent met het selecteren van instellingen, selecteert u Volgende
   4. In het dialoogvenster Geselecteerde instellingsdefinitie hebt u voor elke instelling die u hebt geselecteerd, de optie Omgevingswaarde van instelling opnemen. U kunt desgewenst ook Instellingsdefinitie opnemen selecteren voor elke instelling.
   5. Selecteer Toevoegen om de omgevingswaarden en/of instellingsdefinitie voor de instelling toe te voegen.

Een omgevingswaarde van een instelling bijwerken

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waaraan u de omgevingswaarde voor instellingen wilt toevoegen.
4. Selecteer in de boomstructuur Instellingen > Omgevingswaarden instellen.
5. Selecteer de omgevingswaarde van de instelling die u wilt bijwerken.
6. Werk in het dialoogvenster Instellingswaarde bewerken in de sectie Omgevingswaarde instelling de waarde bij en selecteer Opslaan.

Een omgevingswaarde van een instelling verwijderen

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waarin u de instelling hebt gemaakt of toegevoegd.
4. Selecteer in de boomstructuur Instellingen > Omgevingswaarden instellen.
5. Selecteer de omgevingswaarde van de instelling die u wilt verwijderen.
6. Selecteer op de opdrachtbalk Verwijderen > Verwijderen uit deze oplossing.
   Met Verwijderen uit deze oplossing verwijdert u de omgevingwaarde van de instelling uit de huidige oplossing, maar blijft deze onderdeel van de standaardoplossing of een andere oplossing waaraan de definitie is toegevoegd.

Een omgevingswaarde van een instelling helemaal verwijderen

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waarin u de instelling hebt gemaakt of toegevoegd.
4. Selecteer in de boomstructuur Instellingen > Omgevingswaarden instellen.
5. Selecteer de omgevingswaarde van de instelling die u helemaal wilt verwijderen.
6. Selecteer op de opdrachtbalk Verwijderen > Verwijderen uit deze omgeving.
   Met Verwijderen uit deze omgeving verwijdert u de omgevingwaarde van de instelling uit de huidige omgeving en maakt deze geen deel meer uit van oplossingen in die omgeving.

App-waarde van instelling

Een app-waarde voor de instelling wordt gebruikt om de standaardwaarde van de instelling en alle omgevingswaarden voor de instelling te overschrijven. Gebruik een app-waarde voor de instelling wanneer u niet de omgevingswaarde van de instelling wilt gebruiken voor uw app. Als er geen omgevingswaarde voor de instelling bestaan, gebruikt u een app-waarde voor de instelling wanneer u niet de standaardwaarde van de instelling wilt gebruiken voor uw app.

Notitie

Om de onderstaande stappen te volgen moet u de nieuwe app-ontwerper gebruiken. Momenteel geeft de app-ontwerper alleen Power Apps-platforminstellingen weer. Gebruik voor niet-platforminstellingen de oplossingsverkenner zoals hieronder beschreven.

Een app-waarde van een instelling toevoegen of bijwerken met behulp van de app-ontwerper

1. Open de app waarvoor u de app-waarde wilt instellen in de app-ontwerper.
2. Selecteer Instellingen op de opdrachtbalk.
3. Selecteer in het dialoogvenster Instellingen het tabblad Functies of Aanstaand.
   Het tabblad Functies geeft alle instellingen weer waarvan het releaseniveau is ingesteld op Algemeen beschikbaar. Het tabblad Aanstaand geeft alle instellingen weer waarvan het releaseniveau is ingesteld op Preview.
4. Voeg een app-waarde voor de gewenste instelling toe of werk deze bij.
5. Sla de app op en publiceer deze.

Een app-waarde van een instelling verwijderen met behulp van de app-ontwerper

1. Open de app waaruit u de app-waarde wilt verwijderen in de app-ontwerper.
2. Selecteer Instellingen op de opdrachtbalk.
3. Selecteer in het dialoogvenster Instellingen het tabblad Functies of Aanstaand.
4. Selecteer Opnieuw instellen naar omgevingswaarde naast de app-waarde van de instelling die u wilt verwijderen. Hierdoor valt de instellingswaarde terug naar de instellingsomgevingswaarde, indien aanwezig. Als er geen omgevingswaarde is, gaat de instellingswaarde terug op de standaardwaarde.
   De optie Opnieuw instellen naar omgevingswaarde wordt alleen weergegeven als er eerder een app-waarde voor die instelling is toegevoegd.
5. Sla de app op en publiceer deze.

Een app-waarde van een instelling toevoegen of bijwerken met behulp van de oplossingsverkenner

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waaraan u de app-waarde voor de instelling wilt toevoegen.
4. Als de instellingsdefinitie of instellingsomgevingswaarde niet beschikbaar is in de oplossing, voegt u er een toe. Ga naar Een bestaande instellingsdefinitie toevoegen of Een bestaande omgevingswaarde voor de instelling toevoegen.
5. Selecteer de instellingsdefinitie of instellingsomgevingswaarde.
6. Zoek in het dialoogvenster Instellingswaarde bewerken in de sectie App-waarden instellen naar de app waarvoor u de app-instellingswaarde wilt toevoegen. Houd er rekening mee dat u met de oplossingsverkenner alleen app-instellingen kunt toevoegen voor apps die zich in de huidige oplossing bevinden.
7. Geef de waarde op en selecteer Opslaan.
8. Om de app-waarde van de instelling van kracht te laten worden, moet u de app opnieuw publiceren met behulp van de app-ontwerper of oplossingsverkenner.

Een app-waarde van een instelling verwijderen met behulp van de oplossingsverkenner

1. Meld u aan bij Power Apps.
2. Selecteer in het navigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
3. Ga naar de lijst met oplossingen en open de oplossing waaruit u de app-waarde voor de instelling wilt verwijderen.
4. Als de instellingsdefinitie of instellingsomgevingswaarde niet beschikbaar is in de oplossing, voegt u er een toe. Meer informatie: Een bestaande instellingsdefinitie toevoegen of Een bestaande omgevingswaarde voor de instelling toevoegen.
5. Selecteer de instellingsdefinitie of instellingsomgevingswaarde.
6. Zoek in het dialoogvenster Instellingswaarde bewerken in de sectie App-waarden instellen naar de app waarvoor u de app-instellingswaarde wilt verwijderen. Houd er rekening mee dat u met de oplossingsverkenner alleen app-instellingen kunt verwijderen voor apps die zich in de huidige oplossing bevinden.
7. Selecteer ... naast de app-waarde van de instelling en selecteer Opnieuw instellen naar omgeving.
8. Selecteer Save.
9. Om de app-waarde van de instelling te verwijderen, moet u de app opnieuw publiceren met behulp van de app-ontwerper of oplossingsverkenner.

Een instellingswaarde verkrijgen of bijwerken via code

Ga voor de beschikbare methoden naar Een instellingswaarde ophalen of bijwerken met client-API.

Zie ook

Voor ontwikkelaars:

• Functie RetrieveSetting
• Actie SaveSettingValue