OdooWiki OCA HUB

Kpi Dashboard

kpi_dashboard folder_open OCA/reporting-engine open_in_new
Sin categoría Licencia: AGPL-3

Este módulo añade nuevos tipos de dashboards en un nuevo tipo específico de vista.

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 15.0

Crea cuadros de mando de KPI personalizados dentro de Odoo usando widgets configurables (números, medidores, contadores, gráficos) alimentados por código Python o funciones de modelo, y publícalos como menús para grupos de usuarios seleccionados.

Este módulo añade un nuevo tipo de dashboard a Odoo, construido a partir de indicadores individuales llamados KPIs. Los responsables configuran los KPIs en el nuevo menú "KPI Dashboards" (visible para el grupo "Manage KPI Dashboards"), donde cada KPI puede calcularse mediante código Python o llamando a una función de un modelo elegido, con argumentos opcionales. Cada KPI tiene un widget de visualización (integer, number, meter, counter o graph), un prefijo y un sufijo, y puede actualizarse al vuelo o almacenarse y actualizarse mediante una acción programada ("Generate cron"). Los valores pueden recalcularse manualmente con "Compute now", y el historial puede conservarse en un intervalo elegido, visible a través de "Show history" con botones para ver el valor o su forma sin procesar.

Los dashboards se ensamblan colocando elementos KPI en una cuadrícula: cada elemento tiene una fila, una columna y un tamaño, y el sistema bloquea los widgets superpuestos o los widgets más anchos que el número de columnas del dashboard. Los elementos pueden llevar colores, expresiones de contexto y expresiones de color, y pueden enlazar a acciones (reports, window actions, URLs, server actions) que se abren desde el KPI. Un botón "Generate menu" crea una entrada de menú real para el dashboard, restringida a los grupos definidos en el dashboard. Los dashboards también pueden añadirse al tablero de dashboard estándar de Odoo. El acceso es de solo lectura para los usuarios normales, mientras que el grupo de responsables puede crear y editar todo.

Depende de

busboardbase_sparse_field

Lo necesitan otros módulos

kpi_dashboard_altairkpi_dashboard_bokeh

Menús que añade

KPI Dashboards
Modelos y campos (8)
  • kpi.kpi · modelo nuevoargs, code, name, value, active, kwargs, prefix, suffix, widget, cron_id, function, model_id, action_ids, history_ids, computed_date, store_history, compute_on_fly, computed_value, value_last_update, computation_method, dashboard_item_ids, store_history_interval, store_history_interval_number
  • ir.ui.view · amplía un modelo existentetype
  • kpi.dashboard · modelo nuevoname, width, active, menu_id, item_ids, margin_x, margin_y, group_ids, background_color, number_of_columns, widget_dimension_x, widget_dimension_y, compute_on_fly_refresh
  • kpi.kpi.action · modelo nuevoaction, kpi_id, context
  • kpi.kpi.history · modelo nuevoname, value, kpi_id, widget, raw_value
  • kpi.dashboard.item · modelo nuevorow, name, color, column, kpi_id, size_x, size_y, end_row, end_column, font_color, dashboard_id, modify_color, compute_on_fly, modify_context, special_context, modify_color_expression, modify_context_expression
  • kpi.dashboard.menu · modelo nuevomenu_id, dashboard_id
  • ir.actions.act_window.view · amplía un modelo existenteview_mode

Texto generado por IA (DeepSeek) al leer el código de la versión 15.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. 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: 4 confirmadas, 5 sin información de 9 versiones.

Fuentes · Odoo 15.0

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

terminal Instalación y uso

Documentación de OCA · Odoo 15.0

Configuración

Fuente · Odoo 15.0

Configurar KPIs

#. Access `Dashboards > Configuration > KPI Dashboards > Configure KPI`
#. Create a new KPI specifying the computation method and the kpi type

   #. Number: result must contain a `value` and, if needed, a `previous`
   #. Meter: To show a percentage value, result must contain `value`. `value` must be a positive integer between 0 to 100. Meter is implemented with GaugeMeter (https://github.com/Mictronics/GaugeMeter). It can be customized by setting parameters for GaugeMeter in result. See https://github.com/Mictronics/GaugeMeter#parameter-definitions for details.
   #. Graph: result must contain a list on `graphs` containing `values`, `title` and `key`

#. In order to compute the KPI you can use a predefined function from a model or
   use the code to directly compute it.

Using KPI with code

Defina el código directamente en el campo code. Puede usar self y model como elemento kpi. El script debe crear una variable llamada result como un diccionario que se almacenará como el valor. Por ejemplo, podemos usar:

result = {}
result['value'] = len(model.search([('id', '=', %s)]))
result['previous'] = len(model.search([('id', '!=', %s)]))

Configurar dashboards

#. Access `Dashboards > Configuration > KPI Dashboards > Configure Dashboards`
#. Create a new dashboard and specify all the standard parameters on `Widget configuration`
#. Append elements on KPIs
#. You can preview the element using the dashboard view
#. You can create the menu entry directly using the `Generate menu` button

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, Uso.

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.