Criar e estruturar

Caminho: Minha Mesa > Novo Cadastro

Aqui você monta o esqueleto do Cadastro: quais campos ele tem, de que tipo são e que regras cada um segue. A estrutura é definida no DW e vale para todos que vão usar o Cadastro depois.

---

➕ Campos e tipos

Cada campo tem um tipo, que define o que ele aceita e como aparece na grade e no formulário. São seis tipos:

Tipo	O que guarda	Quando usar
Texto	Texto livre	Nomes, descrições, observações
Número	Valores numéricos	Metas, quantidades, pesos, valores
Data	Datas, com granularidade ajustável	Competências, prazos, marcos
Lista de valores	Uma opção de uma lista fixa	Status, categorias, classificações
Chave externa	Referência a um registro de outra tabela	Vincular a clientes, produtos, filiais
Imagem	Um arquivo de imagem	Logos, fotos, anexos visuais

Detalhes que valem conhecer:

• Data — você escolhe a granularidade: ano, mês, dia ou data-hora. Isso controla o que o usuário preenche e como o BI agrupa.
• Lista de valores — é uma picklist de seleção única. Cada opção pode ter uma cor, e na grade o valor aparece como uma pílula colorida — ótimo para ler status de relance.
• Chave externa — aponta para outra tabela. Na hora de preencher, você busca pelo rótulo (o nome legível), não por um código. Se o registro apontado deixar de existir, o valor aparece como #chave na grade, sinalizando um vínculo órfão.
• Imagem — o usuário faz upload; na grade e no formulário a imagem abre em lightbox (visualização ampliada).

---

🏷️ Rótulo e nome interno

Ao criar um campo, você digita só o rótulo — o nome visível, em linguagem de negócio (ex.: "Meta de Vendas").

A partir dele, a plataforma deriva automaticamente um nome interno (ex.: meta_de_vendas), usado nos bastidores e nas expressões. Esse nome interno é editável, caso você queira ajustá-lo.

Renomear não perde dado

Trocar o rótulo de um campo depois é uma operação não-destrutiva — os dados já preenchidos continuam intactos. Veja como isso funciona em Versões e publicação.

---

⚙️ Atributos do campo

Cada campo aceita alguns atributos que refinam como ele se comporta:

• Obrigatório — o registro não pode ser salvo sem esse campo preenchido.
• Máscara — define o formato de exibição/digitação (ex.: moeda, percentual, formato de data).
• Seção — agrupa campos relacionados no formulário, deixando o preenchimento mais organizado quando há muitos campos.

---

🔑 Unicidade

A unicidade é definida a nível de tabela, como combinações de campos que não podem se repetir — não existe "único por campo" isolado.

Por exemplo, num Cadastro de metas você pode exigir que a combinação Filial + Mês seja única: cada filial tem no máximo uma meta por mês, mas o mesmo mês pode aparecer várias vezes (uma por filial) e a mesma filial pode aparecer em vários meses.

NOTE

Defina como única a combinação mínima que identifica um registro de verdade. Combinações boas evitam duplicatas; combinações largas demais deixam passar dados repetidos.

---

Lista de valores ou Chave externa?

Use Lista de valores quando as opções são poucas e estáveis, vivem só dentro deste Cadastro e você quer cor por opção (status, classificações). Use Chave externa quando o valor é uma entidade que já existe em outra tabela (um cliente, um produto, uma filial) e você quer manter o vínculo — inclusive para o BI cruzar as duas tabelas.