Reportes9 min de lectura

UI de Reportes y Programados: qué hace cada opción

Artículo de referencia para administradores. Explica cada opción disponible en /reportes y /reportes/programados, incluyendo flujos, acciones por fila y comportamiento del scheduler/worker.

Lo esencial

Tres pantallas y un ciclo de ejecución automatizado. Esto es lo que necesitas tener claro antes de operar.

Pantalla /reportes

Generación manual, historial reciente y acceso rápido a programados.

Pantalla /reportes/programados

CRUD completo de programaciones, activación/pausa y ejecución manual.

Ejecución automática

Scheduler + queue + worker con registro en historial y notificación in-app.

Qué hace cada bloque en /reportes

Header de reportes

Programados: Abre la pantalla dedicada de programación de reportes para crear, editar o pausar ejecuciones automáticas.
Nuevo reporte: Te lleva al flujo de creación de reportes para generar análisis bajo demanda.

Tarjetas de resumen

Generados: Total de reportes recientes registrados en historial.
Programados: Total de programaciones y cuántos están activos actualmente.
Última actualización: Fecha y hora del último reporte generado que aparece en historial.
Descargas: Cantidad de reportes completados en la página actual del historial.

Tabla de reportes recientes

Buscador: Filtra por nombre de reporte, clave o usuario generador.
Filtros (tipo, formato, estado): Permiten segmentar el historial para auditoría o seguimiento puntual.
Click en fila: Ejecuta Ver reporte cuando el reporte es compatible y está en estado COMPLETADO.
Menú de acciones por fila: Incluye ver, descargar, enviar por email, compartir y eliminar del historial.

Tarjeta lateral Programados

Lista corta (top 5): Muestra rápidamente los programados más recientes y su próxima ejecución.
Botón play/pausa: Activa o pausa el programado sin entrar a la pantalla detallada.
Ver todos los programados: Navega a /reportes/programados para administración completa.

Opciones del formulario crear/editar

Nombre

Etiqueta interna del programado para identificar su objetivo.

Reporte

Selecciona la clave financiera a ejecutar. En esta fase estado-cartera genera resultado real; las otras claves registran ERROR explícito.

Time zone

Zona horaria sobre la que se calcula próxima ejecución y slot recurrente.

Fecha inicio

Fecha ancla a partir de la cual el scheduler comienza a evaluar ejecuciones.

Hora ejecución

Hora local (HH:mm) en que debe dispararse cada ejecución.

Frecuencia

Define recurrencia: DIARIA, SEMANAL, MENSUAL, BIMENSUAL, TRIMESTRAL, SEMESTRAL o ANUAL.

Días semana

Obligatorio cuando la frecuencia es SEMANAL.

Días del mes

Obligatorio para frecuencias mensuales o superiores. Acepta lista separada por coma (1..31).

Activo

Si se desmarca, se guarda pero no entra al scheduler hasta reactivarlo.

Descripción

Contexto administrativo opcional para tu equipo.

Campos específicos para estado-cartera

Cuando eliges estado-cartera como reporte, el formulario expone estos parámetros adicionales.

towerIds

Filtra estructuras objetivo del reporte.

minOverdue

Filtra por saldo vencido mínimo.

bucket

Filtra por tramo de antigüedad de deuda (0_30, 31_60, 61_90, 90_plus).

minDaysOverdue

Filtra por días de mora mínimos.

topN

Limita la lista de mayores deudores.

showOnlyDebtors

Muestra solo unidades con mora cuando está en true.

cutoffDateMode / cutoffDate

Define si el corte se calcula al día de ejecución (today) o con fecha fija.

Acciones por fila en programados

Editar

Carga el programado en el formulario para actualizar parámetros, frecuencia o estado.

Pausar / Activar

Cambia isActive y recalcula la siguiente ejecución cuando aplica.

Ejecutar ahora

Encola un job manual inmediato. No desplaza el calendario recurrente ya calculado.

Eliminar

Borra la configuración programada (no elimina históricos ya generados).

Del programado al historial

El ciclo de vida de una ejecución programada en cuatro etapas.

Scheduler detecta vencidos

Busca programados activos con próximaEjecución <= now y encola job por slot con id determinístico.

Worker ejecuta

Si reporteClave=estado-cartera exporta CSV real. Si no está implementado, registra ERROR auditado.

Se registra historial

Cada ejecución crea un ReporteGenerado en Reportes Recientes (COMPLETADO o ERROR).

Se notifica al admin

Se envía notificación in-app con link a /reportes o /reportes/programados según resultado.

Notas operativas

Preguntas frecuentes

¿Por qué una fila puede quedar en ERROR aunque el job corrió?

Porque algunas claves financieras aún no tienen generador real. El sistema ejecuta y deja ERROR explícito para trazabilidad.

¿Qué pasa si pauso un programado?

Se conserva configuración y parámetros, pero el scheduler deja de encolarlo hasta reactivarlo.

¿Run-now cambia mi siguiente ejecución programada?

No. Run-now es manual e inmediato; el slot recurrente se mantiene.

¿Eliminar borra archivos o reportes históricos?

No. Solo elimina la configuración del programado. Los reportes del historial permanecen.

Checklist rápido para operar Programados

Valida frecuencia, timezone, parámetros y estado activo antes de salir del módulo.

Iniciar Sesión