Configurazione di Email Notification

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:

• Gli utenti devono avere un indirizzo e-mail valido definito nel suo profilo.
• Il Day CQ Mail Service deve essere configurato correttamente.

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.

Configurazione di Mail Service

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:

Configurazione del canale di notifica e-mail

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:

1. In CRXDE Lite, aggiungete una cartella denominata config sotto la cartella dell’applicazione.

2. Nella cartella di configurazione, aggiungete un nodo denominato:

   com.day.cq.wcm.notification.email.impl.EmailChannel di tipo sling:OsgiConfig

3. Aggiungete una proprietà String al nodo denominato email.from. Per il valore, specificate l'indirizzo e-mail che desiderate utilizzare.

4. Fare clic su Salva tutto.

Utilizzate la procedura seguente per definire il nodo nelle cartelle di origine del pacchetto di contenuto:

1. In jcr_root/apps/*app_name*/config folder, create un file denominato com.day.cq.wcm.notification.email.impl.EmailChannel.xml

2. 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"/>

3. Sostituite il valore dell'attributo email.from ( name@server.com) con l'indirizzo e-mail.

4. Salvate il file.

Configurazione del servizio di notifica e-mail flusso di lavoro

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:

Modelli e-mail per notifica pagina

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.

Personalizzazione dei modelli e-mail per la notifica della pagina

Per personalizzare il modello e-mail inglese per la notifica della pagina:

1. In CRXDE, aprite il file:

   /etc/notification/email/default/com.day.cq.wcm.core.page/en.txt

2. Modificate il file in base alle vostre esigenze.

3. 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

Modelli e-mail per notifica forum

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.

Personalizzazione dei modelli e-mail per la notifica del forum

Per personalizzare il modello e-mail inglese per la notifica del forum:

1. In CRXDE, aprite il file:

   /etc/notification/email/default/com.day.cq.collab.forum/en.txt

2. Modificate il file in base alle vostre esigenze.

3. 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.

Modelli e-mail per notifica flusso di lavoro

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.

Personalizzazione dei modelli e-mail per la notifica del flusso di lavoro

Per personalizzare il modello e-mail inglese per la notifica dell'evento del flusso di lavoro:

1. In CRXDE, aprite il file:

   /etc/workflow/notification/email/default/en.txt

2. Modificate il file in base alle vostre esigenze.

3. Salva le modifiche.

Il modello deve avere il formato seguente:

subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

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

Aggiunta di un modello e-mail per una nuova lingua

Per aggiungere un modello per una nuova lingua:

1. 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 lavoro

2. Adattare il file alla lingua.

3. Salva le modifiche.

Configurazione notifiche e-mail AEM Assets

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.

1. Configurate il servizio e-mail, come descritto sopra in Configurazione del servizio e-mail.
2. Accedete a AEM come amministratore. Fare clic su Strumenti > Operazioni > Console Web per aprire Configurazione console Web.
3. Modificare Giorno CQ DAM Resource Collection Servlet. Selezionare Invia e-mail. Fai clic su Salva.