ID Personalizado
Configure campos de ID personalizado com identificadores automáticos
O campo do tipo ID Personalizado é utilizado para criar identificadores customizados para os itens de uma categoria no ENSPACE.
O ID é gerado automaticamente a partir de componentes que você define — como textos fixos, datas, valores de outros campos e contadores sequenciais. Ele coexiste com o ID nativo do sistema, oferecendo um código de fácil leitura e com significado para o seu negócio, sem substituir o identificador interno.
Quando usar este campo
Utilize o campo ID Personalizado quando precisar gerar códigos automáticos e padronizados para os itens de uma categoria.
Ele é ideal para:
- Protocolos de atendimento com prefixo e contador sequencial
- Códigos de contrato com data e identificador do cliente
- Números de processo com estrutura fixa e contador
- Tickets de suporte ou chamados com prefixo departamental
- Qualquer identificador que exija composição automática de múltiplos elementos
Informações básicas do campo
Todo campo no ENSPACE possui quatro informações básicas que são definidas no momento da criação:
- Nome do campo — nome interno utilizado nas configurações da categoria. Possui limite de 31 caracteres. Não é necessariamente o nome exibido para o usuário final.
- Rótulo Visível (Label) — nome exibido para os usuários em formulários, tarefas e telas. Possui limite de 255 caracteres. Pode ser mais descritivo que o nome interno e pode ser alterado posteriormente sem impactar automações ou referências técnicas.
- Referência técnica — identificador técnico do campo, gerado automaticamente em formato
snake_case. É utilizado em expressões, variáveis, fluxos, automações e referências internas. - Descrição — descrição interna para adicionar contexto ao campo. Ajuda configuradores a entenderem a finalidade do campo e auxilia recursos de IA do ENSPACE durante pesquisas e interpretações automáticas.
Como o campo funciona
O campo ID Personalizado funciona como um gerador de códigos automáticos baseado em componentes configuráveis.
O usuário define um ou mais componentes que compõem o ID. Cada componente gera uma parte do identificador final, e a concatenação de todos na ordem estabelecida forma o código completo. O sistema calcula o ID automaticamente no momento da criação do item.
As configurações aplicadas podem alterar diretamente a estrutura do identificador:
- Componentes de Conteúdo inserem textos fixos ou separadores.
- Componentes de Data inserem a data de criação formatada.
- Componentes de Campo inserem valores de outros campos do item, com transformações e limites.
- Componentes de Contador inserem números sequenciais com zeros à esquerda.
Configurações específicas
O campo ID Personalizado possui recursos adicionais para controlar a composição do identificador. Todas as configurações abaixo são opcionais e ficam disponíveis na seção Configurações Específicas ao selecionar o tipo ID Personalizado.
Componentes
Define a estrutura do identificador através de blocos montáveis. Você pode adicionar quantos componentes precisar e reordená-los livremente. Pelo menos um componente é obrigatório.
Ao clicar em Adicionar, um modal é aberto para seleção do tipo de componente:
| Tipo | Descrição |
|---|---|
| Conteúdo | Insere um texto fixo no ID. Útil para prefixos, sufixos ou separadores. |
| Data | Insere a data de criação do item em formato definido. |
| Campo | Insere o valor de outro campo do item, com opções de transformação e limite. |
| Contador | Insere um número sequencial que incrementa automaticamente a cada novo item. |
Componente Conteúdo
| Configuração | Descrição |
|---|---|
| Conteúdo Fixo | Texto fixo que será inserido no ID. Adicione uma string fixa ao conteúdo do identificador. |
Exemplo: um componente de conteúdo com o valor CONT- gera o prefixo CONT- em todo ID da categoria.
Componente Data
| Configuração | Descrição |
|---|---|
| Formato de Data | Define o formato da data de criação do item que será incluído no ID. Utilize DD para dia, MM para mês e YYYY para ano. |
Exemplo: o formato DDMMYYYY resulta em 31012024 para 31 de janeiro de 2024. O formato YYYYMM gera 202401 para itens criados em janeiro de 2024.
Componente Campo
| Configuração | Descrição |
|---|---|
| Campo de Referência | Campo do item cujo valor será utilizado no ID. |
| Transformações de Texto | Modifica a formatação do valor do campo. Opções: Lowercase, Uppercase, Deburr, Trim, Kebab Case, Camel Case, Snake Case, Capitalização, Start Case, Title Case, Número por extenso, Remove Spaces. |
| Limite de Caracteres | Restringe o número de caracteres utilizados. Opções: Sem limite de caracteres, Primeiras 2 caracteres, Primeiras 3 caracteres, Primeiras 4 caracteres, Últimas 2 caracteres, Últimas 3 caracteres, Últimas 4 caracteres. |
Exemplo: um componente de campo referenciando o campo "Departamento", com transformação "Capitalização" e limite "Primeiras 3 caracteres", gera ADM para o valor Administração.
Componente Contador
| Configuração | Descrição |
|---|---|
| Dígitos do Contador | Define o número de dígitos para o contador sequencial no código personalizado. Por exemplo, 3 dígitos resultarão em 001, 002, 003, etc. |
| Início do Contador | Define o valor inicial do contador sequencial. Por exemplo, se definir como 100, o contador começará em 100, depois 101, 102, e assim por diante. |
Exemplo: um contador com 4 dígitos e início em 1 gera: 0001, 0002, 0003...
- Conteúdo →
CONT- - Data (formato
YYYYMM) →202401 - Conteúdo →
- - Contador (4 dígitos, início em 1) →
0001
CONT-202401-0001, CONT-202401-0002, CONT-202401-0003...Como configurar
Crie um novo campo
Acesse Configurações > Categorias > Campos e clique em Criar.
Preencha as informações básicas
Defina o nome do campo, a referência técnica, o rótulo visível (Label) e selecione o tipo ID Personalizado.
Adicione os componentes
Na seção Configurações Específicas, clique em Adicionar e selecione o tipo de componente desejado (Conteúdo, Data, Campo ou Contador). Configure cada componente conforme a necessidade.
Configure cada componente
No modal de configuração, defina os parâmetros específicos:
- Conteúdo: insira o texto fixo.
- Data: escolha o formato desejado.
- Campo: selecione o campo de referência, aplique transformações e defina o limite de caracteres.
- Contador: defina o número de dígitos e o valor inicial.
Reordene os componentes
Organize a ordem dos componentes arrastando ou utilizando as setas de ordenação. A ordem define a composição final do identificador.
Salve o campo
Após salvar, o campo será aplicado automaticamente aos novos itens da categoria.
Comportamento dos dados
Algumas alterações feitas no campo afetam apenas novos preenchimentos:
- Adicionar, remover ou reordenar componentes não altera IDs já gerados em itens anteriores.
- Modificar o Início do Contador não retroage em registros existentes; a contagem continua a partir do último valor utilizado.
- Alterar o Campo de Referência ou suas transformações não modifica IDs já criados, mesmo que o campo referenciado seja editado posteriormente.
- O ID Personalizado é gerado no momento da criação do item e permanece imutável, salvo em caso de edição manual do item com recálculo explícito.
- Os dados anteriores só serão alterados caso sejam editados novamente.
Boas práticas
- Utilize componentes de Conteúdo para separadores e prefixos que padronizem a visualização do identificador.
- Combine Data e Contador para garantir unicidade temporal dos IDs dentro de períodos.
- Utilize Transformações de Texto e Limite de Caracteres em componentes de Campo para evitar IDs excessivamente longos.
- Prefira Dígitos do Contador compatíveis com o volume esperado de itens (ex: 4 dígitos para até 9.999 registros por período).
- Defina um Início do Contador diferente de 1 quando for necessário continuar uma numeração de sistema anterior.