Detalle
| Campo | Valor |
|---|---|
| Manual de Usuario | Log de Auditorías - Plenario v14 |
| Módulo | Herramientas |
| Ventanas | Log de Auditorías (+ Detalle) |
| Versión | 1.0 |
Introducción
El Log de Auditorías es el visor de la tabla Plenario_Operaciones_Log: registra las operaciones auditadas del sistema (asientos, clientes, créditos, parámetros, cierres, transferencias, tickets, etc.), con el objeto involucrado serializado en JSON para poder revisar el estado guardado.
La ventana permite filtrar por rango de fecha y por tipo de log, ver el resultado en grilla y, con doble clic sobre una fila, abrir el detalle con el objeto serializado (y, en el caso de cierres automáticos, el desglose del proceso). El detalle se puede imprimir, exportar a PDF y exportar a Excel.
Es una herramienta de trazabilidad/diagnóstico: muestra qué operación se hizo, de qué tipo, su estado, origen/destino, quién y cuándo, más el JSON del objeto auditado.
Acceso al módulo
| Ventana | Ruta |
|---|---|
| Log de Auditorías | Herramientas → Log de Auditorías |
El acceso suele requerir permisos que deben solicitarse al administrador del sistema.
Pantalla principal
Al abrir, el rango de fecha se inicializa al día actual (desde = hasta = hoy) y el tipo de log en "Todos". Se carga la grilla con las operaciones del rango/tipo, ordenadas de la más reciente a la más antigua.
| Botón | Descripción |
|---|---|
| Buscar | Ejecuta la consulta con el rango de fecha y el tipo seleccionados. |
| Limpiar parámetros | Restablece los parámetros de búsqueda. |
| (Doble clic en fila) | Abre el Detalle de la operación (FormPlenarioAuditoriasLog_Detalle). |
Filtros de búsqueda
| Filtro | Descripción |
|---|---|
| Fecha (rango) | Rango por fecha de alta del log (Fecha_Add), desde/hasta. Por defecto, hoy. |
| Tipo Log | Combo con los tipos de operación auditada; "Todos" trae todos los tipos. |
| Limpiar parámetros | Vuelve los parámetros a sus valores por defecto. |
El tipo de log se elige de una lista que corresponde al enum
Tipo_Log(Asientos, Parámetros, Clientes, Crédito, Cierre, Factoring, Transferencias, Tickets, etc.). "Todos" (valor 0) no filtra por tipo.
Resultados
La grilla muestra una fila por operación auditada:
| Columna | Descripción |
|---|---|
| Id | Identificador del registro de log. |
| Tipo_Log | Tipo de operación (se muestra el nombre del tipo). |
| Tipo_Log_Id | Identificador del objeto auditado (clave del registro de origen). |
| Descripcion | Descripción de la operación. |
| Origen | Origen de la operación. |
| Destino | Destino de la operación. |
| Estado | Estado de la operación: "Modificado" / "Sin modificar". |
| JSON | Objeto serializado (Objeto_Serializado); el detalle completo se ve en la ventana de detalle. |
| Id_User_Add | Usuario que generó el registro. |
| Fecha_Add | Fecha y hora de alta del log. |
| Fecha_Trabajo | Fecha de trabajo (fecha de operación). |
| User_Environment | Entorno del usuario (máquina/dominio). |
Acciones disponibles
Es una pantalla de consulta y auditoría: no edita los registros.
| Acción | Cómo |
|---|---|
| Buscar / refrescar | Botón Buscar con el rango y tipo elegidos. |
| Filtrar en grilla | Fila de auto-filtro y encabezados de columna. |
| Ver detalle | Doble clic sobre la fila → abre FormPlenarioAuditoriasLog_Detalle. |
Ventana de Detalle
El detalle muestra el objeto serializado de la operación:
- Para tipos normales: el JSON se presenta en una grilla vertical (clave/valor) con el título del Origen.
- Para Cierre de día automático (Tipo_Log = 13): se muestra el desglose del proceso (código de proceso, inicio, fin, resultado, tiempo transcurrido) en una grilla, con las filas expandidas.
| Acción del detalle | Descripción |
|---|---|
| Imprimir | Vista previa de impresión del resultado. |
| Exportar PDF | Exporta el detalle a archivo .pdf. |
| Exportar XLS | Exporta el detalle a archivo .xls. |
| Aceptar | Cierra la ventana de detalle. |
Ejemplo práctico
Auditar quién modificó un cliente ayer:
- Herramientas → Log de Auditorías.
- Ajustar el rango de fecha al día de ayer (desde/hasta).
- En Tipo Log, elegir "Clientes". Buscar.
- Ubicar el registro por Tipo_Log_Id (id del cliente) y revisar Id_User_Add y Fecha_Add.
- Doble clic sobre la fila para ver en el detalle el objeto serializado (estado guardado del cliente).
- (Opcional) Exportar PDF/XLS desde el detalle para adjuntar a un ticket.
Consejos útiles
- El rango arranca en hoy: si buscás una operación vieja, ampliá el rango de fecha antes de Buscar.
- Acotá por Tipo Log para no recorrer todos los tipos cuando ya sabés qué operación buscás.
- Usá Tipo_Log_Id para encontrar el log de un registro concreto (por ejemplo, el id del crédito o del cliente).
- El doble clic es la forma de abrir el detalle; desde ahí exportás a PDF/Excel para evidencia.
Preguntas frecuentes
No veo una operación que sé que ocurrió, ¿por qué?
Por defecto el rango es el día de hoy. Ampliá el **rango de fecha** y verificá el **Tipo Log** (poné "Todos" si no estás seguro), luego **Buscar**.¿Cómo veo el detalle completo de lo que cambió?
**Doble clic** sobre la fila abre la ventana de detalle con el objeto serializado en JSON (clave/valor). Para cierres automáticos muestra el desglose del proceso.¿Puedo exportar la auditoría?
Sí, desde la **ventana de detalle**: botones Imprimir, Exportar PDF y Exportar XLS. La grilla principal admite además filtrado/ordenamiento estándar.¿Qué significa el estado "Modificado" / "Sin modificar"?
Es el `Estado_Operacion` del log: indica si la operación implicó modificación del objeto auditado o no.Permisos
El formulario FormPlenarioAuditoriasLog no ejecuta validaciones IsAllowedObject en su código: la búsqueda y el detalle se ejecutan directamente. El control de acceso se da por la visibilidad de la opción en el menú.
| Operación | Objeto de permiso |
|---|---|
| Acceso al módulo | (por visibilidad de la opción en el menú) |
| Buscar / Ver detalle / Exportar | (sin validación de permiso dentro del form) |
Información técnica
Basada en el análisis del formulario real de la v14.
Formularios principales
| Form | Rol |
|---|---|
FormPlenarioAuditoriasLog.cs (C#, VPNET_WinForms/Common) |
Hereda de FrmSearch. Visor de Plenario_Operaciones_Log: filtro por rango de fecha + tipo de log, grilla de resultados; doble clic abre el detalle. |
FormPlenarioAuditoriasLog_Detalle.cs (C#, Common) |
Hereda de FrmAddMod. Muestra el objeto serializado (JSON) o, para Tipo_Log=13, el desglose del proceso de cierre. Imprime y exporta a PDF/XLS. |
Permisos reales
| Permiso | Acción |
|---|---|
(sin IsAllowedObject en el form) |
Ni el visor ni el detalle validan un objeto de permiso propio. |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
Plenario_Operaciones_Log |
Tabla auditada: tipo, origen, destino, estado, usuario/fecha de alta, fecha de trabajo, entorno y objeto serializado (JSON). |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| ABM de Usuarios y Permisos - Plenario v14 | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- El filtro de la consulta es:
Tipo_Log(0 = Todos) y rango deFecha_Adddesde/hasta; orden descendente porFecha_Add. - Los tipos provienen del enum
Tipo_Logdel manager (1=Asientos, 3=Clientes, 4=Crédito, 10=Cierre, 11=Factoring, 13=Cierre_Dia_Automatico, 18=Transferencias, 26=Tickets, 33=LogError, etc.). - El detalle parsea
Objeto_Serializado: conGetDetalle(JsonDataSource clave/valor) para casos normales, y conGetDetalleCierre(lista deProceso) cuandoTipo_Log == 13. - El título de diseño del form es "Registro de auditoria"; el caption funcional/menú es "Log de Auditorías". Verificar contra el binario instalado ante diferencias.