A partire dalla versione 23.03.04.00 su Esse3 è possibile attivare, nell'ambito Comunicazioni e Messaggistica, l'invio di messaggi su un nuovo canale: si tratta di IO, l'app dei servizi pubblici.
Qui di seguito le indicazioni necessarie per abilitare tale funzionalità.
Per l'invio di messaggi sul nuovo canale App IO è stato utilizzato in Esse3 un nuovo servizio di Cineca, denominato Notification Manager, che a tendere coprirà l'intero processo di scambio di comunicazioni, in modalità integrata, tra tutte le realtà applicative Cineca.
Come prima cosa è quindi necessario accertarsi che tale servizio sia attivo per il proprio ateneo ed in Esse3 sia opportunamente configurato l'interfacciamento: in caso contrario, o nel dubbio, chiedere assistenza alla struttura di supporto che nel caso si preoccuperà di veicolare la richiesta verso le strutture di mercato.
Come si vedrà nel seguito, se l'interfacciamento tra Esse3 ed il servizio Notification Manager non è funzionante il sistema ne da comunque evidenza nelle diverse fasi del processo (sia sulla configurazione del device di comunicazione che sull'invio dei messaggi). |
Su Esse3 è ora presente una nuova tipologia di device di comunicazione, avente codice identificativo "IO", che va ad affiancarsi a quelle già esistenti (EMAIL, SMS, APP, ecc.):
rappresenta il canale App IO, di default su Esse3 è presente un device di sistema "IO" di tale tipologia con le due proprietà di configurazione indicate nella tabella seguente.
Parametro di configurazione | Descrizione |
---|---|
SUBSCRIPTION_KEY | Chiave di sottoscrizione del servizio: si tratta del codice (chiave) rilasciato da App IO nel momento in cui l'ente si accredita per esporre un determinato servizio su cui inviare messaggi |
TEST_RECIPIENT | Codice fiscale che rappresenta il destinatario a cui inviare le notifiche su ambiente di test: infatti, per qualsiasi ambiente diverso da Produzione, i messaggi vengono inviati al destinatario di test configurato (al posto dei destinatari reali) |
L'ateneo dovrà innanzi tutto impostare tali configurazioni applicative in funzione dei servizi che intende pubblicare su App IO:
La particolare icona presente a destra del campo descrizione sta ad indicare che per il device in questione la spedizione avviene tramite il servizio Notification Manager.
Nel momento in cui si effettua il salvataggio delle configurazioni di un device di tipo "IO" impostato ad Attivo, Esse3 comunica tali configurazioni al servizio Notification Manager: Se il problema persiste chiedere assistenza contattando la struttura di supporto. |
Dopo aver configurato opportunamente il/i device di tipologia IO ed averli attivati (N.B.: non dimenticarsi di renderli attivi), come passo successivo è necessario configurare i template di comunicazione dedicati ai messaggi da inviare su App IO.
A tale proposito, con la versione di rilascio indicata ad inizio pagina, vengono messi a disposizione già alcuni template di base attestati sul device di sistema "IO", pensati per le seguenti principali casistiche d'uso di comunicazioni su App IO per gli studenti:
Caso d'uso | Eventi applicativi di Esse3 |
---|---|
Emissione avviso di pagamento pagoPA | 05_253_AVVISO_PAGOPA |
Avviso di scadenza tasse universitarie | PREAVVISO_SCAD_TAX |
Avvenuto pagamento tasse universitarie | 05_021 |
Avviso di rimborso tasse universitarie | 05_038 |
Recupero ISEE | 05_056 |
Avvenuta presentazione domanda di concorso | CONC_ISCR |
Pubblicazione graduatoria, scadenza e link per immatricolazione | COM_GRAD_AB |
Prenotazione esame di profitto | PREN_ISCR |
Pubblicazione esiti esame di profitto/Gestione verbali | 10_018_PUBBL_ESITI |
Registrazione conseguimento titolo | LAU_PRES_DCT_STUD |
Consegna pergamena a seguito di conseguimento titolo | LAU_SPED_PERGA |
Avvenuta sospensione di carriera universitaria | 04_425_APPR_DSOSP |
Avvenuta decadenza dalla carriera universitaria | 04_036_DECADENDI |
Chiusura carriera universitaria | 04_032 |
Per ulteriori dettagli su questi eventi applicativi/template e la loro configurazione si veda Esse3_notifiche_appIO.xlsx
I template di base rilasciati in automatico sono template di sistema
Per creare la versione personalizzata del template, come di consueto, utilizzare la funzione di "duplicazione" (icona con il lucchetto) sul template di sistema di base. Nel momento in cui si finisce di configurare il template e lo si attiva, ricordarsi di verificare anche che l'evento applicativo a cui fa riferimento sia abilitato (la lista fornita in precedenza è di carattere generale, ogni ateneo potrebbero avere abilitati solo alcuni degli eventi applicativi indicati, differenti da quelli abilitati su altri). |
Oltre ai template di base predefiniti, è sempre possibile su qualunque evento applicativo aggiungere liberamente un nuovo template per un device di tipo IO. In tal caso la principale accortezza di cui tenere conto è la seguente:
|
Per quel che riguarda il contenuto dei messaggi, App IO prevede l'utilizzo di testo semplice (no HTML) con in più il riconoscimento di alcune notazioni markdown per applicare formattazioni di base del tipo:
Di conseguenza la maschera di configurazione del template, nel caso in cui venga selezionato un device di tipo IO, non consente di impostare contenuto HTML e rendere invece disponibile un nuovo pulsante di "Anteprima contenuto" (riconoscibile dall'icona con l'occhio) cliccando il quale si apre appunto una finestra che mostra un esempio di come verrebbe visualizzato il messaggio finale su App IO, interpretando le formattazioni markdown eventualmente presenti nel testo.
Inoltre, sempre nel caso di device di tipo IO, si applicano anche le seguenti ulteriori logiche:
Come accennato in precedenza, la spedizione dei messaggi su device di tipologia IO si appoggia al servizio Notification Manager: in particolare si tratta di processo asincrono, ovvero Esse3 inoltra il messaggio a Notification Manager che lo prende in carico ma non ne efffettua l'invio istantaneamente, lo accoda per effettuarne la spedizione appena possibile. In seguito, ad invio avvenuto, sarà disponibilie l'esito finale.
In generale vi sarà quindi un frangente di tempo durante il quale la spedizione di un messaggio su device IO per un dato destinatario risulta nello stato di "in attesa esito", evidenziato da un'apposita icona a forma di pallino giallo e con descrizione "Inoltrato a Notification Manager":
Il recupero dell'esito finale può avvenire in due modi:
Una volta recepito l'esito viene di conseguenza aggiornato su Esse3 lo stato di spedizione della comunicazione per il destinatario.
In caso di errore viene riportata anche la motivazione con gli eventuali dettagli disponibili (visualizzabili per esteso aprendo la finestra di dettaglio, cliccando sull'icona con la lente di ingrandimento a fianco del testo):
Nel caso in cui l'invio del messaggio sia avvenuto con successo lo stato di spedizione comparirà come di consueto con l'icona verde e senza alcuna indicazione di errore:
Ad invio effettuato con successo dovrebbe corrispondere la ricezione su App IO, da parte del destinatario, del relativo messaggio:
Nella versione 23.10.00.00 di Esse3, per gli atenei che hanno sottoscritto con App IO un contratto di tipo Premium, sono state introdotte alcune funzionalità a supporto.
Tra le configurazioni di un device di tipo IO è possibile abilitare l'utilizzo delle funzioni Premium sull'invio dei messaggi, facendo uso dell'apposito flag:
Il flag Premium, sulla configurazione del device, va alzato solo se effettivamente si è sottoscritto un contratto Premium con App IO. Nel caso si abiliti tale impostazione in presenza di una sottoscrizione che invece non prevede le funzioni Premium l'invio dei messaggi potrebbe terminare in errore. |
Una volta abilitata tale configurazione, per i messaggi inviati in modalità Premium è possibile avere un'informazione in più di ritorno:
Tale informazione in Esse3, nel caso di device App IO con funzioni Premium, è mostrata a livello di destinatario della comunicazione nella colonna con intestazione "Lett.":
Visivamente lo stato di lettura è rappresentato da apposite icone, le casistiche possibili sono quelle indicate nella seguente tabella.
Icona | Significato |
---|---|
informazione non disponibile (il destinatario ha disabilitato le notifiche di lettura) | |
(nessuna) | messaggio non ancora letto dal destinatario |
messaggio letto dal destinatario |