{
"info": {
"author": "XCG Consulting,ACSONE SA/NV,Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"bugtrack_url": null,
"classifiers": [
"Framework :: Odoo",
"License :: OSI Approved :: GNU Affero General Public License v3",
"Programming Language :: Python"
],
"description": "==========================================\nPy3o Report Engine - Fusion server support\n==========================================\n\n.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png\n :target: https://odoo-community.org/page/development-status\n :alt: Beta\n.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Freporting--engine-lightgray.png?logo=github\n :target: https://github.com/OCA/reporting-engine/tree/12.0/report_py3o_fusion_server\n :alt: OCA/reporting-engine\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/reporting-engine-12-0/reporting-engine-12-0-report_py3o_fusion_server\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png\n :target: https://runbot.odoo-community.org/runbot/143/12.0\n :alt: Try me on Runbot\n\n|badge1| |badge2| |badge3| |badge4| |badge5| \n\nThis module was written to let a py3o fusion server handle format conversion instead of local libreoffice. If you install this module above the *report_py3o* module, you will have to deploy additionnal software components and run 3 daemons (libreoffice, py3o.fusion and py3o.renderserver). This additionnal complexiy comes with several advantages:\n\n* much better performances (Libreoffice runs permanently in the background, no need to spawn a new Libreoffice instance upon every document conversion).\n* ability to configure PDF export options in Odoo. This brings many new possibilities such as the ability to generate:\n\n * PDF forms\n * PDF/A documents (required by some electronic invoicing standards such as `Factur-X `_)\n * watermarked PDF documents\n * password-protected PDF documents\n\n**Table of contents**\n\n.. contents::\n :local:\n\nInstallation\n============\n\nInstall several additional components and Python libs:\n\n* `Py3o Fusion server `_,\n* `Py3o render server `_,\n* a Java Runtime Environment (JRE), which can be OpenJDK,\n* Libreoffice started in the background in headless mode,\n* the Java driver for Libreoffice (Juno).\n\nIt 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.\n\nThe installation procedure below uses the Java driver. It has been successfully tested on Ubuntu 18.04 LTS ; if you use another OS, you may have to change a few details.\n\nInstallation of Libreoffice, JRE and required Java libs on Debian/Ubuntu:\n\n.. code::\n\n sudo apt-get install default-jre ure libgoogle-gson-java libreoffice-java-common libreoffice-writer\n\nYou may have to install additionnal fonts. For example, to have the special unicode symbols for phone/fax/email in the PDF reports generated by Py3o, you should install the following package:\n\n.. code::\n\n sudo apt-get install fonts-symbola\n\nInstallation of py3o.fusion:\n\n.. code::\n\n pip3 install py3o.fusion\n pip3 install service-identity\n\nInstallation of py3o.renderserver:\n\n.. code::\n\n pip3 install py3o.renderserver\n\nAt the end, with the dependencies, you should have the following py3o python libs:\n\n.. code::\n\n % pip3 freeze | grep py3o\n py3o.formats==0.3\n py3o.fusion==0.8.9\n py3o.renderclient==0.3\n py3o.renderers.juno==0.8.1\n py3o.renderserver==0.5.2\n py3o.template==0.10.0\n py3o.types==0.1.1\n\nStart the Py3o Fusion server:\n\n.. code::\n\n start-py3o-fusion --debug -s localhost -i localhost\n\nStart the Py3o render server:\n\n.. code::\n\n start-py3o-renderserver --java=/usr/lib/jvm/default-java/lib/server/libjvm.so --ure=/usr/share --office=/usr/lib/libreoffice --driver=juno --sofficeport=8997 -i localhost\n\nOn the output of the Py3o render server, the first line looks like:\n\n.. code::\n\n DEBUG:root:Starting JVM: /usr/lib/jvm/default-java/lib/server/libjvm.so with options: -Djava.class.path=/usr/local/lib/python2.7/dist-packages/py3o/renderers/juno/py3oconverter.jar:/usr/share/java/juh.jar:/usr/share/java/jurt.jar:/usr/share/java/ridl.jar:/usr/share/java/unoloader.jar:/usr/share/java/java_uno.jar:/usr/lib/libreoffice/program/classes/unoil.jar -Xmx150M\n\nAfter **-Djava.class.path**, there is a list of Java libs with *.jar* extension ; check that each JAR file is really present on your filesystem. If one of the jar files is present in another directory, create a symlink that points to the real location of the file. If all the jar files are present on another directory, adapt the *--ure=* argument on the command line of Py3o render server.\n\nTo check that the Py3o Fusion server is running fine, visit the URL http://:8765/form. On this web page, under the section *Target format*, make sure that you have a line *This server currently supports these formats: ods, odt, docx, doc, html, docbook, pdf, xls.*.\n\nIf you want to produce valid PDF/A documents with this module, activating the corresponding option in the PDF Export Options may not be enough, you also have to make sure that all the fonts used in the document template are installed on the Odoo server, so that they can be embedded in the PDF/A document. For example, if your document template uses the Arial font, you should install that font on your Odoo server:\n\n.. code::\n\n sudo apt-get install msttcorefonts\n\nConfiguration\n=============\n\nTo configure the PDF export options:\n\n1. Go to the menu *Settings > Technical > Reporting > Py3o > Py3o PDF Export Options* and create a PDF export options profile.\n#. Set the PDF export options profile on the Py3o Server (menu *Settings > Technical > Reporting > Py3o > Py3o Servers*) or on a particular Py3o report with PDF output format (menu *Settings > Technical > Actions > Reports*).\n\nKnown issues / Roadmap\n======================\n\n* Add support for PDF signatures (possible, but no easy because the signature certificate is a very particular PDF export option)\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues `_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us smashing it by providing a detailed and welcomed\n`feedback `_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n~~~~~~~\n\n* XCG Consulting\n* ACSONE SA/NV\n\nContributors\n~~~~~~~~~~~~\n\n* Florent Aide (`XCG Consulting `_)\n* Laurent Mignon ,\n* Alexis de Lattre ,\n* Guewen Baconnier \n* Omar Casti\u00f1eira \n* Holger Brunn \n\nMaintainers\n~~~~~~~~~~~\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\nThis module is part of the `OCA/reporting-engine `_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n\n\n",
"description_content_type": "",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "https://github.com/OCA/reporting-engine",
"keywords": "",
"license": "AGPL-3",
"maintainer": "",
"maintainer_email": "",
"name": "odoo12-addon-report-py3o-fusion-server",
"package_url": "https://pypi.org/project/odoo12-addon-report-py3o-fusion-server/",
"platform": "",
"project_url": "https://pypi.org/project/odoo12-addon-report-py3o-fusion-server/",
"project_urls": {
"Homepage": "https://github.com/OCA/reporting-engine"
},
"release_url": "https://pypi.org/project/odoo12-addon-report-py3o-fusion-server/12.0.1.0.0.99.dev7/",
"requires_dist": [
"odoo12-addon-report-py3o",
"odoo (<12.1dev,>=12.0a)",
"py3o.formats",
"py3o.template"
],
"requires_python": ">=3.5",
"summary": "Let the fusion server handle format conversion.",
"version": "12.0.1.0.0.99.dev7"
},
"last_serial": 5616735,
"releases": {
"12.0.1.0.0.99.dev4": [
{
"comment_text": "",
"digests": {
"md5": "a62f2bc34cad063331871cb66e3f640a",
"sha256": "6eee1ff4a764317586d59aeb2dcbcec3bc917726b3c4ce8c01bb9c2c3db1e666"
},
"downloads": -1,
"filename": "odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a62f2bc34cad063331871cb66e3f640a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 124055,
"upload_time": "2019-03-13T05:48:37",
"url": "https://files.pythonhosted.org/packages/44/c0/c61a32c9fc81fa7334f6dd95457abc56f323801e57cdb319e5b858476cef/odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev4-py3-none-any.whl"
}
],
"12.0.1.0.0.99.dev5": [
{
"comment_text": "",
"digests": {
"md5": "72c0a50aed33fb8b0e97836c21e2d94a",
"sha256": "82e948e74d5ba639b7d8484c8acd307c2008841646468fe2c3090a97bb157038"
},
"downloads": -1,
"filename": "odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "72c0a50aed33fb8b0e97836c21e2d94a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 267124,
"upload_time": "2019-03-18T05:50:41",
"url": "https://files.pythonhosted.org/packages/40/0c/ab316768e947b0be638aefcef7fb6404021a83175432f41facca857eccfb/odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev5-py3-none-any.whl"
}
],
"12.0.1.0.0.99.dev6": [
{
"comment_text": "",
"digests": {
"md5": "7a4ae085aa84213daefadc950dc6d3f5",
"sha256": "dbc3f5e539acf8e9beee303c9f8cc531a0bd0a32db298e93f194565d916e8051"
},
"downloads": -1,
"filename": "odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7a4ae085aa84213daefadc950dc6d3f5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 270788,
"upload_time": "2019-07-19T04:55:44",
"url": "https://files.pythonhosted.org/packages/e7/1d/afc44bbcde8638bed71cc2e99dad45df8c8099e81b804576d033e18bd0a8/odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev6-py3-none-any.whl"
}
],
"12.0.1.0.0.99.dev7": [
{
"comment_text": "",
"digests": {
"md5": "bef4d24ffaf06c4998c6465695cbd9dd",
"sha256": "051c636a55027dab3508456c52caa004eb216635b106468d4a7d605d1ed68806"
},
"downloads": -1,
"filename": "odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bef4d24ffaf06c4998c6465695cbd9dd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 277957,
"upload_time": "2019-08-01T04:58:10",
"url": "https://files.pythonhosted.org/packages/b5/2f/0b78d417fea01d9e008e3c8e6419d8e7ce057dff79f08adfd17fd6ecc3c0/odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev7-py3-none-any.whl"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "bef4d24ffaf06c4998c6465695cbd9dd",
"sha256": "051c636a55027dab3508456c52caa004eb216635b106468d4a7d605d1ed68806"
},
"downloads": -1,
"filename": "odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bef4d24ffaf06c4998c6465695cbd9dd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 277957,
"upload_time": "2019-08-01T04:58:10",
"url": "https://files.pythonhosted.org/packages/b5/2f/0b78d417fea01d9e008e3c8e6419d8e7ce057dff79f08adfd17fd6ecc3c0/odoo12_addon_report_py3o_fusion_server-12.0.1.0.0.99.dev7-py3-none-any.whl"
}
]
}