Usar configurações para fornecer experiências de aplicativo personalizadas

As configurações são componentes da solução que permitem que criadores e administradores configurem aplicativos rapidamente para fornecer uma experiência personalizada. As configurações podem ser usadas para habilitar ou desabilitar recursos, ou configurar o comportamento dos recursos para um único aplicativo ou todos os aplicativos em um ambiente.

As configurações são compostas por três subcomponentes: definição de configuração, valor do ambiente de configuração e valor do aplicativo de configuração.

Subcomponente	Descrição
Definição de configuração	Os autores, administradores ou parceiros de aplicativos podem criar uma definição de configuração que inclui propriedades como nome, descrição, tipo de dados, valor padrão e muito mais. Eles podem então, por meio de código, usar o valor da configuração para habilitar ou desabilitar ou configurar o recurso que estão entregando. Eles podem incluir a definição de configuração na solução que é usada para entregar o recurso a seus clientes. Exemplo: O Manipulador de salvamento assíncrono para aplicativos baseados em modelo é um recurso do Power Apps que usa configurações. A configuração é do tipo Sim/Não e o valor padrão dessa configuração é Não. Portanto, por padrão, o recurso Manipulador de salvamento assíncrono será desabilitado para todos os aplicativos baseados em modelo.
Valor do ambiente de configuração	Um valor do ambiente de configuração pode ser usado para substituir o valor padrão, conforme especificado na definição de configuração. Exemplo: Estendendo o exemplo acima, um administrador de ambiente na organização de um cliente pode adicionar um valor do ambiente de configuração para a configuração Manipulador de salvamento assíncrono e defini-lo como Sim. Esse valor do ambiente de configuração substituirá o valor padrão e se aplicará a todos os aplicativos nesse ambiente. Isso habilitará o recurso Manipulador de salvamento assíncrono para todos os aplicativos baseados em modelos nesse ambiente.
Valor de aplicativo de configuração	Um valor do aplicativo de configuração pode ser usado para substituir o valor padrão, conforme especificado na definição de configuração e no valor do ambiente de configuração (se existir). Exemplo: Mais uma vez, estendendo o exemplo acima, um autor de aplicativo no mesmo ambiente acima pode adicionar um valor do aplicativo de configuração ao Manipulador de salvamento assíncrono para um aplicativo que ele esteja criando e pode defini-lo como Não Esse valor do aplicativo de configuração substituirá o valor do ambiente de configuração e se aplicará apenas a esse único aplicativo. Isso habilitará o recurso Manipulador de salvamento assíncrono para esse único aplicativo.

Observação

Para seguir as etapas listadas abaixo, você precisará ter a Visualização da solução ativada. Na área Soluções do Power Apps, na barra de comando, certifique-se de ter Visualização da solução ativada. Se Visualização da solução desativada for exibido, selecione a opção para ativar a visualização. Mais informações: Exibição da solução

Definição de configuração

Uma definição de configuração especifica as propriedades básicas de uma configuração. A lista completa de propriedades que podem ser configuradas em uma definição de configuração está listada abaixo. Algumas dessas propriedades não poderão ser alteradas após a criação da configuração.

