Partilhar via

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

As configurações são componentes de 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 de recursos para um único aplicativo ou todos os aplicativos em um ambiente.

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

Subcomponente Description
Definição de configuração
  • Os autores, administradores ou parceiros de aplicativos podem criar uma definição de configuração que inclua propriedades como nome, descrição, tipo de dados, valor padrão e muito mais.
  • Eles podem, então, via código, usar o valor da configuração para ativar, desabilitar ou configurar o recurso que estão entregando.
  • Eles podem incluir a definição de configuração na solução usada para fornecer o recurso aos clientes.
  • Exemplo:
    • O manipulador de salvamento assíncrono para aplicativos controlados por 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 de manipulador de salvamento assíncrono será desabilitado para todos os aplicativos controlados por modelo.
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 do 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 modelo 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 do ambiente de configuração (se existir).
  • Exemplo:
    • Mais uma vez, estendendo o exemplo acima, um autor de aplicativo no mesmo ambiente pode adicionar um valor de configuração de aplicativo para a configuração do manipulador de salvamento assíncrono e defini-lo como Não
    • Esse valor de aplicativo de configuração substituirá o valor do 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 ativada. Na área Soluções no Power Apps, na barra de comandos, certifique-se de que tem a Pré-visualização da Solução ativada. Se vista prévia da solução desativada for exibida, selecione a opção para ativar a pré-visualização. Para obter mais informações: Visualização da solução

Definição de definiçã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 depois que a configuração é criada.

Propriedade Description
Nome de exibição O nome apresentado aos consumidores da definição em todas as interfaces de utilizador onde as definições são apresentadas.
Nome O nome exclusivo da definição num 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.
Name tem um prefixo que corresponde ao publicador da solução. Esse prefixo destina-se a dar à configuração um nome exclusivo se você quiser importá-los 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 pode ser alterado após a criação da configuração.
Valor predefinido 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:
  • Ambiente e aplicativo, permite que o valor do ambiente de configuração e os valores do aplicativo de configuração substituam o valor padrão.
  • Apenas ambiente, permite apenas que o valor do ambiente de definição substitua o valor predefinido.
  • Somente aplicativo, permite apenas a configuração de valores do aplicativo para substituir o valor padrão.
  • Nenhum, a configuração não pode ser alterada.
Nível de lançamento O nível de liberaçã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 Pré-visualização.
URL de Informação Uma ligação para a documentação para ajudar os consumidores da definição a compreenderem a finalidade da definição. Será usado como um link Saiba mais em todas as interfaces de usuário onde as configurações são exibidas.

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

  1. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução à qual deseja adicionar a configuração.
  4. Na barra de comando, selecione Nova > Mais > Definição > Definição da definiçã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, vá para: Definindo definição
  6. Quando terminar de fornecer valores para as propriedades, selecione Salvar.

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

  1. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução à qual deseja adicionar a configuração.
  4. Na barra de comando, selecione Adicionar existente > Mais > Definição.
  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 Definição de configuração selecionada , para cada configuração selecionada, você terá a opção de Incluir definição de configuração. Também pode Incluir o valor do ambiente de definição para cada definição, se existir 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. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução na qual você criou a configuração.
  4. Na vista em árvore, selecione Configurações > definições de configuração.
  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 as definições de configurações que não lhe pertencem.
  7. Quando terminar de atualizar os valores das propriedades, selecione Salvar.

Removendo uma definição de configuração

  1. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução que criou ou à qual adicionou a definição.
  4. Na vista em árvore, selecione Configurações > Definições de configurações.
  5. Selecione a definição de configuração que deseja remover.
  6. Na barra de comando, selecione Remover > Remover desta solução.
    Remover desta solução remove a definição de configuração da solução atual, mas 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. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução que criou ou à qual adicionou a definição.
  4. Na vista em árvore, selecione Definições > de configurações.
  5. Selecione a definição de configuração que deseja excluir.
  6. Na barra de comandos, selecione Remover > Apagar deste ambiente.
    Excluir desse ambiente exclui a definição de configuração do ambiente atual e não fará mais parte de nenhuma solução nesse ambiente. Você só pode excluir definições de configuração que estão em sua posse.

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 que seja usado para aplicativos em seu ambiente.

Adicionando um novo valor de ambiente de configuração

  1. Inicie sessão no Power Apps.

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

  3. Na lista de soluções, abra a solução à qual pretende adicionar o valor de definiçã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 da configuração , na seção Definindo 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 comando, selecione Nova > Mais > Definição > Valor de definição do ambiente.
    2. Selecione a configuração para a qual deseja adicionar o valor do ambiente de configuração e selecione Adicionar.
    3. Na caixa de 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.

