---
title: "Campos Personalizados"
canonical: "https://centraldeajuda.projuris.com.br/space/PE/43057268/Campos%20Personalizados"
format: markdown
---
### **Contexto**

No dia a dia, cada equipe possui necessidades específicas de coleta e organização de informações. Para atender a essa diversidade, você pode utilizar a funcionalidade **Campos Personalizados**, que permite adaptar formulários e registros do sistema de forma simples, centralizada e flexível. Essa funcionalidade amplia a personalização do sistema e torna os cadastros mais dinâmicos e adequados ao seu contexto de trabalho.

### **Objetivo**

Após a leitura deste artigo, você aprenderá a configurar e gerenciar os Campos Personalizados, definindo regras de exibição, obrigatoriedade, opções de resposta e condições de uso.

> ⚠️ **Importante:** o cadastro de Campos Personalizados será disponibilizado em “ondas” de atualização. Clientes já existentes serão contemplados em etapas futuras e comunicados oportunamente.

### **Criar um novo campo personalizado**

Para criar um novo campo personalizado, acesse: **Painel de Controle > Campos Personalizados** e selecione o contexto desejado.

![configurar.gif](media://94c9cb8e-0ee9-4e23-97da-c46058ff9038)

Ao clicar em **Configurar**, será exibida a página de definição dos campos personalizados: 

### **Tipos de Campos**

Ao criar um novo campo, é necessário escolher o tipo de informação que ele armazenará. Entre as opções disponíveis:

### **Campos Básicos**

- **Texto Curto: **Limite de 250 caracteres. Entrada livre por digitação.
- **Texto Longo: **Limite de 1000 caracteres. Área de texto para descrições extensas.
- **Números: **Entrada exclusivamente numérica, até 200 caracteres.
- **Monetário: **Entrada numérica com formatação automática (R$ 0,00).
- **Data: **Entrada via calendário ou manual, com formato configurável (dd/mm/aaaa).

### **Campos de Seleção**

- **Lista Suspensa (Dropdown): **Permite escolha única com valor padrão opcional.
- **Múltipla Escolha (Checkbox): **Permite múltiplas seleções e definição de valores padrão.
- **Opção Única (Radio): **Usuário final escolhe apenas uma alternativa.

![image 1 - 2026-02-05T182018.511.png](media://71fb37f5-6269-4ab5-9bd7-d47f25678ef5)

### **Propriedades do Campo**

Após selecionar um tipo de campo, é exibida uma área com suas propriedades principais. 

> ⚠️ O formulário de propriedades do campo se adaptará conforme o tipo de campo personalizado selecionado.

Nesse espaço, é possível definir:

- **Título do campo: **nome do campo que será exibido.
- **Descrição (opcional);**
- **Texto de Ajuda:** orienta o usuário final sobre o objetivo do campo e como preenchê-lo corretamente. Quando o texto de ajuda estiver configurado, ele será exibido para o usuário final por meio de uma legenda flutuante, acionada ao passar o mouse sobre o ícone de informação ao lado do campo. Caso o campo não possua texto de ajuda cadastrado, o ícone de informação não será exibido.
- **Quantidade de Caracteres: **número máximo de caracteres (até 99.999), aplicável apenas aos tipos texto, numérico e área de texto.
- **Valor padrão: **valor que será preenchido ou selecionado automaticamente ao acessar o contexto.
- **Obrigatório**: define se o campo deve ser preenchido antes de salvar um registro. Quando ativada, o campo passa a fazer parte das validações do sistema, além disso campos obrigatórios não podem ter essa configuração alterada e só podem ser excluídos se não estiverem em uso.

![image 1 - 2026-02-05T182337.930.png](media://10b813e5-949a-4fad-b449-e2fac5ad956c)

**Lista de Opções **

Para os campos do tipo “Seleção”, será exibida a “Lista de opções”, através da qual o sistema permite gerenciar todos os valores possíveis. 

![image 1 - 2026-02-05T184917.877.png](media://3bdbe2e8-2a64-4680-88d3-ae5ffbbb3eee)

O usuário pode adicionar, editar, excluir e definir opção padrão diretamente em uma janela dedicada a esse gerenciamento.

![image 1 - 2026-02-05T184516.140.png](media://4d72eee5-c27e-49cf-a4a2-960ebe9b4bdb)

A lista pode ser utilizada para padronizar preenchimentos, evitando que cada pessoa insira termos diferentes para indicar a mesma informação.

### **Regras de exibição**

As regras de exibição permitem definir quando e como o campo será mostrado no sistema:

- **Sempre visível**: ao marcar esta opção, o campo será exibido em todos os cenários do contexto selecionado.

![image 1 - 2026-02-05T185115.974.png](media://e1494569-c9cf-4935-b9c3-9c6424a80614)

- **Exibição condicional baseada em outro campo**: você poderá definir critérios que determinam a exibição do campo personalizado.

Configuração da exibição condicional:

- Em **Ao preencher este campo**, selecione o campo de referência.
- Em **E o valor for**, defina o valor que, quando informado ou selecionado, fará o campo personalizado ser exibido.

![image 1 - 2026-02-05T185646.886.png](media://b881487d-ffe2-48d7-b42d-2ca9f936e1cb)

> ⚠️ Atualmente, a exibição condicional pode ser configurada para os contextos de: **Contratos (tipo de contrato)**, **Requisições (tipo de requisição)** e **Processos (natureza do processo)**.

**Importante**

Na configuração de exibição condicional no contexto de **Requisições**, cada campo personalizado pode ser associado a apenas um tipo de requisição por meio da regra definida.

Ou seja, a vinculação é realizada na proporção de 1 para 1: um campo personalizado permite apenas uma associação condicional a um tipo de requisição específico.

Caso seja necessário exibir o mesmo conteúdo para diferentes tipos de requisição, será preciso criar campos personalizados distintos, configurando individualmente a regra de exibição correspondente a cada tipo.

### **Excluir, Ordenar e Limpar**

Ainda durante a edição dos campos é possível excluir os itens adicionados ou reordená-los definindo a sequência ideal para exibição no formulário, sem que haja a necessidade de recriação. 

![excluir reordenar.gif](media://a97554d8-fb4f-4e87-89ca-4c1d74f85021)

> ⚠️ O campo só poderá ser excluído quando não possuir valores preenchidos em nenhum registro e não estiver vinculado a contextos ativos.

Além disso, antes de salvar, caso necessário, é possível limpar a inclusão dos campos realizada durante a configuração.

![limpar.gif](media://5d6afad1-ce07-4cbb-a77f-92bd8462a04e)

### **Listagem de campos personalizados**

Após criar os campos, eles serão exibidos em uma listagem central, onde você poderá selecionar o contexto desejado, buscar registros, excluir e realizar novas configurações por meio da ação **Configurar**.

![image 1 - 2026-02-05T190735.368.png](media://741d5d72-582f-44e2-b872-9f2d3ae5e944)

- Seleção de Contextos: permite aos usuários escolher e filtrar entre diferentes contextos disponíveis. Ao selecionar um contexto, a listagem é atualizada conforme os campos personalizados correspondentes.

![contexto selecao.gif](media://e5d35e57-f3d8-4dc4-9847-656271705b64)

- Para excluir um campo, selecione-o e clique em **Excluir**. Confirme a ação para removê-lo. Caso o campo esteja em uso em algum contexto, o sistema exibirá uma mensagem de bloqueio, impedindo sua exclusão.

![image 1 - 2026-02-05T191532.564.png](media://1e4761a8-6546-434b-98a6-e2cda2d4bac0)

### **Detalhamento do registro**

Ao detalhar um campo personalizado, você poderá visualizar todas as informações cadastradas.

![detalhar.gif](media://23a5e66e-0698-494f-abe6-8071063eb403)

Para os tipos **seleção, seleção múltipla e rádio**, será exibido o menu **Opções**, onde você pode adicionar, editar ou excluir itens de resposta.

**Exemplo prático**:  
Se você criou o campo “Prioridade” do tipo seleção, poderá configurar opções como “Alta”, “Baixa” e “Média”. Caso uma nova categoria seja criada, basta incluir essa opção na lista.

![image 1 - 2026-01-02T111353.329.png](media://e3a57aea-5c70-4a05-a8a8-cb58b606b1f8)

### **Manutenção de campos personalizados existentes**

Ao clicar em **Configurar**, o sistema exibirá do campo personalizado, com o carregamento prévio de todas as informações já cadastradas. Nessa tela, você pode editar apenas as propriedades permitidas para campos já existentes, respeitando as regras de integridade dos dados. As propriedades que podem ser editadas são: título do campo, descrição, texto de ajuda, obrigatoriedade e regras de exibição. O tipo do campo permanece bloqueado e não pode ser alterado após a criação. Ao editar um campo existente o sistema sinalizará em tela.

![image 1 - 2026-02-05T193354.753.png](media://148e6b24-adfc-4b94-b0ed-7a7daacf8961)

Para campos do tipo lista suspensa, múltipla escolha e opção única, a manutenção das opções ocorre diretamente na listagem de opções. Você pode adicionar novas opções a qualquer momento, e elas ficam disponíveis imediatamente para preenchimento. Também é possível editar o texto de uma opção existente; nesse caso, a alteração é refletida em todos os registros que utilizam essa opção, preservando o histórico.

![alterar.gif](media://90fd76db-3d60-46c7-b149-160bfbcf0c8b)

A exclusão de opções segue regras específicas:

- Quando a opção não está sendo utilizada em nenhum registro, a exclusão é imediata;
- Quando a opção já está em uso, o sistema bloqueia a ação.

![Excluir.gif](media://a7c11972-c59d-407b-93c8-8c8932be7ee4)

### **Visualizar campos personalizados**

Após o cadastro, os campos serão exibidos nas rotinas, no grupo **Campos Personalizados**, conforme o contexto selecionado.

**Exemplo prático**:  
Se você criou o campo “Privado ou Particular” no contexto de **Contratos**, ele ficará disponível na tela de cadastro de contratos, agrupado em “Campos Personalizados”.

![image 1 - 2026-02-05T200042.483.png](media://ae8d7629-1bd8-41a1-ba49-54177e66e1b3)

### **Campos personalizados e integrações**

Se um campo personalizado for criado em um contexto que possua integrações configuradas e for definido como **obrigatório**, você deverá informar obrigatoriamente um **Valor padrão**. Essa exigência evita falhas no funcionamento da integração. 

Além disso, ao salvar o cadastro, será exibida uma mensagem recomendando que você notifique os responsáveis pelas integrações sobre a criação ou alteração do campo.

### **Campos personalizados no contexto de Requisições**

Quando você criar campos personalizados nos contextos de **Requisições de Contratos, Processos ou Procurações**, eles não serão integrados aos módulos correspondentes quando a requisição for finalizada. Esse tipo de informação ficará restrito apenas à requisição em que foi inserido.