Propriedade	Descrição
Nome de exibição	O nome exibido aos consumidores da configuração em todas as interfaces de usuário onde as configurações são exibidas.
Nome	O nome exclusivo da configuração em um ambiente. O nome é gerado automaticamente com base no nome de exibição fornecido, mas pode ser alterado antes que a configuração seja criada. Depois que uma configuração for criada, o Nome não poderá ser alterado, pois poderá ser referenciado em aplicativos ou código. Nome tem um prefixo que corresponde ao editor da solução. Esse prefixo tem como objetivo dar à configuração um nome exclusivo se você quiser importá-la para outra solução ou ambiente no futuro (que teria um prefixo diferente).
Descrição	A descrição ajuda outras pessoas a entender para que a configuração é usada em todas as interfaces de usuário onde as configurações são exibidas.
Tipo de dados	O tipo de dados de uma configuração controla como o valor da configuração é armazenado. O tipo de dados pode ser definido como Número, Cadeia de Caracteres ou Sim/Não. O tipo de dados não poderá ser alterado após a criação da configuração.
Valor padrão	O valor padrão fica disponível depois que você seleciona um Tipo de dados. Ele valor da configuração que será usado, a menos que seja substituído por um valor de ambiente de configuração ou um valor de aplicativo de configuração.
O valor pode ser alterado para	Uma configuração pode ser substituída em um dos seguintes níveis: Ambiente e aplicativo permite que o valor do ambiente de configuração e os valores de aplicativo de configuração substituam o valor padrão. Somente ambiente permite que somente o valor do ambiente de configuração substitua o valor padrão. Somente aplicativo permite que somente valores de aplicativo substituam o valor padrão. Nenhum, a configuração não pode ser substituída.
Nível da versão	O nível de versão é usado para informar a estrutura e outros consumidores da configuração sobre o estado do recurso com o qual a configuração é usada. O nível de versão pode ser definido como Geralmente disponível ou Versão preliminar.
URL para as Informações	Um link para a documentação para ajudar os consumidores da configuração a entender a finalidade da configuração. Será usado como um link Saber mais em todas as interfaces do usuário onde as configurações são exibidas.

Adição de uma nova definição de configuração

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução à qual deseja adicionar a configuração.
4. Na barra de comandos, selecione Novo> Mais> Configuração > Definição de configuração.
5. No diálogo Nova configuração, forneça valores para cada uma das propriedades com base em seus requisitos. Para obter informações sobre como definir propriedades de definição, acesse: Definição de configuração
6. Quando você terminar de fornecer valores para as propriedades, selecione Salvar.

Adição de uma definição de configuração existente

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução à qual deseja adicionar a configuração.
4. Na barra de comandos, selecione Adicionar existente > Mais > Configuração.
5. No diálogo Adicionar definição de configuração existente, selecione uma ou mais configurações que deseja adicionar.
6. Quando terminar de selecionar as configurações, escolha Avançar
7. No diálogo Definição de configuração selecionada, para cada configuração que selecionou, você terá a opção de Incluir definição de configuração. Você também pode Incluir o valor do ambiente de configuração para cada configuração, se houver.
8. Selecione Adicionar para adicionar a definição de configuração e/ou valores do ambiente de configuração.

Atualização de uma definição de configuração

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução em que você criou a configuração.
4. Na exibição em árvore, selecione Configurações> Definições de configuração.
5. Selecione a definição de configuração que você deseja atualizar.
6. No diálogo Editar configuração, atualize os valores de qualquer uma das propriedades que deseja alterar.
   Observe que algumas propriedades não poderão ser atualizadas após a criação de uma configuração. Além disso, na maioria dos casos, você não poderá atualizar as definições de configurações que não sejam suas.
7. Quando você terminar de atualizar os valores para as propriedades, selecione Salvar.

Remoção de uma definição de configuração

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução em que você criou a configuração ou à qual adicionou uma.
4. Na exibição em árvore, selecione Configurações> Definições de configuração.
5. Selecione a definição de configuração que você deseja remover.
6. Na barra de comandos, selecione Remover > Remover desta solução.
   Remover desta solução remove a definição de configuração da solução atual, mas ela continuará a fazer parte da solução padrão ou de qualquer outra solução à qual foi adicionada.

Exclusão de uma definição de configuração

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução em que você criou a configuração ou à qual adicionou uma.
4. Na exibição em árvore, selecione Configurações> Definições de configuração.
5. Selecione a definição de configuração que você deseja excluir.
6. Na barra de comandos, selecione Remover > Excluir deste ambiente.
   Excluir deste ambiente exclui a definição de configuração do ambiente atual e ela não fará mais parte de nenhuma solução nesse ambiente. Você só pode excluir definições de configuração de sua propriedade.

Valor do ambiente de configuração

Um valor do ambiente de configuração é usado para substituir o valor padrão da configuração para todos os aplicativos em um ambiente. Use um valor do ambiente de configuração quando o valor padrão da configuração não for o que você deseja usar para aplicativos em seu ambiente.

