# Informar a Query

### 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)

### 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*

### Visão Geral

***

O objetivo deste programa é permitir a escrita de consultas SQL customizadas para listar múltiplos registros no relatório, como os itens de um pedido ou movimentações financeiras.

### Campos

***

*Campos assinalados com* <mark style="color:red;">**|**</mark> *são de preenchimento obrigatório.*

#### Query<mark style="color:red;">**|**</mark>

Informar a instrução SQL (SELECT) para buscar os dados no banco de dados.

### Botões

***

#### Salvar

Grava a consulta técnica editada para o elemento do relatório.

#### Variáveis

Apresenta o programa *Definição de Variáveis (CSW1CUSTOM131A)* para selecionar quais parâmetros do relatório (configurados na [Aba Parâmetros (CSW1CUSTOM130ATAB2)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/cadastro-de-relatorio/aba-parametros.md)) irão alimentar as variáveis definidas na query com a sintaxe :qualquerNome.

#### Testar Relatório

Permite gerar uma prévia do PDF utilizando a consulta atual e os valores de teste (mock) para validar se os dados estão sendo extraídos corretamente.

***

{% 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: 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:

```
GET https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/camada-de-personalizacao/informar-a-query131.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.