Datos de widgets
Obtiene las filas de un widget con fuente de datos y las entrega al gráfico, métrica o tabla que lo representa.
Que se logra
- Resultado: cada visualización muestra datos actuales de la organización y se recalcula cuando cambia un filtro vinculado.
- Caso de uso: una empresa de servicios selecciona el último trimestre y ve actualizarse solo los widgets preparados para ese periodo.
- Se combina con: Filtros de página, Widgets de visualización y Constructor de reportes con Nova.
Donde esta
- Ruta:
/[orgId]/analytics/ai-reports - Acceso en UI:
AI Reports > widget con datos - Componente(s): ReportWidgetChart.tsx, ReportVisualizationRenderer.tsx
Como funciona
- Abrir una página de reportes con widgets de datos.
- El widget solicita sus filas al cargar y vuelve a solicitarlas cuando cambia un filtro que tiene vinculado.
- Revisar la visualización; después de una operación de Nova, el lienzo fuerza una actualización de los datos.
Reglas y validaciones
- Solo se ejecutan consultas de lectura contra tablas autorizadas.
- El servicio añade el alcance de organización, limita el resultado a 1.000 filas y corta consultas que exceden 15 segundos.
- Los filtros fijos del widget se suman a los valores elegidos en la página.
Backend
- Servicios:
report-widget-data(create) - Efectos: devuelve columnas, filas, cantidad de filas y si el widget tiene una consulta.
Relaciones
- Requiere: un widget con fuente de datos válida.
- Dispara / afecta: la visualización del widget.
Notas
Los bloques de diseño no solicitan datos; se muestran con su título y contenido.