Formulário

Formulário de Cadastro

Essa tela permite a configuração e o gerenciamento dos campos que compõem o formulário de cadastro de usuários. Por meio dela é possível criar novos campos personalizados, editar ou remover campos existentes, além de visualizar os campos padrão disponibilizados pelo sistema.

Campos Customizados

Na tela de Campos Customizados, é possível definir campos próprios para coleta de informações específicas que não estão contempladas nos campos padrão da plataforma.

Cada campo listado na tabela, tanto customizado quanto padrão, seguirá a seguinte ordem de informações:

• ID Importador: Identificação utilizada em processos de importação de dados. Mais detalhes em Importador.
• Campo: Nome de identificação do campo.
• Máscara: Máscara aplicada ao campo, utilizada para padronizar o formato de entrada de dados (exemplo: CPF, CNPJ, telefone, etc.).
• Opções: Quantidade de opções disponíveis para seleção, aplicável apenas aos campos do tipo Lista.
• Obrigatório: Indica se o campo é de preenchimento obrigatório.
• Ações: Ações disponíveis para cada campo listado:
• Editar Campo

  Abre a tela de edição do campo selecionado.

• Excluir Campo

  Exclui permanentemente o campo selecionado. Esta ação é irreversível.

dica

Também é possível arrastar os campos para reorganizar a ordem das informações conforme desejado.

Na seção de campos customizados, é possível visualizar uma prévia de como ficaria o formulário com esses campos. Para isso, você pode clicar no campo

Visualizar formulário

Visualizar formulário

.

Para criar um novo campo, clique no botão

Novo campo

Novo campo

Será aberto um menu lateral com as seguintes informações para preeenchimento:

• ID Importador: Identificador utilizado em integrações com o importador de dados. Deve ser único e corresponder ao nome técnico do campo a ser importado.

• Campo: Nome de exibição do campo. É a identificação que será apresentada na interface do formulário.

• Obrigatório: Define se o preenchimento do campo será obrigatório. Quando ativado, o sistema impedirá o envio do formulário caso o campo esteja vazio.

• Tamanho: Determina a largura do campo em relação à linha onde será exibido. O valor informado define quantos campos poderão ser exibidos lado a lado na mesma linha. Por exemplo, um campo com tamanho 1 ocupará uma linha inteira, enquanto dois campos configurados com tamanho 2 serão exibidos na mesma linha. A opção Preencher faz com que o campo complete automaticamente o espaço restante da linha, garantindo o alinhamento visual entre os campos.

• Tipo: Define o tipo de dado que será aceito pelo campo, determinando o formato de entrada e validação aplicada. Os tipos disponíveis são:

  • Alfanumérico: Permite a entrada de letras, números e caracteres especiais. É indicado para campos que armazenam textos livres, como nomes, endereços ou descrições.
  • Data: Utiliza um seletor de data no formato DD/MM/AAAA. Ideal para campos que registram datas específicas, como data de nascimento, admissão ou validade.
  • Lista: Exibe uma lista de opções predefinidas para seleção de um valor único. É recomendado para campos que exigem padronização, como “Gênero”, “Estado Civil” ou “Departamento”.
  • Ativo/Inativo: Campo de status binário que permite apenas duas opções: Ativo ou Inativo. Utilizado para indicar se determinado registro ou item está em uso.
  • Numérico: Aceita exclusivamente números inteiros, sem separadores decimais. Aplicável a campos como códigos, quantidades ou identificadores numéricos.
  • Decimal: Permite a inserção de números com casas decimais. Utilizado para valores monetários, percentuais ou medidas que exijam precisão.
  • Personalizado: Tipo flexível que possibilita a aplicação de máscaras específicas definidas pelo usuário. Indicado para campos que precisam seguir um formato customizado, como telefones, CNPJs ou códigos de referência.

aviso

Campos marcados com um * são de preenchimento obrigatório.

Campos Padrões

A tela de campos Padrões, serão apresentadas as mesmas informações exibidas para os campos Customizados, porém sem a possibilidade de edição ou exclusão. Nessa tela é possível apenas visualizar a configuração de cada campo, podendo utilizá-la como referência para a criação de novos campos personalizados ou definir se o campo padrão será obrigatório ou não.

