Add module report_xml.
parent
2fc92316db
commit
777713438e
|
@ -0,0 +1,82 @@
|
||||||
|
.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
|
||||||
|
:alt: License: AGPL-3
|
||||||
|
|
||||||
|
Qweb XML Reports
|
||||||
|
================
|
||||||
|
|
||||||
|
This module was written to extend the functionality of the reporting engine to
|
||||||
|
support XML reports and allow modules to generate them by code or by QWeb
|
||||||
|
templates.
|
||||||
|
|
||||||
|
Installation
|
||||||
|
============
|
||||||
|
|
||||||
|
To install this module, you need to:
|
||||||
|
|
||||||
|
* Install the repository `reporting-engine`_.
|
||||||
|
|
||||||
|
Configuration
|
||||||
|
=============
|
||||||
|
|
||||||
|
No manual configuration is needed.
|
||||||
|
|
||||||
|
Usage
|
||||||
|
=====
|
||||||
|
|
||||||
|
This module is technical, so its usage instructions are intended for module
|
||||||
|
developers.
|
||||||
|
|
||||||
|
To use this module, you need to:
|
||||||
|
|
||||||
|
* Create a module.
|
||||||
|
* Make it depend on this one.
|
||||||
|
* Follow `instructions to create reports`_ having in mind that the
|
||||||
|
``report_type`` field in your ``ir.actions.report.xml`` record must be
|
||||||
|
``qweb-xml``.
|
||||||
|
|
||||||
|
In case you want to create a `custom report`_, the instructions remain the same
|
||||||
|
as for HTML reports, and the method that you must override is also called
|
||||||
|
``render_html``, even when this time you are creating a XML report.
|
||||||
|
|
||||||
|
You can visit http://<server-address>/report/xml/<module.report_name>/<ids>
|
||||||
|
to see your XML report online as a web page.
|
||||||
|
|
||||||
|
For further information, please visit:
|
||||||
|
|
||||||
|
* https://www.odoo.com/forum/help-1
|
||||||
|
* https://github.com/OCA/reporting-engine
|
||||||
|
|
||||||
|
Known issues / Roadmap
|
||||||
|
======================
|
||||||
|
|
||||||
|
None
|
||||||
|
|
||||||
|
Credits
|
||||||
|
=======
|
||||||
|
|
||||||
|
* Icon taken from http://commons.wikimedia.org/wiki/File:Text-xml.svg.
|
||||||
|
|
||||||
|
Contributors
|
||||||
|
------------
|
||||||
|
|
||||||
|
* Jairo Llopis <j.llopis@grupoesoc.es>
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
|
||||||
|
.. _reporting-engine: https://github.com/OCA/reporting-engine
|
||||||
|
.. _instructions to create reports: https://www.odoo.com/documentation/8.0/reference/reports.html
|
||||||
|
.. _custom report: https://www.odoo.com/documentation/8.0/reference/reports.html#custom-reports
|
|
@ -0,0 +1,19 @@
|
||||||
|
# -*- encoding: utf-8 -*-
|
||||||
|
|
||||||
|
# Odoo, Open Source Management Solution
|
||||||
|
# Copyright (C) 2014-2015 Grupo ESOC <www.grupoesoc.es>
|
||||||
|
#
|
||||||
|
# This program is free software: you can redistribute it and/or modify
|
||||||
|
# it under the terms of the GNU Affero General Public License as published by
|
||||||
|
# the Free Software Foundation, either version 3 of the License, or
|
||||||
|
# (at your option) any later version.
|
||||||
|
#
|
||||||
|
# This program is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
# GNU Affero General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU Affero General Public License
|
||||||
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
|
from . import controllers, models
|
|
@ -0,0 +1,32 @@
|
||||||
|
# -*- encoding: utf-8 -*-
|
||||||
|
|
||||||
|
# Odoo, Open Source Management Solution
|
||||||
|
# Copyright (C) 2014-2015 Grupo ESOC <www.grupoesoc.es>
|
||||||
|
#
|
||||||
|
# This program is free software: you can redistribute it and/or modify
|
||||||
|
# it under the terms of the GNU Affero General Public License as published by
|
||||||
|
# the Free Software Foundation, either version 3 of the License, or
|
||||||
|
# (at your option) any later version.
|
||||||
|
#
|
||||||
|
# This program is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
# GNU Affero General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU Affero General Public License
|
||||||
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
|
{
|
||||||
|
"name": "Qweb XML Reports",
|
||||||
|
"version": "1.0",
|
||||||
|
"category": "Reporting",
|
||||||
|
"author": "Odoo Community Association (OCA), Grupo ESOC",
|
||||||
|
"license": "AGPL-3",
|
||||||
|
"website": "https://odoo-community.org/",
|
||||||
|
"installable": True,
|
||||||
|
"application": False,
|
||||||
|
"summary": "Allow to generate XML reports",
|
||||||
|
"depends": [
|
||||||
|
"report",
|
||||||
|
],
|
||||||
|
}
|
|
@ -0,0 +1,40 @@
|
||||||
|
# -*- encoding: utf-8 -*-
|
||||||
|
|
||||||
|
# Odoo, Open Source Management Solution
|
||||||
|
# Copyright (C) 2014-2015 Grupo ESOC <www.grupoesoc.es>
|
||||||
|
#
|
||||||
|
# This program is free software: you can redistribute it and/or modify
|
||||||
|
# it under the terms of the GNU Affero General Public License as published by
|
||||||
|
# the Free Software Foundation, either version 3 of the License, or
|
||||||
|
# (at your option) any later version.
|
||||||
|
#
|
||||||
|
# This program is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
# GNU Affero General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU Affero General Public License
|
||||||
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
|
from openerp.http import route
|
||||||
|
from openerp.addons.report.controllers import main as report
|
||||||
|
|
||||||
|
|
||||||
|
class ReportController(report.ReportController):
|
||||||
|
@route()
|
||||||
|
def report_routes(self, reportname, docids=None, converter=None, **data):
|
||||||
|
# Trick the main reporter to think we want an HTML report
|
||||||
|
new_converter = converter if converter != "xml" else "html"
|
||||||
|
response = super(ReportController, self).report_routes(
|
||||||
|
reportname, docids, new_converter, **data)
|
||||||
|
|
||||||
|
# If it was an XML report, just download the generated response
|
||||||
|
if converter == "xml":
|
||||||
|
# XML header must be before any spaces, and it is a common error,
|
||||||
|
# so let's fix that here and make developers happier
|
||||||
|
response.data = response.data.strip()
|
||||||
|
|
||||||
|
# XML files should be downloaded
|
||||||
|
response.headers.set("Content-Type", "text/xml")
|
||||||
|
|
||||||
|
return response
|
|
@ -0,0 +1,70 @@
|
||||||
|
# -*- encoding: utf-8 -*-
|
||||||
|
|
||||||
|
# Odoo, Open Source Management Solution
|
||||||
|
# Copyright (C) 2014-2015 Grupo ESOC <www.grupoesoc.es>
|
||||||
|
#
|
||||||
|
# This program is free software: you can redistribute it and/or modify
|
||||||
|
# it under the terms of the GNU Affero General Public License as published by
|
||||||
|
# the Free Software Foundation, either version 3 of the License, or
|
||||||
|
# (at your option) any later version.
|
||||||
|
#
|
||||||
|
# This program is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
# GNU Affero General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU Affero General Public License
|
||||||
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
|
from openerp import api, fields, models
|
||||||
|
|
||||||
|
|
||||||
|
class ReportAction(models.Model):
|
||||||
|
_inherit = "ir.actions.report.xml"
|
||||||
|
|
||||||
|
report_type = fields.Selection(selection_add=[("qweb-xml", "XML")])
|
||||||
|
|
||||||
|
def _lookup_report(self, cr, name):
|
||||||
|
"""Enable ``qweb-xml`` report lookup."""
|
||||||
|
try:
|
||||||
|
super(ReportAction, self)._lookup_report(cr, name)
|
||||||
|
except Exception as ex:
|
||||||
|
# Somebody thought it was a good idea to use standard exceptions
|
||||||
|
if "qweb-xml" not in ex.message:
|
||||||
|
raise ex
|
||||||
|
else:
|
||||||
|
cr.execute(
|
||||||
|
"SELECT * FROM ir_act_report_xml WHERE report_name=%s",
|
||||||
|
(name,))
|
||||||
|
return cr.dictfetchone()["report_name"]
|
||||||
|
|
||||||
|
@api.model
|
||||||
|
def render_report(self, res_ids, name, data):
|
||||||
|
"""Special handling for ``qweb-xml`` reports."""
|
||||||
|
if data.get("report_type") == u"qweb-xml":
|
||||||
|
new_report = self._lookup_report(name)
|
||||||
|
recs = self.env[self.env.context["active_model"]].browse(res_ids)
|
||||||
|
result = self.env["report"].get_html(recs, new_report, data=data)
|
||||||
|
|
||||||
|
# XML with spaces before the <?xml tag will fail, and trailing ones
|
||||||
|
# do nothing, so let's strip them and make everyone happier
|
||||||
|
result = (result.strip(), "xml")
|
||||||
|
else:
|
||||||
|
result = super(ReportAction, self).render_report(
|
||||||
|
res_ids, name, data)
|
||||||
|
|
||||||
|
return result
|
||||||
|
|
||||||
|
|
||||||
|
class ReportGenerator(models.Model):
|
||||||
|
_inherit = "report"
|
||||||
|
|
||||||
|
@api.model
|
||||||
|
def _get_report_from_name(self, report_name):
|
||||||
|
"""Allow to view ``qweb-xml`` reports as web pages."""
|
||||||
|
try:
|
||||||
|
super(ReportGenerator, self)._get_report_from_name(report_name)
|
||||||
|
except IndexError:
|
||||||
|
return self.env["ir.actions.report.xml"].search(
|
||||||
|
[("report_type", "=", "qweb-xml"),
|
||||||
|
("report_name", "=", report_name)])[0]
|
Binary file not shown.
After Width: | Height: | Size: 4.2 KiB |
File diff suppressed because it is too large
Load Diff
After Width: | Height: | Size: 94 KiB |
Loading…
Reference in New Issue