AEM invia notifiche e-mail agli utenti che:
Hanno effettuato la sottoscrizione a eventi di pagina, ad esempio modifiche o replica. La sezione Inbox notifica descrive come effettuare la sottoscrizione a tali eventi.
Hanno effettuato la sottoscrizione agli eventi forum.
Eseguire un passaggio in un flusso di lavoro. La sezione Passo partecipante descrive come attivare la notifica e-mail in un flusso di lavoro.
Prerequisiti:
Quando un utente riceve una notifica, riceve un messaggio e-mail nella lingua definita nel suo profilo. Ogni lingua ha un proprio modello che può essere personalizzato. È possibile aggiungere nuovi modelli di e-mail per le nuove lingue.
Quando lavorate con AEM esistono diversi metodi per gestire le impostazioni di configurazione di tali servizi; per ulteriori informazioni e procedure consigliate, vedere Configurazione di OSGi.
Per AEM poter inviare e-mail, è necessario configurare correttamente il Day CQ Mail Service. Potete visualizzare la configurazione nella console Web. Quando lavorate con AEM esistono diversi metodi per gestire le impostazioni di configurazione di tali servizi; per ulteriori informazioni e procedure consigliate, vedere Configurazione di OSGi.
Si applicano i seguenti vincoli:
La porta del server SMTP deve essere uguale o superiore a 25.
Il nome host del server SMTP non deve essere vuoto.
L'indirizzo "From" non deve essere vuoto.
Per risolvere un problema con il servizio Day CQ Mail Service, è possibile controllare i registri del servizio:
com.day.cq.mailer.DefaultMailService
Nella console Web, la configurazione è la seguente:
Quando vi iscrivete alle notifiche degli eventi di pagina o forum, l’indirizzo e-mail è impostato su no-reply@acme.com
per impostazione predefinita. Puoi modificare questo valore configurando il servizio Canale e-mail di notifica nella console Web.
Per configurare l'indirizzo e-mail, aggiungere un nodo sling:OsgiConfig
alla directory archivio. Utilizzare la procedura seguente per aggiungere il nodo direttamente utilizzando CRXDE Lite:
In CRXDE Lite, aggiungete una cartella denominata config
sotto la cartella dell’applicazione.
Nella cartella di configurazione, aggiungete un nodo denominato:
com.day.cq.wcm.notification.email.impl.EmailChannel
di tipo sling:OsgiConfig
Aggiungete una proprietà String
al nodo denominato email.from
. Per il valore, specificate l'indirizzo e-mail che desiderate utilizzare.
Fare clic su Salva tutto.
Utilizzate la procedura seguente per definire il nodo nelle cartelle di origine del pacchetto di contenuto:
In jcr_root/apps/*app_name*/config folder
, create un file denominato com.day.cq.wcm.notification.email.impl.EmailChannel.xml
Aggiungete il seguente codice XML per rappresentare il nodo:
<?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" jcr:primaryType="sling:OsgiConfig" email.from="name@server.com"/>
Sostituite il valore dell'attributo email.from
( name@server.com
) con l'indirizzo e-mail.
Salvate il file.
Quando ricevete notifiche e-mail dal flusso di lavoro, sia l’indirizzo e-mail che il prefisso dell’URL dell’host vengono impostati sui valori predefiniti. Potete modificare questi valori configurando il Day CQ Workflow Notification Service nella console Web. In questo caso, si consiglia di mantenere la modifica nella directory archivio.
Nella console Web la configurazione predefinita è la seguente:
Di seguito sono riportati i modelli e-mail per le notifiche della pagina:
/etc/notification/email/default/com.day.cq.wcm.core.page
Il modello inglese predefinito ( en.txt
) è definito come segue:
subject=[CQ Page Event Notification]: Page Event
header=-------------------------------------------------------------------------------------\n \
Time: ${time}\n \
User: ${userFullName} (${userId})\n \
-------------------------------------------------------------------------------------\n\n
message=The following pages were affected by the event: \n \
\n \
${modifications} \n \
\n\n
footer=\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.
Per personalizzare il modello e-mail inglese per la notifica della pagina:
In CRXDE, aprite il file:
/etc/notification/email/default/com.day.cq.wcm.core.page/en.txt
Modificate il file in base alle vostre esigenze.
Salva le modifiche.
Il modello deve avere il formato seguente:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
Dove <text_x> può essere un mix di testo statico e variabili di stringa dinamiche. Le seguenti variabili possono essere utilizzate nel modello e-mail per le notifiche di pagina:
${time}
, la data e l’ora dell’evento.
${userFullName}
, il nome completo dell'utente che ha attivato l'evento.
${userId}
, l'ID dell'utente che ha attivato l'evento.
${modifications}
, descrive il tipo di evento pagina e il percorso della pagina nel formato:
<page event="" type=""> => <page path="">
Esempio:
PageModified => /content/geometrixx/en/products
I modelli e-mail per le notifiche dei forum si trovano in:
/etc/notification/email/default/com.day.cq.collab.forum
Il modello inglese predefinito ( en.txt
) è definito come segue:
subject=[CQ Forum Notification]
header=-------------------------------------------------------------------------------------\n \
Time: Time: ${time}\n \
Forum Page Path: ${forum.path}\n \
-------------------------------------------------------------------------------------\n\n
message=Page: ${host.prefix}${forum.path}.html\n
footer=\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.
Per personalizzare il modello e-mail inglese per la notifica del forum:
In CRXDE, aprite il file:
/etc/notification/email/default/com.day.cq.collab.forum/en.txt
Modificate il file in base alle vostre esigenze.
Salva le modifiche.
Il modello deve avere il formato seguente:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
Dove <text_x>
può essere un mix di testo statico e variabili stringa dinamiche.
Le seguenti variabili possono essere utilizzate nel modello e-mail per le notifiche del forum:
${time}
, la data e l’ora dell’evento.
${forum.path}
, il percorso della pagina del forum.
Il modello e-mail per le notifiche del flusso di lavoro (inglese) si trova in:
/etc/workflow/notification/email/default/en.txt
È definito come segue:
subject=Workflow notification: ${event.EventType}
header=-------------------------------------------------------------------------------------\n \
Time: ${event.TimeStamp}\n \
Step: ${item.node.title}\n \
User: ${participant.name} (${participant.id})\n \
Workflow: ${model.title}\n \
-------------------------------------------------------------------------------------\n\n
message=Content: ${host.prefix}${payload.path.open}\n
footer=\n \
-------------------------------------------------------------------------------------\n \
View the overview in your ${host.prefix}/aem/inbox\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.
Per personalizzare il modello e-mail inglese per la notifica dell'evento del flusso di lavoro:
In CRXDE, aprite il file:
/etc/workflow/notification/email/default/en.txt
Modificate il file in base alle vostre esigenze.
Salva le modifiche.
Il modello deve avere il formato seguente:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
Dove <text_x>
può essere un mix di testo statico e variabili stringa dinamiche. Ogni riga di un elemento <text_x>
deve essere terminata con una barra rovesciata ( \
), fatta eccezione per l'ultima istanza, quando l'assenza della barra rovesciata indica la fine della variabile di stringa <text_x>
.
Ulteriori informazioni sul formato del modello sono disponibili in javadocs del metodo Properties.load().
Il metodo ${payload.path.open}
rivela il percorso del payload dell'elemento di lavoro. Ad esempio, per una pagina in Sites, payload.path.open
sarà simile a /bin/wcmcommand?cmd=open&path=…
.; senza il nome del server, motivo per cui il modello prepende questo con ${host.prefix}
.
Le seguenti variabili possono essere utilizzate nel modello e-mail:
${event.EventType}
, tipo dell'evento
${event.TimeStamp}
, data e ora dell'evento
${event.User}
, l'utente che ha attivato l'evento
${initiator.home}
, il percorso del nodo iniziatore
${initiator.name}
, il nome dell'iniziatore
${initiator.email}
, indirizzo e-mail del promotore
${item.id}
, l'ID dell'elemento di lavoro
${item.node.id}
, id del nodo nel modello di workflow associato a questo elemento di lavoro
${item.node.title}
, titolo dell'elemento di lavoro
${participant.email}
, indirizzo e-mail del partecipante
${participant.name}
, nome del partecipante
${participant.familyName}
, cognome del partecipante
${participant.id}
id del partecipante
${participant.language}
, la lingua del partecipante
${instance.id}
, l'ID del flusso di lavoro
${instance.state}
, lo stato del flusso di lavoro
${model.title}
, titolo del modello di workflow
${model.id}
, l'ID del modello di workflow
${model.version}
, la versione del modello di workflow
${payload.data}
, il payload
${payload.type}
, il tipo di payload
${payload.path}
, percorso del payload
${host.prefix}
, prefisso dell'host, ad esempio: http://localhost:4502
Per aggiungere un modello per una nuova lingua:
In CRXDE, aggiungete un file <language-code>.txt
sotto:
/etc/notification/email/default/com.day.cq.wcm.core.page
: per le notifiche di pagina/etc/notification/email/default/com.day.cq.collab.forum
: per le notifiche forum/etc/workflow/notification/email/default
: per le notifiche sul flusso di lavoroAdattare il file alla lingua.
Salva le modifiche.
Il <language-code>
utilizzato come nome file per il modello e-mail deve essere un codice della lingua minuscola a due lettere riconosciuto da AEM. Per i codici lingua, AEM si basa su ISO-639-1.
Quando le raccolte in AEM Assets vengono condivise o non condivise, gli utenti possono ricevere notifiche e-mail da AEM. Per configurare le notifiche e-mail, effettuate le seguenti operazioni.