.. _tutor/architettura/menu/lookupBranch:

lookupBranch
============




Con ``lookupBranch`` si può raccogliere le tabelle di Lookup di un package. Es::

  class Menu(object):
    def config(self,root):
        fatturazione = root.branch("Fatturazione")
        fatturazione.lookupBranch("Tabelle Ausiliarie", pkg="fatt")
      
permetterà di mostrare alla voce "Tabelle Ausiliarie" tutte le tabelle di lookup del package *fatt*. È possibile indicare anche ``pkg="*"`` per raccogliere tutte le tabelle di tutti i package.

In alternativa al ``pkg``, è possibile specificare invece delle ``tables`` specifiche nella seguente forma::

  fatturazione.lookupBranch("Tabelle Tipi", tables="fatt.tipo_iva,fatt.cliente_tipo")

lookupPage
~~~~~~~~~~
Per visualizzare infine **una sola tabella di lookup** specifica, è possibile utilizzare ``lookupPage``::

  fatturazione.lookupPage("Tipo Iva", table="fatt.tipo_iva")
  
Come si presentano le tabelle di lookup
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Oltre a condividere il ramo di menu, le tabelle ausiliarie **condivideranno anche la stessa pagina**: al clic su una delle tabelle, quindi, verrà effettuato uno switch sulla tabella selezionata, all'interno della stessa pagina. 

.. image:: /_static/images/menu/lookups.gif
    :width: 790px
    :align: center

Si noti che la selezione può essere effettuata sia dal menu sia dal selettore apposito presente accanto al titolo della tabella.

Questo consentirà innanzitutto di inviduare le tabelle di lookup dal menu effettuando una ricerca testuale, e secondariamente di risparmiare tempo e risorse al caricamento.

.. 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     |Permette di indicare il package di cui raccogliere|
|                        |      |le tabelle di lookup (es: pkg='fatt', o pkg='*'   |
|                        |      |per includere tutte le tabelle di tutti i package)|
+------------------------+------+--------------------------------------------------+
|tables                  |T     |Permette di indicare le singole lookup tables da  |
|                        |      |riportare nel menu (es:                           |
|                        |      |tables="fatt.tipo_iva,fatt.cliente_tipo")         |
+------------------------+------+--------------------------------------------------+
|table                   |T     |Se si usa lookupPage, permette di indicare la     |
|                        |      |singola lookup table da riportare nel menu (es:   |
|                        |      |table="fatt.tipo_iva")                            |
+------------------------+------+--------------------------------------------------+
|                               *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