Adição de um novo valor do ambiente de configuração

1. Entrar no Power Apps.

2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.

3. Na lista de soluções, abra a solução à qual deseja adicionar o valor do ambiente de configuração.

4. Se a definição de configuração estiver disponível na solução:

   1. Selecione a definição de configuração.
   2. No diálogo Editar valor da configuração, na seção Valor do ambiente de configuração, selecione Novo valor.
   3. Forneça o valor e selecione Salvar.

   Se a definição de configuração não estiver disponível na solução:

   1. Na barra de comandos, selecione Novo> Mais> Configuração > Valor do ambiente de configuração.
   2. Selecione a configuração ao qual você deseja adicionar o valor do ambiente de configuração e, em seguida, selecione Adicionar.
   3. No diálogo Novo valor do ambiente de configuração, na seção Valor do ambiente de configuração, selecione Novo valor.
   4. Forneça o valor e selecione Salvar.

Adição de um valor de ambiente de configuração existente

1. Entrar no Power Apps.

2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.

3. Na lista de soluções, abra a solução à qual deseja adicionar o valor do ambiente de configuração.

4. Se a definição de configuração estiver disponível na solução:

   1. Selecione a definição de configuração.
   2. No diálogo Editar valor da configuração, na seção Valor do ambiente de configuração, selecione Adicionar valor existente.
   3. Atualize o valor se necessário e, em seguida, selecione Salvar.

   Se a definição de configuração não estiver disponível na solução:

   1. Na barra de comandos, selecione Adicionar existente > Mais > Configuração.
   2. No diálogo Adicionar definição de configuração existente, selecione uma ou mais configurações às quais deseja adicionar valores do ambiente de configuração.
   3. Quando terminar de selecionar as configurações, escolha Avançar
   4. No diálogo Definição de configuração selecionada, para cada configuração que selecionou, você terá a opção de Incluir valor do ambiente de configuração, se existir. Você também pode Incluir a definição de configuração para cada configuração, se quiser.
   5. Selecione Adicionar para adicionar os valores do ambiente de configuração e/ou definições de configuração.

Atualização de um valor do ambiente de configuração existente

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução à qual você adicionou o valor do ambiente de configurações.
4. Na exibição em árvore, selecione Configurações > Valores do ambiente de configuração.
5. Selecione o valor do ambiente de configuração que você deseja atualizar.
6. No diálogo Editar configuração, na seção Valor do ambiente de configuração, atualize o valor e, em seguida, selecione Salvar.

Remoção de um valor do ambiente de configuração

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução em que você criou a configuração ou à qual adicionou uma.
4. Na exibição em árvore, selecione Configurações > Valores do ambiente de configuração.
5. Selecione o valor do ambiente de configuração que você deseja remover.
6. Na barra de comandos, selecione Remover > Remover desta solução.
   Remover desta solução remove o valor do ambiente de configuração da solução atual, mas ele continuará a fazer parte da solução padrão ou de qualquer outra solução à qual foi adicionado.

Exclusão de um valor do ambiente de configuração

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução em que você criou a configuração ou à qual adicionou uma.
4. Na exibição em árvore, selecione Configurações > Valores do ambiente de configuração.
5. Selecione o valor do ambiente de configuração que você deseja excluir.
6. Na barra de comandos, selecione Remover > Excluir deste ambiente.
   Excluir deste ambiente exclui o valor do ambiente de configuração do ambiente atual e ele não fará mais parte de nenhuma solução nesse ambiente.

Valor do aplicativo de configuração

O valor do aplicativo de configuração é usado para substituir o valor padrão da configuração e qualquer valor do ambiente de configuração para um aplicativo único. Use um valor do aplicativo de configuração quando o valor do ambiente de configuração não for o que você deseja usar para seu aplicativo. Se valor do ambiente de configuração não existir, use um valor do aplicativo de configuração quando o valor padrão da configuração não for o que você deseja usar para seu aplicativo.

