# Configuração da Consulta

### 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 Tabela (Relacionamento)* ou *A Partir de uma Query SQL Existente*

### Visão Geral

***

O objetivo do programa é permitir ao cliente definir os dados da criação da nova consulta, os campos, relacionamentos, filtros, entre outros.\
Esta tela é composta por:\
[Aba Colunas (CSW1CUSTOM601TAB1)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta/aba-colunas.md)\
[Aba Filtros (CSW1CUSTOM601TAB2)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta/aba-filtros.md)\
[Aba Tabelas Relacionadas (CSW1CUSTOM601TAB3)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta/aba-tabelas-relacionadas.md)\
[Aba Preview (CSW1CUSTOM601TAB4)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta/aba-preview.md)

### Campos

***

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

#### Nome da Consulta

Informar o nome escolhido para nova rotina de consulta.

#### Multiempresa

Marcar *Sim* ou *Não* para determinar se a consulta é multiempresa.

### Botões

***

#### Salvar

Salva as informações da tela e cria uma nova rotina de consulta.

#### Cancelar

Limpa as informações descritas na tela.

#### Editar Query

Apresenta o programa [Informar a Query (CSW1CUSTOM605)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/informar-a-query.md) para manutenção do plano de consulta em SQL.

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

Este botão será apresentado se a forma de acesso à este programa for através da opção *A Partir de uma Query SQL Existente*.
{% endhint %}

\#### Visualizar Query

Apresenta tela para visualização da Query de acordo com a seleção no grid.

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

Este botão será apresentado se a forma de acesso à este programa for através da opção *A Partir de uma Tabela (Relacionamento)*.
{% endhint %}

\#### Testar Consulta

Executa uma prévia da consulta conforme os dados e informações definidas pelo usuário.

\*\*\*

{% 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/configuracao-da-consulta.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.