Compartilhar via

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

As configurações são componentes de solução que permitem aos criadores e administradores configurar rapidamente aplicativos para fornecer uma experiência personalizada. As configurações podem ser usadas para habilitar ou desabilitar recursos ou configurar o comportamento de 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, definição do valor do ambiente e definição do valor do aplicativo.

Subcomponente Description
Definição de configuração
  • Autores de aplicativos, administradores ou parceiros podem criar uma definição de configuração que inclui propriedades como nome, descrição, tipo de dados, valor padrão e muito mais.
  • Em seguida, eles podem, por meio do código, usar o valor da configuração para habilitar ou desabilitar ou configurar o recurso que estão fornecendo.
  • Eles podem incluir a definição de configuração na solução usada para entregar o recurso aos clientes.
  • Exemplo:
    • O manipulador de salvamento assíncrono para aplicativos controlados por modelos é 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 de manipulador de salvamento assíncrono será desabilitado para todos os aplicativos controlados por modelos.
Definindo o valor do ambiente
  • Um valor de 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 de ambiente de configuração para a configuração de manipulador de salvamento assíncrono e defini-lo como Sim.
    • Esse valor de ambiente de configuração substituirá o valor padrão e será aplicado a todos os aplicativos nesse ambiente.
    • Isso habilitará o recurso de manipulador de salvamento assíncrono para todos os aplicativos controlados por modelos nesse ambiente.
Definindo o valor do aplicativo
  • Um valor de aplicativo de configuração pode ser usado para substituir o valor padrão, conforme especificado na definição de configuração e o valor de ambiente de configuração (se houver).
  • Exemplo:
    • Mais uma vez, ampliando o exemplo acima, um autor de aplicativo no mesmo ambiente pode adicionar um valor de configuração para a definição de manipulador de salvamento assíncrono para um aplicativo que está desenvolvendo e configurá-lo como Não
    • Esse valor de aplicativo de configuração substituirá o valor de ambiente de configuração e se aplicará somente a esse único aplicativo.
    • Isso habilitará o recurso de manipulador de salvamento assíncrono para esse único aplicativo.

Observação

Para seguir as etapas listadas abaixo, você precisa ter a visualização da solução. Na área Soluções no Power Apps, na barra de comandos, verifique se você tem a versão prévia da solução. Se a visualização da solução estiver desativada, selecione a opção para habilitar 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 base 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 podem ser alteradas após a criação da configuração.

Propriedade Description
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 é criada, o Nome não pode ser alterado, pois pode ser referenciado em aplicativos ou código.
O nome tem um prefixo que corresponde ao provedor da solução. Esse prefixo destina-se a 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 configuração é usada em todas as interfaces do usuário em que 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 pode ser alterado depois que a configuração é criada.
Valor padrão O valor padrão fica disponível depois que você seleciona um tipo de dados. Ele especifica o 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:
  • O ambiente e o aplicativo permitem que os valores do ambiente e do aplicativo sejam definidos para substituir o valor padrão.
  • Somente ambiente permite que somente o valor do ambiente de configuração substitua o valor padrão.
  • Modo aplicativo somente, permite definir somente valores do aplicativo para substituir o valor padrão.
  • Nenhum, a configuração não pode ser alterada.
Nível de liberaçã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 Disponibilidade Geral ou Versão Prévia.
URL de Informações Um link para a documentação que ajuda os consumidores a entenderem a finalidade da configuração. Será usado como um link Saiba mais em todas as interfaces do usuário em que as configurações são exibidas.

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

  1. Entre 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ê deseja adicionar a configuração.
  4. Na barra de comandos, selecione Novo > Mais > Configuração > Definição de configuração.
  5. Na caixa de 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 terminar de fornecer valores para as propriedades, selecione Salvar.

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

  1. Entre 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ê deseja adicionar a configuração.
  4. Na barra de comandos, selecione Adicionar configuração existente > Mais >.
  5. Na caixa de diálogo Adicionar definição de configuração existente , selecione uma ou mais configurações que você deseja adicionar.
  6. Quando terminar de selecionar as configurações, selecione Avançar
  7. Na caixa de diálogo Configuração Selecionada, para cada configuração selecionada, você terá a opção de Incluir a definição de configuração. Você também pode incluir o valor de ambiente configurado para cada configuração, se houver um.
  8. Selecione Adicionar para adicionar a definição de configuração e/ou definir valores de ambiente.

Atualizando uma definição de configuração

  1. Entre 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 na qual você criou a configuração.
  4. No modo de exibição de árvore, selecione Definições de Configurações>.
  5. Selecione a definição de configuração que você deseja atualizar.
  6. Na caixa de diálogo Editar configuração , atualize os valores de qualquer uma das propriedades que você deseja alterar.
    Observe que algumas propriedades não podem ser atualizadas após a criação de uma configuração. Além disso, na maioria dos casos, você não poderá atualizar definições de configurações que não possui.
  7. Quando terminar de atualizar os valores das propriedades, selecione Salvar.

Removendo uma definição de configuração

  1. Entre 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ê criou ou adicionou a configuração.
  4. No modo de exibição de árvore, selecione Definições de Configurações>.
  5. Selecione a definição de configuração que você deseja remover.
  6. Na barra de comandos, selecione Remover > Remover desta solução.
    Remover dessa 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.

Excluindo uma definição de configuração

  1. Entre 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ê criou ou adicionou a configuração.
  4. No modo de exibição de árvore, selecione Definições de Configurações>.
  5. Selecione a definição de configuração que você deseja excluir.
  6. Na barra de comandos, selecione Remover > Excluir deste ambiente.
    Excluir desse 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 que você possui.

Definindo o valor do ambiente

Um valor de ambiente de configuração é usado para substituir o valor padrão da configuração para todos os aplicativos em um ambiente. Use um valor de 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.

