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.

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*'.

Suggerimento

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).

---

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”)