Tipos de coluna
Ao criar uma tabela, cada coluna possui um tipo que controla como os dados são validados, exibidos e usados em integrações.
| Tipo | Descrição | Quando usar |
|---|
| ID automático (UUID) | Identificador único gerado pelo sistema. Não editável. | Quando você não tem um ID próprio e precisa garantir unicidade |
Toda tabela precisa de uma coluna de ID. Se você não definir um campo manual (ex: SKU, código), use uma coluna do tipo ID automático.
Texto
| Tipo | Descrição | Quando usar |
|---|
| Texto | Texto de uma linha (até 500 caracteres) | Nome, título, identificador legível |
| Texto curto | Limitado a ~100 caracteres | Tags simples, códigos curtos |
| Texto longo | Múltiplas linhas, sem limite prático | Descrição detalhada, observações |
Contato
| Tipo | Descrição | Validação |
|---|
| E-mail | Endereço de e-mail | Formato usuario@dominio.com |
| Telefone | Telefone com DDI/DDD | 10–13 dígitos, aceita máscara |
| URL | Endereço web | Deve começar com http:// ou https:// |
Seleção
| Tipo | Descrição | Quando usar |
|---|
| Seleção (dropdown) | Escolhe um item de uma lista pré-definida | Status, categoria, prioridade |
| Checklist | Escolhe vários itens de uma lista | Tags múltiplas, recursos selecionados |
| Etiqueta | Lista colorida (similar a tags do Trello) | Etiquetar visualmente registros |
| Sim/Não | Booleano | Ativo, pago, concluído |
Seleção, Checklist e Etiqueta, você define a lista de opções com cores opcionais.
Data e hora
| Tipo | Descrição |
|---|
| Data | Apenas data (DD/MM/AAAA) |
| Data e Hora | Data + hora (12h ou 24h) |
| Hora | Apenas hora |
Número
| Tipo | Descrição | Configurações |
|---|
| Número | Inteiro ou decimal | Mín, máx, casas decimais, permite negativo |
| Moeda | Valor monetário | Código (BRL, USD, EUR), formatação automática |
Para números que representam duração em segundos, é possível configurar a exibição automática como minutos, horas ou dias.
Documentos brasileiros
| Tipo | Descrição | Validação |
|---|
| CPF | Cadastro de pessoa física | 11 dígitos, máscara xxx.xxx.xxx-xx |
| CNPJ | Cadastro de pessoa jurídica | 14 dígitos, máscara xx.xxx.xxx/xxxx-xx |
Especiais
| Tipo | Descrição | Quando usar |
|---|
| Arquivo / Anexo | Upload de arquivos | Documentos, imagens, contratos. Configurável: máx de arquivos, tipos aceitos |
| Conexão | Vincula registros de outra tabela | Relacionar produtos a categorias, contratos a clientes |
| Responsável | Vincula a um usuário do workspace | Atribuir registros a operadores |
Coluna de Conexão
A coluna de conexão cria um relacionamento real entre tabelas:
- Tabela alvo — qual tabela é referenciada
- Múltiplos registros — permite vincular vários itens de uma vez
- Permitir criar inline — usuário pode criar um novo registro sem sair do editor
- Colunas exibidas — quais campos aparecem no mini-card de preview
Atributos comuns a todas as colunas
Cada coluna pode ser configurada com:
| Atributo | Efeito |
|---|
| Obrigatória | Bloqueia o salvamento se vazia |
| Pesquisável | Inclui o campo na busca textual da tabela |
| Ordenação padrão | Ordena a tabela automaticamente por essa coluna ao abrir |
Colunas especiais da tabela
Toda tabela possui três “ponteiros” que indicam quais colunas têm papéis estruturais:
| Papel | Função |
|---|
| ID | Identificador único do registro (auto_id ou manual) |
| Label | Texto exibido em listas, dropdowns e referências de conexão |
| Value | Valor retornado em integrações e usado como chave em automações |
Em tabelas usadas por dropdowns de formulário ou conexões, configure label para o nome exibido e value para o código/ID enviado.
Próximo passo
Criar tabela manualmente
Aplique os tipos de coluna passo a passo.
