Si veda anche: Associare delle condizioni ai template di comunicazione
Introduzione
Questo documento descrive due funzionalità nell’ambito del sottosistema di comunicazioni di Esse3 che permettono di indicare, sulla base di condizioni e filtri configurabili, quali template di comunicazione debbano essere utilizzati e a quali studenti debbano essere destinate le comunicazioni generate (es.: mail, sms) a fronte della notifica di un evento applicativo (es.: registrazione utente).
Le funzionalità in questione sono:
- l’utilizzo o meno di un template di comunicazione sulla base di una condizione di applicabilità ad esso associato;
- l’applicazione automatica di un filtro studenti legato al template di comunicazione.
Per tali funzionalità esistono apposite configurazioni sulla maschera client di dettaglio del template di comunicazione.
La versione di riferimento è la 13.08.02, versione nella quale tali configurazioni sono state in parte riviste ed in parte aggiunte.
Condizione di applicabilita’
E’ possibile assoggettare un template di comunicazione ad una condizione di applicabilità: ciò significa che il template in questione verrà utilizzato se e solo se la condizione associata viene soddisfatta.
La condizione di applicabilità può essere selezionata tra le regole SQL definite in Esse3 (funzione client “Definizione regole di applicabilità”) definite sul contesto ‘COMUNICAZIONI’.
Tali condizioni SQL possono prevedere parametri (fino ad un massimo dei 10 previsti a sistema) ed è quindi possibile indicare quali parametri passati in fase di notifica evento usare per quali parametri della condizione SQL.
L’applicazione della condizione impatta di conseguenza su quante/quali comunicazioni vengono generate a fronte di una notifica evento.
Esempio:
supponiamo di avere l’evento applicativo E con associati i seguenti template (tutti abilitati e relativo media abilitato)
- template T1 senza alcuna condizione di applicabilità associata;
- template T2 con associata la condizione A;
- template T3 con associata la condizione B.
Supponiamo inoltre che, per come sono definite le condizioni e per quelli che sono i parametri passati in fase di notifica evento, solo la condizione A sia verificata.
A fronte della notifica applicativa dell’evento E verranno allora generate solo 2 delle complessive 3 potenziali comunicazioni; infatti
- la comunicazione relativa a T1 viene generata in quanto incondizionata;
- la comunicazione relativa a T2 viene generata in quanto la condizione A è verificata;
- la comunicazione relativa a T3 non viene generata in quanto la condizione B non è verificata.
L’eventuale condizione di applicabilità associata ad un template agisce quindi a monte di qualsiasi altra logica di generazione delle comunicazioni, ancor prima di entrare nel merito della risoluzione di parametri e valutazione dei destinatari.
Da client accedendo alla maschera di dettaglio del template di comunicazione è possibile configurare la condizione di applicabilità nel tab “Proprietà”, riquadro “Condizione di Applicabilità”:
Dopo aver selezionato la condizione da applicare al template è possibile indicare il mapping di ognuno dei 10 possibili parametri previsti a sistema su uno qualsiasi dei parametri previsti dall’evento/template di comunicazione.
Filtro studenti
La funzionalità di filtro studenti, configurata sempre a livello di template di comunicazione, entra in gioco solo se il template effettivamente si applica all’evento notificato (ovvero risulta abilitato, su media abilitato, con l’eventuale condizione di applicabilità soddisfatta).
Si tratta di un filtro che permette di restringere la totalità dei destinatari (passati in fase di notifica evento) ai soli studenti che soddisfano:
- una condizione SQL;
- l’appartenenza ad un gruppo (di struttura didattica)
- entrambi i criteri (nel caso siano specificati tutti e due contemporaneamente).
Tale filtro agisce solo sui destinatari di tipo PERSONE (ovvero gli studenti con anagrafica su P01_ANAPER), quindi qualsiasi altro soggetto di tipologia differente (docente, soggetto esterno, external) indicato tra i destinatari in fase di notifica evento rimarrà presente (non verrà toccato dal filtro).
Se ci troviamo in una situazione in cui i destinatari indicati sulla notifica evento sono tutti e soli studenti e nessuno di questi soddisfa il filtro impostato per il template allora la relativa comunicazione non verrà generata per nulla.
Basta però, ad esempio, che ci sia anche solo un destinatario external (o docente, o soggetto esterno) per far sì che la comunicazione venga generata (al limite solo con quel destinatario, in caso di altri destinatari studenti dei quali nessuno soddisfi il filtro).
Da client accedendo alla maschera di dettaglio del template di comunicazione è possibile configurare il filtro studenti nel tab “Destinatari”, riquadro “Filtro Studenti”:
I destinatari aggiuntivi eventualmente configurati sul medesimo template (destinatari fissi di tipo external) di default vengono aggiunti solo se una volta applicato l’eventuale filtro studenti vi sono ancora destinatari residui.
Processo - Gateway e messaggistica
Visibilita - tutti