Saltar a contenido

Módulos personalizados

Por qué importa

Los módulos personalizados son módulos que tu consultoría crea para necesidades que no cubren los módulos base. Ejemplos típicos:

  • Catálogo de escuelas para una consultoría que atiende muchos casos de estudiantes.
  • Lista de empleadores aprobados para casos LMIA.
  • Eventos pasados para registro de seminarios y promociones.
  • Pólizas si tu consultoría también ofrece seguro de salud para inmigrantes.

ImmCase es metadata-driven: no hace falta escribir código para agregar un módulo. Lo configuras desde la interfaz administrativa y aparece como cualquier otro módulo nativo, con sus permisos, vistas, campos, plantillas.

Crear un módulo personalizado

  1. Barra lateral → Configuración → Módulos → Crear.
  2. Llena los datos básicos:
  3. Nombre (singular y plural).
  4. Clave técnica — minúsculas, sin espacios, sin caracteres especiales (por ejemplo, schools o policies).
  5. Tipo: Personalizado (custom).
  6. Grupo de menú — dónde aparece en la barra lateral.
  7. Tabla — el nombre de la tabla en base de datos (auto-generado de la clave).
  8. Guardar.

ImmCase: - Crea la tabla en la base de datos automáticamente. - Agrega el módulo a la barra lateral. - Crea los permisos básicos (view, create, edit, delete). - Establece la estructura base (campos id, created_at, updated_at, deleted_at, etc.).

Agregar campos

Inmediatamente después de crear el módulo, configura sus campos:

  1. Abre el módulo → pestaña Campos.
  2. Agregar campo → llena nombre, tipo (texto, número, fecha, lista, relación), validación.
  3. Guardar.

Cada campo agregado se crea como columna en la tabla del módulo en la base de datos. Más en Campos.

Configurar relaciones

Si tu módulo se conecta con otros (por ejemplo, escuelas conectadas a casos):

  1. Pestaña Relaciones.
  2. Agregar relación → tipo (perteneceA, tieneMuchos, etc.) → módulo destino.
  3. Guardar.

Más en Relaciones entre módulos.

Configurar visibilidades

Por defecto, los campos del módulo nuevo aparecen en todas partes (lista, detalle, formulario, etc.). Si quieres restringir:

  • Pestaña Visibilidades → marca dónde aparece cada campo.

Más en Visibilidades de campos.

Permisos del módulo

Los permisos básicos se crean automáticamente al crear el módulo. Asígnalos a roles y perfiles:

  • Abre el rol o perfil → Permisos → busca el módulo nuevo → asigna.

Hasta que asignes permisos, solo Super Admin puede acceder al módulo nuevo.

Carpetas automáticas y plantillas

Si tu módulo personalizado va a necesitar:

  • Carpetas automáticas (cada registro tiene su carpeta para archivos): configura en la Estructura de carpetas del módulo.
  • Plantillas PDF específicas: créalas en Plantillas de PDF y asocia al módulo.
  • Flujos de trabajo para automatizar: en Flujos de trabajo, elige este módulo como disparador.

Ten cuidado con

  • No crees módulos que duplican otros. Si necesitas "Estudiantes" y ya tienes "Aplicantes" con un campo tipo=estudiante, no crees un módulo nuevo. Usa filtros. Crear un módulo paralelo fragmenta los datos.
  • Pensar bien la clave técnica. No se puede cambiar. Si dudas, escoge nombres genéricos y duraderos.
  • Probar con un usuario antes de habilitarlo para todos. Crea el módulo, asígnalo solo a tu perfil de admin, prueba, ajusta, y solo entonces extiende permisos al equipo.
  • No abusar. Si tu consultoría termina con 50 módulos personalizados, el menú lateral se vuelve inmanejable. Revisa periódicamente y elimina los que no se usan.

A dónde sigue