reporting-engine/report_xlsx_helper/README.rst

.. image:: https://img.shields.io/badge/license-AGPL--3-blue.png
   :target: https://www.gnu.org/licenses/agpl
   :alt: License: AGPL-3

===========================
Excel report engine helpers
===========================

This module provides a set of tools to facilitate the creation of excel reports with format xlsx.
This module offers a similar functional coverage as the 8.0 version of the ``report_xls`` module.

Usage
=====

In order to create an Excel report you can:

- define a report of type 'xlsx'
- pass ``{'xlsx_export': 1}`` via the context to the report create method

The ``AbstractReportXlsx`` class contains a number of attributes and methods to
facilitate the creation excel reports in Odoo.

* Cell types

  string, number, boolean, datetime.

* Cell formats

  The predefined cell formats result in a consistent
  look and feel of the Odoo Excel reports.

* Cell formulas

  Cell formulas can be easily added with the help of the ``_rowcol_to_cell()`` method.

* Excel templates

  It is possible to define Excel templates which can be adapted
  by 'inherited' modules.
  Download the ``account_move_line_report_xls`` module
  from http://apps.odoo.com as example.

* Excel with multiple sheets

  Download the ``account_asset_management_xls`` module
  from http://apps.odoo.com as example.

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

There is no specific installation procedure for this module.

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

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

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

Bugs are tracked on `GitHub Issues
<https://github.com/OCA/reporting-engine/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.

Credits
=======

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

* Luc De Meyer <luc.demeyer@noviat.com>

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.