Máscaras

Máscaras de formatação servem para definir o padrão visual e estrutural de entrada de dados. Elas orientam o usuário sobre o formato esperado (como CPF, telefone, CEP, datas, entre outros) e garantem consistência na forma como as informações são armazenadas e exibidas.

Ao aplicar uma máscara, o sistema impõe regras sobre o que pode ser digitado e onde cada caractere deve aparecer. Por exemplo, pode limitar a entrada apenas a números, inserir automaticamente separadores como pontos, hífens ou barras, e até validar o comprimento do valor.

A complexidade de uma máscara varia conforme o nível de detalhe exigido. Máscaras simples apenas controlam o formato estático — por exemplo, número de dígitos fixo e separadores definidos. Já máscaras mais complexas podem se adaptar dinamicamente de acordo com o conteúdo digitado, aceitar variações de tamanho, incluir validações condicionais ou até combinar padrões diferentes no mesmo campo.

dica

Expressões Regulares (Regex) também são aceitos como máscaras.

Composição da máscara

• 0 - Aceita qualquer dígito numérico
• a - Aceita qualquer letra (maiúscula ou minúscula)
• * - Aceita qualquer caractere, seja letra, número ou símbolo.

informação

Tudo que não estiver definido acima é tratado como parte fixa da máscara (Exemplo: traços, parênteses, barras etc.)

• [] - Indica que o conteúdo dentro dos colchetes é opcional.
• {} - Define que o conteúdo fixo dentro das chaves deve ser incluído no valor final “sem máscara”. Normalmente, partes fixas são apenas visuais e são removidas quando se obtém o valor cru.
• ` - Impede o deslocamento automático de caracteres ao apagar ou inserir (mantém a posição dos símbolos fixos).
• \\ - Usado para escapar um caractere de definição, forçando-o a ser interpretado como literal. (Exemplo: \\0 mostra o caractere 0 na máscara, em vez de tratá-lo como um número)

aviso

As definições acima não são válidas para Máscaras Regex.

Exemplos de máscaras

Máscaras simples:

• 000.000.000-00 - Máscara para CPFs.
• 00.000.000/0000-00 - Máscara para CNPJs.
• +55 (00) 9 0000-0000 - Máscara para celulares (note que por padrão o campo já virá com o +55 e o primeiro dígito 9 do campo preenchidos automaticamente).
• 00000-000 - Máscara para CEPs.

Máscaras complexas:

• {#}000[aaa]/XYZ-`*[**]: Máscara que valida o conteúdo misturando letras e números para obedecer um formato específico. Vamos por partes:

  • {#} - O conteúdo entre chaves será adicionado de forma fixa no valor final.
  • 000 - Permite digitar 3 números.
  • [aaa] - Permite digitar 3 letras de forma opcional.
  • /XYZ- - Tudo que não estiver tratado nas definições vistas anteriormente são considerados como parte fixa da máscara, porém, nesse caso o conteúdo é apenas visual e não será adicionado no valor final.
  • ` - Impede o deslocamento automático do conteúdo digitado após esse caractere. Sem isso, se você apagar alguma parte digitada anteriormente o conteúdo após seria deslocado para a esquerda automaticamente.
  • * - Aceita qualquer caractere.
  • [**] - Aceita qualquer caractere nas próximas duas posições mas torna opcional que sejam digitados.

• /^[1-6]\d{0,5}$/: Máscara Regex que valida números para obedecer um formato específico. Vamos por partes:

  • / ... /: Indica que a máscara é uma Expressão Regular (Regex).
  • ^: Indica que a máscara deverá validar desde o início do conteúdo digitado.
  • [1-6]: O primeiro dígito deve obrigatoriamente estar entre 1 e 6.
  • \d{0,5}: Após o primeiro dígito podem existir de 0 a 5 dígitos numéricos, ou seja, o número final pode ter no máximo 6 dígitos.
  • $: Indica que a máscara deverá parar a digitação aqui garantindo que não haja mais nada depois.