Utilizar definições para fornecer experiências de aplicação personalizadas

As definições são componentes de solução que permitem que os criadores e administradores configurem rapidamente aplicações para proporcionar uma experiência personalizada. As definições podem ser utilizadas para ativar ou desativar funcionalidades ou configurar o comportamento de funcionalidades para uma única aplicação ou para todas as aplicações dentro de 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	Descrição
Definição de definição	Os autores, administradores ou parceiros de aplicações podem criar uma explicação de definição que inclua propriedades, tais como name, description, data type, default value e muito mais. Podem então, através de código, utilizar o valor da definição para ativar ou desativar ou configurar a funcionalidade que estão a fornecer. Podem incluir a definição de definição na solução que é usada para entregar a funcionalidade aos seus clientes. Exemplo: O Processador de guardar de forma assíncrona para aplicações condicionadas por modelo é uma funcionalidade do Power Apps que utiliza definições. A definição é do tipo Sim/Não e o valor predefinido desta definição é Não. Portanto, por predefinição, a funcionalidade Processador de guardar de forma assíncrona será desativada para todas as aplicações condicionadas por modelo.
Valor de definição do ambiente	Um valor ambiente de definição pode ser usado para substituir o valor predefinido, conforme especificado na definição de definição. Exemplo: Estendendo o exemplo acima, um administrador de administrador na organização de um cliente pode adicionar um valor de definição do ambiente para a definição Processador de guardar de forma assíncrona e defini-lo para Sim. Este valor de definição do ambiente irá substituir o valor predefinido e aplicar-se-á a todas as aplicações nesse ambiente. Isto irá ativar a funcionalidade Processador de guardar de forma assíncrona para todas as aplicações condicionadas por modelo nesse ambiente.
Valor de definição da aplicação	Um valor aplicação de definição pode ser usado para substituir o valor predefinido, conforme especificado na definição de definição e o valor do ambiente de definição (se existir um). Exemplo: Mais uma vez, estendendo o exemplo acima, um autor de aplicação no mesmo ambiente acima, pode adicionar um valor de definição da aplicação para a definição Processador de guardar de forma assíncrona para uma aplicação que está a criar e defini-la como Não Este valor de definição da aplicação irá substituir o valor do ambiente de definição e aplicar-se-á apenas a essa aplicação única. Isto irá ativar a funcionalidade Processador de guardar de forma assíncrona para essa aplicação única.

Nota

Para seguir os passos listados abaixo, é necessário que tenha a Pré-visualização da solução ativada. A partir da área Soluções no Power Apps, na barra de comandos, certifique-se de que tem a Pré-visualização da solução ativada. Se Pré-visualização da solução desativa for apresentado, selecione a opção para ativar a pré-visualização. Mais informações: Vista da solução

Definição de definição

Uma definição de definição especifica as propriedades base de uma definição. A lista completa de propriedades que podem ser configuradas numa definição de definição são listadas abaixo. Algumas destas propriedades não podem ser alteradas após a definição ser criada.

Property	Descrição
Nome a apresentar	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 a apresentar fornecido, mas pode ser alterado antes da definição ser criada. Assim que a definição é criada, não é possível alterar o Nome, uma vez que esta pode ser referenciada nas suas aplicações ou código. O Nome tem um prefixo que corresponde ao editor da solução. Este prefixo destina-se a dar à definição um nome exclusivo se quiser importá-las para outra solução ou ambiente no futuro (que teria um prefixo diferente).
Descrição	A descrição ajuda os outros a entender para que é usada a definição em todas as interfaces de utilizador onde as definições são apresentadas.
Tipo de dados	O tipo de dados de uma definição controla a forma como o valor da definição é armazenado. O tipo de dados pode ser definido como Número, Cadeia ou Sim/Não. O tipo de dados não pode ser alterado depois da definição ser criada.
Valor predefinido	O valor predefinido fica disponível depois de selecionar um Tipo de dados. Especifica o valor da definição que será utilizado a menos que seja ultrapassado por um valor de definição do ambiente ou um valor de definição da aplicação.
O valor pode ser alterado para	A definição pode ser substituída em um dos seguintes níveis: Ambiente e aplicação, permite que tanto o valor do ambiente de definição como os valores de aplicação de definição substituam o valor predefinido. Apenas ambiente, permite apenas que o valor do ambiente de definição substitua o valor predefinido. Apenas aplicação, permite apenas que os valores da aplicação de definição substituam o valor predefinido. Nenhum, a definição não pode ser substituída.
Nível da versão	O nível da versão é utilizado para informar a arquitetura e outros consumidores sobre o estado da funcionalidade com que a definição é utilizada. O nível da versão pode ser definido como Geralmente disponível ou Pré-visualização.
URL de Informações	Uma ligação para a documentação para ajudar os consumidores da definição a compreenderem a finalidade da definição. Será utilizado como uma ligação Saber mais em todas as interfaces de utilizador onde as definições são apresentadas.