Adicionando um valor de ambiente de configuração existente

  1. Inicie sessão no Power Apps.

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

  3. Na lista de soluções, abra a solução à qual pretende adicionar o valor de definiçã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 da configuração , na seção Definindo 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 comando, selecione Adicionar existente > Mais > Definição.
    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 Definição de configuração selecionada , para cada configuração selecionada, você terá a opção de Incluir valor do ambiente de configuração, se existir. Você também pode incluir 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 valor de ambiente de configuração

  1. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução à qual adicionou o valor de definições do ambiente.
  4. Na vista em árvore, selecione Definições > Definindo valores de ambiente.
  5. Selecione o valor do ambiente de configuração que você deseja atualizar.
  6. Na caixa de diálogo Editar configuração , na seção Definindo valor do ambiente , atualize o valor e selecione Salvar.

Removendo um valor de variável de ambiente de configuração

  1. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução que criou ou à qual adicionou a configuração.
  4. Na vista em árvore, selecione Definições > Definindo valores de ambiente.
  5. Selecione o valor do ambiente de configuração que deseja remover.
  6. Na barra de comandos, selecione Remover > Remover desta solução.
    Remover desta solução remove o valor de definição do ambiente da solução atual, mas continuará a ser uma parte da solução predefinida ou qualquer outra solução a que tenha sido adicionada.

Eliminar um valor da variável de ambiente de configuração

  1. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução que criou ou à qual adicionou a definição.
  4. Na vista em árvore, selecione Definições > Definindo valores de ambiente.
  5. Selecione o valor do ambiente de configuração que você deseja excluir.
  6. Na barra de comandos, selecione Remover > Eliminar deste ambiente.
    Eliminar deste ambiente elimina o valor do ambiente da definição do ambiente atual e deixará de fazer parte de quaisquer soluções nesse ambiente.

Definindo o valor do aplicativo

O valor de definição da aplicação é utilizado para substituir o valor predefinido da definição e qualquer valor de definição do ambiente para uma única aplicação. Utilize um valor de definição da aplicação quando o valor de definição do ambiente não é o que pretende utilizar para a sua aplicação. Se não existir um valor de ambiente de configuração, use um valor de aplicativo de configuração quando o valor padrão da configuração não for o que você deseja que seja usado 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 fora da plataforma, use o gerenciador de soluções conforme descrito abaixo.

Adicionar ou atualizar um valor de configuração de aplicativo usando o designer de aplicativos

  1. Abra a aplicação à qual pretende adicionar o valor de definição da aplicação no estruturador de aplicações.
  2. Na barra de comandos, selecione Configurações.
  3. Na caixa de diálogo Configurações , selecione a guia Recursos ou Futuros .
    A guia Recursos exibe todas as configurações que têm o nível de liberação definido como Geralmente disponível. A guia Próximos exibe todas as configurações que têm o nível de liberação definido como Visualização.
  4. Adicione ou atualize um valor de aplicativo para a configuração desejada.
  5. Salve e publique o aplicativo.

Eliminar um valor de uma opção de aplicação utilizando o designer de aplicações

  1. Abra a aplicação da qual pretende remover o valor de definição da aplicação no estruturador de aplicações.
  2. Na barra de comandos, selecione Configurações.
  3. Na caixa de diálogo Configurações , selecione a guia Recursos ou Futuros .
  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 da configuração retorne ao valor do ambiente de configuração, se existir. Se nenhum valor de ambiente de configuração existir, ele retornará ao valor padrão da configuração.
    Observe que a opção Redefinir para o valor do ambiente só será exibida se um valor de aplicativo de configuração tiver sido adicionado anteriormente para essa configuração.
  5. Salve e publique o aplicativo.

Adicionar ou atualizar um valor de definição da aplicação utilizando o explorador de soluções

  1. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução à qual pretende adicionar o valor de definição da aplicaçã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 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 da configuração , na seção Definindo valores do aplicativo , localize o aplicativo ao qual você deseja adicionar o valor do aplicativo de configuração. Observe que, usando o explorador de soluções, pode-se apenas adicionar valores de configuração da aplicação para aplicações que estão na solução atual.
  7. Forneça o valor e selecione Salvar.
  8. Para que o valor de definição da aplicação entre em vigor, terá de voltar a publicar a aplicação utilizando o estruturador de aplicações ou o explorador de soluções.

Excluindo um valor da aplicação de configuração usando o Explorador de Soluções

  1. Inicie sessão no Power Apps.
  2. No painel de navegação, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Na lista de soluções, abra a solução da qual pretende eliminar o valor de definição da aplicaçã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. Para obter 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 da configuração , na seção Definindo 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, em seguida, selecione Redefinir para o ambiente.
  8. Selecione Guardar.
  9. Para que a exclusão do valor da configuração do aplicativo surta efeito, você terá que publicar novamente o aplicativo usando o designer de aplicações ou o explorador de soluções.

Obter ou atualizar um valor de configuração através do código

Para obter 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