# Personalizar Campo

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

***

**Para cadastro**\
Programa do ERP (exceto Componentes)\
[Ícone de Cubo](https://ajuda.consistem.com.br/tecnologia/erp/componentes7/interface-visual/elementos/barra-de-titulo#id-8.-camada-de-personalizacao) - Camada de Personalização (canto superior direito da tela)\
Opção *Dados Gerais* (somente para os programas listados como disponíveis na [Consulta Camada de Personalização (Programas de Cadastro) (CSW1CUSTOM610)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/consulta-camada-de-personalizacao-programas-de-cadastro.md))\
\
**Para visualização**\
Módulo: Componentes\
Grupo: Camada de Personalização\
[Consulta Camada de Personalização (Programas de Cadastro) (CSW1CUSTOM610)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/consulta-camada-de-personalizacao-programas-de-cadastro.md)\
Botão **Camada Personalização**\
[Camada de Personalização (CSW1CUSTOM010)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/camada-de-personalizacao.md)\
[Aba Propriedades (CSW1CUSTOM010TAB2)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/camada-de-personalizacao/aba-propriedades.md)\
Hiperlink da Coluna **Editar**

### Visão Geral

***

O objetivo deste programa é especificar os detalhes do campo que será criado. Isso inclui o tipo do campo, seu nome, o alinhamento, as dimensões, a validação e outros dados relevantes para criação do campo na rotina.

### Campos

***

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

#### Rotina

Exibe informações da rotina personalizada.

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

Selecionar o tipo de campo que será criado. As opções são:\
\- *Campo Texto*\
\- *Campo Ano/Mês*\
\- *Campo Data*\
\- *Campo Valor (Float)*\
\- *Campo Hora*\
\- *Campo Numérico*\
\- *Campo Sim/Não*\
\- *Situação (Inativo/Ativo)*\
\- *Área de Texto (Observação)*\
\- *Campo Valor (Decimal)*\
\- *Objeto*

#### Descrição Campo<mark style="color:red;">**|**</mark>

Informar a descrição do campo (label) que será criado.

#### Campo Obrigatório<mark style="color:red;">**|**</mark>

Selecionar *Sim* ou *Não* para definir se o campo a ser criado será obrigatório.

#### Tamanho Máximo | Tamanho Mínimo<mark style="color:red;">**|**</mark>

Informar os tamanhos mínimo e máximo do campo que será criado.

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

Informar o alinhamento do campo, podendo ser:\
\- *Direta*\
\- *Esquerda*

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

Informar a classe de dados que se relaciona ao campo. Para tipos já definidos no sistema.

{% hint style="success" %} <mark style="color:green;">**Exemplo**</mark>

Propriedade do tipo empresa: Cad.Empresa
{% endhint %}

{% hint style="info" %} <mark style="color:blue;">**Botão F7**</mark>

Apresenta tela com as opções disponíveis para seleção:\
\- *Busca por Global*\
\- *Busca por Parte do Nome*\
\- *Busca por Tabelas com Log*\
\- *Tabelas Revisadas*\
\- *Meus Cadastros*
{% endhint %}

\#### Valor Padrão<mark style="color:red;">**|**</mark>

Informar o valor inicial para novos cadastros do campo, valor de sugestão para campos do tipo lista de opção.

#### Tipo da Seleção<mark style="color:red;">**|**</mark>

Determinar como a seleção de valores pode ser feita. As opções são:\
\- *Registro Único*\
\- *Multi Seleção*

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

Informar a quantidade de decimais de um campo do tipo valor (Decimal ou Float).

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

Informar os valores de uma lista de opções, cada valor deve ser informado separado por "," vírgula.

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

Este é o valor que será gravado na base de dados, quando o usuário selecionar a opção do campo de lista de opções.
{% endhint %}

\#### Displays Lista<mark style="color:red;">**|**</mark>

Informar as descrições da lista de opções separadas por "," vírgula, conforme o campo **Valores Lista**. Deve conter a mesma quantidade de opções separadas por vírgula, igual ao campo **Valores Lista**.

#### Regex Validação

Informar a expressão que consiste em verificar se um valor segue um padrão específico usando uma expressão regular.\
A regex descreve uma estrutura de caracteres permitida (como formato de e-mail, data, número, código, etc.), e a validação confirma se o conteúdo digitado corresponde exatamente a esse padrão.

{% hint style="info" %} <mark style="color:blue;">**Botão F7**</mark>

Apresenta tela com os exemplos de validação com regex disponíveis para seleção.
{% endhint %}

\### Botões

***

#### Confirma

Confirma os dados informados na tela.

#### Cancelar

Limpa as informações descritas na tela.

#### Definir Campos

Apresenta a [Aba Propriedades (CSW1CUSTOM010TAB2)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/camada-de-personalizacao/aba-propriedades.md) para configurar subcampos, atributos ou detalhes adicionais.

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

Este botão será habilitado se o **Tipo Campo** selecionado for *Objeto*.
{% endhint %}

\*\*\*

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