Sommario
| Table of Contents |
|---|
Il sistema prevede l'invio di messaggistica email automatica all'occorrenza di specifici eventi.
Eventi che producono messaggistica
Completamento del processo di censimento
| Note |
|---|
| Solo se è attivo un workflow di validazione per il contesto e la tipologia di prodotto censito |
viene inviata a tutti gli autori riconosciuti del prodotto la mail di cui al template coauthors_submit
# 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
Validazione del prodotto
| Note |
|---|
| questa mail viene inviata indipendentemente dalla presenza di un workflow attivo sul contesto e/o tipologia del prodotto. In caso di assenza di workflow esplicito lo stesso viene infatti concluso con lo status "inactive" |
al completamento del workflow viene inviata a tutti gli autori riconosciuti del prodotto la mail di cui al template coauthors_archive
# 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
negli step intermedi di workflow vengono inviate email al responsabile del dato e agli autori riconosciuti in caso di riapertura del prodotto (reject) e in caso di approvazione con cambio di visibilità della scheda sul portale pubblico. La mail di approvazione non viene inviata se si tratta dell'ultimo step di workflow nel qual caso viene inviata la mail di archiviazione precedente.
Il template utilizzato per la riapertura è submit_reject
# 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
mentre quello utilizzato in approvazione se si modifica la visibilità della scheda sul portale pubblico coauthors_workflow_changedissemination
# 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
| Note |
|---|
| In caso di approvazione senza modifica della visibilità della scheda sul portale pubblico non viene inviata alcuna email |
Modifica visibilità del prodotto sul portale pubblico
Se un'amministratore modifica la visibilità di un prodotto sul portale pubblico (cfr. funzionalità "Modifica visibilità scheda") viene inviata a tutti gli autori riconosciuti del prodotto la mail di cui al template coauthors_changedissemination
# coauthors_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
Request a copy
La funzionalità request a copy prevede l'invio di mail nei seguenti casi
- inserimento della richiesta: inviata al responsabile del dato, template:request_item.author
- approvazione/rifiuto della richiesta: inviata al richiedente, template: modifcabile da chi autorizza/nega l'invio della copia
- richiesta agli amministratori di modifica delle policy in Open Access: inviata su richiesta di chi autorizza l'invio della copia agli amministratori, template: request_item.admin
Modulo ER
Di seguito viene descritto come gestire il template della mail inviate dal Modulo Evaluation and Review
Invia mail in caso di rifiuto
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}
Invia mail e disabilita questionari in caso di rifiuto
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}Personalizzazione dei template
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:
# {0} Name of collection
# {1} Citation of submission
# {2} Submitter's name
# {3} Handle
# {4} Dissemination option
# {5} public url
contestualizzati alla pubblicazione che si sta notificando. Su ogni template a meno di omissioni devono essere presenti gli argomenti che possono essere utilizzati per visualizzarli sulla email.
I nomi dei nuovi template coinvolti sono "submit_task_doct" (mail inviata al termine della submission al dottorando) e "submit_archive_adv" (mail inviata al relatore dopo la validazione definitiva). Ricordiamo dell'esistenza del template "submit_task_adv" inviata al relatore a fine submission. Questi template possono essere attivati/disattivati su esplicita richiesta e riguardano solo la tipologia delle tesi di dottorato.
# 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