# Adicionar Campo Calculado

### 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*\
[Configuração da Consulta (CSW1CUSTOM601)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta.md)\
[Aba Colunas (CSW1CUSTOM601TAB1)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta/aba-colunas.md)\
Botão **Adicionar Campo Calculado**

### Visão Geral

***

O objetivo deste programa é permitir ao usuário criar novas colunas (campos) dinamicamente, cujos valores são o resultado de uma fórmula ou expressão definida. Essa funcionalidade permite enriquecer os conjuntos de dados de uma consulta com informações derivadas, sem a necessidade de alterar a estrutura da fonte de dados original, oferecendo maior flexibilidade para análises e relatórios.

### Campos

***

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

#### Nome da Coluna

Informar o nome que identificará o novo campo calculado. Este nome será o "cabeçalho" da coluna resultante em suas consultas ou exibições.

#### Tipo do Retorno

Selecionar o tipo de dado esperado como resultado da fórmula. As opções são:\
\- *Campo Texto*\
\- *Campo Ano/Mês*\
\- *Campo Data*\
\- *Campo Valor (Float 0 decimais)*\
\- *Campo Valor (Float 1 decimais)*\
\- *Campo Valor (Float 2 decimais)*\
\- *Campo Valor (Float 3 decimais)*\
\- *Campo Valor (Float 4 decimais)*\
\- *Campo Valor (Float 5 decimais)*\
\- *Campo Hora*\
\- *Campo Numérico*\
\- *Campo Sim/Não*\
\- *Situação (Inativo/Ativo)*\
\- *Área de Texto (Observação)*\
\- *Campo Valor (Decimal 0 decimais)*\
\- *Campo Valor (Decimal 1 decimais)*\
\- *Campo Valor (Decimal 2 decimais)*\
\- *Campo Valor (Decimal 3 decimais)*\
\- *Campo Valor (Decimal 4 decimais)*\
\- *Campo Valor (Decimal 5 decimais)*

#### Campo da Fórmula

Selecionar os campos (colunas) existentes em sua consulta ou na fonte de dados que serão utilizados na construção da fórmula. Ao selecionar um campo aqui, automaticamente será inserido no campo **Fórmula** abaixo, pronto para ser usado nas operações. As opções são fixas e pré-definidas no sistema.

#### Fórmula

Exibe a construção da expressão lógica ou matemática que define como o valor do seu campo calculado será determinado. Poderá ser utilizado a calculadora abaixo conforme segue:\
**Operadores Matemáticos:** Botões como +, -, \*, / para adição, subtração, multiplicação e divisão.\
**Parênteses:** Essenciais para agrupar operações e controlar a ordem de precedência na sua fórmula.\
**Valores Numéricos:** Use o teclado virtual (0-9) para inserir números diretamente na sua expressão.\
**Campos da Base de Dados:** Inclua os campos selecionados acima (do Campo **Fórmula**) para realizar cálculos ou manipulações com os respectivos valores.\
**Botões C e X:** C limpa todo o conteúdo do campo **Fórmula**, enquanto X age como um backspace, apagando o último caractere.

### Botões

***

#### Salvar

Finaliza o processo de criação ou edição e armazena a definição do seu campo calculado no sistema, tornando-o disponível para uso em suas consultas.

#### Cancelar

Descarta todas as alterações feitas na tela e retorna ao programa [Configuração da Consulta (CSW1CUSTOM601)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta.md) sem adicionar o campo calculado.

\*\*\*

{% 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/adicionar-campo-calculado.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.