.. _tutor/architettura/menu/thpage:

thpage
======




L'oggetto *thpage* permette di richiamare in un menu una qualsiasi `risorsa th <https://www.genropy.org/docs/tablehandler/th_resource.html>`_, eventualmente specificandone una ``viewResource`` o una ``formResource``.

Es::

  class Menu(object):
  
    def config(self,root):
        fatturazione = root.branch(u"Fatturazione")
        fatturazione.thpage(u"Clienti", table="fatt.cliente")
        fatturazione.thpage(u"Tipi Prodotto", table="fatt.prodotto_tipo")
        fatturazione.thpage(u"Prodotti", table="fatt.prodotto")
        fatturazione.thpage(u"Fatture", table="fatt.fattura")
        fatturazione.thpage(u"Righe vendita", table="fatt.fattura_riga")
        
Si noti che oltre alla risorsa è possibile specificare una ``pkey``. In quel caso la voce di menu si aprirà esclusivamente sulla Form del record indicato. 

.. hint::
  Quest'ultimo caso è quanto avviene in modo automatico utilizzando un  :ref:`tableBranch<tutor/architettura/menu/tableBranch>` 

È possibile passare dei parametri alla risorsa tramire il parametro  ``url_``.
Ad esempio, url_param1='content' può essere recuperato nella risorsa accedendo al dizionario self._call_kwargs['param1'].

Nel caso di una webpage il parametro viene passato nel main::

   def main(self,root, param1=None, **kwargs):



.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|checkpref               |T     |Permette di mostrare la voce di menu o il branch  |
|                        |      |solo se rispettata una determinata condizione     |
|                        |      |espressa nelle preferenze, nella forma            |
|                        |      |"pkg.nomepreferenza" (es:                         |
|                        |      |checkpref='adm.gestione_utenti_nel_menu')         |
+------------------------+------+--------------------------------------------------+
|checkenv                |T     |Permette di mostrare la voce di menu o il branch  |
|                        |      |solo se rispettata una determinata condizione     |
|                        |      |espressa nell'environment (es:                    |
|                        |      |checkenv='deposito_id')                           |
+------------------------+------+--------------------------------------------------+
|newPanel                |B     |Se impostato a True la voce di menu si aprirà in  |
|                        |      |un nuovo tab del browser                          |
+------------------------+------+--------------------------------------------------+
|newWindow               |B     |Se impostato a True la voce di menu si aprirà in  |
|                        |      |una nuova finestra del browser                    |
+------------------------+------+--------------------------------------------------+
|titleCounter            |B     |Se impostato a True verrà mostrato il conteggio   |
|                        |      |dei record                                        |
+------------------------+------+--------------------------------------------------+
|titleCounter_condition  |T     |Se c'è un titleCounter, permette di specificare la|
|                        |      |condizione sulla base della quale calcolare il    |
|                        |      |numero dei record della table specificata         |
+------------------------+------+--------------------------------------------------+
|multipage               |B     |Di default a True, permette di mostrare la        |
|                        |      |linguetta in alto per aprire più pagine           |
|                        |      |all'interno della stessa th resource              |
+------------------------+------+--------------------------------------------------+
|pkey                    |T     |Permette di indicare una pkey di un record di una |
|                        |      |table.                                            |
+------------------------+------+--------------------------------------------------+
|table                   |T     |La table a cui si riferisce la thpage (es:        |
|                        |      |table='fatt.fattura')                             |
+------------------------+------+--------------------------------------------------+
|viewResource            |T     |Permette di specificare la viewResource da        |
|                        |      |utilizzare (es: viewResource='ViewFromCliente')   |
+------------------------+------+--------------------------------------------------+
|formResource            |T     |Permette di specificare la formResource da        |
|                        |      |utilizzare (es: formResource='FormFromCliente')   |
+------------------------+------+--------------------------------------------------+
|url\_                   |T     |Permette di passare dei parametri alla risorsa    |
|                        |      |(es: url_th_condition='$cliente_id=:c_id',        |
|                        |      |url_th_condition_c_id=cliente)                    |
+------------------------+------+--------------------------------------------------+
|pageResource            |T     |                                                  |
+------------------------+------+--------------------------------------------------+
|titleCounter\_          |T     |Serie di parametri passati al titleCounter (es: ti|
|                        |      |tleCounter_condition='$anagrafica_id=:env_anagrafi|
|                        |      |ca_id')                                           |
+------------------------+------+--------------------------------------------------+
|                                *Common Parametri*                                |
+------------------------+------+--------------------------------------------------+
|label                   |T     |Solitamente implicito, si riferisce all'etichetta |
|                        |      |della voce di menu                                |
+------------------------+------+--------------------------------------------------+
|tags                    |T     |Permette di indicare i tag utente a cui le pagine |
|                        |      |sono riservate (es: tags='admin')                 |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Davide Paci

.. raw:: html

   <p style="font-size:0.8em;">Data di pubblicazione 01-03-2022</p>