Skip to content

Commit

Permalink
[MIG] report_qweb_designer: Migration to 12.0
Browse files Browse the repository at this point in the history
  • Loading branch information
chienandalu authored and benwillig committed Apr 17, 2024
1 parent 584cc3e commit 20994f5
Show file tree
Hide file tree
Showing 19 changed files with 181 additions and 85 deletions.
89 changes: 60 additions & 29 deletions report_qweb_signer/README.rst
Original file line number Diff line number Diff line change
@@ -1,22 +1,44 @@
.. 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

=======================
Qweb PDF reports signer
=======================

.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! 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-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Freporting--engine-lightgray.png?logo=github
:target: https://github.com/OCA/reporting-engine/tree/12.0/report_qweb_signer
:alt: OCA/reporting-engine
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/reporting-engine-12-0/reporting-engine-12-0-report_qweb_signer
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
:target: https://runbot.odoo-community.org/runbot/143/12.0
:alt: Try me on Runbot

|badge1| |badge2| |badge3| |badge4| |badge5|

This module extends the functionality of report module to sign
PDFs using a PKCS#12 certificate.

**Table of contents**

.. contents::
:local:

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

To install this module, you need to install Java JDK::

apt-get install openjdk-7-jre-headless
To install this module, you need to install Java JDK Headlees, e.g.:

apt-get install openjdk-8-jre-headless

Configuration
=============
Expand All @@ -42,7 +64,7 @@ For example, if you want to sign only customer invoices in open or paid state:
read access to certificate file and password file

Java Memory Settings
--------------------
~~~~~~~~~~~~~~~~~~~~

If you are signing large amounts of reports at the same time, or if you have a
lower worker memory size than the JVM defaults, you may need to tune the JVM
Expand All @@ -66,10 +88,6 @@ when signing date is important, for example, when signing customer invoices.
You can try the signing with the demo report that is included for customers
called "Test PDF certificate".

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

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

Expand All @@ -79,50 +97,63 @@ Known issues / Roadmap
* To have a visible signature through an image embedded in the resulting PDF.
* Add tests.


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 `here <https://github.com/OCA/reporting-engine/issues/new>`_.
If you spotted it first, help us smashing it by providing a detailed and welcomed
`feedback <https://github.com/OCA/reporting-engine/issues/new?body=module:%20report_qweb_signer%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* Tecnativa

Contributors
~~~~~~~~~~~~

* `Tecnativa <https://www.tecnativa.com>`_:

* Rafael Blasco
* Antonio Espinosa
* Pedro M. Baeza
* Jairo Llopis
* David Vidal

Other credits
~~~~~~~~~~~~~

External utilities
------------------
++++++++++++++++++

* iText v1.4.8: © 2000-2006, Paulo Soares, Bruno Lowagie and others - License `MPL <http://www.mozilla.org/MPL>`__ or `LGPL2 <http://www.gnu.org/licenses/old-licenses/lgpl-2.0.html>`__ - http://sourceforge.net/projects/itext
* jPdfSign: © 2006 Jan Peter Stotz - License `MPL <http://www.mozilla.org/MPL>`__ or `LGPL2 <http://www.gnu.org/licenses/old-licenses/lgpl-2.0.html>`__ (inherited from iText) - http://private.sit.fraunhofer.de/~stotz/software/jpdfsign
* Modified jPdfSign: © 2015 Antonio Espinosa - License `MPL <http://www.mozilla.org/MPL>`__ or `LGPL2 <http://www.gnu.org/licenses/old-licenses/lgpl-2.0.html>`__ (inherited from iText) - static/src/java/JPdfSign.java

Icon
----
++++

`Created by Anton Noskov from the Noun Project <https://thenounproject.com/search/?q=signed+contract&i=65694>`__

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

* Rafael Blasco <[email protected]>
* Antonio Espinosa <[email protected]>
* Pedro M. Baeza <[email protected]>
* Jairo Llopis <[email protected]>
Maintainers
~~~~~~~~~~~

Maintainer
----------
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/reporting-engine <https://github.com/OCA/reporting-engine/tree/12.0/report_qweb_signer>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 change: 0 additions & 1 deletion report_qweb_signer/__init__.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
# -*- coding: utf-8 -*-
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).