Adicionar uma nova definição de definição

1. Inicie sessão no Power Apps.
2. No painel de navegação esquerdo, 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 a definição.
4. Na barra de comandos, selecione Nova > Mais > Definição > Definição de definição.
5. No diálogo Nova definição, forneça valores para cada uma das propriedades com base nos seus requisitos. Para obter informações sobre as propriedades da definição de definição, aceda a: Definição de definição
6. Quando terminar de fornecer valores para as propriedades, selecione Guardar.

Adicionar uma definição de definição existente

1. Inicie sessão no Power Apps.
2. No painel de navegação esquerdo, 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 a definição.
4. Na barra de comandos, selecione Adicionar existente > Mais > Definição.
5. No diálogo Adicionar definição de definição existente, selecione uma ou mais definições que pretenda adicionar.
6. Quando terminar de selecionar definições, selecione Seguinte
7. No diálogo Definição de definição selecionada, para cada definição selecionada, terá a opção de Incluir a definição de definição. Também pode Incluir o valor do ambiente de definição para cada definição, se existir um.
8. Selecione Adicionar para adicionar os valores da definição de definição e/ou definição de ambiente.

Atualizar uma definição de definição

1. Inicie sessão no Power Apps.
2. No painel de navegação esquerdo, 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 em que criou a definição.
4. Na vista da árvore, selecione Definições > Definições de definição.
5. Selecione a definição de definição que pretende atualizar.
6. No diálogo Editar definição, atualize os valores para qualquer uma das propriedades que pretenda alterar.
   Note que algumas propriedades não podem ser atualizadas após a criação de uma definição. Além disso, na maioria dos casos não será capaz de atualizar definições de definições de que não é proprietário.
7. Quando terminar de atualizar os valores para as propriedades, selecione Guardar.

Remover uma definição de definição

1. Inicie sessão no Power Apps.
2. No painel de navegação esquerdo, 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 em que criou ou adicionou a definição.
4. Na vista da árvore, selecione Definições > Definições de definição.
5. Selecione a definição de definição que pretende remover.
6. Na barra de comandos, selecione Remover > Remover desta solução.
   A opção Remover desta solução remove a definição de definição 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 uma definição de definição

1. Inicie sessão no Power Apps.
2. No painel de navegação esquerdo, 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 em que criou ou adicionou a definição.
4. Na vista da árvore, selecione Definições > Definições de definição.
5. Selecione a definição de definição que pretende eliminar.
6. Na barra de comandos, selecione Remover > Eliminar deste ambiente.
   A opção Eliminar deste ambiente elimina a definição de definição do ambiente atual e deixará de fazer parte de quaisquer soluções nesse ambiente. Só pode eliminar definições de definição de que é proprietário.

Valor de definição do ambiente

Um valor de definição do ambiente é utilizado para substituir o valor predefinido da definição para todas as aplicações num ambiente. Utilize um valor de definição do ambiente quando o valor predefinido da definição não é o que pretende utilizar para aplicações no seu ambiente.

Adicionar um novo valor de definição do ambiente

1. Inicie sessão no Power Apps.

2. No painel de navegação esquerdo, 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 estiver disponível na solução:

   1. Selecione a definição da definição.
   2. No diálogo Editar valor de definição na secção Valor ambiente de definição, selecione Novo valor.
   3. Forneça o valor e, em seguida, selecione Guardar.

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

   1. Na barra de comandos, selecione Nova > Mais > Definição > Valor de definição do ambiente.
   2. Selecione a definição para a qual pretende adicionar o valor de definição do ambiente e, em seguida, selecione Adicionar.
   3. No diálogo Novo valor de definição do ambiente na secção Valor ambiente de definição, selecione Novo valor.
   4. Forneça o valor e, em seguida, selecione Guardar.

Adicionar um valor de definição do ambiente

1. Inicie sessão no Power Apps.

2. No painel de navegação esquerdo, 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 estiver disponível na solução:

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

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

   1. Na barra de comandos, selecione Adicionar existente > Mais > Definição.
   2. No diálogo Adicionar definição de definição existente, selecione uma ou mais definições para a qual pretenda adicionar os valores de definição do ambiente.
   3. Quando terminar de selecionar definições, selecione Seguinte
   4. No diálogo Definição de definição selecionada, para cada definição selecionada, terá a opção de Incluir valor de definição do ambiente, se existir um. Também pode Incluir a definição de definição para cada definição, se pretender.
   5. Selecione Adicionar para adicionar os valores da definição do ambiente e/ou definições de definição.

