# Informar a Query

### Pré-Requisitos

***

O acesso à Camada de Personalização é concedido no programa [Configuração de Permissão de Perfil e Usuário (CSWMEN070)](/modulos/componentes/manuais-de-telas/configuracao-dos-componentes/configuracao-de-permissao-de-perfil-e-usuario.md), onde se deve marcar a opção *Permitir Acesso a Camada de Personalização de Programas* na coluna **Configuração**. Este acesso é automaticamente liberado para **Usuários Administradores** e **Usuários Consistem**

### Acesso

***

Módulo: Componentes\
Grupo: Camada de Personalização\
[Painel de Consultas (CSW1CUSTOM100)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/painel-de-consultas.md)\
Botão **+Criar Nova Consulta** - Opção *A Partir de uma Query SQL Existente*\
[Configuração da Consulta (CSW1CUSTOM601)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta.md)\
Botão **Editar Query**

### Visão Geral

***

O objetivo deste programa é permitir ao usuário definir ou editar consultas de dados, tornando-as dinâmicas através da inclusão de variáveis. Isso possibilita a criação de relatórios ou filtros parametrizados, adaptáveis a diferentes necessidades sem reescrita constante.\
Esta interface serve como um ambiente para o usuário inserir e configurar o código de uma query, que será executada pelo sistema para interagir com uma fonte de dados. O recurso de variáveis é um ponto chave, permitindo que as queries sejam reutilizáveis e flexíveis.

{% hint style="warning" %} <mark style="color:orange;">**Importante**</mark>

O **Aviso** (intitulado Dica do Fonte) é um componente informativo com orientações essenciais sobre como utilizar a área de Query.
{% endhint %}

\### Campos

***

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

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

Informar a sintaxe da query (por exemplo, SQL para bancos de dados relacionais). A informação deve estar correta para garantir a execução bem-sucedida.\
\
Para tornar a query flexível, você pode incorporar variáveis. A sintaxe padrão para uma variável é **:qualquerNome:**.\
\
Exemplo: Se quiser buscar dados de um cliente específico, a query poderia ser: **SELECT \* FROM clientes WHERE id\_cliente = :idDoCliente**.\
\
Quando a query for executada, o sistema solicitará ou buscará um valor para **idDoCliente**, permitindo que use a mesma query para diferentes IDs.

### Botões

***

#### Salvar

Confirma e armazena a query que foi criada ou modificada.

#### Variáveis

Apresenta o programa \_ (CSW1CUSTOM606)\_ para definição das variáveis utilizadas na *query SQL*.

\*\*\*

{% 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-query.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.