<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="mass-reporting"></a>
<h2>MASS REPORTING</h2>
<p>This module allows you to generate a large volume of reports (like several
thousands), optionally concatenate them, and alerts users when the process is
done.
It is based on the Job queue provided by the <code>connector</code> framework to
process the reports, and on the standard messaging system of Odoo to send
alerts.</p>
<a name="installation"></a>
<h3>Installation</h3>
<p>To use this module, you need to install <cite>PyPDF2</cite>:</p>
<pre>
<code>$ sudo pip install PyPDF2</code>
</pre>
<p>Or on Debian based system:</p>
<pre>
<code>$ sudo apt-get install python-pypdf2</code>
</pre>
<a name="configuration"></a>
<h3>Configuration</h3>
<p>Go to the <em>Reporting / Mass reporting / Mass reports</em> menu to create a new
mass report. Here you have to set the following options:</p>
<blockquote>
<ul class="simple">
<li>set the data model from which reports should be printed (e.g. 'Invoice'),</li>
<li>select the user account used to print the reports,</li>
<li>select the reports to print in the right order (e.g. a PDF letter
+ the PDF invoice),</li>
<li>configure the filters to use (e.g. to get only validated invoices)</li>
<li><dl class="first docutils">
<dt>choose the output format:</dt>
<dd><ul class="first last">
<li>do nothing (simple case, useful if you just want to generate your
invoices as attachments)</li>
<li>concatenate all files into one,</li>
<li>put individual reports into a single ZIP archive</li>
<li>or implement your own output format (like sending the produced data
by email or SFTP to another server).</li>
</ul>
</dd>
</dl>
</li>
</ul>
</blockquote>
<p>Once configured, just push the "Run" button and wait. The configured user will
be notified via the Odoo messaging when the mass report is processed.
The resulting file (if any) will be available in the <cite>File</cite> field.</p>
<a name="usage"></a>
<h3>Usage</h3>
<a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/143/8.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/server-tools/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 <a class="reference external" href="https://github.com/OCA/server-tools/issues/new?body=module:%20nsca_client%0Aversion:%208.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<a name="credits"></a>
<h3>Credits</h3>
<a name="images"></a>
<h4>Images</h4>
<ul class="simple">
<li>Icon: from the <a class="reference external" href="https://en.wikipedia.org/wiki/Oxygen_Project">Oxygen theme</a> (LGPL)</li>
</ul>
<a name="contributors"></a>
<h4>Contributors</h4>
<ul class="simple">
<li>Sébastien Alix <<a class="reference external" href="mailto:sebastien.alix@osiell.com">sebastien.alix@osiell.com</a>></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>