Configure seu aplicativo com fórmulas que não apenas calculam valores e executam outras tarefas (como no Excel), mas também respondem à entrada do usuário (como requer um aplicativo).

  • No Excel, você cria fórmulas que, por exemplo, preenchem células e criam tabelas e gráficos.
  • No PowerApps, 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.

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 tópico fornece somente uma visão de geral de como trabalhar com fórmulas. Procure a referência da fórmula para obter mais detalhes e a lista completa de funções, operadores e outros blocos de construção que você pode usar.

Pré-requisitos

Mostrar um valor simples

No Excel, você pode inserir dados específicos, como o número 42 ou a frase Olá, mundo, digitando-os em uma célula. Essa célula sempre mostrará os dados exatamente como você digitou. No PowerApps, você pode especificar dados que não são alterados, definindo a propriedade Texto de um rótulo para a sequência exata dos caracteres desejados, entre aspas duplas.

  1. Selecione Novo no menu Arquivo (próximo à borda esquerda da tela).

  2. Em Criar um aplicativo, selecione Layout de telefone no bloco Aplicativo em branco.

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

    Barra de fórmulas

    Essa barra tem duas partes:

    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. Você pode ver o nome do controle selecionado na guia Conteúdo:

    A barra de conteúdo mostra o controle selecionado no momento

    Você pode alterar o nome do controle selecionado na guia Conteúdo clicando no nome.

  3. Adicione um controle Rótulo à tela.

    Adicionado um controle TextBox

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

  4. Defina o valor da propriedade Texto para "Olá, mundo", digitando essa cadeia de caracteres entre aspas duplas na barra de fórmulas:

    Usando o rótulo "Olá, mundo"

    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 PowerApps, é 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 mostrarão esse número, independentemente de outras alterações na planilha ou no aplicativo.

    Observação: no PowerApps, não preceda uma fórmula com um sinal de igual ou um sinal de mais, como você 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.

  5. Na propriedade Text do rótulo, substitua “Olá, mundo” por Sum(1,2,3).

    Se você digitar a função parcial Sum(1,2, 3, sem um parêntese de fechamento, haverá erros

    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 os pontos de exclamação amarelos para indicar um erro até que você digite o parêntese final dessa fórmula:

    Usando a fórmula completa Sum(1,2,3)

Alterar um valor com base na entrada

No Excel, você digita =SUM(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.

Ilustração de recálculo do Excel para adição de dois números

No PowerApps, você pode obter um resultado semelhante, adicionando controles e definindo suas propriedades. Este exemplo mostra o rótulo do procedimento anterior e dois controles Entrada de texto, chamados TextInput1 e TextInput2.

Ilustração de recálculo do PowerApps para adição de dois números

Independentemente de quais números você digitar nos controles de entrada de texto, o rótulo sempre mostrará a soma desses números, porque a propriedade Text está definida com esta fórmula:
TextInput1 + TextInput2

Ilustração de recálculo do PowerApps para adição de dois números

No Excel, você pode usar a formatação condicional para mostrar, por exemplo, valores negativos em vermelho. No PowerApps, você usa uma fórmula que contém a função If, que se comporta praticamente da mesma maneira no Excel.

  1. Defina a propriedade Color do rótulo com esta fórmula:
    If( Value(TextBox1.Text) < 0, Red, Black )

    Observação: em uma fórmula, especifique a propriedade de um controle, fornecendo o nome do controle seguido por um ponto e pelo nome da propriedade. Por exemplo, especifique a propriedade Texto de TextBox1 digitando TextBox1.Text.

    Ilustração de recálculo do PowerApps com alteração da cor de um rótulo com base em seu valor

  2. Em TextInput1 e TextInput2, especifique dois números que, quando somados, resultem em um número negativo.

    Ilustração de recálculo do PowerApps com alteração da cor de um rótulo com base em seu valor

    O valor do rótulo é exibido em vermelho.

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 contenham uma cadeia de texto especificada pelo usuário, ou pode permitir que os usuários classifiquem um conjunto de dados com base em uma determinada coluna no conjunto de dados. Nesse procedimento, você vai permitir que os usuários alterem a cor da tela, ajustando um ou mais 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:

    Inserir um controle deslizante

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

    Organizar controles deslizantes e adicionar rótulos para cada componente de cor

  3. Defina a propriedade Máx. de cada controle deslizante para 255, que é o valor máximo de um componente de cor para a função RGBA.

    Você pode especificar a propriedade Máx., selecionando-a na guia Conteúdo ou na lista de propriedades:

    Altere o valor máximo de cada controle deslizante

  4. Selecione a tela, clicando fora de qualquer controle, e defina a propriedade Preencher da tela para esta fórmula:
    RGBA( Slider1.Value, Slider2.Value, Slider3.Value, 1 )

    Como descrito anteriormente, você acessa as propriedades de controle usando o operador . . Slider1.Value refere-se à propriedade Valor, que reflete onde o usuário inseriu o controle deslizante entre os valores Mín. e Máx. Conforme você digita essa fórmula, cada controle que ela contém é codificado por cor entre a tela e a barra de fórmulas:

    Alterar a fórmula da cor de preenchimento do plano de fundo da tela, mas antes da conclusão

    Conforme você digita o parêntese de fechamento, o plano de fundo da tela será alterado para cinza-escuro com base no valor padrão de cada controle deslizante, que é 50. Quando você termina de digitar a fórmula, ela é calculada e usada como o valor da cor de preenchimento do plano de fundo. Você pode interagir com seu aplicativo no espaço de trabalho padrão sem a necessidade de abrir a visualização:

    Altere o valor máximo de cada controle deslizante

  5. Ajuste os controles deslizantes e veja como as alterações afetam a cor do plano de fundo.

    À medida que cada controle deslizante é alterado, a fórmula que contém a função RGBA é recalculada, o que altera imediatamente a aparência da tela.

    Alterar a fórmula da cor de preenchimento do plano de fundo da tela, agora após a conclusão

Gerenciar o comportamento do aplicativo

Você pode usar fórmulas não apenas para executar cálculos e alterar a aparência, mas também para agir. Por exemplo, você pode definir a propriedade OnSelect de um botão para uma fórmula que inclua a função Navegar. Quando um usuário selecionar esse botão, será exibida a tela que você especificar na fórmula.

Você pode usar algumas funções, como Navegar e Coletar, somente em fórmulas de comportamento. A referência de fórmula se destaca se você puder usar uma função somente neste contexto.

Você pode inserir mais de uma ação em uma fórmula de comportamento se separar as funções com um ponto e vírgula (;). Por exemplo, você talvez queira atualizar uma variável de contexto, enviar dados para uma fonte de dados e ir para outra tela.

Exibir uma lista de propriedades por categoria

A lista de propriedades mostra as propriedades em ordem alfabética, mas você também pode exibir todas as propriedades de um controle, organizadas por categoria, se selecionar a opção Avançado na guia Exibir:

Exibição avançada

Você pode editar fórmulas diretamente neste modo de exibição. Com o seletor de controle na parte superior do painel, você pode localizar rapidamente um controle para trabalhar. E, com a pesquisa de propriedade, você pode localizar rapidamente uma propriedade desse controle.

Inicialmente, essa exibição mostra as propriedades mais importantes. Para exibir todas as propriedades, clique na seta para baixo, na parte inferior do painel. Cada controle tem uma longa lista de propriedades que controlam todos os aspectos da aparência e do comportamento do controle. Você pode rolar pela lista ou procurar uma propriedade, digitando na caixa, na parte superior do painel.

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 PowerApps.

destaque da sintaxe