.. _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>` 

.. 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                    |
+------------------------+------+--------------------------------------------------+
|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     |                                                  |
+------------------------+------+--------------------------------------------------+
|                               *Common Parameters*                                |
+------------------------+------+--------------------------------------------------+
|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