# Criação de Campos Adicionais

A funcionalidade de **Criação de** **Campos Adicionais** permite **expandir** os programas padrão do Consistem ERP para que eles atendam 100% às particularidades do seu negócio.

Com ela, você pode acoplar uma **rotina auxiliar** a um **programa já existente**, inserindo novos campos, abas e regras de validação sem perder a integridade da rotina original.

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

Apenas programas identificados com o ícone <i class="fa-cubes">:cubes:</i> estão disponíveis para inclusão de campos adicionais.
{% endhint %}

### Tipos de Estruturas Disponíveis

A complexidade da personalização pode variar de acordo com a necessidade de dados que você precisa capturar. O sistema suporta desde formulários simples até estruturas hierárquicas complexas:

* **Cadastro Simples:** Ideal para formulários básicos e diretos (Ex: Cadastro de Operador). \
  É utilizado quando você precisa apenas de campos de preenchimento simples (texto, número, data).
* **Cadastro com Abas e Grids:** Permite organizar um grande volume de informações extras separando-as em abas ou listas.
* **Mestre-Detalhe (Hierárquico):** A estrutura mais robusta, utilizada quando há dependência entre os dados.

### Personalizando um programa

Para ilustrar, vamos utilizar o programa  [Cadastro de Empresa (CCAPL000)](https://app.gitbook.com/s/JAFv73zIUkocB6ArsYjv/manuais-de-telas/cadastros-gerais/cadastro-de-empresa) . O objetivo é adicionar informações de contato que não existem no padrão.

#### Configurando a Rotina Auxiliar:

1. Acesse o programa [Camada de Personalização (CSW1CUSTOM010)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/camada-de-personalizacao), ícone <i class="fa-cubes">:cubes:</i> opção **Dados Gerais**.
2. Defina o **Tipo da Rotina**: neste exemplo, selecionamos "Cadastro Simples".
3. Insira o **Título da Rotina**: defina como "Complemento Cadastro de Empresa".
4. Crie os Campos Adicionais: inclua os campos "WhatsApp" e "Idioma".

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2Fzkg6uaUzAPWgn1h12SBL%2F2026-04-03_16h27_06.png?alt=media&#x26;token=a2e5129f-3492-4f51-aa50-c9b3e33b739d" alt=""><figcaption></figcaption></figure>

Após preencher os dados, clique no botão **Gerar Rotina**. O sistema irá processar as informações e a personalização estará imediatamente disponível para uso no Cadastro de Empresa.

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FYta6AUkbn8wcWW8jlCJp%2F2026-04-03_16h31_21.png?alt=media&#x26;token=4bca991b-8c96-4217-b173-a4b5108a9fb1" alt=""><figcaption></figcaption></figure>

#### Como acessar a personalização?

Uma vez configurada a camada de personalização em um programa, o botão **Personalizar** ficará visível na tela. Este botão é o portal para acessar os campos extras que foram criados.

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FxPXyCbENPbghpjEtnhwT%2F2026-04-03_16h32_55.png?alt=media&#x26;token=33a2ecfb-18c9-4c67-b115-6b9526041e5a" alt=""><figcaption></figcaption></figure>

#### Rotina personalizada

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2Fq2dARRBdJpajn9hh0Ftm%2F2026-04-03_16h33_36.png?alt=media&#x26;token=81353235-9fff-49a8-8679-b272b923b42c" alt="Complemento Cadastro de Empresa"><figcaption></figcaption></figure>

#### **Status Visual (Cores do Botão)**

Para facilitar a operação, a cor do botão Personalizar muda dinamicamente para indicar o status dos dados preenchidos naquela tela auxiliar:

<table><thead><tr><th width="116">Cor</th><th width="172">Status</th><th>Significado</th></tr></thead><tbody><tr><td><mark style="background-color:$info;">Cinza</mark></td><td>Sem Dados</td><td>Não há informações preenchidas ou salvas nos campos adicionais.</td></tr><tr><td><mark style="background-color:yellow;">Amarelo</mark></td><td>Dados Temporários</td><td>O usuário preencheu informações, mas elas ainda não foram efetivadas no banco de dados.</td></tr><tr><td><mark style="background-color:green;">Verde</mark></td><td>Dados Gravados</td><td>As informações adicionais foram salvas com sucesso e estão vinculadas ao registro principal.</td></tr></tbody></table>

***

### Regras de Negócio e Validações

Mais do que apenas guardar dados, a camada de personalização permite garantir a qualidade da informação através do botão Validações.

É possível criar "travas" ou regras lógicas que impedem a gravação se determinada condição não for atendida.

{% hint style="success" %} <mark style="color:$success;">**Exemplo**</mark>\
\
Imagine que você criou um campo personalizado e deseja impedir que o processo continue se o valor digitado for "99". O sistema exibirá uma mensagem de erro e interromperá a gravação.
{% endhint %}

{% hint style="info" %}
**Nota Técnica** \
\
A validação utiliza lógica condicional padrão. \
\&#xNAN;*Exemplo de código:* `if ID000001=99 quit $$$Error("Esta condição não é permitida")`
{% endhint %}

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2F1OhPqJLs080AsRtRZYaf%2F2026-04-03_16h35_36.png?alt=media&#x26;token=c40f637b-8f27-4ba1-99a9-086e79d98ca8" alt=""><figcaption></figcaption></figure>

***

### Configuração Técnica&#x20;

Esta seção é destinada aos analistas responsáveis pela configuração da rotina.

* **Persistência de Dados:** Para cadastros simples, lembre-se de definir a global de persistência correta (Ex: **^%CSMENOP**) e o título da janela.
* **Configurando Mestre-Detalhe:** Para ativar estruturas hierárquicas, navegue até a [Aba Propriedades (CSW1CUSTOM010TAB2) ](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/camada-de-personalizacao/aba-propriedades)e selecione a opção **Objeto** no campo "Tipo Campo".

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