0.12   Gli eventi

In questo capitolo vedremo i vari eventi disponibili in o2 e come utilizzarli.

Obiettivi

Al completamento di questo capitolo sarai in grado di:

• Individuare ogni tipo di evento
• Applicare il meccanismo degli eventi alla logica dei programmi
• Scegliere gli eventi in base alle necessità

Introduzione

Gli eventi sono tutti quei momenti in cui l’o2runtime può passare il controllo ad un’azione o ad un programma indicati dal programmatore ed hanno due scopi:

1. Permettere al programmatore di intervenire all’interno di procedure automatizzate (come gli eventi di view di Read new row e Leaving modified row)
2. Permettere al programmatore di indicare le azioni da eseguire a fronte di certi comportamenti dell’operatore (come gli eventi di action per i pulsanti)

Gli eventi si dividono in 4 categorie in dipendenza degli oggetti su cui sono definiti e del tipo di esecuzione che possono invocare.

0.12.1   Gli eventi di applicazione

Gli eventi di applicazione servono a controllare momenti esecutivi indipendenti dal programma chiamato e comuni a tutta l’appliazione e sono due:

1. Start program

   Lo Start program serve ad indicare il programma da eseguire all’entrata nell’applicazione, cioè immediatamente dopo la funzione di login di convalida dell’utente di scrittura della sessione.

   Tale programma può essere un programma batch di servizio di ambiente, utile a vari scopi: impostare variabili di ambiente, impostare i menu di applicazione, recuperare informazioni dell’utente e scrivere log e statistiche; oppure può essere un programma con interfaccia che dia al via alle esecuzioni in assenza di menu, mostri menu personalizzati, mostri e costituisca la home page del sito, richieda o notifichi informazioni all’utente e quanto altro si voglia eseguire sempre ed una sola volta ad ogni accesso al proprio sito.

2. On request program

   L’On request program, invece, deve essere rigorosamente batch per un logico motivo: la sua esecuzione viene invocata ad ogni request da parte dell’utente e, quindi, anche durante le normali interazioni richieste dagli altri programmi.

   L’utilizzo di questo evento è da prendersi in considerazione in casi molto particolari, ad esempio, qualora si vogliano fare controlli sullo stato della sessione o per risolvere esigenze specifiche di gestione della comunicazione http.

0.12.2   Gli eventi di programma

Ad oggi l’o2 prevede un solo evento di programma e cioè la initial action.

La initial action è l’azione eseguita automaticamente dal programma ogni volta che viene chiamato ed è possibile impostarla dall’omonimo campo nella pagina di Program properties del programma.

Come abbiamo visto, tramite questo evento è possibile impostare una vista del programma su specifici valori di ricerca ma risulta molto utile anche per effettuare controlli e valorizzare variabili all’entrata in un programma con interfaccia.

Indispensabile l’utilizzo della initial action per i programmi batch: non mostrando alcuna interfaccia all’utente, tali programmi rimangono in esecuzione per la durata della loro gerarchia esecutiva, il cui primo passo è sempre la initial action, in assenza della quale non eseguono alcuna azione.

0.12.3   Gli eventi di view

Agli eventi di view è possibile collegare 2 azioni del programma che contiene la vista, tramite la pagina di View properties:

1. Action on read new row

   Questa action verrà invocata ogni volta che, ad opera dell’utente o delle logiche esecutive delle azioni, verrà impostata la selezione del record corrente per la vista, prima di eseguire qualunque azione scatenata dai controlli e prima di comporre la form da mostrare all’operatore.

   Questo evento risulta particolarmente utile per sincronizzare il contesto visualizzato con i record selezionati nelle viste e per mostrare decodifiche dei dati del recordset. Ad esempio, con questo evento, si possono opportunamente valorizzare variabili locali a fronte di valori letti dal record corrente.

2. Action on leaving modified row

   L’azione qui indicata sarà automaticamente eseguita ogni volta che si tenterà di impostare la selezione per la vista, abbandonando un record modificato e non scritto su database.

   Questo evento è pensato per automatizzare le procedure di salvataggio delle modifiche: inserendo un’azione che esegua un’istruzione di record postrow, si otterrà l’effetto di salvare le modifiche apportate dall’operatore, senza che egli lo richieda, ad ogni tentativo di cambio del record corrente.

   Un altro utilizzo può essere quello di assicurare ad una vista la corretta forma dei dati da salvare, prima di scriverli su database, indipendentemente dalle azioni che ne provocheranno le modifiche.

0.12.4   Gli eventi di interfaccia

Gli eventi di interfaccia sono di numero e di forma più varia e servono ad indicare le azioni di programma da eseguire a fronte delle varie funzionalità offerte dai controlli di interazione con l’utente.

Il controllo window

Prevede un solo evento di Close click action, la cui azione viene indicata nella pagina di proprietà della form:

L’azione qui indicata verrà eseguita quando l’operatore clicca sulla crocetta di chiusura della finestra e può essere utile per eseguire azioni all’uscita dal programma o per impostare criteri di visibilità per le finestre.

I controlli associati a campi (Edit control, List/combo box, Check box, Text area e Multi page)

Implementano tutti un evento di on change, controllabile tramite 2 proprietà della finestra Object inspector, presente durante la sessione di editing della form.

La proprietà Action indica l’azione da eseguire a fronte di una modifica al valore del controllo: l’azione verrà eseguita al prossimo ritorno al server.

La proprietà Submit on change permette di indicare un’espressione che, se valutata a "true", forza il ritorno al server quando si abbandoni il controllo dopo averlo modificato. Il comportamento, guidato da un javascript, è lo stesso che se l’operatore premesse un pulsante di submit ogni qualvolta abbia apportato modifiche al controllo: questo permette di aggiornare le viste e di eseguire l’azione indicata nella proprietà Action del controllo ad ogni modifica del valore.

L’uso delle due proprietà permette di utilizzare gli eventi di on change dei controlli associati a campi, in modo da far reagire in maniera dinamiche e tempestiva il contesto del programma alle eventuali variazioni di valore dei campi e delle variabili che si utilizzano: particolarmente utile si dimostra nella validazione dei valori inseriti e nell’aggiornamento delle link, delle viste dipendenti e delle viste in base a campi di selezione.

I controlli button e image

Implementano l’evento di click, che prevede (proprietà Action dell’Object inspector) l’indicazione di un’azione da eseguire quando l’operatore prema il pulsante sinistro del mouse su tali controlli.

L’utilizzo di questo evento è semplice da capire e costituisce la base dell’interazione con pulsanti e aree grafiche cliccabili: permette di implementare facilmente menu di comandi personalizzati e gli effetti interattivi più frequenti di ogni applicazione.