.. _tablehandler/tipi_tablehandler/related_th:

relatedTableHandler
===================




Il relatedTableHandler è in realtà l'estensione della funzionalità di un altro TableHandler "principale" utilizzato in presenza di una table gerarchica, al fine di permettere lo spostamento degli elementi in relazione tra le voci della gerarchia (di default non possibile). 

.. image:: /_static/images/tipi_tablehandler/relatedtablehandler.gif
    :width: 100%
    :align: center
    
Il TableHandler in figura è reso semplicemente da queste righe di codice::
  
  th = center.plainTableHandler(relation='@tracks_by_genre')
        form.htree.relatedTableHandler(th,
                                    dropOnRoot=False,
                                    inherited=True)  
                                    
Come si può notare, un  :ref:`plainTableHandler<tablehandler/tipi_tablehandler/plain_th>`  (ma è possibile usare qualsiasi altro tipo di TableHandler) viene arricchito con il relatedTableHandler.
  
.. hint::
  Per le sue caratteristiche questo TableHandler è utilizzabile in presenza di tabelle gerarchiche in cui può essere utile permettere lo spostamento degli elementi tra le voci della gerarchia in relazione.

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|table                   |T     |Permette di indicare la table di partenza dei dati|
+------------------------+------+--------------------------------------------------+
|relation                |T     |In caso di tabella in relazione, permette di      |
|                        |      |indicare la relation_name da seguire per          |
|                        |      |recuperare i dati                                 |
+------------------------+------+--------------------------------------------------+
|formResource            |T     |Permette di indicare una specifica formResource   |
|                        |      |del Tablehandler da utilizzare                    |
+------------------------+------+--------------------------------------------------+
|viewResource            |T     |Permette di indicare una specifica viewResource   |
|                        |      |del Tablehandler da utilizzare                    |
+------------------------+------+--------------------------------------------------+
|condition               |T     |Permette di applicare una condizione ai dati      |
|                        |      |forniti dalla relazione o dalla tabella           |
+------------------------+------+--------------------------------------------------+
|title                   |T     |Titolo del box occupato dal Tablehandler          |
|                        |      |(visualizzato sopra la griglia)                   |
+------------------------+------+--------------------------------------------------+
|delrow                  |B     |True o False, se impostato a False disattiva la   |
|                        |      |possibilità di eliminare record                   |
+------------------------+------+--------------------------------------------------+
|addrow                  |B     |True o False, se impostato a False disattiva la   |
|                        |      |possibilità di aggiungere record                  |
+------------------------+------+--------------------------------------------------+
|export                  |B     |True o False, se impostato a True permette di     |
|                        |      |esportare i dati in formato Excel                 |
+------------------------+------+--------------------------------------------------+
|virtualStore            |B     |True o False, se impostato a True il caricamento  |
|                        |      |dei dati sarà automatico e la ricerca             |
|                        |      |disabilitata.                                     |
+------------------------+------+--------------------------------------------------+
|view_store_onStart      |B     |In caso di chiamata a un tablehandler con quindi  |
|                        |      |di default uno store statico, al fine di          |
|                        |      |visualizzare i dati nello store al caricamento si |
|                        |      |può impostare un innesco oppure il parametro      |
|                        |      |view_store_onStart=True                           |
+------------------------+------+--------------------------------------------------+
|searchOn                |B     |Se impostato a "False" disabilita la casella di   |
|                        |      |testo per effettuare la ricerca quando questa è   |
|                        |      |già in sostituzione alla query classica (es:      |
|                        |      |quando virtualStore=False)                        |
+------------------------+------+--------------------------------------------------+
|extendedQuery           |B     |True o False, se impostato a True attiva la       |
|                        |      |ricerca avanzata e la toolbar di default del      |
|                        |      |tablehandler                                      |
+------------------------+------+--------------------------------------------------+
|autoSave                |B     |Se impostato a True, il salvataggio automatico    |
|                        |      |delle modifiche sarà abilitato                    |
+------------------------+------+--------------------------------------------------+
|grid_autoSelect         |B     |Se impostato a True verrà automaticamente         |
|                        |      |selezionato il primo valore in griglia al         |
|                        |      |caricamento                                       |
+------------------------+------+--------------------------------------------------+
|grid_multiSelect        |B     |True o False, se impostato a False impedisce la   |
|                        |      |selezione multipla delle celle                    |
+------------------------+------+--------------------------------------------------+
|grid_selfDragRows       |B     |True o False, se impostato a True permette        |
|                        |      |l'ordinamento personalizzato delle righe tramite  |
|                        |      |trascinamento                                     |
+------------------------+------+--------------------------------------------------+
|form_locked             |B     |Permette di scegliere se la Form del th           |
|                        |      |rappresentato si mostrerà di default come aperta o|
|                        |      |chiusa                                            |
+------------------------+------+--------------------------------------------------+
|formInIframe            |B     |Se impostato a True la form sarà caricata in un   |
|                        |      |iframe                                            |
+------------------------+------+--------------------------------------------------+
|configurable            |B     |Di default True, se impostato a False non mostrerà|
|                        |      |la linguetta per configurare le colonne           |
+------------------------+------+--------------------------------------------------+
|dropOnRoot              |B     |True o False, se impostato a True permette di     |
|                        |      |trascinare una cella della tabella gerarchica     |
|                        |      |sulla categoria primaria (root)                   |
+------------------------+------+--------------------------------------------------+
|inherited               |B     |Se impostato a "True", comparirà una checkbox     |
|                        |      |"Contenuti ereditati" che permetterà di           |
|                        |      |visualizzare gli elementi appartenenti ai         |
|                        |      |sottoelementi in una table gerarchica             |
+------------------------+------+--------------------------------------------------+