Detalle
| Campo |
Descripción |
| Manual de Usuario |
Dashboards - Tableros de indicadores |
| Módulo |
Dashboards |
| Objetivo |
Consultar indicadores del negocio y construir tableros compartidos con información de distintos módulos. |
| Acceso |
Menú principal de Plenario, opción Dashboards. |
| Permiso de acceso |
Dashboard.Ver |
| Información relacionada |
Préstamos, factoring, tesorería, inversiones, cambio, contabilidad, usuarios y seguridad. |
Introducción
El módulo Dashboards concentra indicadores visuales de distintas áreas de
Plenario. Permite consultar paneles disponibles y, con autorización, construir
tableros personalizados combinando indicadores, rangos de fecha y formatos de
visualización.
No debe confundirse con el grupo Dashboard del Gestor de Reportes ni con el
inicio de otros módulos. Esta opción abre el constructor general
FormDashboards.
Acceso al módulo
- Iniciá sesión en Plenario.
- Abrí Dashboards desde el menú principal.
- El sistema valida
Dashboard.Ver.
- La pantalla muestra los paneles e indicadores habilitados para el usuario.
El módulo está disponible para todas las empresas. La visibilidad de cada panel
depende de permisos por módulo.
Pantalla inicial
La pantalla presenta tarjetas de acceso a los paneles disponibles. Cada tarjeta
informa nombre, descripción e ícono. Sólo se muestran como utilizables los
paneles para los que el usuario posee autorización.
Los dominios registrados en el código son:
| Dominio |
Información |
| Préstamos |
Colocación, evolución diaria, mora, tramos de mora, principales morosos y cobranza. |
| Factoring |
Indicadores de operaciones y cartera de factoring. |
| Tesorería |
Órdenes de pago y egresos. |
| Inversiones |
Plazos fijos, colocaciones y cauciones. |
| Cambio |
Operaciones de compra y venta de divisas. |
| Contabilidad |
Asientos y plan de cuentas. |
| Funnel |
Indicadores de embudo o evolución comercial. |
La disponibilidad exacta depende de los proveedores registrados en la versión
instalada y de los permisos del usuario.
Consultar un dashboard
- Elegí el panel o tablero.
- Definí el rango Desde/Hasta cuando esté disponible.
- Aplicá el filtro.
- Revisá tarjetas, gráficos y tablas.
- Pasá el puntero o seleccioná un elemento para ver su detalle.
Los resultados se calculan al consultar. Si el rango no se informa, la interfaz
aplica sus fechas predeterminadas.
Tableros personalizados
Crear un tablero
- Seleccioná Nuevo dashboard.
- Ingresá un nombre.
- Elegí color e ícono.
- Indicá si será público.
- Agregá indicadores desde el catálogo.
- Ordená y dimensioná los elementos.
- Guardá.
Se requiere Dashboards.Crear. Al crearlo, el usuario queda registrado como
propietario.
Agregar indicadores
El catálogo agrupa los indicadores por dominio. Para cada elemento:
- Elegí el módulo.
- Seleccioná el indicador.
- Definí el tipo de visualización ofrecido.
- Ubicalo en la cuadrícula.
- Ajustá tamaño, orden y configuración.
Cada elemento conserva dominio, clave del indicador, posición, dimensiones,
tipo de visualización y configuración JSON.
Editar o eliminar
Sólo el propietario puede editar la definición, reemplazar indicadores,
administrar miembros o eliminar el tablero. La eliminación es lógica: el
tablero queda inactivo.
Compartir con usuarios
Un tablero puede ser:
- Público: visible para los usuarios habilitados.
- Privado: visible para el propietario y los miembros asignados.
Para compartir uno privado:
- Abrí su configuración.
- Seleccioná los usuarios.
- Guardá los miembros.
Ser miembro permite visualizar el tablero; no convierte al usuario en
propietario ni le permite modificar su estructura.
Filtros y resultados
Los proveedores reciben un rango de fechas con valores Desde, Hasta y
Corte. Según el indicador, el resultado puede ser:
- un valor resumido;
- una serie temporal;
- una distribución por categoría;
- una tabla de detalle;
- un ranking.
Compará siempre períodos equivalentes y revisá el rango activo antes de usar un
valor en una decisión o informe.
Ejemplo práctico
Caso: tablero de seguimiento de Préstamos.
- Abrí Dashboards.
- Creá un tablero llamado Seguimiento mensual de Préstamos.
- Agregá indicadores de colocación, cobranza, mora por tramos y principales morosos.
- Ordená primero los valores generales y luego los gráficos de detalle.
- Marcá el tablero como privado.
- Agregá a los responsables de Créditos y Cobranzas como miembros.
- Guardá.
- Seleccioná el mes que querés analizar y aplicá el filtro.
- Verificá que todos los indicadores usen el mismo período antes de comparar.
Consejos útiles
- Usá nombres que indiquen área y período esperado.
- Evitá cargar demasiados indicadores en un mismo tablero.
- Agrupá métricas relacionadas y mantené tamaños consistentes.
- Usá tableros privados para información destinada a un equipo puntual.
- No confundas falta de datos con falta de permisos: comprobá ambos casos.
- Verificá el rango de fechas antes de comparar valores.
- Si un gráfico no carga, probá primero otro rango y luego consultá a Soporte.
Cómo lo calcula el Asistente IA
Cuando le pedís estos datos al Asistente IA, los calcula con estas reglas.
Colocación de préstamos
- Usa el criterio del Dashboard de Préstamos: cantidad de créditos, capital colocado y ticket promedio, por moneda.
- Un crédito cuenta como colocado en su fecha de otorgamiento (o de liquidación, si no tiene). No cuentan los pendientes de otorgar ni los anulados; los cancelados sí.
- No usa la fecha de carga de la operación, que puede ser meses anterior al otorgamiento.
- "Colocación" en Factoring es otra cosa: ver Operado de factoring del mes en el manual de Liquidaciones en Factoring.
Preguntale al Asistente IA: «¿Cuánto prestamos este mes?», «Colocación de préstamos de septiembre», «Ticket promedio de préstamos».
Cartera de créditos por estado
- Agrupa todos los créditos por estado y moneda, con cantidad y capital.
- El estado es el que usa el sistema: Anulado, Pendiente, Cancelado, Mora (contra la fecha de trabajo) o Vigente. Ver el manual de Vencimientos de Clientes.
- No es el embudo de créditos online de la web de originación.
Preguntale al Asistente IA: «¿Cuántos créditos en mora hay?», «Cartera de préstamos por estado».
Preguntas frecuentes
¿Por qué no puedo abrir Dashboards?
El acceso principal requiere Dashboard.Ver.
¿Por qué una tarjeta de módulo no está disponible?
Además del acceso principal, el usuario necesita el permiso
Dashboards.<Modulo>.Ver correspondiente.
¿Por qué no aparece la opción para crear?
La creación y edición mediante el constructor requieren Dashboards.Crear.
¿Quién puede editar un tablero compartido?
Sólo su propietario. Los miembros pueden consultarlo.
¿Un tablero público puede mostrar cualquier indicador?
La visibilidad del tablero no reemplaza los permisos por panel o módulo. Cada
usuario conserva sus restricciones.
¿Por qué un indicador aparece vacío?
Revisá el rango, la existencia de operaciones en el período y el permiso del
panel. Si otros usuarios obtienen datos con el mismo criterio, solicitá revisar
tu perfil.
¿Qué ocurre al eliminar un dashboard?
Se marca como inactivo y deja de aparecer en los listados operativos.
¿El Asistente calcula la colocación de préstamos igual que el dashboard?
Sí: usa el criterio del Dashboard de Préstamos (fecha de otorgamiento, sin pendientes ni anulados), por moneda. Ver Cómo lo calcula el Asistente IA.
Permisos
| Objeto de seguridad |
Alcance |
Dashboard.Ver |
Habilita el ingreso desde el menú principal. |
Dashboards.Crear |
Permite crear y guardar dashboards desde el constructor. |
Dashboards.<Modulo>.Ver |
Habilita los indicadores de un dominio; por ejemplo Dashboards.Prestamos.Ver. |
La edición y eliminación también exigen que el usuario sea propietario del
tablero. La membresía sólo amplía la visibilidad.
Información técnica
FormDashboards aloja recursos HTML mediante WebView2.
DashboardsBridge intercepta https://dashboards.local/ y resuelve la API
virtual dentro del proceso. Los indicadores se obtienen de proveedores
registrados en IndicadorRegistry.
Componentes principales
| Componente |
Función |
VPNET_WinForms\Dashboards\FormDashboards.cs |
Formulario host, identidad activa e inicialización de WebView2. |
VPNET_WinForms\Dashboards\DashboardsBridge.cs |
API virtual de tarjetas, tableros, catálogo, indicadores, usuarios y miembros. |
VPNET_WinForms\Dashboards\html\index.html |
Pantalla de inicio. |
VPNET_WinForms\Dashboards\html\view.html |
Visualización del tablero. |
VPNET_WinForms\Dashboards\html\edit.html |
Constructor y edición. |
IndicadorRegistry |
Registro idempotente de proveedores. |
DashboardsManager |
Visibilidad, alta, edición, baja, items y miembros. |
DashboardDataService |
Servicios compartidos para el cálculo. |
DashboardPermisos |
Permisos por dominio y capability de creación. |
Proveedores
| Clase |
Dominio |
PrestamosIndicadorProvider |
Préstamos |
FactoringIndicadorProvider |
Factoring |
TesoreriaIndicadorProvider |
Tesorería |
InversionesIndicadorProvider |
Inversiones |
CambioIndicadorProvider |
Cambio |
ContabilidadIndicadorProvider |
Contabilidad |
FunnelIndicadorProvider |
Funnel |
Tablas
| Tabla |
Uso |
Dashboards_Tableros |
Nombre, apariencia, propietario, visibilidad, configuración y estado. |
Dashboards_Items |
Indicadores, posición, tamaño y configuración por tablero. |
Dashboards_Miembros |
Usuarios con acceso a tableros privados. |
Seguridad_Usuarios |
Identidad, propietario y miembros seleccionables. |
Los indicadores consultan las tablas operativas de cada módulo mediante sus
providers y clases de dashboard; no se encontró un procedimiento almacenado
único para el constructor general.
Relación con otros módulos y manuales
- Préstamos, Factoring, Tesorería, Inversiones, Cambio y Contabilidad:
aportan los datos calculados por cada proveedor.
- Seguridad: controla el acceso general, la creación y la visualización por dominio.
- Gestor de Reportes: es una funcionalidad diferente; puede mostrar reportes
o un dashboard heredado, pero no reemplaza este constructor general.
- Manuales relacionados: Gestor de Reportes y los manuales principales de cada
módulo operativo incluido en el catálogo.
Notas para soporte
- WebView2 Runtime es obligatorio.
index.html, view.html, edit.html, librerías y estilos deben estar embebidos.
AgenteIdentidad se establece antes de validar permisos internos.
- El acceso inicial usa
Dashboard.Ver, mientras los paneles usan el prefijo plural Dashboards..
- La empresa no oculta el módulo; el control vigente es por panel.
- Un usuario ve tableros propios, públicos o aquellos donde figura como miembro.
- Sólo el propietario satisface
DashboardsManager.PuedeEditar.
- Si un indicador falla, revisar dominio, clave, fechas y provider registrado.
Ver también