Pular para o conteúdo principal

Campos Configuráveis

O ACCELERO permite a criação de campos configuráveis para customizar o cadastro de algumas entidades do sistema. Esses campos enriquecem a solução permitindo a adequação de diversas situações específicas.

Caminho de acesso: Avançado > Campos configuráveis

TODO: Adicionar Screenshot

Incluir print da tela de listagem de campos configuráveis.

Visão Geral

Campos configuráveis permitem que você adicione informações customizadas aos cadastros padrão do sistema, adaptando-o às necessidades específicas da sua operação sem necessidade de customização de código.

Exemplos de uso:

  • Número de matrícula interna (pessoas)
  • Departamento (pessoas/empresas)
  • Tipo de veículo especial (veículos)
  • Observações específicas do evento (eventos)
  • Autorização especial (visitantes)

Configuração de Campos

Cada campo configurável pode receber as seguintes configurações:

TODO: Adicionar Screenshot

Incluir print do formulário de criação/edição de campo configurável.

CampoDescrição
NomeNome que aparecerá na tela para identificar o campo configurável
TipoTexto, numérico ou lista
Tam. máx.Tamanho máximo do campo em quantidade de caracteres
ValidaçõesQue validações devem ser feitas no campo específico no momento de salvar dados (obrigatório, formato, etc.)
Válido paraEm que telas de cadastro este campo deve aparecer: pessoas, visitantes, eventos, empresas, veículos, eventos recorrentes e convites Telegram
TamanhoTamanho horizontal do campo em tela: pequeno, médio ou grande

Onde os Campos Aparecem

Os campos configuráveis aparecerão sempre em seção específica nas telas de cadastro, sempre organizados em ordem alfabética pela descrição.

Entidades que Suportam Campos Configuráveis

  • Pessoas: Adicione campos específicos ao cadastro de pessoas
  • Visitantes: Campos customizados para visitantes
  • Eventos: Informações adicionais em eventos
  • Empresas: Dados específicos de empresas
  • Veículos: Informações complementares de veículos
TODO: Adicionar Screenshot

Incluir print mostrando campos configuráveis exibidos em um formulário de cadastro (por exemplo, pessoa).

Tipos de Campo

Campo de Texto

Aceita entrada de texto livre.

Configurações:

  • Tamanho máximo em caracteres
  • Validação opcional (formato, obrigatoriedade)
  • Tamanho de exibição (pequeno, médio, grande)

Exemplos de uso:

  • Nome do departamento
  • Observações específicas
  • Código de referência externo
  • E-mail secundário

Campo Numérico

Aceita apenas valores numéricos.

Configurações:

  • Tamanho máximo em dígitos
  • Validação opcional (obrigatoriedade, faixa de valores)
  • Tamanho de exibição

Exemplos de uso:

  • Número de matrícula
  • Código de custo
  • Ramal telefônico
  • Número de autorização

Campo Lista

Apresenta uma lista de opções pré-definidas para seleção.

Configurações:

  • Itens da lista (opções disponíveis)
  • Validação opcional (obrigatoriedade)
  • Tamanho de exibição

Exemplos de uso:

  • Departamento (seleção de uma lista fixa)
  • Tipo de documento
  • Motivo da visita
  • Classificação de risco

Validações Disponíveis

As validações permitem garantir a qualidade dos dados inseridos:

ValidaçãoDescrição
ObrigatórioCampo deve ser preenchido obrigatoriamente
Formato específicoDefine padrão que o valor deve seguir
Tamanho mínimoQuantidade mínima de caracteres
Tamanho máximoQuantidade máxima de caracteres

Tamanhos de Exibição

O campo pode ter diferentes larguras na tela:

TamanhoUso Recomendado
PequenoCódigos curtos, números, siglas
MédioTextos médios, descrições curtas
GrandeTextos longos, observações extensas

Ordem de Exibição

Ordenação Alfabética

Os campos configuráveis são sempre exibidos em ordem alfabética pela descrição, independentemente da ordem de criação.

