Listas de opciones (Picklists)¶
Por qué importa¶
Una lista de opciones (picklist) es un conjunto de valores predefinidos para un campo: tipo de visa, estado civil, nacionalidad, etapa de caso. En lugar de teclear libre (donde un consultor escribe "PR" y otro "Permanent Residence" y otro "Residencia Permanente"), eliges de una lista. Garantiza consistencia y permite reportes confiables.
ImmCase organiza picklists en grupos, donde cada grupo tiene sus opciones.
Crear un grupo de picklist¶
- Barra lateral → Configuración → Listas de opciones → Crear grupo.
- Llena:
- Nombre del grupo (por ejemplo, "Tipo de visa", "Etapa de caso").
- Clave técnica (
visa_type,case_stage). - Tipo: global (compartido entre módulos) o específico de un módulo.
- Guardar.
Agregar opciones al grupo¶
- Abre el grupo → pestaña Opciones → Crear opción.
- Llena:
- Etiqueta — lo que ve el usuario.
- Valor técnico — usado en BD (
pr_express,study_permit). - Color opcional — útil en kanban y tarjetas.
- Icono opcional.
- Orden — posición en la lista.
- Activa — desactivada significa que no aparece en nuevos formularios.
- Guardar.

Asignar grupo a un campo¶
Al crear un campo tipo Picklist en un módulo, en el formulario del campo eliges qué grupo usa. Una vez asignado, el campo solo acepta valores del grupo.
Un mismo grupo puede ser usado por campos de varios módulos. Por ejemplo, "Estado civil" se usa en Aplicantes, Cónyuges, Padres del aplicante — todos comparten el mismo grupo.
Modificar opciones existentes¶
- Renombrar etiqueta — instantáneo, los registros existentes no cambian (siguen apuntando al mismo valor técnico) pero ven la etiqueta nueva.
- Cambiar valor técnico — cuidado: los registros que apuntan al valor viejo se quedan huérfanos. Mejor crear opción nueva y migrar.
- Desactivar opción — los registros que ya la tienen la conservan, pero los formularios nuevos no la ofrecen.
Picklists multiseleccionables¶
Si un campo permite varias opciones del mismo grupo (por ejemplo, "Idiomas hablados"), márcalo como Picklist múltiple al crear el campo. Internamente almacena un arreglo de IDs.
Ten cuidado con¶
- No abuses los grupos. Tener 200 picklists de 3 opciones cada uno es un desastre de mantenimiento. Si tienes campos similares, comparte el grupo.
- Los colores son importantes para kanban. Si tu picklist se usa como agrupador kanban, asigna colores distintos para que las columnas se distingan visualmente.
- Verificar antes de eliminar. Eliminar un grupo o una opción puede dejar campos sin opciones válidas y registros con valores inválidos.
A dónde sigue¶
- Visibilidades de campos — dónde aparecen los campos picklist.
- Campos — crear campos que usen picklists.