Operación · Documentos

Reportería

Genera documentos trazables a partir de una plantilla publicada, un sistema autorizado, sus variables y un periodo claramente definido.

Generación: user · admin · tenant_admin · super_admin Gestión: tenant_admin · super_admin
DiseñoPlantilla versionada
EjecuciónSistema + periodo + datos
SalidaHTML · PDF · entrega

Quién puede usar Reportería

La página está disponible para todos los roles autenticados salvo invitado. El contenido visible y las acciones dependen del rol y del tenant.

RolPuede generarPuede administrar
InvitadoNo tiene acceso a Reportería.No.
UsuarioPlantillas publicadas, sistemas autorizados y ejecuciones propias.No.
AdministradorPlantillas publicadas, sistemas autorizados y ejecuciones propias.No administra plantillas ni programaciones.
Administrador de tenantDentro de su tenant y con visibilidad de ejecuciones del tenant.Plantillas, versiones, publicación, programaciones y clonación de blueprints.
SuperadministradorDespués de seleccionar y abrir un tenant.Todo lo anterior y gobierno de blueprints maestros.
  1. Abre Reportería.

    El usuario de tenant entra directamente en su alcance.

  2. Si eres superadministrador, selecciona un tenant.

    Después pulsa Open para cargar plantillas, sistemas, ejecuciones y programaciones.

  3. Confirma el tenant activo.

    Cambiarlo reinicia la plantilla, pestaña, ejecución y demás selección actual.

No cambies de tenant con una configuración pendiente

El cambio limpia el estado de trabajo de la página. Guarda la versión o termina de registrar la ejecución antes de abrir otro alcance.

Consultar y administrar plantillas

La biblioteca organiza el contrato del reporte. Los usuarios operativos solo ven plantillas publicadas; los gestores también trabajan con borradores y versiones inmutables.

Consultar una plantilla publicada

  1. Expande Template library.

    Busca por nombre y usa los filtros de estado o rol.

  2. Selecciona una plantilla publicada.

    Revisa descripción, versión activa y roles autorizados.

  3. Abre Structure.

    Consulta el contrato, parámetros y estructura sin modificar la versión publicada.

  4. Usa la vista previa sintética.

    Comprueba diseño y distribución con datos de prueba; no representa valores reales del proceso.

Crear o versionar una plantilla

  1. Define metadatos y roles.

    Asigna nombre, descripción y quién podrá ejecutar la plantilla.

  2. Diseña el contrato.

    La estructura debe cumplir el formato scada-report.v1.

  3. Si usas IA, describe el resultado esperado.

    Puedes mejorar la instrucción, revisar diferencias y generar una propuesta; valida siempre la estructura resultante.

  4. Selecciona Validate.

    El backend revisa contrato y dependencias antes de permitir una versión.

  5. Crea el borrador o guarda una versión.

    Las versiones existentes no se sobrescriben: cada cambio produce una nueva versión.

  6. Revisa la preparación y publica.

    Solo una versión lista debe convertirse en la referencia para nuevas ejecuciones.

Publicar cambia la referencia operativa

Las nuevas ejecuciones y las programaciones asociadas utilizan la versión publicada vigente. Revisa contrato, parámetros y vista previa antes de publicar.

Generar un reporte

La generación combina una plantilla publicada con un sistema, variables, reglas de alarma, periodo y formatos de salida.

  1. Selecciona una plantilla publicada.

    Una plantilla en borrador no puede ejecutarse.

  2. Abre Generate.

    Si lo prefieres, describe con IA la intención: sistema, periodo, datos y formatos.

  3. Revisa las coincidencias propuestas.

    Cuando un nombre es ambiguo, el front exige confirmar la opción correcta.

  4. Selecciona el sistema.

    Solo aparecen sistemas autorizados para tu usuario y tenant.

  5. Completa los bindings.

    Busca y asigna variables, mínimos, máximos y demás parámetros esperados por la plantilla.

  6. Configura alarmas si la plantilla las solicita.

    Las reglas disponibles quedan limitadas a las variables elegidas; define severidades y estados.

  7. Define periodo y formatos.

    Selecciona inicio, fin y salida HTML, PDF o ambas.

  8. Valida la ejecución.

    Corrige parámetros pendientes antes de iniciar el proceso.

  9. Genera y sigue el progreso.

    La ejecución recibe un UUID y avanza de forma asíncrona; la pantalla actualiza el estado aproximadamente cada 1.8 segundos.

