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. 

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

1. Alterar entre as variáveis já criadas para a função.
2. Renomear a variável selecionada e adicionar um tipo.
3. 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".

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.