> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/camada-de-personalizacao/definicao-de-variaveis131a.md).

# Definição de Variáveis

### Pré-Requisitos

***

Este programa será apresentado se o **Tipo do Elemento** selecionado na linha do grid for *Tabela de Dados* na [Aba Elementos (CSW1CUSTOM130ATAB3)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/cadastro-de-relatorio/aba-elementos.md) e houver variáveis identificadas no contexto do SQL (exemplo :variavel:)

### Acesso

***

Módulo: Componentes\
Grupo: Camada de Personalização\
[Painel de Relatórios (CSW1CUSTOM130)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/painel-de-relatorios.md)\
Botão **Criar Novo Relatório**\
[Cadastro de Relatório (CSW1CUSTOM130A)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/cadastro-de-relatorio.md)\
[Aba Elementos (CSW1CUSTOM130ATAB3)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/cadastro-de-relatorio/aba-elementos.md)\
Coluna **Ações** - Opção *Configurar*\
[Informar a Query (CSW1CUSTOM131)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/informar-a-query131.md)\
Botão **Variáveis**

### Visão Geral

***

O objetivo deste programa é realizar a correlação (De/Para) entre as variáveis declaradas no código SQL (utilizando a sintaxe :nomeDaVariavel) e os parâmetros globais definidos no cadastro do relatório. Esta etapa é essencial para que a consulta SQL seja filtrada corretamente com base nas escolhas do usuário no momento da impressão.

### Colunas do Grid

***

#### Seq.

Exibe a ordem sequencial das variáveis identificadas na consulta SQL.

#### Descrição Variável

Exibe o nome técnico da variável conforme escrita na query (ex: :qualquerNome).

#### Parâmetro

Selecionar qual parâmetro do relatório (configurado na [Aba Parâmetros (CSW1CUSTOM130ATAB2)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/cadastro-de-relatorio/aba-parametros.md)) deve alimentar esta variável.

### Botões

***

#### Salvar

Grava o vínculo estabelecido entre as variáveis da query e os parâmetros.

#### Manutenção

A coluna **Parâmetro** é habilitada para alteração dos dados.

***

{% hint style="danger" %} <mark style="color:red;">**Atenção**</mark>

As descrições das principais funcionalidades do sistema estão disponíveis na documentação de [Componentes](/tecnologia/erp/componentes.md).\
A utilização incorreta deste programa pode ocasionar problemas no funcionamento do sistema e nas integrações entre módulos.
{% endhint %}

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/camada-de-personalizacao/definicao-de-variaveis131a.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.