Metodo th_options

Opzioni che regolano il comportamento

Come per la ViewResource , anche per le Form esiste un metodo con lo stesso nome che consente di personalizzare il comportamento della form stessa.

def th_options(self):
    return dict(dialog_height='400px', dialog_width='600px' )

questo è un tipico esempio delle opzioni di base impostate dal package editor sul quale è possibile intervenire.

---

Parametri:

Nome parametro	Tipo	Descrizione
dialog_width	T	Permette di indicare la larghezza della finestra di dialogo della Form (es: dialog_width=”600px”)
dialog_height	T	Permette di indicare l’altezza della finestra di dialogo della Form (es: dialog_height=”600px”)
dialog_windowRatio	T	Invece di indicare delle dimensioni fisse in termini di width e height, è possibile indicare un valore in proporzione alla dimensione complessiva della finestra (es: dialog_windowRatio=.8)
duplicate	B	Se impostato a «True» permette di visualizzare il bottone che permette la duplicazione immediata del record
autoSave	T	Se impostato a «True» la form verrà salvata automaticamente a ogni modifica.
modal	B	Permette di visualizzare la Form come «modale», ovvero senza la caratteristica barra superiore e con i bottoni «Ritornare», «Annulla» e «Salva» per gestire le operazioni
searchOn	B	In una table gerarchica, se impostato a True permette di mostrare il campo per la ricerca
form_delete	B	Se impostato a False, la Form non presenterà il bottone per l’eliminazione di un record
form_add	B	Se impostato a False, la Form non presenterà il bottone per l’aggiunta di un nuovo record
form_save	B	Se impostato a False non verrà mostrato il bottone di salvataggio della Form
showtoolbar	B	Se impostato a False, la Form non presenterà la toolbar superiore
showfooter	B	Se impostato a False, la Form nasconderà la barra inferiore
actionMenu	B	Se impostato a True mostrerà il menu delle action per il record (icona ingranaggio)
printMenu	B	Se impostato a True permette di visualizzare l’icona per il lancio della stampa del record in oggetto
startKey	T	Permette di aprire la Form indicando un record specifico (es: startKey=”newrecord”)
defaultPrompt	T	Permette di indicare una serie di campi, all’interno di un dizionario, da fornire subito al clic sul bottone + al momento dell’aggiunta di un nuovo record (es: defaultPrompt=dict(title=»Nuovo record», fields=[dict(value=”^.titolo”,width=”15em”, lbl=”!![it]Titolo”)]))
allowSaveInvalid	B	Se impostato a True, permette di annullare le validazioni e permettere il salvataggio del record anche in presenza di campi non validi
navigation	B	Se impostato a False nasconderà la barra di navigazione tra i record della Form
selector	B	Se impostato a True, permette di mostrare un’icona con una lente di ingrandimento nella toolbar superiore della Form, che consentirà di spostarsi tra i record.
titleTemplate	T	Di default equivalente al nome della Tabella, permette invece di specificare un template da utilizzare come titolo
lazyBuild	B	Se impostato a True, la costruzione della Form sarà «lazy»
readOnly	B	Se impostato a True, la Form sarà in sola lettura
audit	B	Se impostato a True mostrerà la record history (lista cambiamenti del record)
copypaste	B	Se impostato a True permetterà il copia/incolla dei valori del record
annotations	B	Se abilitato il package ORGN, permette di attivare nella Form della table la gestione delle annotazioni
draftInvalid	B
excludeCols	T
Tabelle Gerarchiche Parameters
hierarchical	B	Se impostato a «True», permette la visualizzazione gerarchica della tabella. Può essere anche “closed” (albero gerarchico chiuso al caricamento) o “open” (albero gerarchico aperto)
tree_	T	Permette di passare dei parametri al namespace «tree» di una table gerarchica
tree_excludeRoot	B	In una table gerarchica, se impostato a True permette di escludere la radice primaria dall’albero gerarchico
tree_picker	T	In una table gerarchica, permette di indicare il campo da usare per il picker

Autore della sezione: Valter Vettorello e Davide Paci