account-financial-reporting/mis_builder
Stéphane Bidoul af05e07136 [UPD] prefix versions with 8.0 2015-10-09 09:59:21 +02:00
..
migrations/8.0.0.2 [FIX] mis_builder: pep8 2015-07-26 23:12:45 +02:00
models [FIX] mis_builder: correct implementation and doctests for _min/_max 2015-08-30 16:35:03 +02:00
report import guard for report_xls 2015-08-25 14:44:26 +02:00
security [ADD] mis builder: Add read access for base user 2015-07-26 23:12:43 +02:00
static [FIX] Heading levels 2015-08-26 17:17:32 +02:00
tests [IMP] mis_builder: unused imports in test 2015-07-26 23:12:45 +02:00
views [IMP] mis_builder: more compact view 2015-07-26 23:12:45 +02:00
wizard [IMP] mis_builder OpenERP->Odoo in headers + copyright year 2015-07-26 23:12:43 +02:00
README.rst [IMP] mis_builder: improve README and add some roadmap ideas 2015-09-20 12:58:00 +02:00
__init__.py [IMP] mis_builder OpenERP->Odoo in headers + copyright year 2015-07-26 23:12:43 +02:00
__openerp__.py [UPD] prefix versions with 8.0 2015-10-09 09:59:21 +02:00

README.rst

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

===========
MIS Builder
===========

This module allows you to build Management Information Systems dashboards.
Such style of reports presents KPI in rows and time periods in columns.
Reports mainly fetch data from account moves, but can also combine data coming
from arbitrary Odoo models. Reports can be exported to PDF, Excel and they
can be added to Odoo dashboards.

Installation
============

There is no specific installation procedure for this module.

Configuration and Usage
=======================

To configure this module, you need to:

* Go to Accounting > Configuration > Financial Reports > MIS Report Templates where
  you can create report templates by defining KPI's. KPI's constitute the rows of your
  reports. Such report templates are time independent.

.. figure:: static/description/ex_report_template.png
   :scale: 80 %
   :alt: Sample report template

* Then in Accounting > Reporting > MIS Reports you can create report instance by
  binding the templates to time period, hence defining the columns of your reports.

.. figure:: static/description/ex_report.png
   :alt: Sample report configuration

* From the MIS Report view, you can preview the report, add it to and Odoo dashboard,
  and export it to PDF or Excel.

.. figure:: static/description/ex_dashboard.png
   :alt: Sample dashboard view

.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
   :alt: Try me on Runbot
   :target: https://runbot.odoo-community.org/runbot/91/8.0

For further information, please visit:

* https://www.odoo.com/forum/help-1

Known issues / Roadmap
======================

* Add 'Fiscal Year' period type.

* Allow selecting accounts by type. This is currently possible by expressing
  a query such as balp[][('account_id.user_type.code', '=', ...)]. This will work
  but would be more efficient if one could write balp[user_type=...], as it would
  involve much less queries to the database.

* A mechanism to have a global move line filter at the level of the report template,
  report instance, or even column. Such a domain filter would be ANDed with the
  other filters and would allow to easily create reports filtered on analytic axis
  or business unit. To be complete such a mechanism should allow implementing similar
  filters on non accounting queries.

* More tests should be added. The first part is creating test data, then it will be
  easier. At the minimum, We need the following test data:

  * one account charts with a few normal accounts and view accounts,
  * two fiscal years,
  * an opening entry in the second fiscal year,
  * to test multi-company consolidation, we need a second company with it's own
    account chart and two fiscal years, but without opening entry; we also need
    a third company which is the parent of the other two and has a consolidation
    chart of account.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/account-financial-reporting/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
`here <https://github.com/OCA/account-financial-reporting/issues/new?body=module:%20mis_builder%0Aversion:%208.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Credits
=======

Contributors
------------

* Stéphane Bidoul <stephane.bidoul@acsone.eu>
* Laetitia Gangloff <laetitia.gangloff@acsone.eu>
* Adrien Peiffer <adrien.peiffer@acsone.eu>

Maintainer
----------

.. 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 http://odoo-community.org.