| Author: |
XCG Consulting,Odoo Community Association (OCA) |
| License: |
AGPL-3 |
| Branch: |
10.0-py3o_template_multilang-lmi |
| Repository: |
acsone/reporting-engine |
| Dependencies: |
base,
and
report |
| Languages: |
PO File (71, 10.3%),
Python (475, 68.9%),
and
XML (143, 20.8%) |
| Other branches: |
10-cmis_report_write_compat-lmi,
10.0,
10.0-alf_master,
10.0-backport-report_csv-lmi,
10.0-brb_master,
10.0-crd_master,
10.0-oba_master,
10.0-py3o_template_selection_modularity-lmi,
10.0-refactor_py3o-jne,
10.0-refactor_py3o_bis-jne,
10.0-report_py3o_print_report_name-lmi,
12.0,
12.0-prg_master,
12.0-ref_report_py3o_python_3.9-mle,
12.0-report_substitute_generate_email-qgr,
13.0,
13.0-imp_report_qweb_signer_allowed_reports_tbi,
13.0-mig-report_py3o_multilang,
13.0-mig_report_substitute,
13.0-ref_report_py3o_python_3.11_tbi,
13.0-report_qweb_element_page_visibility,
13.0-slg_master,
14.0,
14.0-imp_report_qweb_signer_allowed_reports_tbi,
14.0-mig-report_py3o,
14.0-update-dotfiles-sbi,
9.0-import_report_py3o,
9.0-refactor_py3o-lmi,
9.0-refactor_py3o_bis-lmi,
9.0-refactor_py3o_controller-lmi,
9.0-report_py3o,
9.0-report_py3o_custom_filename-lmi,
9.0-report_py3o_xls_tbi,
9.0-slg_master,
add-report_py3o_signer-lco,
and
imp-temp-remove-java-in-manifest-lco |
| Other repositories: |
001101/reporting-engine,
AITIC/reporting-engine,
Aabcrow/reporting-engine,
AcruxLab/reporting-engine,
AdriaGForgeFlow/reporting-engine,
Ahmad-Hamouda/reporting-engine,
Albin-John/reporting-engine,
Alfa-90/reporting-engine,
App247/reporting-engine,
AsierSV/reporting-engine,
Axon-System/reporting-engine,
Bubbles-IT/reporting-engine,
CB-Gran-Canaria/reporting-engine,
CGenie/reporting-engine,
CMR-tetra/reporting-engine,
Cayprol/reporting-engine,
Change2improve/reporting-engine,
ClancyQiao/reporting-engine,
ClearCorp/oca-reporting-engine,
ComitorDevTeam/reporting-engine,
Comunitea/reporting-engine,
DamonLiu0814/reporting-engine,
Darknroses/reporting-engine,
Digital5-Odoo/reporting-engine,
Dobtor-OCA/reporting-engine,
Domatix/reporting-engine,
DudhatShivam/reporting-engine,
EBII/reporting-engine,
ERPLibre/reporting-engine,
EssentNovaTeam/reporting-engine,
Fitranugraha/reporting-engine,
ForgeFlow/reporting-engine,
Gabinete-Digital/reporting-engine,
Glue-Software-Engineering-AG/reporting-engine,
Gofekra/reporting-engine,
GrupoAlvamex/reporting-engine,
Guobower/reporting-engine,
Hamza-Talibi/reporting-engine,
HarshalBhoir/reporting-engine,
HomerDeoDatu/reporting-engine,
IJOL/reporting-engine-1,
Infinityloopsistemas/reporting-engine,
Ingeos/reporting-engine,
Jarsa/reporting-engine,
JasonJun1/reporting-engine,
Jeisonpernia/reporting-engine,
JoJoJoJoJoJoJo/reporting-engine,
Kayuulab/reporting-engine,
KonosCL/reporting-engine,
LeGittan/reporting-engine,
Leuan12/reporting-engine,
Maartincm/reporting-engine,
MadsackMediaStore/reporting-engine,
MathBenTech/reporting-engine,
Mefistous/reporting-engine,
NachoAlesLopez/reporting-engine,
NeatNerdPrime/reporting-engine,
NextERP-Romania/reporting-engine,
Noviat/reporting-engine,
Nubeo-be/reporting-engine,
OCA-MUK/reporting-engine,
OCA/reporting-engine,
ORETEK/reporting-engine,
OpenCode/reporting-engine,
OutillageStEtienne/reporting-engine,
Palpid/reporting-engine,
PrenorSistemas/reporting-engine,
QD-odoo/reporting-engine,
QubiQ/reporting-engine,
Rad0van/reporting-engine,
RealSolutionsLux/reporting-engine,
SHEFFIELDAFRICA/reporting-engine,
SanteLibre/reporting-engine,
Saran440/reporting-engine,
SequarSrl/reporting-engine,
SerpentConsultingServices/reporting-engine,
SeuMarco/reporting-engine,
ShakirMemon786/reporting-engine,
SimoRubi/reporting-engine,
SolutionSeekers/reporting-engine,
SportPursuit/reporting-engine,
StefanRijnhart/reporting-engine,
Studio73/reporting-engine,
Syci-Consulting/reporting-engine,
TRESCLOUD/reporting-engine,
Tatider/reporting-engine,
Tecnativa/reporting-engine,
TemosEngenharia/reporting-engine,
Tonow-c2c/reporting-engine,
VanMoof/reporting-engine,
Vauxoo/reporting-engine,
VisiionSolucionesTecnologicas/reporting-engine,
VitalPet/reporting-engine,
WilldooIT/reporting-engine,
Zhouhao12345/reporting-engine,
Zio-Overload/reporting-engine,
aaltinisik/reporting-engine,
abgfbr/report_py3o,
abs44/reporting-engine,
acsone/report_py3o,
adhoc-dev/oca-reporting-engine,
ajaychauhan727/reporting-engine,
ajinvn2019/reporting-engine,
akretion/report_py3o,
akretion/reporting-engine,
akshayksolves/reporting-engine,
alesisjoan/reporting-engine,
alessavindell/reporting-engine,
alexlafalce/reporting-engine,
algiopensource/reporting-engine,
allanaguilar/reporting-engine,
amendoncabh/reporting-engine,
andhit-r/reporting-engine,
anhvu-sg/reporting-engine,
anos4444/reporting-engine,
apachesep/reporting-engine,
apertoso/reporting-engine,
apetbiz/reporting-engine,
aravinthu/reporting-engine,
aremili/reporting-engine,
arfie/reporting-engine,
aroodooteam/reporting-engine,
atonaltzin/reporting-engine,
augustynr/reporting-engine,
aurestic/reporting-engine,
avoinsystems/reporting-engine,
bacgdev/reporting-engine,
bacgroup/reporting-engine,
bealdav/reporting-engine,
beenhere4hours/reporting-engine,
bishalgit/reporting-engine,
blooparksystems/reporting-engine,
bmya/reporting-engine-1,
brain-tec/reporting-engine,
budisentosa/reporting-engine,
camptocamp/reporting-engine,
cataclysmic/reporting-engine,
chenjingxiong/reporting-engine,
christophe-hanon/reporting-engine,
ciel-it/reporting-engine,
cogitoweb/reporting-engine,
coopiteasy/reporting-engine,
damendieta/reporting-engine,
dani-xtendoo/reporting-engine,
daramousk/reporting-engine,
darshan-odoo/reporting-engine,
dcorio/reporting-engine,
ddico/reporting-engine,
detian08/reporting-engine,
dev00007/reporting-engine,
diegobgl/reporting-engine,
dominiquekonsuntack/reporting-engine,
dong-z/reporting-engine,
dorsaf/reporting-engine,
druidoo-dev/reporting-engine,
dupski/reporting-engine,
ecosoft-odoo/reporting-engine,
eezee-it/reporting-engine,
elperrofarelo/reporting-engine,
enocare/reporting-engine,
etobella/reporting-engine,
exosoftware/oca-reporting-engine,
ezodoo/reporting-engine,
fabiomix/reporting-engine,
faide/reporting-engine,
fateenvoy/reporting-engine,
fauzi-tsani/reporting-engine,
feriosvega/reporting-engine,
flachica/reporting-engine,
fmdl/reporting-engine,
frankchongli/odoo-alt-reporting-engine,
fugui0310/reporting-engine,
gaanto/reporting-engine,
gastonfeng/reporting-engine,
gbertolani/reporting-engine,
gdgellatly/reporting-engine,
germanponce/reporting-engine,
gonza3001/reporting_engine,
govorushagreat/reporting-engine,
goyugo/reporting-engine,
grap/reporting-engine,
guewen/reporting-engine,
gurneyalex/reporting-engine,
hanelsofterp/reporting-engine,
haroldtamo/reporting-engine,
hbrunn/reporting-engine,
hendrixcosta/report_py3o,
henrycoding/reporting-engine,
hippe-67/reporting-engine,
hisyam44/reporting-engine,
hmrodrigues/reporting-engine,
holgedchen/reporting-engine,
iamyeonhan/reporting-engine,
ifadhf/reporting-engine,
ilyasProgrammer/reporting-engine,
initOS/reporting-engine,
it-projects-llc/reporting-engine,
izzihector/reporting-engine,
j209/reporting-engine,
jacky82669513/reporting-engine,
jaferrer/reporting-engine,
jarroyomorales/reporting-engine,
jason156/reporting-engine,
jesusVMayor/reporting-engine,
jffernandez/reporting-engine,
jlzhou/reporting-engine,
jnaudon/reporting-engine,
johnbendi/reporting-engine,
julenalgios/reporting-engine,
kararaMohamed/reporting-engine,
kenzey0man/reporting-engine,
kevin070982/reporting-engine,
khaeusler/reporting-engine,
kittiu/reporting-engine,
kmee/reporting-engine,
kongrattapong/reporting-engine,
kos94ok-3D/reporting-engine,
lbvisperas/reporting-engine,
leemannd/reporting-engine,
legalsylvain/reporting-engine,
leonidasthe300/reporting-engine,
libregob/reporting-engine,
lideritjnma/reporting-engine,
limingsichuan/reporting-engine,
lintoct/reporting-engine,
luc-demeyer/reporting-engine,
lweiming/reporting-engine,
maherjaballi/reporting-engine,
matrixise/reporting-engine,
max1314/reporting-engine,
michaelgg84/reporting-engine,
minhhq09/reporting-engine,
minorisa/reporting-engine,
mivilsoft/reporting-engine,
mjavint/reporting-engine,
modoolar/reporting-engine,
mohamed-helmy/reporting-engine,
mohamedhagag/reporting-engine-1,
multidadosti-erp/reporting-engine,
mwithi/reporting-engine,
myceliandre/reporting-engine,
myonnet/oca-reporting-engine,
nabima/reporting-engine,
nicolasjelincic/reporting-engine,
ninetynineplus/reporting-engine,
niulinlnc/reporting-engine,
njeudy/reporting-engine,
novawish/reporting-engine,
nucleoosystem/reporting-engine,
odof/reporting-engine,
odoogap/reporting-engine,
odoonz/reporting-engine,
one2pret/reporting-engine,
onesteinbv/reporting-engine,
onurugur/reporting-engine,
oondeo/reporting-engine,
osanchezm/reporting-engine,
ovnicraft/reporting-engine,
p-tombez/reporting-engine,
pasgou/reporting-engine,
paulvermeulen/reporting-engine,
piensom/reporting-engine,
pnajman-modoolar/reporting-engine,
popcomputadores-desenv/reporting-engine,
praxigento/oca-reporting-engine,
ps-tubtim/reporting-engine,
pscloud/reporting-engine,
puchisco/reporting-engine,
pythoner-3k/reporting-engine,
rachmataditiya/reporting-engine,
reservationpartnerlt/reporting-engine,
richard-willdooit/reporting-engine,
robertsvx27/reporting-engine,
robin5210/reporting-engine,
royalline1/reporting-engine-1,
rrgaona/reporting-engine,
rsullivan2704/reporting-engine,
ruben-tonetto/reporting-engine,
rwsdigital/reporting-engine,
sacodoo/reporting-engine,
sacostaylara/reporting-engine,
saif-serpentcs/reporting-engine,
samnimri/reporting-engine,
sandreanybox/reporting-engine,
sansirit/reporting-engine,
sanube/reporting-engine,
schout-it/reporting-engine,
sekhsokh/reporting-engine,
sendalpegat/reporting-engine,
sergiocorato/reporting-engine,
serpentcs-dev1/reporting-engine,
sewisoft/reporting-engine,
sgheller/reporting-engine,
shiftctrl-io/reporting-engine,
shouyejing/report_py3o,
simahawk/reporting-engine,
soeethiha/reporting-engine,
solvosci/reporting-engine,
somiderventa/reporting-engine,
songpon/reporting-engine,
steingabelgaard/reporting-engine,
sunflowerit/reporting-engine,
superkaja/reporting-engine,
suwatuanp/reporting-engine,
syci/reporting-engine,
takinobori/oca-reporting-engine,
tbaden/reporting-engine,
tegin/reporting-engine,
thandokazi/reporting-engine,
thomaspot/reporting-engine,
tirma-sa/reporting-engine,
trobz/reporting-engine,
tsengel2/reporting-engine,
tuanna7593/reporting-engine,
unitek-solusi/OCA-reporting-engine,
ursais/reporting-engine,
valmarnet/reporting-engine,
vdedyukhin/reporting-engine,
versada/reporting-engine,
vertelab/odoo-l10n_se,
vikichavada/reporting-engine,
wahello/reporting-engine,
wuhuizhong/reporting-engine,
xcgd/report_py3o,
xcgd/reporting-engine,
xhair/reporting-engine,
xwh123807/reporting-engine,
yelizariev/reporting-engine,
ygdmxy/reporting-engine,
zarumaru/reporting-engine,
zeroincombenze/reporting-engine,
zhaohuaw/reporting-engine,
and
zohaibrehman/reporting-engine |
<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg">
</a>
<a name="report-py3o"></a>
<h2>Report Py3o</h2>
<p>The py3o reporting engine is a reporting engine for Odoo based on <a class="reference external" href="http://www.libreoffice.org/">Libreoffice</a>:</p>
<ul class="simple">
<li>the report is created with Libreoffice (ODT or ODS),</li>
<li>the report is stored on the server in OpenDocument format (.odt or .ods file)</li>
<li>the report is sent to the user in OpenDocument format or in any output format supported by Libreoffice (PDF, HTML, DOC, DOCX, Docbook, XLS, etc.)</li>
</ul>
<p>The key advantages of a Libreoffice-based reporting engine are:</p>
<ul class="simple">
<li>no need to be a developper to create or modify a report: the report is created and modified with Libreoffice. So this reporting engine has a fully WYSIWYG report developpment tool!</li>
<li>For a PDF report in A4/Letter format, it's easier to develop it with a tool such as Libreoffice that is designed to create A4/Letter documents than to develop it in HTML/CSS.</li>
<li>If you want your users to be able to modify the document after its generation by Odoo, just configure the document with ODT output (or DOC or DOCX) and the user will be able to modify the document with Libreoffice (or Word) after its generation by Odoo.</li>
<li>Easy development of spreadsheet reports in ODS format (XLS output possible).</li>
</ul>
<p>This reporting engine is an alternative to <a class="reference external" href="https://github.com/aeroo/aeroo_reports">Aeroo</a>: these 2 reporting engines have similar features but their codes are completely different.</p>
<a name="installation"></a>
<h3>Installation</h3>
<p>You must install 2 additionnal python libs:</p>
<pre class="code">
<code class="code">pip install py3o.template
pip install py3o.formats</code>
</pre>
<p>To allow the conversion of ODT or ODS reports to other formats (PDF, DOC, DOCX, etc.), you must install several additionnal components and Python libs:</p>
<ul class="simple">
<li><a class="reference external" href="https://bitbucket.org/faide/py3o.fusion">Py3o Fusion server</a>,</li>
<li><a class="reference external" href="https://bitbucket.org/faide/py3o.renderserver">Py3o render server</a>,</li>
<li>a Java Runtime Environment (JRE), which can be OpenJDK,</li>
<li>Libreoffice started in the background in headless mode,</li>
<li>the Java driver for Libreoffice (Juno).</li>
</ul>
<p>It is also possible to use the Python driver for Libreoffice (PyUNO), but it is recommended to use the Java driver because it is more stable.</p>
<p>The installation procedure below uses the Java driver. It has been successfully tested on Ubuntu 16.04 LTS ; if you use another OS, you may have to change a few details.</p>
<p>Installation of py3o.fusion:</p>
<pre class="code">
<code class="code">pip install py3o.fusion
pip install service-identity</code>
</pre>
<p>Installation of py3o.renderserver:</p>
<pre class="code">
<code class="code">pip install py3o.renderserver</code>
</pre>
<p>Installation of Libreoffice and JRE on Debian/Ubuntu:</p>
<pre class="code">
<code class="code">sudo apt-get install default-jre ure libreoffice-java-common libreoffice-writer</code>
</pre>
<p>At the end, with the dependencies, you should have the following py3o python libs:</p>
<pre class="code">
<code class="code">% pip freeze | grep py3o
py3o.formats==0.3
py3o.fusion==0.8.6.dev1
py3o.renderclient==0.2
py3o.renderers.juno==0.7
py3o.renderserver==0.5.1.dev1
py3o.template==0.9.10.dev1
py3o.types==0.1.1</code>
</pre>
<p>Start the Py3o Fusion server:</p>
<pre class="code">
<code class="code">start-py3o-fusion --debug -s localhost</code>
</pre>
<p>Start the Py3o render server:</p>
<pre class="code">
<code class="code">start-py3o-renderserver --java=/usr/lib/jvm/default-java/jre/lib/amd64/server/libjvm.so --ure=/usr/lib --office=/usr/lib/libreoffice --driver=juno --sofficeport=8997</code>
</pre>
<p>On the output of the Py3o render server, the first line looks like:</p>
<pre class="code">
<code class="code">DEBUG:root:Starting JVM: /usr/lib/jvm/java-8-openjdk-amd64/jre/lib/amd64/server/libjvm.so with options: -Djava.class.path=/usr/local/lib/python2.7/dist-packages/py3o/renderers/juno/py3oconverter.jar:/usr/lib/ure/share/java/juh.jar:/usr/lib/ure/share/java/jurt.jar:/usr/lib/ure/share/java/ridl.jar:/usr/lib/ure/share/java/unoloader.jar:/usr/lib/ure/share/java/java_uno.jar:/usr/lib/libreoffice/program/classes/unoil.jar -Xmx150M</code>
</pre>
<p>After <strong>-Djava.class.path</strong>, there is a list of Java libs with <em>.jar</em> extension ; check that each JAR file is really present on your filesystem. On Ubuntu 16.04 LTS, the package <em>ure</em> installs several libs in another directory:</p>
<ul class="simple">
<li>/usr/lib/ure/share/java/juh.jar is located in /usr/share/java/juh.jar</li>
<li>/usr/lib/ure/share/java/jurt.jar is located in /usr/share/java/jurt.jar</li>
<li>/usr/lib/ure/share/java/ridl.jar is located in /usr/share/java/ridl.jar</li>
<li>/usr/lib/ure/share/java/unoloader.jar is located in /usr/share/java/unoloader.jar</li>
<li>/usr/lib/ure/share/java/java_uno.jar is located in /usr/share/java/java_uno.jar</li>
</ul>
<p>To work around this problem, you can create a symlink:</p>
<pre class="code">
<code class="code">sudo ln -s /usr /ure</code>
</pre>
<p>and then use <strong>--ure=/</strong> instead of <strong>--ure=/usr/lib</strong> in the command line of <em>start-py3o-renderserver</em>.</p>
<p>To check that the Py3o Fusion server is running fine, visit the URL <a class="reference external" href="http:/">http:/</a>/<IP_address>:8765/form. On this web page, under the section <em>Target format</em>, make sure that you have a line <em>This server currently supports these formats: ods, odt, docx, doc, html, docbook, pdf, xls.</em>.</p>
<a name="configuration"></a>
<h3>Configuration</h3>
<p>For example, to replace the native invoice report by a custom py3o report, add the following XML file in your custom module:</p>
<pre class="code">
<code class="code"><?xml version="1.0" encoding="utf-8"?>
<odoo>
<record id="account.account_invoices" model="ir.actions.report.xml">
<field name="name">Invoice</field>
<field name="model">account.invoice</field>
<field name="report_name">account.report_invoice</field>
<field name="report_type">py3o</field>
<field name="py3o_filetype">odt</field>
<field name="module">my_custom_module_base</field>
<field name="py3o_template_fallback">report/account_invoice.odt</field>
</record>
</odoo></code>
</pre>
<p>where <em>my_custom_module_base</em> is the name of the custom Odoo module. In this example, the invoice ODT file is located in <em>my_custom_module_base/report/account_invoice.odt</em>.</p>
<p>If you want an invoice in PDF format instead of ODT format, the XML file should look like:</p>
<pre class="code">
<code class="code"><?xml version="1.0" encoding="utf-8"?>
<odoo>
<record id="local_py3o_server" model="py3o.server">
<field name="url">http://localhost:8765/form</field>
</record>
<record id="account.account_invoices" model="ir.actions.report.xml">
<field name="name">Invoice</field>
<field name="model">account.invoice</field>
<field name="report_name">account.report_invoice</field>
<field name="report_type">py3o</field>
<field name="py3o_filetype">pdf</field>
<field name="py3o_server_id" ref="local_py3o_server"/>
<field name="module">my_custom_module_base</field>
<field name="py3o_template_fallback">report/account_invoice.odt</field>
</record>
</odoo></code>
</pre>
<a name="usage"></a>
<h3>Usage</h3>
<a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/143/10.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a>
<a name="known-issues-roadmap"></a>
<h3>Known issues / Roadmap</h3>
<ul class="simple">
<li>generate barcode ?</li>
</ul>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/reporting-engine/issues">GitHub Issues</a>. 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.</p>
<a name="credits"></a>
<h3>Credits</h3>
<a name="contributors"></a>
<h4>Contributors</h4>
<ul class="simple">
<li>Florent Aide (<a class="reference external" href="http://odoo.consulting/">XCG Consulting</a>)</li>
<li>Laurent Mignon (Acsone)</li>
</ul>
<a name="maintainer"></a>
<h4>Maintainer</h4>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>This module is maintained by the OCA.</p>
<p>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.</p>
<p>To contribute to this module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>.</p>