Atualizar um valor de definição do ambiente

1. Inicie sessão no Power Apps.
2. No painel de navegação esquerdo, 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 da árvore, selecione Definições > Valores de definição do ambiente.
5. Selecione o valor de definição do ambiente que pretende atualizar.
6. No diálogo Editar definição na secção Valor de definição do ambiente, atualize o valor e selecione Guardar.

Remover um valor de definição do ambiente

1. Inicie sessão no Power Apps.
2. No painel de navegação esquerdo, 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 em que criou ou adicionou a definição.
4. Na vista da árvore, selecione Definições > Valores de definição do ambiente.
5. Selecione o valor de definição do ambiente que pretende remover.
6. Na barra de comandos, selecione Remover > Remover desta solução.
   A opçã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 de definição do ambiente

1. Inicie sessão no Power Apps.
2. No painel de navegação esquerdo, 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 em que criou ou adicionou a definição.
4. Na vista da árvore, selecione Definições > Valores de definição do ambiente.
5. Selecione o valor de definição do ambiente que pretende eliminar.
6. Na barra de comandos, selecione Remover > Eliminar deste ambiente.
   A opção Eliminar deste ambiente elimina o valor da definição do ambiente do ambiente atual e deixará de fazer parte de quaisquer soluções nesse ambiente.

Valor de definição da aplicação

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 definição do ambiente, utilize um valor de definição da aplicação quando o valor predefinido da definição não é o que pretende utilizar para a sua aplicação.

Nota

Para seguir os passos listados abaixo, é necessário utilizar o novo estruturador de aplicações. Atualmente, o estruturador de aplicações apenas apresenta definições da plataforma Power Apps. Para definições de não plataforma, utilize o explorador de soluções como descrito abaixo.

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

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 Definições.
3. No diálogo Definições, selecione o separador Funcionalidades ou Em Breve.
   O separador Funcionalidades apresenta todas as definições que têm o nível de versão definido como Geralmente disponível. O separador Em Breve apresenta todas as definições que têm o nível de versão definido como Pré-visualização.
4. Adicione ou atualize um valor da aplicação para a definição pretendida.
5. Guarde e publique a aplicação.

Eliminar um valor de definição da aplicação utilizando o estruturador 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 Definições.
3. No diálogo Definições, selecione o separador Funcionalidades ou Em Breve.
4. Selecione Repor para valor do ambiente junto do valor de definição da aplicação que pretende eliminar. Isto faz com que o valor de definição recue para o valor de definição do ambiente, se existir um. Se não existir qualquer valor de definição do ambiente, irá recua para o valor predefinido da definição.
   Note que a opção Repor para valor do ambiente só é apresentada se um valor de definição da aplicação tiver sido previamente adicionado a essa definição.
5. Guarde e publique a aplicação.

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 esquerdo, 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 definição ou o valor de definição do ambiente não estiverem disponíveis na solução, adicione um deles. Aceda a Adicionar uma definição de definição existente ou Adicionar um valor de definição do ambiente existente.
5. Selecione a definição de definição ou o valor de definição do ambiente.
6. No diálogo Editar valor de definição na secção Valores da aplicação de definição, encontre a aplicação para a qual pretende adicionar o valor da aplicação de definição. Note que utilizando o explorador de soluções só pode adicionar valores de aplicação de definição a aplicações que estão na solução atual.
7. Forneça o valor e selecione Guardar.
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.

Eliminar 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 esquerdo, 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 definição ou o valor de definição do ambiente não estiverem disponíveis na solução, adicione um deles. Mais informações: Adicionar uma definição de definição existente ou Adicionar um valor de definição do ambiente existente.
5. Selecione a definição de definição ou o valor de definição do ambiente.
6. No diálogo Editar valor de definição na secção Valores da aplicação de definição, encontre a aplicação para a qual pretende eliminar o valor da aplicação de definição. Note que utilizando o explorador de soluções só pode remover valores de aplicação de definição a aplicações que estão na solução atual.
7. Selecione ... junto do valor de definição da aplicação e, em seguida, selecione Repor para ambiente.
8. Selecione Guardar.
9. Para que a eliminação do 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.

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

Para os métodos disponíveis, vá a Obter ou atualize um valor de definição utilizando a API de cliente.

Consulte também

Para programadores:

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