.. _tutor/architettura/menu/packageBranch:

packageBranch
=============




Il *packageBranch* permette di costruire **dinamicamente** un branch basato su un `Package <https://www.genropy.org/docs/genropy_orm/model/package.html>`_. Le voci contenute nel nuovo ramo saranno le singole tabelle::

  class Menu(object):
    def config(self,root):
        fatturazione = root.branch(u"Fatturazione")
        fatturazione.packageBranch('Gestione utenti',pkg='adm',
                                    subMenu='userSubmenu',
                                    branch_parametro=3)
                                
Si noti che è possibile specificare un ``branchMethod``, ovvero un altro  :ref:`metodo<tutor/architettura/menu/menu_methods>`  personalizzato, che si occuperà della costruzione del menu.

.. 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                    |
+------------------------+------+--------------------------------------------------+
|pkg                     |T     |Il package a cui si riferisce il branch (es:      |
|                        |      |pkg='fatt')                                       |
+------------------------+------+--------------------------------------------------+
|subMenu                 |T     |Permette di indicare il nome del metodo           |
|                        |      |personalizzato che si occupa della costruzione del|
|                        |      |menu (es: subMenu='costruisciMenuPersonalizzato') |
+------------------------+------+--------------------------------------------------+
|branchMethod            |T     |**deprecato** Permette di indicare il nome del    |
|                        |      |metodo personalizzato che si occupa della         |
|                        |      |costruzione del menu (es:                         |
|                        |      |branchMethod='costruisciMenuPersonalizzato')      |
+------------------------+------+--------------------------------------------------+
|branch\_                |T     |Permette di passare un qualunque parametro al     |
|                        |      |metodo di costruzione del menu (es:               |
|                        |      |branch_date='31/12/2021')                         |
+------------------------+------+--------------------------------------------------+
|cacheTime               |L     |Il tempo di caching, in secondi, tra un           |
|                        |      |caricamento e l'altro (es: cacheTime=5)           |
+------------------------+------+--------------------------------------------------+
|                               *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