Dica: Para controlar a ordem de exibição, use prefixos numéricos ou alfabéticos:

  • "1. Departamento"
  • "2. Matrícula"
  • "3. Observações"

Cuidados Importantes

Atenção - Campos Obrigatórios

É importante tomar cuidado com a criação de campos configuráveis obrigatórios com validação em sistemas com cadastros ativos.

Problema:

  • Cadastros antigos podem tornar-se inválidos devido à introdução de um novo campo configurável obrigatório com validação
  • Pessoas/veículos/empresas existentes não terão o novo campo preenchido
  • Tentativa de edição desses cadastros falhará até que o campo seja preenchido

Solução:

  1. Crie o campo como opcional inicialmente
  2. Preencha o campo em todos os cadastros existentes (manualmente ou via API)
  3. Somente então torne o campo obrigatório

Exemplos Práticos

Exemplo 1: Departamento para Pessoas

Nome: Departamento
Tipo: Texto
Tam. máx.: 50
Validações: Não obrigatório
Válido para: Pessoas
Tamanho: Médio

Resultado: Campo "Departamento" aparece no cadastro de pessoas para identificar a área de trabalho.

Exemplo 2: Número de Autorização para Eventos

Nome: Número de Autorização
Tipo: Numérico
Tam. máx.: 10
Validações: Obrigatório
Válido para: Eventos
Tamanho: Pequeno

Resultado: Ao cadastrar eventos, será obrigatório informar um número de autorização.

Exemplo 3: Tipo de Veículo Especial

Nome: Categoria do Veículo
Tipo: Texto
Tam. máx.: 30
Validações: Não obrigatório
Válido para: Veículos
Tamanho: Médio

Resultado: Campo adicional para classificar veículos (Utilitário, Carga, Executivo, etc.).

Exemplo 4: Centro de Custo para Empresas

Nome: Centro de Custo
Tipo: Numérico
Tam. máx.: 8
Validações: Obrigatório
Válido para: Empresas
Tamanho: Pequeno

Resultado: Todas as empresas devem ter um centro de custo associado.

Integração com Outras Funcionalidades

Tipos de Evento

Campos configuráveis podem ter valores padrão definidos em Tipos de Evento:

  • Configure valores padrão para campos específicos
  • Ao criar evento daquele tipo, campos já vêm preenchidos
  • Agiliza processos repetitivos

Ver Eventos - Tipos de Evento para mais detalhes.

Eventos Recorrentes

Campos configuráveis podem ser preenchidos em eventos recorrentes:

  • Defina valores padrão para todos os eventos gerados
  • Campos são replicados automaticamente

Ver Pessoas - Eventos Recorrentes para mais detalhes.

API e Integrações

Campos configuráveis podem ser acessados via API:

  • Leitura de valores
  • Gravação de valores
  • Validações aplicadas também via API

Boas Práticas

  1. Nomes descritivos: Use nomes claros que identifiquem facilmente o propósito do campo

  2. Planeje antes de criar: Defina quais campos são realmente necessários antes de criar

  3. Evite campos obrigatórios em sistemas ativos: Sempre crie como opcional primeiro

  4. Use validações apropriadas: Configure apenas validações realmente necessárias

  5. Tamanho adequado: Configure tamanho máximo realista para evitar problemas futuros

  6. Documentação: Mantenha registro externo do propósito de cada campo configurável

  7. Revisão periódica: Remova campos que não são mais utilizados

  8. Consistência: Use padrões de nomenclatura consistentes (ex: sempre em maiúsculas ou minúsculas)

Limitações

  • Não suportam múltiplos valores
  • Validações são limitadas às opções padrão do sistema

Próximos Passos

  • Pessoas - Veja como campos configuráveis aparecem no cadastro de pessoas
  • Veículos - Configure campos específicos para veículos
  • Eventos - Defina campos customizados para eventos
  • Empresas - Adicione informações específicas de empresas