Variáveis no
Power Apps são componentes de memória temporária que permitem armazenar valores
(como textos, números, registros ou tabelas) para que possam ser utilizados e
consultados posteriormente em qualquer lugar da aplicação durante a sessão do
usuário. Elas funcionam como "caixas" onde você guarda uma informação
específica, sendo essenciais para gerenciar o estado do sistema, controlar a
visibilidade de elementos ou manter dados que foram calculados em um ponto do
app e precisam ser exibidos em outro.
A função Set do Power Fx é responsável pela criação e atualização de
variáveis globais dentro de um aplicativo Canvas, permitindo o armazenamento de
valores acessíveis em qualquer tela ou painel. Variáveis globais funcionam como
pontos centrais de controle de estado, orientando o comportamento de outros
controles através de fórmulas condicionais como If e Switch.
Em sistemas híbridos de telas e painéis, o uso disciplinado de poucas
variáveis, cada uma carregando múltiplos contextos, reduz a complexidade de
manutenção e evita inconsistências entre diferentes partes do aplicativo.
Pré-requisito: você precisa ter concluído o tutorial anterior, com o ícone
e os três botões já inseridos, ainda sem configuração completa, dentro do Painel_NavegacaoCad.
📌 Guia de Navegação
1. Variáveis: A Inteligência do Sistema
O que Você Vai Aprender Neste Tutorial
Você vai
entender o que é uma variável dentro do Power Apps, a diferença entre variável
Global e variável Contextual, e vai conhecer, em nível conceitual, as primeiras
variáveis que vão sustentar o Controle Mov_Extras_Mobile — a pirâmide de
variáveis globais de controle e as variáveis de dados. A aplicação prática
dessas variáveis, dentro de fórmulas reais, fica para os tutoriais seguintes.
Por que Este Tutorial é Importante e sua Conexão com o Anterior
No tutorial
anterior você inseriu o ícone e os três botões do Painel_NavegacaoCad, mas ainda sem configurá-los por completo — e é exatamente
aqui que essa lacuna se explica. Antes de escrever qualquer fórmula de
navegação, é preciso entender o que são variáveis e como elas vão orientar cada
botão, cada painel e cada tela do sistema. As variáveis no sistema, como o
título já diz muito bem, são o cérebro do sistema: são elas que controlam tudo,
orientam, guiam, corrigem, ensinam.
2. Conceito de Variáveis: Global e Contextual
Uma
variável, dentro do Power Apps, é um espaço de memória temporário que guarda um
valor enquanto o aplicativo está aberto. Esse valor pode ser um texto, um
número, uma cor, ou até um registro inteiro vindo de uma tabela — e qualquer
fórmula, em qualquer parte do aplicativo, pode ler ou modificar esse valor a
qualquer momento.
O Power Apps
trabalha com dois tipos principais de variável, e a diferença entre eles não é
de sintaxe, é de alcance — ou seja, até onde aquela memória viaja dentro
do aplicativo.
A variável
de contexto é criada com a função UpdateContext e vive presa a uma única tela. Ela nasce, existe e morre
dentro dos limites daquela tela específica — se o usuário navegar para outra, o
valor dela deixa de existir para quem está na tela nova.
A variável
global é criada com a função Set e vive em um alcance muito maior: o aplicativo inteiro. Uma
vez definida, ela pode ser lida e modificada por qualquer fórmula, em qualquer
tela, em qualquer painel, sem restrição. É esse alcance amplo que torna a
variável global a ferramenta certa sempre que uma informação precisa atravessar
telas e painéis diferentes — exatamente o cenário mais comum dentro de uma
arquitetura de telas híbridas como a do nosso sistema.
O sistema
tem vários tipos de variáveis, mas quase todas são globais, mudando apenas o
contexto em que elas são inseridas — e é justamente essa disciplina que vamos
explorar a seguir.
3. Conhecendo as Primeiras Variáveis do Sistema
Na prática,
vamos conhecer as primeiras variáveis que serão usadas nos próximos tutoriais —
mas deixando claro que, aqui, estamos aprendendo apenas os conceitos. A prática
real, com fórmulas completas amarradas a controles específicos, vai acontecer
quando escrevermos as fórmulas que regem os painéis.
A Pirâmide de Variáveis Globais que Controlam o Sistema
Set(varGlobal_Acao; "A Ação imediata como cadastro de categorias, cadastro de modelos ou movimentações de bens");;
Set(varGlobal_Tarefa; "As tarefas de cada ação como ver, criar, editar, excluir, etc.");;
Essas três
variáveis formam a pirâmide de controle do sistema, com três níveis de contexto
diferentes. A varGlobal_Atividade representa o nível mais amplo — em qual área geral do
sistema o usuário está trabalhando. A varGlobal_Acao representa um nível intermediário — o que, especificamente,
está sendo feito dentro daquela atividade. E a varGlobal_Tarefa representa o nível mais específico — qual etapa exata
daquela ação está em andamento.
Variáveis de Dados
Set(varDadosSubcategoria; Self.Selected);;
Além da
pirâmide de controle, o sistema utiliza variáveis de dados, responsáveis por
guardar informações específicas que o usuário está manipulando em determinado
momento — uma categoria escolhida, uma subcategoria selecionada, e assim por
diante.
4. Por que Poucas Variáveis, com Muito Contexto
Quando estamos aprendendo a criar aplicativos no Power Apps,
é comum pensar em criar uma variável nova para cada pequena necessidade: uma
para cada tela, uma para cada botão, uma para cada painel e assim por diante. O
problema é que essa estratégia cresce rápido demais. Em pouco tempo, o
aplicativo pode ficar cheio de variáveis espalhadas, cada uma com uma função
muito específica, tornando difícil lembrar para que cada uma serve e em que
momento deve ser atualizada.
A filosofia deste sistema segue o caminho oposto: em vez de criar
muitas variáveis com pouco contexto, usamos poucas variáveis globais capazes de
carregar diferentes informações conforme a situação. As três variáveis principais
da pirâmide — varGlobal_Atividade, varGlobal_Acao e varGlobal_Tarefa — servem
para a Tela_Cadastros, para a Tela_Catalogo e para qualquer tela futura. O que
muda é apenas o valor guardado nelas; a estrutura permanece a mesma.
Essa escolha deixa o sistema mais fácil de entender e
manter, porque reduz a quantidade de nomes que você precisa controlar. Sempre
que uma variável for criada ou atualizada com a função Set, lembre que ela
recebe dois argumentos: primeiro, o nome da variável; depois, o valor que será
armazenado nela. Esse valor pode ser um texto, um número, uma cor, o resultado
de uma fórmula ou até um registro inteiro vindo de um controle, como acontece
com Self.Selected. Por enquanto, os exemplos deste tutorial servem como
referência conceitual; as fórmulas definitivas serão aplicadas, passo a passo,
nos próximos tutoriais.
Como Escrever os Dois Tipos de Variáveis
Variáveis de contexto: são criadas com UpdateContext
e devem ser usadas quando o valor só precisa existir dentro da tela atual.
Exemplo: UpdateContext({ varNome: "Osorio" })
Como funciona: a função recebe um registro entre
chaves e cria, ou atualiza, a variável varNome apenas no escopo
daquela tela. Ao navegar para outra tela, essa variável deixa de estar
disponível.
Variáveis globais: são criadas com Set
e devem ser usadas quando o valor precisa ser acessado em qualquer tela do
aplicativo.
Exemplo: Set(varUsuarioLogado; User().FullName)
Como funciona: a função recebe dois argumentos: o
nome da variável e o valor que será guardado nela. Diferente de UpdateContext,
ela não usa chaves e o valor fica disponível para todo o aplicativo enquanto a
sessão estiver ativa.
5. O que Você Aprendeu e os Cuidados para Não Errar
Você
entendeu a diferença entre variável de contexto e variável global, conheceu a
pirâmide de três variáveis globais que vai sustentar o controle do sistema —
Atividade, Ação e Tarefa — e teve o primeiro contato com as variáveis de dados,
que guardam informações específicas manipuladas pelo usuário. Você também
entendeu por que o sistema prefere poucas variáveis carregando muito contexto,
em vez de muitas variáveis dedicadas a propósitos isolados.
Atenção
Técnica
Ao criar
qualquer variável nova no sistema, pergunte-se primeiro se uma variável já
existente não poderia assumir esse novo contexto, em vez de criar uma variável
adicional só para aquele caso específico.
Erro
Comum
O erro mais
comum ao trabalhar com variáveis globais é esquecer que elas são acessíveis de
qualquer tela — um valor definido numa tela pode continuar "vivo" e
visível para outra tela, se não for devidamente limpo no momento certo, gerando
comportamento inesperado em partes do sistema aparentemente sem relação entre
si.
O Que Vem a Seguir
No próximo
tutorial vamos voltar à Tela_Cadastros para configurar, de fato, o ícone e os
três botões que já inserimos no Painel_NavegacaoCad.
Nenhum comentário:
Postar um comentário