from . import models
9 changes: 5 additions & 4 deletions report_qweb_signer/__manifest__.py
Original file line number Diff line number Diff line change
@@ -1,25 +1,26 @@
# -*- coding: utf-8 -*-
# Copyright 2015 Tecnativa - Antonio Espinosa
# Copyright 2017 Tecnativa - Pedro M. Baeza
# Copyright 2018 Tecnativa - David Vidal
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).

{
"name": "Qweb PDF reports signer",
"summary": "Sign Qweb PDFs usign a PKCS#12 certificate",
"version": "10.0.1.0.1",
"version": "12.0.1.0.0",
"category": "Reporting",
"website": "https://www.tecnativa.com",
"website": "https://www.github.com/reporting-engine",
"author": "Tecnativa, "
"Odoo Community Association (OCA)",
"license": "AGPL-3",
"installable": True,
"depends": [
"report",
"web",
],
"external_dependencies": {
"bin": ['/usr/bin/java'],
},
"data": [
"data/defaults.xml",
"security/ir.model.access.csv",
"views/report_certificate_view.xml",
"views/res_company_view.xml",
Expand Down
7 changes: 7 additions & 0 deletions report_qweb_signer/data/defaults.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<odoo>
<record model="ir.config_parameter" id="report_qweb_signer_java_param">
<field name="key">report_qweb_signer.java_parameters</field>
<field name="value">-Xms4M -Xmx4M</field>
</record>
</odoo>
4 changes: 2 additions & 2 deletions report_qweb_signer/demo/report_partner_demo.xml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
<odoo>

<template id="report_partner_demo_document">
<t t-call="report.external_layout">
<t t-call="web.external_layout">
<div class="page">
<div class="row">
<div class="col-md-12">
Expand All @@ -24,7 +24,7 @@ License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
</template>

<template id="report_partner_demo">
<t t-call="report.html_container">
<t t-call="web.html_container">
<t t-foreach="docs" t-as="o">
<t t-call="report_qweb_signer.report_partner_demo_document" t-lang="o.lang"/>
</t>
Expand Down
4 changes: 1 addition & 3 deletions report_qweb_signer/models/__init__.py
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# -*- coding: utf-8 -*-
# © 2015 Antiun Ingenieria S.L. - Antonio Espinosa
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).

from . import report
from . import ir_actions_report
from . import report_certificate
from . import res_company
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
# -*- coding: utf-8 -*-
# Copyright 2015 Tecnativa - Antonio Espinosa
# Copyright 2017 Tecnativa - Pedro M. Baeza
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
Expand Down Expand Up @@ -28,16 +27,16 @@ def _normalize_filepath(path):
return path if os.path.exists(path) else False


class Report(models.Model):
_inherit = 'report'
class IrActionsReport(models.Model):
_inherit = 'ir.actions.report'

def _certificate_get(self, report, docids):
def _certificate_get(self, res_ids):
"""Obtain the proper certificate for the report and the conditions."""
if report.report_type != 'qweb-pdf':
if self.report_type != 'qweb-pdf':
return False
certificates = self.env['report.certificate'].search([
('company_id', '=', self.env.user.company_id.id),
('model_id', '=', report.model),
('model_id', '=', self.model),
])
if not certificates:
return False
Expand All @@ -47,11 +46,11 @@ def _certificate_get(self, report, docids):
_logger.debug(
"Certificate '%s' allows only one document, "
"but printing %d documents",
cert.name, len(docids))
cert.name, len(res_ids))
continue
# Check domain
if cert.domain:
domain = [('id', 'in', tuple(docids))]
domain = [('id', 'in', tuple(res_ids))]
domain = domain + safe_eval(cert.domain)
docs = self.env[cert.model_id.model].search(domain)
if not docs:
Expand All @@ -62,34 +61,34 @@ def _certificate_get(self, report, docids):
return cert
return False

def _attach_filename_get(self, docids, certificate):
if len(docids) != 1:
def _attach_filename_get(self, res_ids, certificate):
if len(res_ids) != 1:
return False
doc = self.env[certificate.model_id.model].browse(docids[0])
doc = self.env[certificate.model_id.model].browse(res_ids[0])
return safe_eval(certificate.attachment, {
'object': doc,
'time': time
})

