Se você já usou outra ferramenta de programação, como Visual Basic ou JavaScript, deve estar se perguntando: onde estão as variáveis? O PowerApps é um pouco diferente e exige uma abordagem diferente. Em vez de buscar uma variável, pergunte-se: O que eu faria no Excel?
Em outras ferramentas, você pode ter realizado explicitamente um cálculo e armazenado o resultado em uma variável. No entanto, o PowerApps e o Excel automaticamente recalculam fórmulas à medida que os dados de entrada mudam, por isso geralmente não é necessário criar nem atualizar as variáveis. Ao utilizar essa abordagem sempre que possível, é mais fácil criar, compreender e manter seu aplicativo.
Em alguns casos, você precisará usar variáveis no PowerApps, que estende o modelo do Excel, adicionando fórmulas de comportamento. Essas fórmulas são executadas quando, por exemplo, um usuário seleciona um botão. Dentro de uma fórmula de comportamento, geralmente, é útil definir uma variável a ser usada em outras fórmulas.
Em geral, evite usar variáveis. Mas, às vezes, apenas uma variável pode habilitar a experiência que você deseja.
Converter Excel em PowerApps
Excel
Vamos examinar como o Excel funciona. Uma célula pode conter um valor, como um número ou uma cadeia de caracteres ou uma fórmula com base nos valores de outras células. Depois que o usuário insere um valor diferente em uma célula, o Excel recalcula automaticamente todas as fórmulas que dependem do valor novo. Você não precisa fazer nenhuma programação para habilitar esse comportamento.
O Excel não tem variáveis. O valor de uma célula que contém uma fórmula muda com base em sua entrada, mas não há nenhuma maneira de lembrar o resultado de uma fórmula e armazená-lo em uma célula ou em qualquer outro lugar. Se você alterar o valor de uma célula, a planilha inteira poderá ser alterada e qualquer valor calculado anteriormente será perdido. Um usuário do Excel pode copiar e colar células, mas isso está sob o controle manual do usuário e não é possível com fórmulas.
PowerApps
Aplicativos que você cria no PowerApps se comportam de maneira muito parecida com o Excel. Em vez de atualizar células, é possível adicionar controles em qualquer local que desejar em uma tela e nomeá-los para uso em fórmulas.
Por exemplo, você pode replicar o comportamento do Excel em um aplicativo adicionando um controle Rótulo, chamado TextBox1, e dois controles Entrada de texto, chamados TextInput1 e TextInput2. Se você definir a propriedade Texto de TextBox1 como TextInput1 + TextInput2, ela sempre exibirá a soma de quaisquer números que estiverem em TextInput1 e TextInput2 automaticamente.
Observe que o controle TextBox1 está selecionado, mostrando sua fórmula de Texto na barra de fórmulas na parte superior da tela. Aqui, encontramos a fórmula TextInput1 + TextInput2. Esta fórmula cria uma dependência entre esses controles, assim como as dependências são criadas entre as células em uma planilha do Excel. Vamos alterar o valor de TextInput1:
A fórmula para TextBox1 foi automaticamente recalculada, exibindo o novo valor.
no PowerApps, você pode usar fórmulas para determinar não apenas o valor principal de um controle, mas também propriedades como a formatação. No próximo exemplo, uma fórmula para a propriedade Color do rótulo mostrará automaticamente os valores negativos em vermelho. A função If deve ser bem semelhante à do Excel:
If( Value(TextBox1.Text) < 0, Red, Black )
Agora, se o resultado de nosso cálculo em TextBox1 for negativo, o número será exibido em vermelho:
Você pode usar fórmulas para uma ampla variedade de cenários:
- Ao usar o GPS do seu dispositivo, um controle de mapa pode exibir seu local atual com uma fórmula que usa Location.Latitude e Location.Longitude. À medida que você se move, o mapa rastreará automaticamente seu local.
- Outros usuários podem atualizar as fontes de dados. Por exemplo, outras pessoas de sua equipe podem atualizar itens em uma lista do SharePoint. Quando você atualiza uma fonte de dados, todas as fórmulas dependentes são recalculadas automaticamente para refletir os dados atualizados. Ao aprofundar ainda mais o exemplo, você poderá definir a propriedade Itens de uma galeria como a fórmula Filter( SharePointList), que exibirá automaticamente o conjunto de registros recém-filtrado.
Benefícios
Usar fórmulas para criar aplicativos tem muitas vantagens:
- Se você conhece o Excel, também conhece o PowerApps. O modelo e a linguagem de fórmula são os mesmos.
- Se você usou outras ferramentas de programação, pense na quantidade de códigos necessária para executar esses exemplos. No Visual Basic, você precisaria escrever um manipulador de eventos para o evento de alteração em cada controle de entrada de texto. O código para realizar o cálculo em cada um deles é redundante e pode ficar fora de sincronia, ou você precisaria escrever uma sub-rotina comum. No PowerApps, você realizou tudo com uma única fórmula de uma linha.
- Para compreender de onde o texto de TextBox1 é proveniente, você sabe exatamente onde procurar: a fórmula na propriedade Texto. Não há nenhuma outra forma de afetar o texto deste controle. Em uma ferramenta de programação tradicional, qualquer manipulador de eventos ou sub-rotina poderia alterar o valor do rótulo, de qualquer lugar no programa. Isso pode dificultar o rastreamento de quando e onde uma variável foi alterada.
- Se o usuário altera um controle deslizante e, em seguida, muda de ideia, ele pode alterar o controle deslizante de volta para seu valor original. E é como se nada nunca tivesse sido alterado: o aplicativo mostrará os mesmos valores de controle como fazia antes. Não há nenhuma ramificação para experimentar e perguntar "e se", assim como não há nada no Excel.
Em geral, se você puder obter um efeito usando uma fórmula, será melhor. Deixe que o mecanismo da fórmula no PowerApps trabalhe para você.
Saber quando usar variáveis
Vamos alterar nosso adicionador simples para atuar como uma calculadora antiga, com um total acumulado. Se você selecionar um botão Adicionar, um número será adicionado ao total acumulado. Se você selecionar um botão Limpar, redefinirá o total acumulado para zero.
Nossa calculadora usa algo que não existe no Excel: um botão. Neste aplicativo, não é possível usar somente fórmulas para calcular o total acumulado porque seu valor depende de uma série de ações que o usuário realiza. Em vez disso, nosso total acumulado deve ser registrado e atualizado manualmente. A maioria das ferramentas de programação armazena essas informações em uma variável.
Às vezes, você precisará que uma variável para o seu aplicativo se comporte da maneira desejada. Mas a abordagem vem com Advertências:
- Você deve atualizar manualmente o total acumulado. O recálculo automático não fará isso para você.
- O total acumulado não pode mais ser calculado com base nos valores de outros controles. Ele depende de quantas vezes o usuário selecionou o botão Adicionar e qual valor estava no controle de entrada de texto em cada uma das vezes. O usuário inseriu 77 e selecionou Adicionar duas vezes, ou ele especificou 24 e 130 para cada uma das adições? Você não pode determinar a diferença depois que o total atingiu 154.
- As alterações no total podem vir de caminhos diferentes. Neste exemplo, os botões Adicionar e Limpar podem atualizar o total. Se o aplicativo não se comportar da maneira esperada, qual botão estará causando o problema?
Criar uma variável global
Para criar nossa calculadora, precisamos de uma variável para manter o total acumulado. As variáveis mais simples para trabalhar com PowerApps são variáveis globais.
Como variáveis globais funcionam:
- Defina o valor da variável global com a função Set. Set (MyVar, 1) define a variável global MyVar para um valor de 1.
- Você usa a variável global referenciando o nome usado com a função Set. Nesse caso, MyVar retornará 1.
- Variáveis globais podem conter qualquer valor, incluindo cadeias de caracteres, números, registros e tabelas.
Recompilaremos nossa calculadora usando uma variável global:
Adicione um controle de entrada de texto, chamado TextInput1, e dois botões, chamados Button1 e Button2.
Defina a propriedade Texto de Button1 como "Adicionar" e defina a propriedade Texto de Button2 como "Limpar".
Para atualizar o total acumulado sempre que um usuário seleciona o botão Adicionar, defina sua propriedade OnSelect como esta fórmula:
Set( RunningTotal, RunningTotal + Text1 )
Na primeira vez que um usuário selecionar o botão Adicionar e Set for chamado, RunningTotal será criado com um valor padrão em branco. Além disso, ele será tratado como zero.
Para definir o total acumulado como 0, sempre que o usuário seleciona o botão Limpar, defina sua propriedade OnSelect como esta fórmula:
Set( RunningTotal, 0 )
Adicione um controle Rótulo e defina sua propriedade Text como RunningTotal.
Esta fórmula será automaticamente recalculada e exibirá ao usuário o valor de RunningTotal à medida que ele mudar de acordo com os botões que o usuário selecionar.
Visualize o aplicativo e nossa calculadora estará como descrito acima. Insira um número na caixa de texto e pressione o botão Adicionar algumas vezes. Quando estiver pronto, retorne para a experiência de criação usando a tecla Esc.
Para ver o valor da variável global, selecione o menu Arquivo e selecione Variáveis no painel à esquerda.
Para ver todos os locais em que nossa variável é definida e usada, selecione-a.
Tipos de variáveis
Há três tipos de variáveis no PowerApps:
| Tipo de variáveis | Escopo | Descrição | Funções |
| Variáveis globais | Aplicativo | O mais simples de usar. Contém um número, cadeia de caracteres de texto, booliano, registro, tabela, etc. que podem ser referências de qualquer lugar no aplicativo. | Definir |
| Variáveis de contexto | Tela | Excelente para passar valores para uma tela, bem como parâmetros para um procedimento em outras linguagens. Só pode ser referenciada de uma tela. | UpdateContext Navegar |
| Coleções | Aplicativo | Mantém uma tabela que pode ser de referências de qualquer lugar no aplicativo. Permite que o conteúdo da tabela seja modificado em vez de ser definido como um todo. Pode ser salvo para o dispositivo local para uso posterior. | Coletar ClearCollect Aplicar Patch Atualizar Remover SaveData LoadData etc. |
Todas as variáveis criadas implicitamente quando usados nas funções Definir, UpdateContext, Navegar ou Coletar. Não há nenhuma declaração explícita de variáveis tal como é feito em outras ferramentas de programação. Os tipos das variáveis também são derivados implicitamente dos valores que são colocados nelas.
Todas as variáveis são mantidas na memória enquanto o aplicativo está em execução. Depois que o aplicativo é fechado, os valores mantidos nas variáveis são perdidos. Você pode armazenar o conteúdo de uma variável em uma Fonte de Dados usando as funções Aplicar Patch ou Coletar, ou com a função SaveData no caso de coleções que você pode armazenar no dispositivo local. Quando o aplicativo for carregado pela primeira vez, todas as variáveis terão o valor em branco.
Você pode usar o nome da variável para ler o valor dela. Por exemplo, uma vez definido com Set( MyColor, Red ), você poderá simplesmente usar MyVar em qualquer lugar em que um valor de cor pode ser usado e ele será substituído por Red. É possível ter uma variável global ou um conjunto com o mesmo nome que uma variável de contexto. Nesse caso, a variável de contexto terá precedência. Você ainda pode fazer referência à coleção ou variável global usando o operador de desambiguidade @[MyColor].
Criar uma variável de contexto
Examinaremos como nossa calculadora seria criada usando uma variável de contexto em vez de uma variável global.
Como funcionam as variáveis de contexto:
- Crie e defina variáveis de contexto usando a função AtualizarContexto. Se uma variável de contexto ainda não existir quando você atualizou pela primeira vez, ela será criada com um valor padrão em branco.
- Crie e atualize as variáveis de contexto com registros. Em outras ferramentas de programação, geralmente você usa "=" para a atribuição, como em "x = 1". Para variáveis de contexto, use { x: 1 } em vez disso. Quando você usa uma variável de contexto, use seu nome diretamente.
- Também é possível definir uma variável de contexto quando uma tela é exibida, usando a função Navegar. Se pensar em uma tela como um tipo de procedimento ou uma sub-rotina, isso será semelhante ao parâmetro que passa em outras ferramentas de programação.
- Exceto para Navegar, as variáveis de contexto são limitadas ao contexto de uma única tela, que é de onde elas obtêm o nome. Você não pode usar nem defini-las fora deste contexto.
- Variáveis de contexto podem conter qualquer valor, incluindo cadeias de caracteres, números, registros e tabelas.
Vamos recompilar nossa calculadora usando uma variável de contexto:
Adicione um controle de entrada de texto, chamado TextInput1, e dois botões, chamados Button1 e Button2.
Defina a propriedade Texto de Button1 como "Adicionar" e defina a propriedade Texto de Button2 como "Limpar".
Para atualizar o total acumulado sempre que um usuário seleciona o botão Adicionar, defina sua propriedade OnSelect como esta fórmula:
UpdateContext( { RunningTotal: RunningTotal + Text1 } )
Na primeira vez que um usuário selecionar o botão Adicionar e AtualizarContexto for chamado, RunningTotal é criado com um valor padrão em branco. Além disso, ele será tratado como zero.
Para definir o total acumulado como 0, sempre que o usuário seleciona o botão Limpar, defina sua propriedade OnSelect como esta fórmula:
UpdateContext( { RunningTotal: 0 } )
Novamente, AtualizarContexto é usado com a fórmula UpdateContext( { RunningTotal: 0 } ).
Adicione um controle Rótulo e defina sua propriedade Text como RunningTotal.
Esta fórmula será automaticamente recalculada e exibirá ao usuário o valor de RunningTotal à medida que ele mudar de acordo com os botões que o usuário selecionar.
Visualize o aplicativo e teremos nossa calculadora conforme descrita acima. Insira um número na caixa de texto e pressione o botão Adicionar algumas vezes. Quando estiver pronto, retorne para a experiência de criação usando a tecla Esc.
Você pode definir o valor de uma variável de contexto ao navegar para uma tela. Isso é útil para a passagem de "contexto" ou de "parâmetros" de uma tela para outra. Para ver isso, insira uma nova tela e inserir um botão com a propriedade OnSelect definida como:
Navigate( Screen1, None, { RunningTotal: -1000 } )
Selecionar este botão na Screen2 (o que pode ser feito durante a criação, se você selecionar o botão em direção às extremidades) mostrará Screen1 e também definirá a variável de contexto RunningTotal para -1000.
Para ver o valor da variável de contexto, selecione o menu Arquivo e selecione Variáveis no painel à esquerda.
Para ver onde sua variável de contexto é definida e usada, selecione-a.
Criar uma coleção
Por fim, examinaremos a criação de nossa calculadora com uma coleção. Já que uma coleção contém uma tabela que é fácil de modificar, faremos com que essa calculadora mantenha uma "fita de papel" de cada valor conforme eles forem inseridos.
Como coleções funcionam:
- Crie e defina coleções usando a função LimparColeta. Como alternativa, você pode usar a função Coletar, mas isso exigirá efetivamente outra variável em vez de substituir a antiga.
- Uma coleção é um tipo de fonte de dados e, portanto, uma tabela. Para acessar um único valor em uma coleção, use a função Primeiro e extraia um campo do registro resultante. Se você usar um único valor com LimparColeta, esse será o campo Valor, como neste exemplo:
First( VariableName ).Value
Vamos recriar nossa calculadora usando uma coleção:
Adicione um controle de Entrada de texto, chamado TextInput1 e dois botões, chamados Button1 e Button2.
Defina a propriedade Texto de Button1 como "Adicionar" e defina a propriedade Texto de Button2 como "Limpar".
Para atualizar o total acumulado sempre que um usuário seleciona o botão Adicionar, defina sua propriedade OnSelect como esta fórmula:
Collect( PaperTape, TextInput1.Text )
Essa fórmula adicionará o novo valor ao final da coleção. Já que estamos adicionando um único valor, Coletar colocará automaticamente esse valor em uma tabela de coluna única com nome da coluna Valor, que usaremos mais tarde.
Para limpar nossa fita de papel quando o usuário seleciona o botão Limpar, defina sua propriedade OnSelect como esta fórmula:
Clear( PaperTape )
Para adicionar o total acumulado, adicione um rótulo e defina sua propriedade Text com esta fórmula:
Sum( PaperTape, Value )
Para executar a calculadora, pressione F5 para abrir a Versão Prévia, insira números no controle de entrada de texto e selecione botões.
Para retornar ao espaço de trabalho padrão, pressione a tela Esc.
Para exibir a fita de papel, insira um controle Tabela de dados e defina sua propriedade Itens para esta fórmula:
PaperTape
Você também precisará selecionar as colunas a exibir no painel direito, em nosso caso, mostrar a coluna Valor:
Para ver os valores em sua coleção, selecione Coleções no menu Arquivo.
Para armazenar e recuperar sua coleção, adicione dois controles de botão adicionais e defina o texto deles como Carregar e Salvar. Para Carregar, defina a propriedade OnSelect como:
Clear( PaperTape ); LoadData( PaperTape, "StoredPaperTape", true )
É preciso limpar a coleção primeiro, já que LoadData acrescentará os valores armazenados no final da coleção.
Para Salvar, defina a propriedade OnSelect como:
SaveData( PaperTape, "StoredPaperTape" )
Visualize novamente pressionando a tecla F5, insira números no controle de entrada de texto e selecione os botões. Selecione o botão Salvar. Feche e recarregue o seu aplicativo e, em seguida, selecione o botão Carregar para recarregar sua coleção.
Observação: SaveData e LoadData não funcionam quando executado em um navegador da Web, você deve estar usando o studio instalado no Windows ou um dos participantes do dispositivo móvel.