Campos¶
Por qué importa¶
Los campos son las "columnas" de un módulo: nombre, correo, monto, fecha. Como administrador puedes agregar, modificar y configurar campos en cualquier módulo personalizado, y modificar configuración (etiqueta, validación, visibilidad) en módulos base.
Tipos de campos¶
- Texto corto / largo.
- Número / Moneda.
- Booleano (sí/no).
- Fecha / Fecha y hora.
- Picklist / Picklist múltiple.
- Relación — apunta a otro módulo.
- Archivo.
- Computado — calculado desde otros campos.
Agregar un campo¶
- Abre el módulo → pestaña Campos → Agregar campo.
- Llena:
- Nombre técnico — usado en BD/URL (
amount,closed_date). - Etiqueta — lo que ve el usuario.
- Tipo.
- Obligatorio.
- Default.
- Validación — formato, longitud, rango, único.
- Buscable — incluido en búsqueda global.
- Guardar.
ZaazCRM agrega la columna a la BD.

Campos computados¶
No se llenan — se calculan. Ejemplo: nombre_completo = CONCAT(first_name, ' ', last_name). Configura:
- Expresión — fórmula SQL o de plantilla.
- Disparador — al crear, al editar, siempre.
Nombre para mostrar (display_name)¶
Cada módulo tiene un campo display_name que define cómo se muestra el registro en listas/referencias. Para recomputar todos los registros: comando admin modules:finalize-records.
Picklists relacionados¶
Campos picklist almacenan ID de la opción, no el texto. Opciones se manejan en Listas de opciones.
Validación¶
- Formato — correo, teléfono, RFC.
- Longitud — mínimo, máximo.
- Rango — números o fechas.
- Único — sin duplicados.
Ten cuidado con¶
- No cambies tipo de un campo con datos. Crea nuevo y migra.
- No elimines sin verificar dependencias.
- Renombrar nombre técnico — no se puede.
A dónde sigue¶
- Listas de opciones — para campos picklist.
- Visibilidades — dónde aparece cada campo.