.. _tablehandler/tipi_tablehandler/th_formhandler: thFormHandler ============= Il thFormHandler è un component speciale che permette di integrare non un intero TableHandler, ma solo una formResource, all'interno di una webpage o di un altro tableHandler. .. image:: /_static/images/tipi_tablehandler/thformhandler.png :width: 100% :align: center Il TableHandler in figura è reso semplicemente da queste righe di codice nel *main* di una webpage:: th = root.thFormHandler(table='mu.genres', datapath='main.genres') Con l'attributo ``startKey`` è possibile individuare una *pkey* della quale visualizzare la Form al caricamento della pagina. Si noti che in alternativa alla *startKey*, che caricherà la Form contestualmente al caricamento della pagina, è possibile usare un `dataController `_ per effettuare il posizionamento della Form sul record desiderato al verificarsi di un evento, ad esempio:: atc_grid = bottom.contentPane(region='center', datapath='.feature_attachments').thFormHandler( table='bnck.feature_competitor', formResource='FormForMainCompetitor') atc_grid.dataController("frm.goToRecord(pkey)", pkey='^main.center_th.features.cf_id',frm=atc_grid.js_form) Se si desidera poi far aprire la Form su un nuovo record al caricamento, è possibile impostare ``startKey='*newrecord*'``. .. hint:: Per le sue caratteristiche questo TableHandler è utilizzabile in presenza di tabelle gerarchiche o quando non si è interessati alla griglia di dati ma solo alla possibilità di inserire o visualizzare singoli record (ad es, aree riservate o pagine pubbliche). .. raw:: html
**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 | +------------------------+------+--------------------------------------------------+ |startKey |T |Permette di indicare una pkey della cui Form | | | |effettuare il pre-caricamento, anche in forma di | | | |path (es: startKey='^#FORM.record.fattura_id') | +------------------------+------+--------------------------------------------------+ |formId |T |Permette di assegnare un identificativo alla | | | |risorsa (es: formId='principale') | +------------------------+------+--------------------------------------------------+