Skip to Content

Report to printer

Beta License: AGPL-3 OCA/report-print-send Translate me on Weblate Try me on Runboat

This module allows users to send reports to a printer attached to the server.

It adds an optional behaviour on reports to send it directly to a printer.

  • Send to Client is the default behaviour providing you a downloadable PDF
  • Send to Printer prints the report on selected printer

It detects trays on printers installation plus permits to select the paper source on which you want to print directly.

Report behaviour is defined by settings.

You will find this option on default user config, on default report config and on specific config per user per report.

This allows you to dedicate a specific paper source for example for preprinted paper such as payment slip.

Settings can be configured:

  • globally
  • per user
  • per report
  • per user and report

Table of contents

Installation

To install this module, you need to:

  1. Install PyCups - https://pypi.python.org/pypi/pycups
sudo apt-get install cups
sudo apt-get install libcups2-dev
sudo apt-get install python3-dev
sudo pip install pycups

Configuration

To configure this module, you need to:

  1. Enable the “Printing / Print User” option under access rights to give users the ability to view the print menu.

The jobs will be sent to the printer with a name matching the print_report_name of the report (truncated at 80 characters). By default this will not be displayed by CUPS web interface or in Odoo. To see this information, you need to change the configuration of your CUPS server and set the JobPrivateValue directive to “none” (or some other list of values which does not include “job-name”) , and reload the server. See cupsd.conf(5) <https://www.cups.org/doc/man-cupsd.conf.html> for details.

If you want to see the button in the top bar to set the user’s printer, you need to have the “Show printer button on navbar” group.

Usage

Guidelines for use:

  • To update the CUPS printers in Settings > Printing > Update Printers from CUPS
  • To print a report on a specific printer or tray, you can change these in Settings > Printing > Reports to define default behaviour.
  • To print a report on a specific printer and/or tray for a user, you can change these in Settings > Printing > Reports in Specific actions per user
  • Users may also select a default action, printer or tray in their preferences.

When no tray is configured for a report and a user, the default tray setup on the CUPS server is used.

The users are able to change their default printer by using the button with the printer icon set on the navbar.

Known issues / Roadmap

  • With threaded printing there’s no download fallback when the issue isn’t detected by the CUPS Odoo backend. To able to do it, we would need to notify the bus or use web_notify for it.

Changelog

13.0.1.0.0 (2019-09-30)

  • [RELEASE] Port from V12.

12.0.1.0.0 (2018-02-04)

  • [RELEASE] Port from V11.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

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

Credits

Authors

  • Agile Business Group & Domsense
  • Pegueroles SCP
  • NaN
  • LasLabs
  • Camptocamp
  • Open for Small Business Ltd

Contributors

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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.

This module is part of the OCA/report-print-send project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.