Variável é um local reservado na memória para guardar alguma informação e pode ser obtida ou alterada até perder sua referência. Toda variável possui dois blocos na categoria Variáveis: o bloco obter variável e o bloco atribuir variável.
Figura 1 - Variável com o nome "x" obtendo um valor e passando seu valor para retorno da função (blocos azuis)
Criando uma variável
Para criar uma variável, basta ir à categoria Variável e clicar no botão Criar variável para abrir a janela de criação, nela é possível definir um nome e informar o tipo (referenciar uma entidade do sistema).
Figura 2 - Na janela de criação de variável é possível definir o nome e o seu tipo
O Cronapp possui um tipo de variável chamado Dinâmico que aceita todos os tipos primários (inteiro, booleano, texto etc), arrays, objetos e mais. Esse tipo pode ser usado tanto nos blocos de programação cliente (JavaScript) quanto nos blocos de programação servidor (Java).
Você pode definir uma entidade para uma variável (Figura 2), assim, ao usar blocos como Obter Campo do Objeto, será possível selecionar um atributo dessa entidade. Na figura 3 estamos passando a variável usuário e seu tipo é a entidade User (<app.entity.User>), dessa forma o bloco Obter campo de consegue identificar e exibir quais os atributos existentes nessa entidade.
Figura 3 - Adicionando a entidade que será o tipo da variável
Blocos gerados
Após criar uma variável, dois blocos são gerados: atribuir variável (definir para), que permite alimentar ou atualizar uma variável e o bloco obter variável (retorno), onde é possível obter seu valor. Toda variável é criada com escopo local, ou seja, só poderá ser utilizada na função do bloco em que foi criada.
| Informações |
|---|
Com exceção da variável "item" (padrão), qualquer variável criada e não utilizada em seguida será excluída da lista de variáveis da função, evitando acumulo de variáveis sem uso. |
Figura 4.1 - Após criar uma variável, arraste-a para a área de edição
Obter bloco complementar
O menu de contexto dos blocos de variáveis segue a mesma estrutura dos demais blocos de programação (acesse o tópico Menu de contexto em Bloco de programação), com exceção da opção "Obter bloco complementar". Essa opção cria o bloco de variável complementar, assim, ao selecionar essa opção no bloco atribuir variável (definir para), um bloco obter variável (retorno) da mesma variável será criado e vice-versa. Essa opção é apenas um atalho para evitar ter que arrastar o bloco complementar da categoria Variáveis.
Figura 4.2 - Também é possível obter o bloco complementar de uma variável através do menu de contexto
Manipulação da variável
Ao clicar sobre a caixa de seleção da variável, é possível fazer alguns ajustes:
Figura 5 - Opções disponíveis ao selecionar a caixa de seleção da variável
- Alterar entre as variáveis já criadas para a função.
- Renomear a variável selecionada e adicionar um tipo.
- Excluir todas as referências dessa variável na função, inclusive os blocos acoplados a ela. Para excluir apenas o bloco selecionado:
- Clique com o botão direito sobre o bloco e selecione a opção "Deletar" ou
- Selecione o bloco e use o botão "
Delete".
| Nota |
|---|
Ao renomear uma variável, todas as referências daquela variável serão automaticamente renomeadas. Dessa forma, é importante ficar atento para não renomear uma variável com o mesmo nome de uma variável já existente na função. Por exemplo: Imagine uma função que possua 2 variáveis, " |
Parâmetros da função
Os parâmetros de uma função serão obtidos dentro da categoria variável.
Figura 6 - Acesso aos parâmetros da função através da categoria Variáveis
Variável de escopo
A variável de escopo é responsável por criar uma variável que pode ser usada por outras funções e outros blocos, contanto que ele seja executado no mesmo formulário. Esse bloco só está disponível para blocos clientes (JavaScript).
Figura 7.1 - Criando variável de escopo
No exemplo da figura 7.1 estamos criando uma variável de escopo chamada "nome" na "Função 1" e obtendo seu conteúdo em outra função na figura 7.2.
Figura 7.2 - Obtendo o conteúdo da variável em outra função
Valor da sessão
Para os blocos Servidor (Java) é possível utilizar a Sessão. Uma sessão pode se referir ao conteúdo, local ou variável de armazenamento temporário das informações úteis de um usuário. Essa informação é individual e se mantém armazenada durante a interação do usuário com a aplicação. Para saber mais sobre os campos de sessão, acesse sua documentação.
| Nota |
|---|
Vale lembrar que não é recomendável o uso de variáveis de sessões. Para mais informações esse assunto, acesse o tópico "Uso de Variáveis de Sessão" em Manual de Boas Práticas. |
Nesta página
| Índice |
|---|
...