Observação

Para seguir as etapas listadas abaixo, você precisará usar o novo designer de aplicativo. Atualmente, o designer de aplicativo exibe apenas configurações da plataforma do Power Apps. Para configurações fora da plataforma, use o gerenciador de soluções conforme descrito abaixo.

Adição ou atualização de um valor do aplicativo de configuração usando o designer de aplicativo

1. Abra o aplicativo ao qual deseja adicionar o valor do aplicativo de configuração no designer de aplicativo.
2. Na barra de comandos, selecione Configurações.
3. No diálogo Configurações, selecione a guia Recursos ou Futuros.
   A guia Recursos exibe todas as configurações com o nível de versão definido como Geralmente disponível. A guia Futuros exibe todas as configurações com o nível de versão definido como Versão preliminar.
4. Adicione ou atualize um valor do aplicativo para a configuração desejada.
5. Salve e publique o aplicativo.

Exclusão de um valor do aplicativo de configuração usando o designer de aplicativo

1. Abra o aplicativo do qual deseja remover o valor do aplicativo de configuração no designer de aplicativo.
2. Na barra de comandos, selecione Configurações.
3. No diálogo Configurações, selecione a guia Recursos ou Futuros.
4. Selecione Redefinir para valor do ambiente ao lado do valor do aplicativo de configuração que você deseja excluir. Isso fará com que o valor da configuração volte ao valor do ambiente de configuração, se houver. Se não houver um valor do ambiente de configuração, ele fará fallback para o valor padrão da configuração.
   Observe que a opção de Redefinir para o valor do ambiente só será exibida se um valor do aplicativo de configuração tiver sido adicionado anteriormente a essa configuração.
5. Salve e publique o aplicativo.

Adição ou atualização de um valor do aplicativo de configuração usando o gerenciador de soluções

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução à qual deseja adicionar o valor do aplicativo de configuração.
4. Se a definição de configuração ou o valor do ambiente de configuração não estiverem disponíveis na solução, adicione um deles. Acesse Adição de uma definição de configuração existente ou Adição de um valor do ambiente de configuração existente.
5. Selecione a definição de configuração ou o valor do ambiente de configuração.
6. No diálogo Editar valor da configuração, na seção Valores do aplicativo de configuração, encontre o aplicativo ao qual deseja adicionar o valor do aplicativo de configuração. Observe que, usando o gerenciador de soluções, você só poderá adicionar valores do aplicativo de configuração para aplicativos na solução atual.
7. Forneça o valor e selecione Salvar.
8. Para que o valor do aplicativo de configuração entre em vigor, você terá que republicar o aplicativo usando o designer de aplicativo ou gerenciador de soluções.

Exclusão de um valor do aplicativo de configuração usando o gerenciador de soluções

1. Entrar no Power Apps.
2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Na lista de soluções, abra a solução da qual deseja excluir o valor do aplicativo de configuração.
4. Se a definição de configuração ou o valor do ambiente de configuração não estiverem disponíveis na solução, adicione um deles. Mais informações: Adição de uma definição de configuração existente ou Adição de um valor do ambiente de configuração existente.
5. Selecione a definição de configuração ou o valor do ambiente de configuração.
6. No diálogo Editar valor da configuração, na seção Valores do aplicativo de configuração, encontre o aplicativo do qual deseja excluir o valor do aplicativo de configuração. Observe que, usando o explorador de soluções, você só poderá remover os valores do aplicativo de configuração para aplicativos na solução atual.
7. Selecione ... ao lado do valor do aplicativo de configuração e, em seguida, Redefinir para ambiente.
8. Selecione Salvar.
9. Para que a exclusão do valor do aplicativo de configuração entre em vigor, você terá que republicar o aplicativo usando o designer de aplicativo ou gerenciador de soluções.

Obtenção ou atualização de um valor de configuração por meio de código

Para os métodos disponíveis, acesse Obter ou atualizar um valor de configuração usando a API do cliente.

Confira também

Para desenvolvedores:

• Função RetrieveSetting
• Ação SaveSettingValue