OdooWiki OCA HUB

Key Performance Indicators

kpi folder_open OCA/reporting-engine open_in_new
Report Licencia: AGPL-3

Este módulo proporciona la base para crear indicadores clave de rendimiento, incluidos umbrales estáticos y dinámicos (consulta SQL o código Python), en fuentes de datos locales y remotas.

El módulo también proporciona el mecanismo para actualizar los KPI automáticamente. Se ejecuta un planificador cada hora y actualiza los valores de los KPI, en función de la periodicidad de cada KPI. El cálculo de los KPI también se puede realizar manualmente.

Un umbral es una lista de rangos y un rango es:

  • un nombre (como Good, Warning, Bad)
  • un valor mínimo (fijo, consulta sql o código python)
  • un valor máximo (fijo, consulta sql o código python)
  • color (código RGB como #00FF00 para verde, #FFA500 para naranja, #FF0000 para rojo)

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 19.0

Crea y realiza un seguimiento de los Indicadores Clave de Rendimiento (KPI) dentro de Odoo, calculados a partir de código Python o consultas SQL en bases de datos locales o externas, con umbrales codificados por colores y actualizaciones automáticas cada hora.

Este módulo añade un área de KPI bajo el menú Spreadsheet Dashboard. Los usuarios con el grupo "Manage KPI's" pueden definir KPI, categorías, umbrales y rangos.

  • Un KPI tiene un nombre, categoría, umbral, periodicidad (minute/hour/day/week/month) y un tipo de cálculo: Python, SQL sobre la base de datos local de Odoo, o SQL sobre una fuente de datos externa. El código debe devolver un único valor.
  • Cada KPI muestra su último valor, color y fecha de última ejecución, y mantiene un historial de cada cálculo. Un botón "Compute KPI Now" lo ejecuta manualmente.
  • Los umbrales agrupan rangos. Un rango tiene un nombre, un color y un mínimo y un máximo que pueden ser valores fijos, código Python o consultas SQL (locales o externas). Los rangos no deben solaparse; el sistema bloquea los rangos solapados y marca los no válidos con un mensaje.
  • Un trabajo programado se ejecuta cada hora y recalcula los KPI activos cuya próxima fecha de ejecución haya pasado, y luego programa la siguiente ejecución según la periodicidad.
  • El valor del KPI se colorea según el rango en el que se encuentre, y este color se muestra en las vistas kanban y lista del panel de KPI.
  • Los menús de configuración abarcan KPIs, Categories, Ranges, Data Sources y Thresholds. Los registros se filtran por compañía.

Depende de

base_external_dbsourcespreadsheet_dashboard

Lo necesitan otros módulos

Menús que añade

Key Performance IndicatorsKey Performance IndicatorsKey Performance IndicatorsCategoriesRangesData SourcesThresholds
Modelos y campos (5)
  • kpi · modelo nuevoname, color, value, active, kpi_code (KPI Code), kpi_type, company_id, category_id, dbsource_id, description, history_ids, periodicity, threshold_id, last_execution (Last execution), periodicity_uom, next_execution_date (Next execution date)
  • kpi.history · modelo nuevodate (Execution Date), name, color, value, kpi_id, company_id
  • kpi.category · modelo nuevoname, description
  • kpi.threshold · modelo nuevoname, valid, kpi_ids, range_ids, company_id, invalid_message (Message)
  • kpi.threshold.range · modelo nuevoname, color, valid, max_code (Maximum Computation Code), max_type, min_code (Minimum Computation Code), min_type, max_error (Maximum Error), max_value (Maximum Value), min_error (Minimum Error), min_value (Minimum Value), company_id, threshold_ids, invalid_message (Message), max_dbsource_id, max_fixed_value (Maximum Fixed Value), min_dbsource_id, min_fixed_value (Minimum Fixed Value)

Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.

Fuentes · Odoo 19.0

Confirmado el 2026-11-03 en la rama 19.0 de OCA/reporting-engine.

terminal Instalación y uso

Documentación de OCA · Odoo 19.0

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.