Il funzionamento standard di IRIS pervede l'invio di messaggi di notifica a seguito di specifici eventi. I messaggi sono rivolti a profili differenti a seconda della tipologia di evento. La maggior parte dei messaggi inviati da IRIS sono personalizzabili. E' possibile configurare l'Archivio per fare in modo che l'invio di alcuni messaggi vengano inibiti oppure vengano spediti a determinati gruppi di utenti. Inoltre è possibile modificare il template dei messaggi inviati attraverso il modulo di gestione delle etichette.
La modifica dei template dei messaggi inviati da IRIS avviene attraverso il modulo di gestione delle etichette. Per accedervi occorre essere loggati in visione completa e portarsi in Configurazione, Gestione Etichette, Cerca etichette default.
Attraverso la form successiva è possibile cercare il messaggio che si vuole modificare. Ulteriori dettagli sull'utilizzo del modulo di gestione etichette sono disponibili nella seguente guida:
xxx
Le chiavi di tutti i messaggi inviati da IRIS hanno la segente sintassi *MAIL.TEMPLATE.\[IDENTIFICATIVO_TEMPLATE\]* L'elenco degli identificativi dei vari temlpate è indicato di seguito. |
Il soggetto della mail è gestito tramite il placeholder "Subject". Si tratta di una parola speciale utile al sistema all'identificazione del soggetto della mail. Il sistema calcola il soggetto della mail dal placeholder "Subject" fino al primo "\n" (carattere a capo).
Ciascun template è composto da una parte di testo e una serie di parametri. I parametri sono utilizzabili secondo la seguente sintassi:
{numero_parametro}
Di seguito vengono illustrati i messaggi inviati da IRIS
Nell'excel allegato sono riassunti i messaggi inviati dal modulo IR. Viene specificata la chiave di identificazione del messaggio, l'ambito di invio, l'evento che scatena l'invio, i destinatari e il template di default, compresi i parametri a disposizione.
Ambito: Workflow non attivo
Descrizione evento: Censimento e archiviazione di un nuovo prodotto
Destinatari: Autori interni del prodotto
Parametri:
· {0} Name of collection
· {1} Citation of submission
· {2} Submitter's name
· {3} Handle
· {4} Dissemination option
· {5} public url
Template
coauthors_archive # # Item Archived (coauthors) email message # # \{0\} Name of collection # \{1\} Citation of submission # \{2\} Submitter's name # \{3\} Handle # \{4\} Dissemination option # \{5\} public url # Subject: \[IRIS\]: Inserimento definitivo registrazione E'' stata inserita in via definitiva in IRIS la registrazione relativa a: \{1\} di cui Lei e'' uno degli autori. La registrazione e'' stata immessa da \{2\} nella tipologia \{0\}. \{4\} Link alla pubblicazione: \{5\} La ringraziamo per la collaborazione -------------------------------------------------- IRIS Team
|
coauthors_archive_changedissemination # # Change dissemination value (coauthor) email message # # \{0\} Name of collection # \{1\} Citation of submission # \{2\} Submitter's name # \{3\} Handle # \{4\} Dissemination option # \{5\} public url # Subject: \[IRIS\]: Cambio visibilita'' prodotto sul portale pubblico E'' stata cambiata da parte degli operatori la visibilita'' della scheda: \{1\} di cui Lei e'' uno degli autori. \{4\} Link alla pubblicazione: \{5\} -------------------------------------------------- IRIS Team
|
coauthors_archive # # Item Archived (coauthors) email message # # \{0\} Name of collection # \{1\} Citation of submission # \{2\} Submitter's name # \{3\} Handle # \{4\} Dissemination option # \{5\} public url # Subject: \[IRIS\]: Aggiornamento registrazione E'' stata aggiornata e inserita in via definitiva in IRIS la registrazione relativa a: \{1\} di cui Lei e'' uno degli autori. L''aggiornamento e'' stato inserito da \{2\} nella tipologia \{0\}. \{4\} Link alla pubblicazione: \{5\} La ringraziamo per la collaborazione -------------------------------------------------- IRIS Team
|
coauthors_archive # # Item Archived (coauthors) email message # # \{0\} Name of collection # \{1\} Citation of submission # \{2\} Submitter's name # \{3\} Handle # \{4\} Dissemination option # \{5\} public url # Subject: \[IRIS\]: Registrazione validata E'' stata validata in IRIS la registrazione relativa a: \{1\} di cui Lei e'' autore. La registrazione e'' stata immessa da \{2\} nella tipologia \{0\}. La scheda e'' visibile sul portale pubblico al link: \{5\} -------------------------------------------------- IRIS Team
|
Workflow task email message # # \{0\} Title of submission # \{1\} Name of collection # \{2\} submitter's name # \{3\} Description of task # \{4\} link to 'my DSpace' page # Subject: \[IRIS\]: Nuova registrazione da validare Dettaglio registrazione: Titolo: \{0\} Tipologia: \{1\} Responsabile scheda: \{2\} \{3\} Accedi al desktop prodotti con la visione operativa al link: \{4\} -------------------------------------------------- IRIS Team
|
coauthors_submit_deposit # # Workflow (coauthor) email message # # \{0\} Name of collection # \{1\} Citation of submission # \{2\} Submitter's name # \{3\} Handle # \{4\} Dissemination option # \{5\} public url # Subject: \[IRIS\]: Inserimento nuovo prodotto E'' stata inserita la registrazione relativa a: \{1\} di cui Lei e'' uno degli autori. La registrazione e'' stata immessa da \{2\} nella tipologia \{0\}. \{4\} Link alla pubblicazione: \{5\} Non e'' necessario quindi che Lei immetta una nuova registrazione per il lavoro in questione. -------------------------------------------------- IRIS Team
|
Item Archived email message # # \{0\} Title of submission # \{1\} Name of collection # \{2\} handle # Subject: \[IRIS\]: Registrazione disponibile sul portale pubblico La registrazione da lei inserita relativa a: \{0\} nella tipologia: \{1\} E'' stata verificata e pubblicata sul portale IRIS. L''handle della pubblicazione è: \{2\} -------------------------------------------------- IRIS Team
|
Rejection email message # # \{0\} Title of submission # \{1\} Name of collection # \{2\} Name of the rejector # \{3\} Reason for the rejection # \{4\} Link to 'My DSpace' page # \{5\} Dissemination's option # Subject: \[IRIS\]: Registrazione riaperta in validazione Titolo: \{0\} Tipologia: \{1\} \{5\} La registrazione e'' stata riaperta in validazione con la seguente motivazione: \{3\} da \{2\} Per accedere alla registrazione accedi al desktop prodotti al link: \{4\} -------------------------------------------------- IRIS Team
|
submitter_submit # # submission email message # # \{0\} Name of collection # \{1\} Citation of submission # \{2\} Submitter's name # \{3\} Handle # \{4\} Dissemination option # \{5\} public url # Subject: \[IRIS\]: Submission completata E'' stata approvata la submission relativa a: \{1\} La registrazione e'' stata immessa da \{2\} nella tipologia \{0\}. \{4\} Link alla pubblicazione: \{5\} -------------------------------------------------- IRIS Team
|
coauthors_archive_changedissemination # # Change dissemination value (coauthor) email message # # \{0\} Name of collection # \{1\} Citation of submission # \{2\} Submitter's name # \{3\} Handle # \{4\} Dissemination option # \{5\} public url # Subject: \[IRIS\]: Cambio visibilita'' prodotto E'' stata cambiata da parte degli operatori la visibilita'' della scheda: \{1\} di cui Lei e'' uno degli autori. \{4\} Link alla pubblicazione: \{5\} -------------------------------------------------- IRIS Team
* * |
coauthors_submit_integra # # Modifica/Integra (coauthor) email message # # \{0\} Name of collection # \{1\} Citation of submission # \{2\} Submitter's name # \{3\} Handle # \{4\} Dissemination option # \{5\} public url # Subject: \[IRIS\]: Riapertura per modifiche registrazione E'' in corso di revisione da parte degli operatori la registrazione relativa a: \{1\} di cui Lei e'' uno degli autori. La registrazione e'' stata immessa da \{2\} nella tipologia \{0\}. \{4\} Link alla pubblicazione: \{5\} In seguito Le sara'' inviata conferma dell''inserimento. -------------------------------------------------- IRIS Team
* *
Di seguito un immagine che riassume gli eventi principali che interessano il workflow dei prodotti
!worddavb9047fe7762d53e3deee1dff34148f3e.png|height=464,width=468!
|
submit_task_doct # # End of submission for thesis email message # # \{0\} Title of submission # \{1\} Submitter's name # \{2\} collection's name # \{3\} handle # Subject: \[IRIS\]: Tesi depositata in attesa di pubblicazione E'' stata inserita la registrazione relativa alla seguente tesi: \{0\} di cui Lei e'' l''autore. -------------------------------------------------- IRIS Team
|
submit_task_adv # # Workflow task email message # # \{0\} Title of submission # \{1\} Submitter's name # \{2\} collection's name # \{3\} handle # Subject: \[IRIS\]: Tesi depositata dal dottorando E'' stata inserita la registrazione relativa alla seguente tesi: \{0\} di cui Lei e'' relatore. La registrazione e'' stata immessa da \{1\} -------------------------------------------------- IRIS Team
|
submit_archive_adv # # Workflow archive email message # # \{0\} Title of submission # \{1\} Submitter's name # \{2\} collection's name # \{3\} handle Subject: \[IRIS\]: Registrazione tesi E'' stata rivista e inserita la registrazione relativa a: \{0\} immessa da \{1\} nella tipologia \{2\} L''handle assegnato e'' \{3\} -------------------------------------------------- IRIS Team
|
Di seguito viene descritto come gestire il template della mail inviate dal Modulo Evaluation and Review
Nel caso di utilizzo della logica di rifiuto "invia mail in caso di rifiuto" verrà inviata una mail utilizzando come oggetto la label "mail.er.rejectSingle.object" e come testo la label "mail.er.rejectSingle.body"
I parametri utilizzabili sono:
{0}: nome valutatore
{1}: utente valutatore
{2}: nome sessione
{3}: motivo del rifiuto
{4}: nome del progetto
I testi di default (sostituibili tramite gestione etichette) sono:
mail.er.rejectAll.object=Rifiuto della compilazione del questionario {0}
mail.er.rejectAll.body=L''utente {0} ({1}) ha rifiutato la compilazione del questionario {2} - {4}, con la seguente motivazione:<br/>{3}<br/>Tutti i questionari di quest''area associati all''utente sono stati disabilitati
mail.er.rejectSingle.object=Rifiuto della compilazione del questionario {0}
mail.er.rejectSingle.body=L''utente {0} ({1}) ha rifiutato la compilazione del questionario {2} - {4}, con la seguente motivazione:<br/>{3}
Nel caso di utilizzo della logica di rifiuto "invia mail e disabilita questionari in caso di rifiuto" verrà inviata una mail utilizzando come oggetto la label "mail.er.rejectAll.object" e come testo la label "mail.er.rejectAll.body". I parametri utilizzabili sono:
{0}: nome valutatore
{1}: utente valutatore
{2}: nome sessione
{3}: motivo del rifiuto
{4}: nome del progetto
I testi di default (sostituibili tramite gestione etichette) sono:
mail.er.rejectAll.object=Rifiuto della compilazione del questionario {0}
mail.er.rejectAll.body=L''utente {0} ({1}) ha rifiutato la compilazione del questionario {2} - {4}, con la seguente motivazione:<br/>{3}<br/>Tutti i questionari di quest''area associati all''utente sono stati disabilitati
mail.er.rejectSingle.object=Rifiuto della compilazione del questionario {0}
mail.er.rejectSingle.body=L''utente {0} ({1}) ha rifiutato la compilazione del questionario {2} - {4}, con la seguente motivazione:<br/>{3}
E' possibile la personalizzazione del template email seguendo alcune linee guide di seguito descritte. Per personalizzare un template email occorre aggiungere (e NON modificare) la chiave perché di default il template è preso su un file e di conseguenza la chiave sull'i18n non esiste se non è stata personalizzata precedentemente.
La chiave per il recupero dall'i18n è costruita partendo dal nome del file: se il template dell'email ha nome: coauthors_archive, la chiave da inserire sull'i18n è mail.template.coauthors_archive Esempio di personalizzazione del template coauthors_submit sul file dell'i18n: mail.template.coauthors_submit = Subject: \[TEST\]: Inserimento nuovo prodotto \n E'' stata inserita la registrazione relativa a: \n\{1\} \n di cui Lei e'' uno degli autori. \n La registrazione e'' stata immessa da \{2\} \n nella tipologia \{0\}. \n \{4\} \n Link alla pubblicazione: \{5\} \n Non e'' necessario quindi che Lei immetta una nuova registrazione per il \n lavoro in questione. \n -------------------------------------------------- \n IRIS Team
E' obbligatorio inserire la parola "Subject:" perché si tratta di un placeholder. Tale requisito è necessario per inserire l'oggetto della email (in questo caso "\[TEST\]: Inserimento nuovo prodotto"); l'applicativo calcola l'oggetto della email immediatamente dopo la parola "Subject:" fino a fine linea individuato con il "\n".
Tutto il resto fa parte del corpo della email dove i vari parametri contestualizzati all'item sono spiegati su wiki per ogni template (\{1\} etc..etc...).
Occorre ricordare che non vengono processate le linee che iniziano con "#". Dopo il fix è possibile personalizzare i template seguendo le operazioni Gestione etichette che prevedono le seguenti operazioni: esportazione del file, inserimento della chiave mancante e importazione del file. Per rendere effettiva la modifica si deve selezionare il pulsante dedicato Ricarica etichette.
Di seguito un esempio degli argomenti descritti su ogni template: |