Catálogos¶

Para qué sirve¶

Un catálogo es una lista de opciones reutilizable, plana o jerárquica (con niveles), que alimenta los campos de selección de los formularios: por ejemplo "Tipos de solicitud" o "Sedes". Se administran en un solo lugar y cualquier formulario puede usarlos.

Quién puede usarla¶

Los permisos previstos son ver (catalog:read), crear (catalog:create) y editar (catalog:update).

Importante

La pantalla no comprueba permisos por adelantado: todos los botones se ven. Si tu usuario no tiene permiso, el servidor rechaza la acción y verás un mensaje de error. Ver Permisos.

Dónde encontrarla¶

Menú lateral > Configuración > Catálogos (/catalogos). Además existen /catalogos/nuevo (alta), /catalogos/{id} (detalle de solo lectura) y /catalogos/{id}/editar (edición).

La lista de catálogos¶

Descripción de la pantalla: "Administrá y organizá tus catálogos de datos.". Se muestra como tarjetas.

Botón Nuevo catálogo.
Filtros: buscador Buscar catálogo, Estado (Activo / Inactivo) y Origen (Usuario / Sistema).
Cada tarjeta muestra nombre, estado, descripción, Origen:, la cantidad de ítems activos ("{activos} / {total} ítems activos" o "Sin ítems") y los botones Ver y Editar (este último solo en catálogos de origen Usuario).
Paginación con Por página (10, 15, 20 o 30). El total de páginas es estimado: si la página vino completa se asume que hay otra.
Sin resultados: "No se encontraron catálogos."; error: "No se pudieron cargar los catálogos.".

📷 IMAGEN PENDIENTE

Captura: lista de catálogos en tarjetas con filtros Estado y Origen. Archivo sugerido: img/configuracion-catalogos-lista.png

Origen: Usuario y Sistema¶

Usuario: creados desde esta pantalla; se pueden editar y desactivar.
Sistema: vienen precargados. Son de solo lectura: no se editan ni se desactivan.

Ver un catálogo¶

Ver abre el detalle: nombre, insignias de origen y estado, "Última modificación: hace X", panel Estructura del Catálogo con el árbol de ítems (los inactivos aparecen tachados con la insignia "inactivo"; "Total nodos: n") y panel lateral con Descripción, Origen, Estado e Instrucciones. Desde acá, Editar catálogo (solo origen Usuario).

Crear un catálogo¶

En Configuración > Catálogos hacé clic en Nuevo catálogo.
Completá Nombre (obligatorio, hasta 255 caracteres, por ejemplo "Tipos de solicitud"). Debe ser único. Opcionalmente, Descripción (hasta 1000 caracteres).
Armá el árbol en Estructura del Catálogo (ver siguiente sección).
Hacé clic en Crear catálogo. Mensaje de éxito: "¡Catálogo guardado correctamente!"; te lleva al detalle.

Editor de árbol¶

El panel Estructura del Catálogo combina un explorador del árbol y un panel Detalles del Nodo.

Hacé clic en Raíz para agregar un ítem de primer nivel.
Seleccioná un ítem. Si no hay ninguno seleccionado: "Selecciona un nodo para ver detalles".
Completá ETIQUETA (nombre visible, "Nombre del elemento") y VALOR (valor técnico). Ambos son obligatorios en todos los ítems.
Para crear un nivel inferior, usá Agregar Subnodo con el ítem seleccionado.
Para reordenar, arrastrá los nodos ("Arrastrá para reordenar nodos").
Para cambiar de padre, en MOVER A elegí Seleccionar nuevo padre (o Sin padre (raíz)) y hacé clic en Mover.
ESTADO ACTIVO activa o desactiva el ítem.
Eliminar quita un ítem que todavía no se guardó (los ya guardados se desactivan, no se borran).
Guardá con Crear catálogo o Guardar cambios.

📷 IMAGEN PENDIENTE

Captura: editor de catálogo con árbol de tres niveles, un nodo seleccionado y el panel Detalles del Nodo. Archivo sugerido: img/configuracion-catalogos-arbol.png

Tip

Los catálogos jerárquicos no tienen límite de niveles. Un campo Select jerárquico del formulario permite elegir en cascada y guarda el camino completo.

Editar un catálogo¶

Desde la tarjeta o el detalle, hacé clic en Editar / Editar catálogo.
Modificá Nombre, Descripción o el árbol.
Hacé clic en Guardar cambios (está deshabilitado en catálogos de Sistema). Éxito: "¡Catálogo guardado correctamente!".

Al guardar, el árbol completo se reemplaza por el que ves en pantalla. Si falla el guardado de los ítems, el sistema revierte el nombre y la descripción ("No se pudieron guardar los cambios en los ítems. Se revirtió el nombre y la descripción.") o advierte: "Ocurrió un error al guardar. El catálogo puede haber quedado en un estado inconsistente — por favor revisalo antes de continuar.". En ese caso, abrí el catálogo y verificalo.

Validaciones al guardar (se muestran bajo Error de validación): "El nombre es requerido", "El nombre no puede superar los 255 caracteres", "La descripción no puede superar los 1000 caracteres", "Todos los ítems deben tener una etiqueta.", "Todos los ítems deben tener un valor.".

Desactivar y activar¶

Nada se borra: todo es baja lógica.

Desactivar un ítem¶

Al desactivar un ítem que tiene subítems activos aparece Desactivar "{ítem}" con tres opciones: Solo este item, Este item y sus hijos o Cancelar. Los nodos desactivados no se ofrecen en los formularios.

Desactivar un catálogo¶

Al editar un catálogo de tipo Usuario, usá el interruptor Activo / Inactivo del encabezado.
Al desactivar aparece Desactivar catálogo: "¿Seguro que querés desactivar este catálogo? Los formularios existentes que lo usan van a seguir funcionando.".
Si algún formulario publicado usa el catálogo, el diálogo cambia a Este catálogo está en uso: los formularios existentes siguen funcionando con la información actual, pero el catálogo deja de estar disponible para formularios nuevos. Confirmá con Confirmar de todas formas.
Mensajes: "¡Catálogo desactivado correctamente!" / "¡Catálogo activado correctamente!".

Revisiones¶

Cada cambio efectivo en un catálogo (nombre, descripción, alta, baja o reactivación de ítems, cambio de etiqueta, valor, orden o estructura) genera una revisión numerada que no se puede modificar. Guardar sin cambios reales no genera revisión. Activar o desactivar el catálogo completo tampoco.

Qué implica para el trabajo diario:

Las solicitudes guardan la revisión del catálogo que se usó al completar el formulario y siguen mostrándola igual aunque después cambie.
Si el catálogo cambió mientras un solicitante completaba el formulario, el envío se rechaza y debe recargar el formulario.
Si dos personas editan a la vez, la segunda recibe un aviso de conflicto: recargá y volvé a aplicar tus cambios.
Los formularios intermedios de un flujo publicado usan una copia congelada de su catálogo.

Cómo se usan en los formularios¶

Los campos Select simple, Select múltiple y Select jerárquico piden un Catálogo de opciones. Solo aparecen catálogos activos. Antes de desactivar un catálogo que está en uso, revisá qué formularios lo usan y el aviso que muestra el sistema. Ver Formularios.