diff --git a/kpi/README.rst b/kpi/README.rst index 5a5bb4a4c..b565b535d 100644 --- a/kpi/README.rst +++ b/kpi/README.rst @@ -1,10 +1,29 @@ -.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg - :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html - :alt: License: AGPL-3 +========================= +Key Performance Indicator +========================= -=== -KPI -=== +.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png + :target: https://odoo-community.org/page/development-status + :alt: Beta +.. |badge2| image:: https://img.shields.io/badge/licence-LGPL--3-blue.png + :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html + :alt: License: LGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fserver--tools-lightgray.png?logo=github + :target: https://github.com/OCA/server-tools/tree/11.0/kpi + :alt: OCA/server-tools +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/server-tools-11-0/server-tools-11-0-kpi + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png + :target: https://runbot.odoo-community.org/runbot/253/11.0 + :alt: Try me on Runbot + +|badge1| |badge2| |badge3| |badge4| This module provides the basis for creating key performance indicators, including static and dynamic thresholds (SQL query or Python code), @@ -22,6 +41,12 @@ A threshold is a list of ranges and a range is: * a maximum value (fixed, sql query or python code) * color (RGB code like #00FF00 for green, #FFA500 for orange, #FF0000 for red) + +**Table of contents** + +.. contents:: + :local: + Configuration ============= @@ -32,11 +57,9 @@ Users must be added to the appropriate groups within Odoo as follows: Usage ===== +Example of usage: https://www.youtube.com/watch?v=OC4-y2klzIk -.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas - :alt: Try me on Runbot - :target: https://runbot.odoo-community.org/runbot/128/9.0 Known issues / Roadmap ====================== @@ -48,12 +71,16 @@ Bug Tracker Bugs are tracked on `GitHub Issues `_. In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us smashing it by providing a detailed and welcomed +`feedback `_. + +Do not contact contributors directly about support or help with technical issues. Credits ======= Contributors ------------- +~~~~~~~~~~~~ * Daniel Reis * Glen Dromgoole @@ -62,17 +89,19 @@ Contributors * Gervais Naoussi * Iván Todorovich -Maintainer ----------- +Maintainers +~~~~~~~~~~~ + +This module is maintained by the OCA. .. image:: https://odoo-community.org/logo.png :alt: Odoo Community Association :target: https://odoo-community.org -This module is maintained by the OCA. - OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use. -To contribute to this module, please visit https://odoo-community.org. +This module is part of the `OCA/server-tools `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. \ No newline at end of file diff --git a/kpi/__init__.py b/kpi/__init__.py index bdb4c9bb3..7988aa3f7 100644 --- a/kpi/__init__.py +++ b/kpi/__init__.py @@ -1,4 +1,3 @@ -# -*- coding: utf-8 -*- # Copyright 2012 - Now Savoir-faire Linux # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). diff --git a/kpi/__openerp__.py b/kpi/__manifest__.py similarity index 94% rename from kpi/__openerp__.py rename to kpi/__manifest__.py index 82e16d814..d14cc89e1 100644 --- a/kpi/__openerp__.py +++ b/kpi/__manifest__.py @@ -1,10 +1,9 @@ -# -*- coding: utf-8 -*- # Copyright 2012 - Now Savoir-faire Linux # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). { "name": "Key Performance Indicator", - "version": "9.0.1.1.0", + "version": "11.0.1.1.0", "author": "Savoir-faire Linux,Odoo Community Association (OCA)", "website": "http://www.savoirfairelinux.com", "license": "AGPL-3", diff --git a/kpi/data/kpi.xml b/kpi/data/kpi.xml index f32a79864..8bf99d95e 100644 --- a/kpi/data/kpi.xml +++ b/kpi/data/kpi.xml @@ -1,18 +1,16 @@ - - - - Update KPI values - - 1 - hours - -1 - - - - - - + + + Update KPI values + + 1 + hours + -1 + + + code + model.update_kpi_value() + diff --git a/kpi/images/kpi_computation.png b/kpi/images/kpi_computation.png index 63adf135f..cd0e9da8e 100644 Binary files a/kpi/images/kpi_computation.png and b/kpi/images/kpi_computation.png differ diff --git a/kpi/images/kpi_definition.png b/kpi/images/kpi_definition.png index f8e301677..9ba2176f2 100644 Binary files a/kpi/images/kpi_definition.png and b/kpi/images/kpi_definition.png differ diff --git a/kpi/images/kpi_range.png b/kpi/images/kpi_range.png index 50b84a3e4..fd6d3d701 100644 Binary files a/kpi/images/kpi_range.png and b/kpi/images/kpi_range.png differ diff --git a/kpi/images/kpi_threshold.png b/kpi/images/kpi_threshold.png index 623bc7254..225a43808 100644 Binary files a/kpi/images/kpi_threshold.png and b/kpi/images/kpi_threshold.png differ diff --git a/kpi/models/__init__.py b/kpi/models/__init__.py index f46e81d90..7da5b4485 100644 --- a/kpi/models/__init__.py +++ b/kpi/models/__init__.py @@ -1,4 +1,3 @@ -# -*- coding: utf-8 -*- # Copyright 2012 - Now Savoir-faire Linux # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). diff --git a/kpi/models/kpi.py b/kpi/models/kpi.py index f4c1a9af7..69c4cabb8 100644 --- a/kpi/models/kpi.py +++ b/kpi/models/kpi.py @@ -1,11 +1,10 @@ -# -*- coding: utf-8 -*- # Copyright 2012 - Now Savoir-faire Linux # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). from datetime import datetime, timedelta -from openerp import fields, models, api -from openerp.tools.safe_eval import safe_eval -from openerp.tools import ( +from odoo import fields, models, api +from odoo.tools.safe_eval import safe_eval +from odoo.tools import ( DEFAULT_SERVER_DATETIME_FORMAT as DATETIME_FORMAT, ) import re diff --git a/kpi/models/kpi_category.py b/kpi/models/kpi_category.py index 2c34c9c6b..3c97e3aa9 100644 --- a/kpi/models/kpi_category.py +++ b/kpi/models/kpi_category.py @@ -1,8 +1,7 @@ -# -*- coding: utf-8 -*- # Copyright 2012 - Now Savoir-faire Linux # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). -from openerp import fields, models +from odoo import fields, models class KPICategory(models.Model): diff --git a/kpi/models/kpi_history.py b/kpi/models/kpi_history.py index 598431560..10fe4f6de 100644 --- a/kpi/models/kpi_history.py +++ b/kpi/models/kpi_history.py @@ -1,8 +1,7 @@ -# -*- coding: utf-8 -*- # Copyright 2012 - Now Savoir-faire Linux # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). -from openerp import fields, models +from odoo import fields, models class KPIHistory(models.Model): diff --git a/kpi/models/kpi_threshold.py b/kpi/models/kpi_threshold.py index b62a3ffbb..dcc6199cf 100644 --- a/kpi/models/kpi_threshold.py +++ b/kpi/models/kpi_threshold.py @@ -1,8 +1,7 @@ -# -*- coding: utf-8 -*- # Copyright 2012 - Now Savoir-faire Linux # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). -from openerp import fields, models, api, exceptions, _ +from odoo import fields, models, api, exceptions, _ class KPIThreshold(models.Model): diff --git a/kpi/models/kpi_threshold_range.py b/kpi/models/kpi_threshold_range.py index a5b32313f..d1b2d6b34 100644 --- a/kpi/models/kpi_threshold_range.py +++ b/kpi/models/kpi_threshold_range.py @@ -1,9 +1,8 @@ -# -*- coding: utf-8 -*- # Copyright 2012 - Now Savoir-faire Linux # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). -from openerp import fields, models, api -from openerp.tools.safe_eval import safe_eval +from odoo import fields, models, api +from odoo.tools.safe_eval import safe_eval import re diff --git a/kpi/readme/CONTRIBUTORS.rst b/kpi/readme/CONTRIBUTORS.rst new file mode 100644 index 000000000..6aed435ce --- /dev/null +++ b/kpi/readme/CONTRIBUTORS.rst @@ -0,0 +1,6 @@ +* Daniel Reis +* Glen Dromgoole +* Loic Lacroix +* Sandy Carter +* Gervais Naoussi +* Iván Todorovich \ No newline at end of file diff --git a/kpi/readme/DESCRIPTION.rst b/kpi/readme/DESCRIPTION.rst new file mode 100644 index 000000000..c73ee9b90 --- /dev/null +++ b/kpi/readme/DESCRIPTION.rst @@ -0,0 +1,15 @@ +This module provides the basis for creating key performance indicators, +including static and dynamic thresholds (SQL query or Python code), +on local and remote data sources. + +The module also provides the mecanism to update KPIs automatically. +A scheduler is executed every hour and updates the KPI values, based +on the periodicity of each KPI. KPI computation can also be done +manually. + +A threshold is a list of ranges and a range is: + +* a name (like Good, Warning, Bad) +* a minimum value (fixed, sql query or python code) +* a maximum value (fixed, sql query or python code) +* color (RGB code like #00FF00 for green, #FFA500 for orange, #FF0000 for red) \ No newline at end of file diff --git a/kpi/readme/USAGE.rst b/kpi/readme/USAGE.rst new file mode 100644 index 000000000..c70fc22a5 --- /dev/null +++ b/kpi/readme/USAGE.rst @@ -0,0 +1,2 @@ +Example of usage: +https://www.youtube.com/watch?v=OC4-y2klzIk \ No newline at end of file diff --git a/kpi/tests/__init__.py b/kpi/tests/__init__.py index c9e401ab7..b4dd9f28b 100644 --- a/kpi/tests/__init__.py +++ b/kpi/tests/__init__.py @@ -1,4 +1,3 @@ -# -*- coding: utf-8 -*- # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). from . import test_kpi diff --git a/kpi/tests/test_kpi.py b/kpi/tests/test_kpi.py index 4ac3c0b1e..c01ca423e 100644 --- a/kpi/tests/test_kpi.py +++ b/kpi/tests/test_kpi.py @@ -1,7 +1,6 @@ -# -*- coding: utf-8 -*- # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). -from openerp.tests.common import TransactionCase +from odoo.tests.common import TransactionCase class TestKPI(TransactionCase): diff --git a/kpi/views/kpi.xml b/kpi/views/kpi.xml index 73cff3cee..9e5f5394a 100644 --- a/kpi/views/kpi.xml +++ b/kpi/views/kpi.xml @@ -2,98 +2,97 @@ - - - - kpi.tree - kpi - - + + + kpi.tree + kpi + + + + + + + + + + + + + kpi.filter + kpi + + + + + - - - - - - + + + + + + + + + + - - kpi.filter - kpi - - + + kpi.form + kpi + +
+ - - - - - - - - - - - - - - - - - kpi.form - kpi - - - - - - - - + + + + + + -