.. _le_stampe/template/tipi_template:

Tipi di Template
================




Il tipo di Template viene identificato nel tab ``Metadata`` del  :ref:`Template Editor<le_stampe/template/template_editor>` . 

È possibile scegliere tra:

- template di ``Stampa`` 
- template di ``Email``      
- template di ``Riga``

A seconda della tipologia prescelta, potranno essere visualizzate alcune aree specifiche da compilare per quel tipo di template.

Il template di Stampa
---------------------

Viene utilizzato per definire delle stampe PDF relative ad uno o ad una serie di singoli record. Per la creazione del template di stampa, si rimanda alla sezione `stampe da template <https://www.genropy.org/docs/manuale_utente_genropy/stampe/stampe_personalizzate/stampe_personalizzate_template.html>`_. 

Una volta creato e salvato un template di stampa, la stampa corrispondente sarà elencata e lanciabile dall'icona della stampante.

.. image:: /_static/images/template-stampa.jpg
    :width: 700px
    :align: center


Il template di Email
---------------------

Viene utilizzato per `inviare e-mail automatizzate <https://www.genropy.org/docs/package/email/email.html>`_ personalizzate (stampe unione, mail con dati di record). 

Nel momento in cui si contrassegna il template per l'invio via e-mail, nel tab ``Modifica`` compariranno le nuove aree ``Metadati Email`` e  ``Attached reports``

.. spiegare come funzionano

Una volta creato e salvato, un template email potrà essere lanciato dall'icona della bustina.

.. image:: /_static/images/template-email.jpg
    :width: 700px
    :align: center

Il template di Riga 
-------------------
Il template *Riga* (*rowtemplate*) può essere utilizzato in tre ambiti differenti: 

- come **anteprima visualizzabile in griglia**, sotto forma di un fumetto al passaggio del mouse;
- come **stampa di sole righe**, lanciabile dalle stampe in ``Comune > Template Row``;
- in **sostituzione alla modalità standard di visualizzazione in griglia**, per rappresentare i dati di un record usando il template.

Nel momento in cui il template viene contrassegnato come template di *riga* comparirà un campo ``Height`` per permettere l'inserimento di un parametro di altezza da utilizzare nella stampa delle sole righe di cui al punto precedente.

Il template di riga in modalità *anteprima* sarà invece visualizzabile in griglia tenendo premuto *CTRL* al passaggio sul record:

.. image:: /_static/images/template_row.png
    :width: 600px
    :align: center
    
Il template di *riga* sarà automaticamente applicato se assegniamo al template il codice ``preview``. In alternativa, o in caso di presenza di più template di anteprima, o in caso si voglia utilizzare il template in una vista particolare e in un'altra no, è possibile gestire manualmente l'utilizzo del template di anteprima ridefinendo il `metodo th_options <https://www.genropy.org/docs/tablehandler/ViewResource/base_hooks/th_options_method.html>`_ della vista::

  def th_options(self):
      return dict(view_preview_tpl='r_fatt_riga')
      
.. hint::
  Per saperne di più sulle modalità di utilizzo del *templaterow*, consulta l'articolo sul nostro Blog: "`Come visualizzare i record con i template di riga <https://www.genropy.org/blog/come-visualizzare-i-record-con-i-template-di-riga/>`_"

.. sectionauthor:: Davide Paci