Messaggistica di sistema
Introduzione
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.
Modifica dei template
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
Identificativo messaggio
Wiki Markup |
---|
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. |
Subject
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).
Parametri
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
MODULO IR
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.
MAIL.TEMPLATE.COAUTHORS_ARCHIVE
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
Wiki Markup 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
MAIL.TEMPLATE. COAUTHORS_CHANGEDISSEMINATION
Ambito: Workflow non attivo
Descrizione evento: Modifica visibilità sul portale pubblico di un 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
TemplateWiki Markup 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
MAIL.TEMPLATE. COAUTHORS_ARCHIVE_INTEGRA
Ambito: Workflow non attivo
Descrizione evento: Integrazione di un 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
TemplateWiki Markup 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
MAIL.TEMPLATE. COAUTHORS_ARCHIVE_WORKFLOW
Ambito: Workflow attivo
Descrizione evento: Censimento 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
TemplateWiki Markup 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
MAIL.TEMPLATE. SUBMIT_TASK
Ambito: Workflow attivo
Descrizione evento: Inserimento di una nuova pubblicazione da validare
Destinatari: Membri del gruppo di validazione
Parametri:
· {0} Title of submission
· {1} Name of collection
· {2} submitter's name
· {3} Description of task
· {4} link to 'my DSpace' page
TemplateWiki Markup 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
MAIL.TEMPLATE. COAUTHORS_SUBMIT
Ambito: Workflow attivo
Descrizione evento: Inserimento in Archivio di una nuova pubblicazione
Destinatari: Autori interni
Parametri:
· {0} Name of collection
· {1} Citation of submission
· {2} Submitter's name
· {3} Handle
· {4} Dissemination option
· {5} public url
TemplateWiki Markup 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
MAIL.TEMPLATE. SUBMIT_ARCHIVE
Ambito: Workflow attivo
Descrizione evento: Inserimento in Archivio di una nuova pubblicazione
Destinatari: Responsabile del dato
Parametri:
· {0} Title of submission
· {1} Name of collection
· {2} handle
TemplateWiki Markup 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
MAIL.TEMPLATE. SUBMIT_REJECT
Ambito: Workflow attivo
Descrizione evento: Rifiuto di validazione di un prodotto
Destinatari: Responsabile del dato
Parametri:
· {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
TemplateWiki Markup 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
MAIL.TEMPLATE. SUBMITTER_WF3
Ambito: Workflow attivo
Descrizione evento: Inserimento in Archivio di una nuova pubblicazione. Valido solo in caso di attivazione workflow di validazione a 3 step
Destinatari: Responsabile del dato
Parametri:
· {0} Name of collection
· {1} Citation of submission
· {2} Submitter's name
· {3} Handle
· {4} Dissemination option
· {5} public url
TemplateWiki Markup 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
MAIL.TEMPLATE. COAUTHORS_WORKFLOW_CHANGEDISSEMINATION
Ambito: Workflow attivo
Descrizione evento: Modifica visibilità sul portale pubblico di un prodotto
Destinatari: Autori interni
Parametri:
· {0} Name of collection
· {1} Citation of submission
· {2} Submitter's name
· {3} Handle
· {4} Dissemination option
· {5} public url
TemplateWiki Markup 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 * *
MAIL.TEMPLATE. COAUTHORS_SUBMIT_INTEGRA
Ambito: Workflow attivo
Descrizione evento: Modifica Integrazione di un prodotto
Destinatari: Autori interni
Parametri:
· {0} Name of collection
· {1} Citation of submission
· {2} Submitter's name
· {3} Handle
· {4} Dissemination option
· {5} public url
TemplateWiki Markup 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!
MAIL.TEMPLATE. SUBMIT_TASK_DOCT
Ambito: Tesi di dottorato
Descrizione evento: Tesi depositata in attesa di pubblicazione
Destinatari: Responsabile del dato (dottorando)
Parametri:
· {0} Title of submission
· {1} Submitter's name
· {2} collection's name
· {3} handle
TemplateWiki Markup 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
MAIL.TEMPLATE. SUBMIT_TASK_ADV
Ambito: Tesi di dottorato
Descrizione evento: Tesi depositata in attesa di pubblicazione
Destinatari: Relatore
Parametri:
· {0} Title of submission
· {1} Submitter's name
· {2} collection's name
· {3} handle
TemplateWiki Markup 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
MAIL.TEMPLATE. SUBMIT_ARCHIVE_ADV
Ambito: Tesi di dottorato
Descrizione evento: Archiviazione di una Tesi di Dottorato
Destinatari: Relatore
Parametri:
· {0} Title of submission
· {1} Submitter's name
· {2} collection's name
· {3} handle
TemplateWiki Markup 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
MAIL.TEMPLATE. REQUEST_ITEM.ADMIN
Ambito:
Descrizione evento: Richiesta della copia di un fulltext senza policy Open Access
Destinatari: Responsabile del dato o mail amministratore
Parametri:
· {0} fiel ID
· {1} handle
· {2} Token
· {3} Requester's name
· {4} Requester's email
Template
Subject: Request for Open Access {3}, with address {4}, requested the following document/file to be in Open Access: Document Handle:{1} File ID: {0} Token:{2}
MAIL.TEMPLATE. REQUEST_ITEM.AUTHOR
Ambito:
Descrizione evento: Richiesta della copia di un fulltext senza policy Open Access
Destinatari: Autore interno del prodotto o mail ammimnistratore
Parametri:
· {0} Requester's name
· {1} Requester's email
· {2} Token
· {3} Citation
· {4} Title
· {5} Request message
· {6} Link to answer
· {7} Internal Author
Template
Subject: Request copy of document Dear {7}, A user of {9}, named {0} and using the email {1}, requested a copy of the file(s) associated with the document: "{4}" ({3}) submitted by you. This request came along with the following message: "{5}" To answer, click {6} Whether you choose to grant or deny the request, we think that it''s in your best interest to respond. IF YOU ARE NOT AN AUTHOR OF THIS DOCUMENT, and only submitted the document on the author''s behalf, PLEASE REDIRECT THIS MESSAGE TO THE AUTHOR(S). Only the author(s) should answer the request to send a copy. IF YOU ARE AN AUTHOR OF THE REQUESTED DOCUMENT, thank you for your cooperation! If you have any questions concerning this request, please contact {10}.
Il sistema prevede l'invio di messaggistica email automatica all'occorrenza di specifici eventi.
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
Wiki Markup |
---|
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.