# Personalização da Consulta

### Pré-Requisitos

***

O acesso é 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

***

Programa do ERP (com grid)\
Rodapé do grid\
[Personalizar Dados](https://ajuda.consistem.com.br/tecnologia/erp/componentes7/funcionalidades/grid/ferramentas-do-grid#id-9.-personalizar-dados)

### Visão Geral

***

O objetivo deste programa é gerenciar e adicionar novos dados (colunas) ao grid, além de modificar a estilização das células como cores, estilo de fonte, entre outros atributos visuais. O formato deste programa é Modal.

### Campos

***

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

#### Informações

Exibe as informações sobre a rotina de origem.

### Colunas do Grid

***

#### Tabela

Exibe o nome das tabelas relacionadas à consulta.

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

Ao clicar na descrição da coluna **Tabela** será apresentado o programa [Revisão da Tabela (CSW1CUSTOM080)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/revisao-da-tabela.md), possibilitando fazer ajustes na tabela relacionada, como definir quais as colunas devem ficar disponíveis para apresentação no grid.
{% endhint %}

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

O nome da tabela será exibido somente se a coluna tiver sido selecionada através do botão **Adicionar Tabela**.
{% endhint %}

\#### Editar

Apresenta o programa [Inclusão de Tabela (CSW1CUSTOM065)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/inclusao-de-tabela065.md) para manutenção na configuração da tabela de origem manual.

#### Ações

Apresenta tela com as opções:\
\- *Excluir*: exclui a coluna adicionada.\
\- *Alterar Situação*: altera a situação da personalização selecionada entre *Ativo* e *Inativo*. Com a situação *Inativo* não será apresentada a coluna no grid.\
\- *Configurar Detalha (Link)*: exibe o programa [Programa de Detalha (Configuração de Parâmetros) (CSW1CUSTOM068)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/programa-de-detalha-configuracao-de-parametros.md), onde se define como um link de detalhe será criado para os dados desta tabela na consulta.

#### Global

Exibe o nome da global e suas chaves (IdKey).

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

O nome da global será exibido somente se a coluna tiver sido selecionada através do botão **Adicionar Tabela**.
{% endhint %}

\#### Coluna Origem

Exibe o nome da propriedade/coluna da tabela no banco de dados que está sendo referenciada.

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

O nome da coluna origem será exibido somente se a coluna tiver sido selecionada através do botão **Adicionar Tabela**.
{% endhint %}

\#### Origem

Definir como a coluna foi adicionada ou é populada. As opções podem ser:\
\- *Manual*: adicionada explicitamente pelo usuário.\
\- *Automática*: gerada por um relacionamento ou configuração padrão do sistema.

#### Colunas Adicionais

Ao clicar no botão de [TreeView](/glossario/treeview.md), são apresentadas as colunas relacionadas a tabela informada, sendo possível definir quais colunas serão apresentadas.

#### Descrição

Informar uma descrição para as colunas adicionais.

#### Habilitada

Permite marcar o checkbox que determina se o campo/coluna será exibido na consulta. Será possível marcar somente os itens em segundo nível do [TreeView](/glossario/treeview.md).

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

A marcação será possível somente se a coluna tiver sido selecionada através do botão **Adicionar Tabela**.
{% endhint %}

\#### Situação

Exibe a situação da coluna na personalização. As opções podem ser:\
\- *Ativo*\
\- *Inativo*: destacado em vermelho.

#### Entidade Revisada

Exibe *Sim* ou *Não* para determinar se a entidade (classe) foi revisada e liberada pelo usuário.\
Opção *Não*: entidade (classe) não foi revisada pelo programa [Revisão da Tabela (CSW1CUSTOM080)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/revisao-da-tabela.md).

### Botões

***

#### Salvar

Confirma e salva todas as alterações realizadas.

#### Cancelar

Fecha o modal descartando quaisquer alterações não salvas.

#### Adicionar Tabela

Apresenta o programa [Inclusão de Tabela (CSW1CUSTOM065)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/inclusao-de-tabela065.md) para selecionar e adicionar uma nova tabela à consulta.

#### Adicionar Coluna

Apresenta o programa [Cadastro de Código Low Code (CSW1CUSTOM111)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/cadastro-de-codigo-low-code.md) para incluir uma nova coluna (configuração) à consulta atual.

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

É necessário um conhecimento técnico aprofundado para a definição do cadastro *low-code*.
{% endhint %}

\#### Manutenção

A coluna **Descrição** é habilitada para manutenção dos dados.

#### Formatar

Apresenta o programa [Formatação Condicional (CSW1CUSTOM067)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/formatacao-condicional.md) para formatação condicional da personalização selecionada.

#### Logs

Apresenta o programa [Consulta Logs de Alteração (CSWLOG610)](/modulos/componentes/manuais-de-telas/consulta-de-componentes/consulta-logs-de-alteracao.md) com o histórico de logs ou alterações feitas nesta personalização.

\*\*\*

{% 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/personalizacao-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.
