Report delle stampe
=====================

Premessa
-----------

La seguente miniguida è nata dalla richiesta giunta da alcune scuole di verificare il numero di pagine stampate dai vari utenti per evitare eccessi a scapito degli altri.


Configurazione sul server
-------------------------------

Sono stati creati due script:

- printaccounting.py 

- printreporting.sh

Il primo è uno script python che raccoglie i dati dai file /var/log/page.log 
e li scrive in **/var/log/cups/cupspages.db**, un database SQLite; viene eseguito 
ogni notte da un  cron job.

Il secondo è uno script bash che estrae i dati utili dal database e li scrive 
in 4 file nella cartella **/home/cups-report**; Viene eseguito da un cron job 
ogni notte dopo lo script precedente.

Accesso ai report di stampa per gli utenti autorizzati
----------------------------------------------------------------

I dati contenuti nei 4 file di report sono accessibili solo agli utenti 
(generalmente uno solo) appartenenti al gruppo **print-accounting**, 
assegnabile via ``Octonet``.

Per accedere alla cartella l'utente può:

- Cliccare su **File system** e poi sulla cartella **home**

.. figure:: /images/cups-report/fig1.png
      :width: 100%
      :align: center
      
- Cliccare su **home** e poi sulla cartella **cups-report**

.. figure:: /images/cups-report/fig2.png
      :width: 100%
      :align: center
       
Per creare un collegamento diretto dalla Home dell'utente:

- Cliccare col tasto destro del mouse e poi **Invia a** uno tra:

  - Pannello laterale
  
  - Scrivania

.. figure:: /images/cups-report/fig3.png
      :width: 40%
      :align: center
       
- Nel caso si sia scelto il pannello laterale, ci si troverà cups-report tra i segnalibri
 
.. figure:: /images/cups-report/fig4.png
      :width: 15%
      :align: center

|

La lettura dei file non richiede spiegazioni in quanto il significato appare immediato.

.. note::

    Per come vengono estratti, i dati non sono in tempo reale, ma fotografano 
    sempre la situazione del giorno precedente.