def _attach_signed_read(self, docids, certificate):
if len(docids) != 1:
def _attach_signed_read(self, res_ids, certificate):
if len(res_ids) != 1:
return False
filename = self._attach_filename_get(docids, certificate)
filename = self._attach_filename_get(res_ids, certificate)
if not filename:
return False
attachment = self.env['ir.attachment'].search([
('datas_fname', '=', filename),
('res_model', '=', certificate.model_id.model),
('res_id', '=', docids[0]),
('res_id', '=', res_ids[0]),
], limit=1)
if attachment:
return base64.decodestring(attachment.datas)
return False

def _attach_signed_write(self, docids, certificate, signed):
if len(docids) != 1:
def _attach_signed_write(self, res_ids, certificate, signed):
if len(res_ids) != 1:
return False
filename = self._attach_filename_get(docids, certificate)
filename = self._attach_filename_get(res_ids, certificate)
if not filename:
return False
try:
Expand All @@ -98,7 +97,7 @@ def _attach_signed_write(self, docids, certificate, signed):
'datas': base64.encodestring(signed),
'datas_fname': filename,
'res_model': certificate.model_id.model,
'res_id': docids[0],
'res_id': res_ids[0],
})
except AccessError:
raise UserError(
Expand All @@ -108,9 +107,11 @@ def _attach_signed_write(self, docids, certificate, signed):

def _signer_bin(self, opts):
me = os.path.dirname(__file__)
irc_param = self.env['ir.config_parameter'].sudo()
java_bin = 'java -jar'
java_param = irc_param.get_param('report_qweb_signer.java_parameters')
jar = '{}/../static/jar/jPdfSign.jar'.format(me)
return '%s %s %s' % (java_bin, jar, opts)
return '%s %s %s %s' % (java_bin, java_param, jar, opts)

def pdf_sign(self, pdf, certificate):
pdfsigned = pdf + '.signed.pdf'
Expand All @@ -132,30 +133,28 @@ def pdf_sign(self, pdf, certificate):
(process.returncode, err, out))
return pdfsigned

@api.model
def get_pdf(self, docids, report_name, html=None, data=None):
report = self._get_report_from_name(report_name)
certificate = self._certificate_get(report, docids)
@api.multi
def render_qweb_pdf(self, res_ids=None, data=None):
certificate = self._certificate_get(res_ids)
if certificate and certificate.attachment:
signed_content = self._attach_signed_read(docids, certificate)
signed_content = self._attach_signed_read(res_ids, certificate)
if signed_content:
_logger.debug(
"The signed PDF document '%s/%s' was loaded from the "
"database", report_name, docids,
"database", self.report_name, res_ids,
)
return signed_content
content = super(Report, self).get_pdf(
docids, report_name, html=html, data=data,
)
content, ext = super(IrActionsReport, self).render_qweb_pdf(res_ids,
data)
if certificate:
# Creating temporary origin PDF
pdf_fd, pdf = tempfile.mkstemp(
suffix='.pdf', prefix='report.tmp.')
with closing(os.fdopen(pdf_fd, 'w')) as pf:
with closing(os.fdopen(pdf_fd, 'wb')) as pf:
pf.write(content)
_logger.debug(
"Signing PDF document '%s' for IDs %s with certificate '%s'",
report_name, docids, certificate.name,
self.report_name, res_ids, certificate.name,
)
signed = self.pdf_sign(pdf, certificate)
# Read signed PDF
Expand All @@ -169,5 +168,5 @@ def get_pdf(self, docids, report_name, html=None, data=None):
except (OSError, IOError):
_logger.error('Error when trying to remove file %s', fname)
if certificate.attachment:
self._attach_signed_write(docids, certificate, content)
return content
self._attach_signed_write(res_ids, certificate, content)
return content, ext
4 changes: 2 additions & 2 deletions report_qweb_signer/models/report_certificate.py
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# -*- coding: utf-8 -*-
# © 2015 Antiun Ingenieria S.L. - Antonio Espinosa
# Copyright 2015 Tecnativa - Antonio Espinosa
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).

from odoo import api, fields, models


class ReportCertificate(models.Model):
_name = 'report.certificate'
_description = 'Report Certificate'
_order = 'sequence,id'

@api.model
Expand Down
Loading

0 comments on commit 20994f5

Please sign in to comment.