Elegir el tipo de columna

Cada columna de tu tabla tiene un tipo. Elegir bien el tipo es lo que hace que el formulario salga cómodo y los datos salgan limpios.

Catálogo completo

Usa esta tabla como guía rápida. Los nombres son exactamente los que ves en el desplegable Tipo del módulo.

Cuando el dato es…	Usa el tipo	Qué te da
Un nombre, un código corto	Texto	Campo de una línea
Una descripción larga	Texto largo	Caja de varias líneas
Un precio, un monto	Moneda	Se muestra como $9.800 en los listados
Una cantidad entera	Entero	Solo números sin decimales
Una cantidad con decimales	Decimal	2,5 kg · 9,22 horas
Una cantidad con unidad	Medida	Número + unidad ("12,5 kg")
Sí / no, activo / inactivo	Booleano	Interruptor ON/OFF en el listado
Una fecha	Fecha	Calendario
Fecha y hora juntas	Fecha y hora	Calendario + reloj
Una foto	Imagen	Subida con miniatura en el listado
Varias fotos	Múltiples imágenes	Galería (el parámetro fija el máximo)
Un archivo o PDF	Archivo / PDF	Subida y enlace de descarga
Un correo o un enlace	Email / Enlace	Validación y clic directo
Un dato de otra tabla	Relaciones	Lista desplegable con los registros de esa tabla
Un estado del proceso	Workflow	Etiqueta de color + botones de transición
Un color	Color	Selector de color
Una lista fija de opciones	Select	Desplegable con valores definidos por ti

Cuándo importa el "Parámetro del tipo"

Al elegir ciertos tipos aparece un campo extra llamado Parámetro del tipo. Es donde escribes info específica de ese tipo:

• Relaciones → escribe la tabla destino (categorias, clientes, productos).
• Múltiples imágenes → escribe el máximo de imágenes (10).
• Medida → escribe la unidad literal (kg) o el nombre de una columna hermana que guarda la unidad por fila (unidad_insumo).
• Select → escribe los valores separados por coma (baja,media,alta).

Tipo "Medida" — el caso más útil

El tipo Medida muestra un valor numérico junto a su unidad en una sola celda (15 Kilogramo en vez de dos columnas).

• Se guarda como número, así que sumas, promedios y triggers siguen funcionando.
• La unidad puede ser fija (kg) o por fila (nombre de otra columna que guarda la unidad de cada registro).

Ejemplo real de Recetas:

• cantidad tipo Medida con parámetro unidad_insumo (nombre de otra columna).
• unidad_insumo tipo Select con valores kg,litro,unidad,gramo.

Al mostrar el listado ves 500 gramo, 2 litro, 4 unidad en cada fila.

Tipo "Workflow"

Convierte una columna en el estado de un proceso. Ver Workflow Manager.

• Se muestra como etiqueta de color en el listado.
• Al editar el registro, aparecen botones con las transiciones válidas desde el estado actual.
• Cada transición puede requerir un formulario y respetar permisos por rol.

Tipo "Relaciones" — a fondo

Ver Relacionar tablas.

• Muestra un desplegable con los registros de la tabla destino.
• Por defecto muestra la segunda columna de esa tabla (típicamente el nombre).
• Con tabla:columna en el parámetro puedes mostrar otra columna específica.
• Casos especiales: admins (usuarios del CMS).

Elegir íconos sin saber inglés

Cuando un campo pide ícono (secciones, tableros, widgets), hay un botón con cuadrícula que abre el catálogo visual. Escribe en español lo que buscas: cliente, pedido, café, vacaciones, stock, limpieza. El catálogo entiende sinónimos comunes.

:::tip Si no aparece nada Prueba una palabra más general: en vez de "sanitización" escribe "limpieza"; en vez de "liquidación" escribe "sueldo" o "dinero". También funciona escribir el nombre técnico en inglés si lo conoces (cup-hot, truck). :::

¿Cuál elijo si no estoy seguro?

Regla general:

• Valor pequeño → Texto.
• Valor con formato específico (dinero, fecha, email) → tipo correspondiente.
• Elegir de una lista fija → Select.
• Sí / No → Booleano.
• Sube archivo → Imagen / Múltiples imágenes / Archivo.
• Apunta a otra tabla → Relaciones.
• Cambia de estado → Workflow.

Ante la duda, empieza con Texto y cámbialo después si notas que estarías mejor con otro tipo (recuerda: cambios de tipo pueden fallar si los datos existentes no calzan).

Ejemplo — columnas de la tabla Productos

nombre         Texto
categoria      Relaciones (parámetro: categorias)
precio         Moneda
stock          Entero
imagen         Imagen
descripcion    Texto largo (visibilidad OFF)
activo         Booleano
rendimiento    Decimal

¿Qué sigue?

• Archivos e imágenes — el detalle de campos multimedia.
• Relacionar tablas — el tipo Relaciones a fondo.
• Campos condicionales — mostrar campos según lo que el usuario elija en otros.