Campos
Nesta seção
Defina a estrutura de dados da categoria
Os campos definem as propriedades e o formato dos dados dentro de uma categoria. Cada campo possui um tipo (texto, número, data, seleção, relacionamento, entre outros) e pode ser configurado com regras de validação, condições de exibição, eventos automáticos e textos de ajuda.
Como criar um campo
Acesse as configurações da categoria
No menu lateral esquerdo, vá em Configurações > Estrutura > Categorias.
Acesse os campos da categoria
Na configuração da categoria, clique no card Campos e depois em Criar.
Preencha a aba Definição
- Nome do campo (obrigatório) — o nome de exibição do campo.
- Referência técnica (obrigatório) — o identificador interno do campo em
snake_case(ex:nome_cliente,valor_total). Pode ser preenchido manualmente ou gerado automaticamente a partir do nome. É essa referência que será usada nas variáveis ({{data.referencia_tecnica}}). - Tipo de Campo (obrigatório) — selecione o tipo de dado. Veja a lista completa na seção Tipos de campo.
A referência técnica e o tipo de campo não podem ser alterados após a criação. Escolha com cuidado.
Configure as demais abas (opcional)
- Visual — ícone, largura do campo na tela, esquema de cores e agrupamento por seção. Use quando quiser personalizar a aparência do campo na interface.
- Regras e Condições — validações, valor inicial, preservação de dados e condicionais de exibição. Use quando o campo tiver regras de preenchimento ou precisar aparecer apenas em determinadas condições.
- Eventos de Campo — ações automáticas disparadas quando o valor do campo é alterado. Use quando quiser que a alteração de um campo dispare ações em outros campos ou no sistema.
- Ajuda — espaço reservado (placeholder), texto de ajuda, instrução e descrição. Use para orientar o preenchimento do campo com textos explicativos exibidos ao usuário.
Salve
Clique em Salvar.
Por padrão, todo novo campo é criado sem permissões liberadas. Após salvar, o sistema solicitará a configuração de permissões (Ver, Criar, Atualizar, Excluir) se você tiver autorização. Caso contrário, solicite a um administrador.
Gerenciar campos
Editar
Campos existentes podem ser editados a qualquer momento — nome, configurações visuais, regras, eventos e textos de ajuda podem ser alterados livremente. Apenas a referência técnica e o tipo de campo são permanentes.
Reordenar
A ordem em que os campos são criados define a ordem de exibição padrão na tabela de itens da categoria. Para reorganizar sem alterar a ordem de criação, utilize Visualizações Personalizadas.
Excluir
Campos podem ser excluídos a qualquer momento. Os dados dos itens que já utilizavam o campo permanecem salvos internamente, mas não podem ser editados — editar o item após a exclusão do campo faz com que a referência ao dado seja perdida.
Não é possível duplicar campos.
Valor inicial
Todo campo pode ter um valor inicial — um valor que já vem preenchido automaticamente quando o formulário é aberto para criação de um novo item. Pode ser um valor fixo (ex: 0, Pendente) ou uma expressão dinâmica (ex: {{data.outro_campo}}, dayjs()).
Acesse a configuração do campo
Na tela de campos da categoria, clique no campo que deseja configurar (ou crie um novo).
Vá até a aba Regras e Condições
Na sidebar de configuração, clique na aba Regras e Condições.
Preencha o campo Valor Inicial
Insira o valor desejado:
- Valor fixo — digite diretamente (ex:
0,Pendente,true). - Expressão — utilize variáveis e funções (ex:
{{data.outro_campo}},math({{data.preco}} * 1.1),dayjs()).
Ative a expressão (se aplicável)
Se você inseriu uma expressão (e não um valor fixo), role até a parte inferior da sidebar, na área de Pré-visualização do campo, e ative o booleano "Utilize a expressão para o valor inicial". Sem essa ativação, o sistema tratará o texto como valor literal.
Para entender a sintaxe de expressões, consulte Expressões.
Salve
Clique em Salvar. O valor inicial será aplicado a todos os novos itens criados na categoria a partir desse momento.
Tipos de campo
Os campos disponíveis estão organizados por categoria:
Texto
| Campo | Descrição |
|---|---|
| Texto | Texto simples, ideal para nomes e descrições curtas. |
| Texto Longo | Para descrições detalhadas e textos extensos. |
| HTML | Editor de texto com formatação HTML. |
Valor e Tempo
| Campo | Descrição |
|---|---|
| Número | Valores numéricos com limites configuráveis. |
| Valor Monetário | Valores em dinheiro com moeda associada. |
| Duração | Tempo em horas, minutos e segundos. |
| Data | Seleção de datas, útil para prazos e eventos. |
Seleção Única
| Campo | Descrição |
|---|---|
| Alternativa Binária | Sim/não, verdadeiro/falso. |
| Botões de Seleção Única | Escolha única entre opções visíveis. |
| Lista de Seleção Única | Dropdown com uma única escolha. |
Seleção Múltipla
| Campo | Descrição |
|---|---|
| Caixas de Seleção | Marcar múltiplas opções. |
| Lista de Seleção Múltipla | Dropdown com múltiplas seleções. |
Relacionamentos
| Campo | Descrição |
|---|---|
| Relacionamento Simples | Conecta a outro item (um para um). |
| Relacionamento Múltiplo | Conecta a vários itens (um para muitos). |
Mídia e Arquivos
| Campo | Descrição |
|---|---|
| Arquivo | Upload de documentos e arquivos. |
| Imagem | Upload de imagens. |
| Exibição e tratamento de arquivos PDF. |
Documentos
| Campo | Descrição |
|---|---|
| Editor de Documentos | Edição avançada de documentos com templates. |
| Assinatura Eletrônica | Assinatura digital de documentos via integrações. |
Estrutura
| Campo | Descrição |
|---|---|
| Grupo | Agrupamento de campos relacionados. |
| Repetidor | Conjunto de campos que se repete em estrutura de lista. |
| Matriz de Dados | Tabela de dados estruturados. |
Compostos
| Campo | Descrição |
|---|---|
| Endereço | Conjunto predefinido de subcampos para dados de localização. |
| Pessoa/Empresa | Conjunto predefinido de subcampos para dados de pessoa física ou jurídica. |
Especiais
| Campo | Descrição |
|---|---|
| Tags | Marcadores criados a partir de texto digitado. |
| Anotações | Registro de anotações com arquivos e histórico. |
| Chat | Troca de mensagens vinculada a um item. |
| Campo Virtual | Campo de valor dinâmico, calculado automaticamente. |
| ID Personalizado | Identificador customizado para os itens. |
Campos de opções
Os campos de opções do ENSPACE são utilizados para registrar escolhas, estados e seleções predefinidas em formulários, tarefas e telas.
Eles podem ser usados para:
- limitar respostas a valores predefinidos;
- padronizar categorias, status e classificações;
- coletar consentimentos e confirmações;
- exibir alternativas de forma organizada;
- evitar erros de digitação em dados repetitivos;
- acelerar o preenchimento com seleção rápida.
Comparação entre os campos
| Recurso | Booleano | Lista de Opções | Rádio | Caixa de Seleção | Multi-Seleção |
|---|---|---|---|---|---|
| Aceita múltiplas seleções | Não | Não | Não | Sim | Sim |
| Exibe todas as opções | Sim | Não | Sim | Sim | Não |
| Tipo de dado armazenado | Booleano | String | String | Array | Array |
| Possui opções predefinidas | Sim (2 fixas) | Sim | Sim | Sim | Sim |
| Permite valor padrão | Sim | Sim | Sim | Sim | Sim |
| Ocupa espaço visual | Mínimo | Compacto | Médio | Grande | Compacto |
| Permite adicionar opções livres | Não | Não | Não | Não | Não |
Como os campos de opções funcionam
Os campos de opções restringem o preenchimento a valores predefinidos pelo administrador.
O campo Booleano funciona como um campo de boolean, armazenando apenas dois estados possíveis: verdadeiro ou falso.
true) ou falso (false). É utilizado para representar estados binários como sim/não, ativo/inativo ou habilitado/desabilitado.Os campos Lista de Opções e Rádio funcionam como campos de string com seleção restrita. O valor armazenado é exatamente o texto da opção escolhida.
Já os campos Caixa de Seleção e Multi-Seleção armazenam múltiplos valores simultaneamente.
Recursos compartilhados
Todos os campos de opções compartilham recursos de configuração e padronização das alternativas disponíveis.
Opções predefinidas
As opções são definidas pelo administrador durante a criação ou edição do campo.
Cada opção possui:
- rótulo: o texto exibido ao usuário;
- valor interno: o texto armazenado no sistema (pode ser igual ou diferente do rótulo).
Valor padrão
Define qual opção (ou opções) será preenchida automaticamente quando o campo estiver vazio no formulário.
| Campo | Comportamento do padrão |
|---|---|
| Booleano | Preenche como Sim ou Não conforme configurado. |
| Lista de Opções | Seleciona a opção padrão no dropdown. |
| Rádio | Marca o botão da opção padrão. |
| Caixa de Seleção | Marca as opções padrão automaticamente. |
| Multi-Seleção | Seleciona as opções padrão na lista. |
Modos de exibição
A forma como as opções são apresentadas influencia diretamente na experiência de preenchimento.
| Modo | Campo | Descrição |
|---|---|---|
| Dropdown compacto | Lista de Opções | Exibe apenas a opção selecionada; as demais aparecem ao clicar. |
| Botões visíveis | Rádio | Todas as opções aparecem simultaneamente, facilitando comparação. |
| Caixas independentes | Caixa de Seleção | Cada opção é uma escolha separada que pode ser marcada ou desmarcada. |
| Tags compactas | Multi-Seleção | Exibe as opções selecionadas como tags; a lista completa aparece ao clicar. |
| Toggle | Booleano | Exibe um controle de alternância entre dois estados. |
Cores e identificação visual
É possível atribuir cores ou ícones às opções para facilitar a identificação visual do valor selecionado.
Isso é útil para:
- status de processos (verde, amarelo, vermelho);
- prioridades (baixa, média, alta);
- categorias coloridas;
- sinalização rápida em relatórios e kanbans.
Comportamento dos dados
As configurações aplicadas nos campos de opções afetam diretamente o valor salvo e a consistência dos registros.
Isso significa que:
- alterar o rótulo de uma opção não modifica o valor armazenado;
- remover uma opção utilizada em registros existentes pode causar inconsistências;
- adicionar novas opções não afeta registros antigos;
- alterar o valor padrão aplica-se apenas a novos preenchimentos.
Algumas alterações afetam apenas novos preenchimentos.
Exemplo:
- adicionar uma nova opção não modifica registros já existentes;
- alterar o valor padrão não retroage automaticamente;
- conteúdos anteriores só mudam se forem editados novamente.
Casos de uso
- Booleano: consentimento LGPD, termos aceitos, cliente ativo/inativo, produto disponível, tarefa concluída, envio de newsletter autorizado.
- Lista de Opções: status de processo, estado civil, tipo de documento, categoria de produto, motivo de contato, forma de pagamento, nível de escolaridade.
- Rádio: forma de envio (sedex/pac), tipo de atendimento (presencial/online), turno de preferência (manhã/tarde/noite), método de contato preferido.
- Caixa de Seleção: dias da semana disponíveis, serviços contratados, áreas de interesse, permissões de acesso, recursos incluídos.
- Multi-Seleção: tags de classificação, responsáveis por área, idiomas falados, especialidades do profissional, canais de comunicação.
Boas práticas
- Utilize Booleano apenas para estados binários inequívocos. Evite criar booleanos para situações que podem evoluir para três ou mais opções no futuro.
- Prefira Lista de Opções quando houver muitas opções ou quando o espaço na tela for limitado.
- Utilize Rádio quando houver poucas opções (até 5) e o usuário precisar comparar todas antes de decidir.
- Utilize Caixa de Seleção quando cada opção for independente e o usuário precisar visualizar todas as alternativas simultaneamente.
- Utilize Multi-Seleção para seleções múltiplas em espaço compacto, especialmente quando há muitas opções disponíveis.
- Defina valores padrão que acelerem o preenchimento sem induzir erros.
- Padronize os valores internos das opções para facilitar filtros, automações e integrações via API.
- Evite remover opções já utilizadas; prefira desabilitá-las para manter a integridade dos registros históricos.