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 Consultar catálogos (catalog:read), Crear catálogos (catalog:create) y Actualizar catálogos (catalog:update).

Importante

La pantalla puede mostrar catálogos y controles a una cuenta que no tiene los permisos previstos. La comprobación de acceso no es uniforme. Modificá sólo los catálogos que te corresponde administrar y consultá a quien administra STU si ves opciones ajenas a tu función. Ver Permisos.

Dónde encontrarla¶

Menú lateral > Configuración > Catálogos. Usá Nuevo catálogo, Ver o Editar según la tarea.

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.".

Listado de catálogos DOCS con filtros Estado y Origen.

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 permite editar cada ítem directamente en su fila.

Hacé clic en Agregar item raíz para crear una opción de primer nivel.
Completá Etiqueta, el nombre que verá el solicitante, y Valor, el identificador de esa opción. Ambos son obligatorios.
Para agregar un subítem, usá el botón + al extremo derecho de la fila de su padre. Completá los dos campos de la nueva fila, que aparece debajo y con sangría.
Usá Contraer o Expandir para plegar y desplegar los hijos.
El interruptor de cada fila activa o desactiva el ítem. Si tiene hijos activos, se te pide elegir si también los desactivás.
El control Reordenar, a la izquierda de cada fila, permite arrastrarla dentro del árbol.
Guardá con Crear catálogo o Guardar cambios. Abrí el detalle para comprobar el orden y la estructura guardados.

Si el orden vuelve al anterior después de guardar y reabrir, registrá lo ocurrido y avisá a quien administra STU; no des por confirmado el reordenamiento sólo porque lo ves antes de guardar.

Si el buscador Buscar item... aparece deshabilitado, recorré las filas y plegá las ramas que no necesitás. No confundas ese buscador con Buscar catálogo, que filtra la lista general.

Editor del catálogo DOCS con etiqueta y valor en cada fila, subítems y controles de agregar y activar.

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¶

Los catálogos y los ítems guardados se desactivan y pueden reactivarse. Los ítems que todavía no guardaste se pueden quitar del borrador.

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.

Elegí si la baja afecta al padre o también a sus hijos; después guardá el catálogo.

Para reactivar una rama, encendé el interruptor del padre y el de cada hijo que necesites recuperar. Reactivar el padre no reactiva automáticamente sus hijos. Guardá y comprobá el resultado al reabrir.

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. Revisá cuáles dependen de él y cómo podrán completarse antes de decidir. Si corresponde continuar, usá Confirmar de todas formas.
Mensajes: "¡Catálogo desactivado correctamente!" / "¡Catálogo activado correctamente!".

Catálogo DOCS de práctica desactivado; sus ítems conservan sus interruptores individuales.

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.