Visibilidades de campos¶
Por qué importa¶
Un campo puede aparecer en ocho contextos distintos: la lista (tabla), el detalle, el formulario de crear, el formulario de editar, el resumen, la pestaña relacionada-al-padre, kanban, tarjetas. Las visibilidades te dejan decidir qué campos aparecen en cuáles contextos. Sin esto, todos los campos aparecen en todos lados y los formularios se vuelven inmanejables.
Los ocho contextos¶
| Contexto | Función | Dónde se usa |
|---|---|---|
list |
índice | Vista de lista (columnas de tabla) |
details |
mostrar | Vista de detalle (campos visibles) |
form_create |
crear | Formulario al crear nuevo registro |
form_edit |
editar | Formulario al editar registro existente |
summary |
mostrar | Sección de resumen del detalle |
related_to_parent |
índice | Pestañas relacionadas del padre |
kanban |
índice | Vista kanban (campos en la tarjeta) |
cards |
índice | Vista de tarjetas |
cards_related_to_parent |
índice | Tarjetas en pestañas relacionadas |
Configurar visibilidad de un campo¶
- Abre el módulo → pestaña Visibilidades.
- Encuentra el campo en la lista.
- Marca/desmarca las casillas para cada contexto.
- Guardar.

Por qué no es lo mismo que permisos¶
- Visibilidad = ¿este campo se renderiza en este contexto? Decisión global del módulo.
- Permiso de campo = ¿este usuario tiene derecho a ver/editar este campo? Decisión por rol/perfil.
Un campo puede ser visible en el contexto form_edit (la visibilidad lo permite) pero invisible para un usuario específico porque su perfil restringe ese campo. Las dos capas trabajan juntas.
Casos típicos¶
- Notas internas — visible en
detailsyform_edit, invisible enlist(no quieres notas largas en la tabla). - Folio — visible en
listysummary, invisible en formularios (se asigna automáticamente). - Total de presupuesto — visible en
list,details,summary,cards,kanban. - Razón de descalificación (prospecto) — visible solo si el estado es "Descalificado", controlado vía condiciones (más adelante).
Grupos de campos¶
Para organizar muchos campos en el formulario, agrupa con grupos de campos (field_groups):
- Crea un grupo (por ejemplo, "Datos personales", "Documentos", "Dirección").
- Asigna campos al grupo.
- En el formulario, los campos aparecen en secciones plegables por grupo.
Esto reduce el muro-de-50-campos en un formulario en secciones manejables.
Ten cuidado con¶
- Visibilidad por omisión es "todos los contextos". Si creas un campo nuevo y no configuras visibilidad, aparece en todos lados. Configura de inmediato.
- Quitar un campo de
listno lo elimina — solo deja de mostrarse en la columna de tabla. Los datos siguen en el registro. Si después quieres mostrarlo en filtros guardados, vuelve a marcarlo. - Verificar después de cambios masivos. Si modificas visibilidades de muchos campos, revisa la vista de lista antes de dar por terminado — un cambio mal puede hacer que la tabla se quede sin columnas útiles.
A dónde sigue¶
- Relaciones entre módulos — el contexto
related_to_parentdepende de relaciones. - Campos — para entender qué campos vas a configurar.