01Plantilla publicada
02Sistema
03Bindings
04Periodo
05Ejecución
QueuedLa solicitud está registrada y espera procesamiento.
RunningLa construcción del documento sigue en curso.
CompletedLos artefactos disponibles pueden abrirse o entregarse.
FailedConsulta el detalle, corrige entradas o plantilla y vuelve a ejecutar.
No cierres el diagnóstico en el porcentaje

Si una ejecución falla, conserva su UUID y revisa el mensaje final. Los gestores ven las ejecuciones del tenant; otros usuarios consultan únicamente las propias.

Programar un reporte

Las programaciones están disponibles para administrador de tenant y superadministrador. Ejecutan de forma recurrente una plantilla publicada con bindings y destinatarios persistentes.

  1. Abre Schedule.

    Selecciona crear una programación o edita una existente.

  2. Asigna nombre y plantilla.

    Usa una plantilla publicada y un nombre que identifique frecuencia y propósito.

  3. Configura cron y zona IANA.

    La expresión determina cuándo se ejecuta; la zona evita interpretar la hora en una ubicación incorrecta.

  4. Define el periodo retrospectivo.

    Indica cuánto tiempo anterior debe cubrir cada ejecución.

  5. Selecciona sistema, formatos y bindings.

    Completa los mismos parámetros que requiere una generación manual.

  6. Elige destinatarios.

    Incluye únicamente dispositivos activos, verificados y con notificaciones habilitadas.

  7. Activa y guarda.

    Revisa la próxima ejecución y conserva la programación inactiva mientras esté en preparación.

  • Usa una zona IANA válida, por ejemplo una región y ciudad reconocibles.
  • Comprueba que el periodo retrospectivo no deje huecos ni duplique datos de forma innecesaria.
  • Revisa destinatarios cuando cambien usuarios o dispositivos.
  • Desactiva temporalmente antes de realizar una prueba de estructura.
  • La eliminación solicita confirmación y no conserva una programación ejecutable.
La programación sigue la versión publicada actual

Publicar una versión nueva puede modificar documentos futuros sin editar la programación. Valida el nuevo contrato con los mismos bindings antes de publicarlo.

Trabajar con blueprints

Un blueprint es un diseño maestro reutilizable. Se clona para iniciar una plantilla del tenant sin modificar el original.

RolAcciones disponiblesResultado
Administrador de tenantPrevisualizar y clonar blueprints publicados.Nueva plantilla independiente dentro de su tenant.
SuperadministradorCrear borrador, versionar, publicar, archivar y mantener portabilidad.Blueprint maestro disponible para los tenants autorizados.
  1. Abre Blueprints.

    Esta pestaña solo aparece para gestores.

  2. Selecciona uno publicado.

    Revisa descripción, versión y vista previa antes de clonarlo.

  3. Clona al tenant.

    Elige un nombre identificable para la plantilla resultante.

  4. Valida referencias y parámetros.

    La portabilidad no sustituye la revisión de variables, roles y bindings del destino.

  5. Versiona y publica la plantilla clonada.

    Desde ese momento se administra de forma independiente.

Clonar no vincula futuras modificaciones

Los cambios posteriores al blueprint no sobrescriben automáticamente la plantilla ya creada en el tenant.

Abrir, descargar y entregar documentos

Una ejecución completada muestra sus artefactos, formato, tamaño y expiración. La vista previa HTML se abre en un marco aislado.

  1. Localiza la ejecución.

    La lista reciente conserva hasta 40 resultados según tu alcance.

  2. Comprueba Completed.

    No intentes entregar una ejecución todavía en cola, en proceso o fallida.

  3. Selecciona View, Open o Download.

    El sistema crea un enlace seguro de acceso temporal, válido durante 10 minutos.

  4. Revisa el documento.

    Comprueba periodo, sistema, variables, unidades y páginas antes de distribuirlo.

  5. Selecciona Deliver si necesitas enviarlo.

    Elige un dispositivo de correo, WhatsApp o Telegram que esté activo, verificado y habilitado.

  6. Confirma el resultado.

    Si falla la entrega, revisa el dispositivo y conserva el UUID de ejecución.

El enlace temporal no es un archivo permanente

No lo uses como repositorio ni lo publiques. Descarga el artefacto autorizado o genera un nuevo enlace cuando el anterior haya expirado.

Reportería · Manual de usuario de SCADA IA