Introdução às fórmulas em aplicativos de tela

Configure seu aplicativo de tela com fórmulas que, além de calcular valores e executar outras tarefas (como no Excel), também respondem à entrada do usuário (como um aplicativo requer).

• Em Excel, você cria fórmulas que populam células e criam tabelas e gráficos.
• No Power Apps, você cria fórmulas semelhantes ao configurar controles em vez de células. Além disso, você pode criar fórmulas que se aplicam especificamente a aplicativos em vez de a planilhas.

Power Apps usa Power Fx, uma linguagem de fórmula de código baixo e software livre baseada em Excel que você pode usar para expressar lógica, manipulação de dados e comportamento do aplicativo.

Por exemplo, você pode criar uma fórmula para determinar como seu aplicativo responde quando os usuários selecionam um botão, ajustam um controle deslizante ou fornecem outra entrada. Essas fórmulas podem mostrar uma tela diferente, atualizar uma fonte de dados externa para o aplicativo ou criar uma tabela que contenha um subconjunto dos dados em uma tabela existente.

Você pode usar fórmulas para uma ampla variedade de cenários. Por exemplo, pode usar o GPS de um dispositivo, um controle de mapa e uma fórmula que use Location.Latitude e Location.Longitude para exibir o local atual. Quando você se deslocar, o mapa rastreará automaticamente seu local.

Este artigo fornece uma visão geral de como trabalhar com fórmulas. Consulte a referência de fórmulas para ver mais detalhes e a lista completa de funções, operadores e outros elementos que você pode usar.

Pré-requisitos

1. Inscreva-se no Power Apps e entre com suas credenciais.
2. Saiba como configurar um controle no Power Apps.

Usar a barra de fórmulas do Power Fx

A barra de fórmulas do Power Fx na parte superior do Power Apps Studio é onde você escreve e edita fórmulas para seu aplicativo. Ele fornece o IntelliSense – sugestões de preenchimento automático, realce de sintaxe e mensagens de erro embutidas – para ajudá-lo a criar fórmulas mais rapidamente e com menos erros.

1. Abra o aplicativo para edição no Power Apps Studio.
2. Selecione qualquer tela ou controle na tela.
3. Na lista suspensa de propriedades no lado esquerdo da barra de fórmulas, selecione a propriedade para a qual você deseja definir uma fórmula (por exemplo, Texto ou OnSelect).
4. Selecione a barra de fórmulas e comece a digitar sua fórmula. Conforme você digita, o IntelliSense mostra sugestões de funções e propriedades que correspondem à sua entrada.
5. Selecione uma sugestão ou continue digitando até que sua fórmula seja concluída.

Mostrar um valor

Em Excel, você insere um dado específico, como o número 42 ou a frase Olá, Mundo, digitando-os em uma célula. Essa célula mostra os dados exatamente como você os digita. No Power Apps, você pode especificar dados que não são alterados, definindo a propriedade Text de um rótulo para a sequência exata dos caracteres desejados, entre aspas duplas.

1. Criar um aplicativo de tela em branco.

   A barra de fórmulas fica na parte superior da tela.

   

   1. Lista de propriedades: cada controle e tela tem um conjunto de propriedades. Use essa lista para selecionar uma propriedade específica.
   2. Fórmula: a fórmula a ser calculada para esta propriedade, composta de funções, operadores e valores. Conforme você digita, o IntelliSense ajuda você com recomendações para fórmula, sintaxe e erros.
   3. Controle selecionado: na barra de fórmulas, você pode ver e editar as propriedades para o controle selecionado ou para a tela, caso nenhum controle esteja selecionado.

2. Adicione um controle de texto à tela.

   Quando você adiciona um rótulo de texto, a lista de propriedades mostra automaticamente a propriedade Text , que conduz o que o controle mostra. Por padrão, o valor dessa propriedade é "Text".

