> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/geral/utilizar-variaveis.md).

# Utilização de Variáveis no Genesis

### Visão Geral

O console de Variáveis permite cadastrar e gerenciar variáveis utilizadas pelas rotinas do Genesis. Fica localizado ao lado de **Propriedades da Rotina** e **Log**, e é dividido em duas abas: **Rotina e Projeto.**

<figure><img src="/files/6CVqTuRDuoFkA0RHvtx2" alt=""><figcaption></figcaption></figure>

<p align="center"> Console de Variáveis com a aba Projeto ativa</p>

***

### Tipos de variáveis

#### Variáveis Rotina

Ficam disponíveis **apenas na rotina onde foram criadas**. Não podem ser acessadas por outras rotinas do mesmo projeto.

<figure><img src="/files/yXKzA3ngjnHXbMi0jpr9" alt=""><figcaption></figcaption></figure>

<p align="center"> Aba <strong>Rotina</strong> do console de variáveis</p>

#### Variáveis Projeto

Ficam disponíveis em **todas as rotinas do projeto**. Use quando o valor precisar ser compartilhado entre múltiplas rotinas.

<figure><img src="/files/DgPs4ZvPAzVZviO8BLRm" alt=""><figcaption></figcaption></figure>

<p align="center">Aba <strong>Projeto</strong> do console de variáveis</p>

<figure><img src="/files/sZuYccPeQ4HXkEVJaGNS" alt=""><figcaption></figcaption></figure>

<p align="center">Menu suspenso de seleção de variável em um componente, mostrando <code>varprojeto</code> e <code>varRotina</code> disponíveis simultaneamente dentro da rotina que as criou</p>

***

### Como usar

#### Passo 1 — Acessar o console de Variáveis

No editor da rotina, clique na aba **Variáveis**, ao lado de **Propriedades da Rotina** e **Log**.

#### Passo 2 — Escolher o escopo (Rotina ou Projeto)

Selecione a aba correspondente ao escopo desejado:

* **Rotina** → variável disponível apenas nesta rotina
* **Projeto** → variável disponível em todas as rotinas do projeto

#### Passo 3 — Criar uma nova variável

Clique em **+ Nova Variável** no canto superior direito. Uma nova linha será adicionada à tabela.

#### Passo 4 — Configurar a variável

Preencha os campos:

* **Nome** — identificador da variável
* **Tipo** — tipo de dado (ver tabela abaixo)
* **Lista?** — marque para transformar a variável em lista
* **Valor** — valor inicial (opcional; em variáveis Projeto corresponde ao "Valor padrão")

***

### Campos e opções

| Campo  | Descrição                                              | Valores aceitos                                      |
| ------ | ------------------------------------------------------ | ---------------------------------------------------- |
| Nome   | Identificador da variável usado nos componentes        | Texto                                                |
| Tipo   | Tipo de dado armazenado                                | Dinâmico, Texto, Inteiro, Lógico, Decimal, Data/Hora |
| Lista? | Transforma a variável em uma lista do tipo selecionado | Marcado / Desmarcado                                 |
| Valor  | Valor inicial da variável                              | Depende do tipo escolhido                            |

#### Tipos disponíveis

| Tipo      | Descrição                     |
| --------- | ----------------------------- |
| Dinâmico  | Aceita qualquer tipo de valor |
| Texto     | Cadeia de caracteres          |
| Inteiro   | Número inteiro                |
| Lógico    | Verdadeiro ou falso           |
| Decimal   | Número com casas decimais     |
| Data/Hora | Valor de data e/ou hora       |

<figure><img src="/files/rhEDgWCNX1R9yKYtJAp9" alt=""><figcaption></figcaption></figure>

<p align="center">Menu suspenso com os tipos de variáveis disponíveis</p>

#### Modo Lista

Ao marcar a caixa de seleção **Lista?**, a variável passa a armazenar uma coleção de valores do tipo selecionado. O rótulo do tipo muda para **Lista \[Tipo]** (ex: `Lista Texto`).\ <br>

<figure><img src="/files/4jdPj6Z0gGz1aHjiqbwL" alt=""><figcaption></figcaption></figure>

<p align="center">Variável configurada como <code>Lista Texto</code> com a caixa de seleção Lista? Ativo</p>

***

### Observações e dicas

* 💡 Use **variáveis rotina** sempre que o valor não precisar ser compartilhado — isso mantém a rotina isolada e evita efeitos colaterais em outras rotinas do projeto.
* 💡 Use **variáveis projeto** para valores compartilhados entre rotinas (ex: credenciais, configurações, contadores).
* 💡 No componente **Atribuir Valor Variável**, o menu suspenso mostra todas as variáveis acessíveis naquele escopo — projeto e rotina da rotina atual.
* ⚠️ Uma variável rotina criada em uma rotina **não estará visível** em outras rotinas, mesmo dentro do mesmo projeto.
* ⚠️ O tipo **Dinâmico** aceita qualquer valor, mas reduz a previsibilidade da rotina — prefira tipos específicos quando possível.