Inserimento dati personalizzabile: Search control

Questo oggetto permette la ricerca di un generico dato presente nel database, a patto che questo dato sia interfacciato con il meccanismo di astrazione query Hibernate. E' completamente programmabile, pertanto offre grande libertà di utilizzo.

Attributi specifici

dac_class

Permette di specificare il tipo di dato da gestire. E' necessario conoscere il nome completo del tipo di dato. Ad esempio, non è sufficiente scrivere An1DACAnagrafeUnica ma è necessario scrivere il nome completo it.saga.pubblici.anagrafeUnica.An1DACAnagrafeUnica.

I dati utilizzabili sono parecchi ed è necessario, ove non si conosca a priori il tipo di dato, chiederlo agli sviluppatori (normalmente l'insieme di dati che normalmente si utilizza è abbastanza limitato e non è un problema ricordarli).

dac_string (input)

Permette di iniziare una ricerca del dato a partire dalla sua descrizione testuale. Potrebbe causare l'apertura della finestra di ricerca qualora i risultati siano molteplici oppure il tipo di dato lo richieda.

E' mutuamente esclusivo con il parametro di input dac_pkid

dac_pkid (input)

Carica nel controllo il dato specificato da dac_class a partire dalla sua chiave primaria (numerica). Questo tipo di caricamento non apre alcuna finestra di ricerca.

E' mutuamente esclusivo con il parametro di input dac_string

ref_date

Qualora si tratti di un dato gestito a storico, è possibile impostare la data di validità della ricerca. Se impostato a vuoto significa "il dato più recente".

flg_bonifica

Permette di definire la visibilità o meno dei dati da bonificare.

• AUTO: Lascia al tipo di dato stesso l'incombenza di gestire questa informazione.
• MANUAL: Permette di gestire manualmente il flag (specificandolo nei criteri di ricerca).

case

Permette di definire se l'utente può inserire o meno lettere minuscole in quello che scrive nel controllo.

• UPPER: Solo lettere maiuscole.
• FREE: Inserimento con case libero (maiuscole e minuscole).

user_criteria_xml

Permette di definire un criterio di filtraggio dei dati modificabile dall'utente in fase di ricerca (qualora questa si apra durante la ricerca). Questo criterio viene espresso con una codifica XML. Non è necessario imparare la sintassi si questa codifica in quanto da una maschera di ricerca del dato in oggetto è possibile, tramite il filtro avanzato, definire un criterio e poi esportarlo in XML tramite l'apposita funzione (click destro sul criterio → Copia negli appunti (XML))

system_criteria_xml

E' analogo al parametro user_criteria solo che questo non è modificabile e solitamente non direttamente visibile all'utente.

dac_string (output)

Torna in output il testo contenuto nel controllo, null se non è caricato alcun oggetto.

dac_pkid (output)

Torna in output la chiave primaria (numerica) dell'oggetto contenuto nel controllo, null se non è caricato alcun oggetto.

Attributi di base

Per una spiegazione dei rimanenti attributi riferirsi alla pagina Inserimento dati personalizzabile: Attributi base degli oggetti