3. Defina o valor da propriedade Text como "Olá, Mundo", digitando essa cadeia de caracteres entre aspas duplas na barra de fórmulas:

   

   O rótulo reflete esse novo valor conforme você o digita. A tela pode mostrar ícones de ponto de exclamação amarelos enquanto você digita. Esses ícones indicam erros, mas eles desaparecem quando você termina de inserir um valor válido. Por exemplo, uma cadeia de caracteres sem aspas duplas em ambas as extremidades não é válida.

   No Excel, você pode mostrar um número, como 42, digitando-o em uma célula ou digitando uma fórmula cujo resultado seja esse número, como =SUM(30,12). No Power Apps, é possível obter o mesmo efeito configurando a propriedade Text de um controle, como um rótulo, como 42 ou Sum(30,12). A célula e o rótulo sempre mostram esse número, independentemente de outras alterações na planilha ou no aplicativo.

   Observação

   No Power Apps, você não coloca um sinal de igual nem um sinal de mais antes de uma fórmula, como faz no Excel. A barra de fórmulas trata qualquer coisa que você digitar como uma fórmula por padrão. Você também não coloca uma fórmula entre aspas duplas ("), como fez anteriormente para especificar uma cadeia de texto.

4. Na propriedade Text do rótulo, substitua "Olá, Mundo" por Sum(1,2,3).

   Enquanto você digita, a barra de fórmulas ajuda, mostrando a descrição e os argumentos esperados para essa função. Assim como acontece com as aspas duplas finais em "Olá, mundo", a tela mostra uma cruz vermelha, indicando um erro até que você digite o parêntese final dessa fórmula.

   

   Fórmula preenchida com o parêntese final adicionado:

   

Alterar um valor com base na entrada

No Excel, você digita =A1+A2 em uma célula para exibir a soma dos valores contidos nas células A1 e A2. Se um ou ambos os valores forem alterados, a célula que contém a fórmula automaticamente mostrará o resultado atualizado.

No Power Apps, você pode obter um resultado semelhante, adicionando controles a uma tela e definindo suas propriedades. Este exemplo mostra um rótulo de texto chamado Text1 e dois controles de entrada de texto , chamados TextInput1 e TextInput2. Adicione uma fórmula ao controle Text1 para que, quando você inserir um número em TextInput1 e TextInput2, os valores sejam adicionados e exibidos no Text1.

Independentemente dos números que você digita nos controles de entrada de texto, o rótulo de texto sempre mostra a soma desses números porque sua propriedade Text está definida como esta fórmula: TextInput1.Text + TextInput2.Text.

No Excel, você pode usar fórmulas de formatação condicional para mostrar, por exemplo, valores negativos em vermelho. No Power Apps, você pode usar fórmulas para determinar não apenas o valor principal de um controle, mas também propriedades como a cor.

Neste exemplo, uma fórmula para a propriedade Color do rótulo mostra automaticamente os valores negativos em vermelho. A função If deve ser semelhante à do Excel:

If( Value(Label1.Text) < 0, Color.Red, Color.Black )

Alterar uma cor com base na entrada do usuário

Você pode configurar seu aplicativo com fórmulas para que os usuários possam alterar a aparência ou o comportamento do seu aplicativo. Por exemplo, você pode criar um filtro para mostrar apenas os dados que contêm uma cadeia de caracteres de texto especificada pelo usuário ou permitir que os usuários classifiquem um conjunto de dados com base em uma determinada coluna.

Neste exemplo, permitir que os usuários alterem a cor da tela de fundo ajustando os controles deslizantes.

1. Remova os controles dos procedimentos anteriores ou crie um aplicativo em branco como fez anteriormente e adicione três controles deslizantes a ele. Pesquise por Controle Deslizante na caixa de pesquisa do painel Inserir e selecione Controle Deslizante para adicionar um controle deslizante à tela. Repita para adicionar três deslizadores.

   

2. Organize os controles deslizantes de forma que não se sobreponham, adicione três rótulos e configure-os para mostrar o texto em Vermelho, Verde e Azul.

3. Defina a propriedade Max de cada controle deslizante como 255 (o padrão é 100), que é o valor máximo de um componente de cor para a função RGBA .

   

4. Selecione a tela para desselecionar qualquer controle e, em seguida, defina a propriedade Fill da tela para esta fórmula: RGBA( Slider1.Value, Slider2.Value, Slider3.Value, 1 ). Sua tela fica cinza escuro, refletindo as posições atuais dos controles deslizantes.

   Na fórmula, você pode acessar as propriedades de controle usando o seletor de propriedades. Por exemplo, Slider1.Value refere-se à propriedade Value que reflete onde o usuário inseriu o controle deslizante entre os valores Mín. e Máx..

5. Selecione Visualização (F5) e ajuste os controles deslizantes para ver como cada um altera a cor da tela de fundo.

   

   Conforme cada controle deslizante é alterado, a fórmula RGBA é recalculada e a cor da tela é atualizada imediatamente.

Gerenciar o comportamento do aplicativo

Use fórmulas não apenas para executar cálculos e alterar a aparência, mas também para tomar medidas. Por exemplo, defina a propriedade OnSelect de um botão como uma fórmula que inclui a função Navigate . Quando um usuário selecionar esse botão, será exibida a tela que você especificar na fórmula.

Use algumas funções, como Navegar e Coletar, somente em fórmulas de comportamento. Fórmulas de comportamento são as fórmulas em propriedades On... , como OnSelect, OnVisible, OnHidden e OnStart. Se você colocar uma dessas funções em uma propriedade que espera um valor, como Texto, Visível ou Preenchimento, a fórmula será sinalizada como um erro, pois essa propriedade espera um valor (por exemplo, um Boolean para Visible) em vez de uma ação. A referência de fórmulas indica se uma função só pode ser usada nesse contexto. Para obter as regras completas e a lista de funções de alteração de estado, consulte Trabalhando com fórmulas detalhadamente.

Execute mais de uma ação em uma fórmula de comportamento separando funções com um ponto-e-vírgula (;). Por exemplo, você pode atualizar uma variável de contexto, enviar dados por push para uma fonte de dados e, em seguida, navegar até outra tela, tudo em uma única fórmula OnSelect .

Exibir uma lista de propriedades por categoria

A lista de propriedades mostra propriedades em ordem alfabética, mas você também pode exibir todas as propriedades de um controle organizado por categoria. Selecione um controle, por exemplo, Texto1, e selecione a guia Avançado no painel Propriedades para ver uma lista completa categorizada de propriedades para esse controle.

Você pode editar fórmulas diretamente nesse modo de exibição. Use a caixa de pesquisa de propriedades para localizar e alterar rapidamente o comportamento ou a aparência de uma propriedade.

Sintaxe da fórmula

Ao digitar uma fórmula na barra de fórmulas, elementos de sintaxe diferentes aparecem em cores diferentes para melhorar a legibilidade e ajudá-lo a entender as fórmulas longas. Aqui está a lista de códigos de cor no Power Apps.

Informações relacionadas

• Usar Localizar e Substituir na barra de fórmulas
• Use Copilot para gerar fórmulas
• Referência de fórmulas do Power Fx para aplicativos de tela
• Trabalhando com fórmulas em profundidade