> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/~/revisions/ZEf8tqpkUEBhycM8s1jE/tools/parametros.md).

# Parâmetros

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

O recurso **Parâmetros** permite criar variáveis reutilizáveis dentro do seu processo (flow).\
Essas variáveis podem ser usadas em filtros SQL, variáveis de ambiente para scripts JavaScript ou para transferir valores entre blocos de execução.

***

### **Onde encontrar**

A aba **Parâmetros** está localizada no painel lateral esquerdo.\
Ao abrir o menu do Studio, você verá a área dedicada para criação e edição de parâmetros.

***

### **Como adicionar um novo parâmetro**

1. Clique no botão **“+”** no canto superior direito da aba **Parâmetros**.
2. Uma janela de configuração será exibida com os seguintes campos:
   * **Param name**: Nome único do parâmetro (**obrigatório**).
   * **Description**: Campo opcional para explicar o propósito ou uso do parâmetro.
   * **Value**: Valor padrão a ser usado durante as execuções (pode ser alterado dinamicamente).
3. Clique em **Save** para criar o parâmetro.

{% hint style="warning" %}
&#x20;**Dica**: Ao usar parâmetros em filtros dentro de dashboards, se quiser que todos os valores sejam o padrão, utilize `all_`.
{% endhint %}

***

### **Como usar parâmetros**

Depois de criados, os parâmetros podem ser usados em diferentes blocos do seu fluxo:

* **Em consultas SQL**: use a sintaxe `{{ parameter_name }}`
* **Em blocos JavaScript**: `{{params.parameter_name}}`
* **No Builder (Computed)**: `{{ parameter_name }}`
* **Em filtros visuais de dashboard**: utilize parâmetros para filtrar dados dinamicamente

***

### **Gerenciando parâmetros**

* **Editar e Excluir**: Clique nos três pontos e selecione a opção desejada.
* **Copiar**: Clique no ícone de copiar.

***

### **Notas**

* O campo **User ID** é um parâmetro interno especial e pode ser usado para identificar o usuário atual.
* Parâmetros têm escopo restrito ao fluxo atual e **não** afetam outros projetos ou processos.
* É possível definir e usar múltiplos parâmetros simultaneamente ao longo do seu fluxo.