Saltar a contenido

Campos

Por qué importa

Los campos son las "columnas" de un módulo: nombre, correo, fecha de nacimiento, número de pasaporte. Como administrador puedes agregar, modificar, ocultar y configurar campos en cualquier módulo personalizado, y modificar la configuración (etiqueta, validación, visibilidad) de los campos de módulos base.

Tipos de campos

  • Texto corto — una línea (nombre, RFC).
  • Texto largo — varios párrafos (notas, dirección).
  • Número — entero o decimal.
  • Moneda — número con formato de moneda.
  • Booleano — sí/no, verdadero/falso.
  • Fecha y Fecha y hora.
  • Picklist — selección de una lista predefinida.
  • Picklist múltiple — varias selecciones.
  • Relación — apunta a un registro de otro módulo (belongsTo).
  • Archivo — carga directa.
  • Computado — valor calculado a partir de otros campos.

Agregar un campo

  1. Abre el módulo → pestaña Campos → Agregar campo.
  2. Llena:
  3. Nombre técnico — usado en BD y URL (first_name, passport_number). No cambiarás esto después.
  4. Etiqueta — lo que ve el usuario (puede ser distinto por idioma).
  5. Tipo — de la lista anterior.
  6. Obligatorio — si está marcado, no se puede guardar el registro sin él.
  7. Default — valor inicial (opcional).
  8. Validación — formato esperado (correo, teléfono, regex).
  9. Buscable — incluido en búsqueda global.
  10. Guardar.

ImmCase agrega la columna correspondiente a la tabla del módulo en base de datos.

Screenshot: editor de campo con tipo de campo y opciones

Campos computados

Un campo computado no se llena — se calcula automáticamente a partir de otros campos.

Ejemplo: campo nombre_completo computado como CONCAT(first_name, ' ', last_name).

  1. Tipo: Computado.
  2. Expresión — fórmula SQL o de plantilla.
  3. Disparador — cuándo recalcular: al crear, al editar, siempre.

Útil para nombres completos, totales, edades calculadas desde fecha de nacimiento, etc.

Nombre para mostrar (display_name)

Cada módulo tiene un campo especial display_name que define cómo se muestra el registro en listas y referencias. Por ejemplo, un aplicante puede mostrarse como <folio> - <nombre completo>.

Lo configuras en Campos → campo display_name → expresión.

Para recomputar todos los registros existentes después de cambiarlo, usa el comando admin modules:finalize-records (o pídeselo a tu administrador técnico).

Picklists relacionados

Un campo de tipo Picklist no almacena el texto del valor — almacena el ID de la opción. Las opciones se manejan en Listas de opciones (Picklists).

Al crear un campo Picklist, eliges qué grupo de opciones usa.

Validación

Cada campo puede tener reglas:

  • Formato — correo, teléfono, RFC.
  • Longitud — mínimo, máximo.
  • Rango — para números o fechas.
  • Único — no puede haber dos registros con el mismo valor.

Las validaciones se aplican en el formulario y en la API. Si un valor inválido viene de otra fuente (importación), ImmCase lo rechaza.

Ten cuidado con

  • No cambies el tipo de un campo con datos. Si un campo tipo Texto tiene 10,000 registros y lo cambias a Número, los datos pueden corromperse. Si necesitas cambiar tipo, crea un campo nuevo y migra los datos.
  • No elimines un campo sin verificar dependencias. Otros campos computados, plantillas, flujos de trabajo o reportes pueden referenciarlo. Romperás todo si lo eliminas sin revisar.
  • Renombrar el nombre técnico — no se puede. Si te equivocas, crea uno nuevo y elimina el viejo, o vive con el nombre raro.

A dónde sigue