> 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/tools/tarefas/etl/definir-valor-de-parametro.md).

# Definir valor de parâmetro

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

A **tarefa Definir valor de parâmetro** no **Gaio DataOS** permite atribuir manualmente um novo valor a um parâmetro existente dentro de um fluxo de dados. É um recurso fundamental para controlar a execução do fluxo, atualizar dinamicamente o contexto ou sobrescrever valores padrão em tempo de execução.

***

## Como usar

### 1. Abrir a task

Navegue até:\
**Tasks > ETL > Definir valor de parâmetro**

***

### 2. Configurar os campos da task

* **Rótulo (opcional):** Rótulo personalizado para identificar esta task no fluxo.
* **Parâmetro:** Selecione o parâmetro que deseja atualizar. Ele **deve já existir** no ambiente.
* **Padrão:** Valor padrão original do parâmetro (somente leitura).
* **Atual:** Valor atual em uso antes da atualização (somente leitura).
* **Valor:** Novo valor que será atribuído ao parâmetro durante a execução do fluxo.

{% hint style="warning" %}
O valor definido aqui sobrescreve temporariamente o valor atual do parâmetro durante a execução do fluxo e pode ser reutilizado por outras tasks na sequência.
{% endhint %}

***

### 3. Salvar e aplicar

* Após informar o novo valor no campo **Value**, clique em **Save**.
* Quando o fluxo for executado, o parâmetro será atualizado em tempo real com o novo valor atribuído.

***

### Casos de uso

* Atualizar dinamicamente filtros ou variáveis antes da execução de queries
* Aplicar lógica condicional baseada em valores definidos em runtime
* Personalizar execuções a partir de entradas do usuário ou valores contextuais
* Sobrescrever parâmetros herdados de outros fluxos ou configurações padrão