Adicionando um novo valor de ambiente de configuração

  1. Entre 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ê deseja adicionar o valor de configuração do ambiente.

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

    1. Selecione a definição de configuração.
    2. Na caixa de diálogo Editar valor de configuração , na seção Definir valor do ambiente , 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 para a qual você deseja adicionar o valor de ambiente de configuração e, em seguida, selecione Adicionar.
    3. Na caixa de diálogo Novo valor de ambiente de configuração , na seção Definir valor do ambiente , selecione Novo valor.
    4. Forneça o valor e selecione Salvar.

Adicionando um valor de ambiente de configuração existente

  1. Entre 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ê deseja adicionar o valor de configuração do ambiente.

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

    1. Selecione a definição de configuração.
    2. Na caixa de diálogo Editar valor de configuração , na seção Definir valor do ambiente , selecione Adicionar valor existente.
    3. Atualize o valor, se necessário, e selecione Salvar.

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

    1. Na barra de comandos, selecione Adicionar configuração existente > Mais > Configurações.
    2. Na caixa de diálogo Adicionar definição de configuração existente , selecione uma ou mais configurações para as quais você deseja adicionar valores de ambiente de configuração.
    3. Quando terminar de selecionar as configurações, selecione Avançar
    4. Na caixa de diálogo de definição da configuração selecionada, para cada configuração selecionada, você terá a opção de incluir valor de ambiente da configuração, se houver. Você também pode incluir a definição de configuração para cada configuração, se desejar.
    5. Selecione Adicionar para adicionar os valores de ambiente de configuração e/ou definições de configuração.

Atualizando um parâmetro de ambiente de configuração

  1. Entre 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. No modo de exibição de árvore, selecione Configurações > Definindo valores de ambiente.
  5. Selecione o valor de ambiente de configuração que você deseja atualizar.
  6. Na caixa de diálogo Editar configuração , na seção Definir valor do ambiente , atualize o valor e selecione Salvar.

Removendo um valor de configuração do ambiente

  1. Entre 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ê criou ou adicionou a configuração.
  4. No modo de exibição de árvore, selecione Configurações > Definindo valores de ambiente.
  5. Selecione o valor de 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.

Excluindo um valor de ambiente de configuração

  1. Entre 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ê criou ou adicionou a configuração.
  4. No modo de exibição de árvore, selecione Configurações > Definindo valores de ambiente.
  5. Selecione o valor de ambiente de configuração que você deseja excluir.
  6. Na barra de comandos, selecione Remover > Excluir deste ambiente.
    Excluir deste ambiente remove o valor do parâmetro de configuração do ambiente atual, fazendo com que ele não seja mais parte de nenhuma solução nesse ambiente.

Definindo o valor do aplicativo

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 de configuração do aplicativo quando o valor do ambiente de configuração não for o que você deseja usar para o seu aplicativo. Se um valor de ambiente de configuração não existir, use um valor de 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ê precisa usar o novo designer de aplicativo. Atualmente, o designer de aplicativos exibe apenas as configurações da plataforma power apps. Para configurações que não são de plataforma, use o gerenciador de soluções, conforme descrito abaixo.

Adicionando ou atualizando um valor de configuração de aplicativo 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. Na caixa de diálogo Configurações , selecione a guia Recursos ou Próximos .
    A guia Recursos exibe todas as configurações que têm 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 de aplicativo para a configuração desejada.
  5. Salve e publique o aplicativo.

Excluindo um valor de configuração do aplicativo usando o designer de aplicativos

  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. Na caixa de diálogo Configurações , selecione a guia Recursos ou Próximos .
  4. Selecione Redefinir para o valor do ambiente ao lado do valor do aplicativo de configuração que você deseja excluir. Isso faz com que o valor de configuração retorne ao valor do ambiente de configuração, se existir um. Se nenhum valor de ambiente de configuração existir, ele retornará ao valor padrão da configuração.
    Observe que a opção para Redefinir para o valor do ambiente só será exibida se um valor do aplicativo de configuração foi adicionado anteriormente para essa configuração.
  5. Salve e publique o aplicativo.

Adicionando ou atualizando um valor de configuração do aplicativo usando o gerenciador de soluções

  1. Entre 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 estiver disponível na solução, adicione um deles. Vá para Adicionar uma definição de configuração existente ou adicionando um valor de ambiente de configuração existente.
  5. Selecione a definição de configuração ou o valor do ambiente de configuração.
  6. Na caixa de diálogo Editar valor de configuração , na seção Definir valores do aplicativo , localize o aplicativo para o qual você deseja adicionar o valor do aplicativo de configuração. Observe que, usando o Solution Explorer, você só pode adicionar valores de configuração do aplicativo para aplicativos que estão 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.

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

  1. Entre 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 estiver disponível na solução, adicione um deles. Mais informações: adicionando uma definição de configuração existente ou adicionando um valor de ambiente de configuração existente.
  5. Selecione a definição de configuração ou o valor do ambiente de configuração.
  6. Na caixa de diálogo Editar valor de configuração , na seção Configuração de valores do aplicativo , localize o aplicativo para o qual você deseja excluir o valor do aplicativo de configuração. Observe que, usando o gerenciador de soluções, você só pode remover a configuração de valores de aplicativo para aplicativos que estão na solução atual.
  7. Selecione ... ao lado do valor do aplicativo de configuração e selecione Redefinir para o ambiente.
  8. Clique em Salvar.
  9. Para que a exclusão do valor de configuração do aplicativo entre em vigor, você precisará republicar o aplicativo usando o designer de aplicativos ou o gerenciador de soluções.

Obtendo ou atualizando um valor de configuração por meio do código

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

Consulte também

Para desenvolvedores:

  • Last updated on