Configurazione della notifica e-mail

AEM invia notifiche e-mail agli utenti che:

  • Si è iscritto a eventi di pagina, ad esempio modifiche o replica. La sezione Inbox notifica descrive come effettuare la sottoscrizione a tali eventi.

  • Si sono abbonati agli eventi del forum.

  • Eseguire un passaggio in un flusso di lavoro. La sezione Passaggio partecipante descrive come attivare la notifica tramite e-mail in un flusso di lavoro.

Prerequisiti:

  • Gli utenti devono avere un indirizzo e-mail valido definito nel suo profilo.
  • È necessario configurare correttamente il Day CQ Mail Service .

Quando un utente viene informato, riceve un’e-mail nella lingua definita nel suo profilo. Ogni lingua ha un proprio modello che può essere personalizzato. È possibile aggiungere nuovi modelli e-mail per le nuove lingue.

NOTA

Quando si lavora con AEM esistono diversi metodi per gestire le impostazioni di configurazione di tali servizi; per ulteriori dettagli e pratiche consigliate, consulta Configurazione di OSGi .

Configurazione del servizio e-mail

Affinché AEM possa inviare e-mail, è necessario configurare correttamente il Day CQ Mail Service . Puoi visualizzare la configurazione nella console Web. Quando si lavora con AEM esistono diversi metodi per gestire le impostazioni di configurazione di tali servizi; per ulteriori dettagli e pratiche consigliate, consulta Configurazione di OSGi .

Si applicano i seguenti vincoli:

  • La porta server SMTP deve essere uguale o superiore a 25.

  • Il nome host del server SMTP non deve essere vuoto.

  • L'indirizzo "Da" non deve essere vuoto.

Per aiutarti a eseguire il debug di un problema con Day CQ Mail Service, puoi guardare i registri del servizio:

com.day.cq.mailer.DefaultMailService

La configurazione si presenta come segue nella console Web:

chlimage_1-276

Configurazione del canale di notifica e-mail

Quando vi abbonate a notifiche di eventi di pagina o forum, l’indirizzo e-mail da è 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 da, aggiungi un nodo sling:OsgiConfig all’archivio. Segui la procedura seguente per aggiungere il nodo direttamente utilizzando CRXDE Lite:

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

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

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

  3. Aggiungi una proprietà String al nodo denominato email.from. Per il valore , specifica l’indirizzo e-mail che desideri utilizzare.

  4. Fare clic su Salva tutto.

Utilizza la seguente procedura per definire il nodo nelle cartelle di origine del pacchetto di contenuti:

  1. Crea un file denominato com.day.cq.wcm.notification.email.impl.EmailChannel.xml nel tuo jcr_root/apps/*app_name*/config folder

  2. Aggiungi il seguente 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. Sostituisci il valore dell'attributo email.from ( name@server.com) con il tuo indirizzo e-mail.

  4. Salva il file.

Configurazione del servizio di notifica e-mail del flusso di lavoro

Quando ricevi notifiche e-mail del flusso di lavoro, sia l’indirizzo e-mail del flusso di lavoro che il prefisso dell’URL dell’host sono impostati sui valori predefiniti. Puoi modificare questi valori configurando il Servizio notifica e-mail flusso di lavoro CQ giornaliero nella console Web. In questo caso, si consiglia di mantenere la modifica nell’archivio.

Nella console Web la configurazione predefinita è la seguente:

chlimage_1-277

Modelli e-mail per notifica pagina

I modelli e-mail per le notifiche di pagina si trovano di seguito:

/libs/settings/notification-templates/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, apri il file:

    /libs/settings/notification-templates/com.day.cq.wcm.core.page/en.txt

  2. Modifica il file in base alle tue esigenze.

  3. Salva le modifiche.

Il modello deve avere il seguente formato:

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

Dove <text_x> può essere un mix di variabili di testo statiche e di stringhe dinamiche. Le seguenti variabili possono essere utilizzate all’interno del 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 notifiche 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, apri il file:

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

  2. Modifica il file in base alle tue esigenze.

  3. Salva le modifiche.

Il modello deve avere il seguente formato:

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

Dove <text_x> può essere un mix di variabili di testo statiche e di stringhe dinamiche.

Le seguenti variabili possono essere utilizzate all'interno del 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 notifiche flusso di lavoro

Il modello e-mail per le notifiche del flusso di lavoro (inglese) si trova in:

/libs/settings/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 le notifiche dei flussi di lavoro

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

  1. In CRXDE, apri il file:

    /libs/settings/workflow/notification/email/default/en.txt

  2. Modifica il file in base alle tue esigenze.

  3. Salva le modifiche.

Il modello deve avere il seguente formato:

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

Dove <text_x> può essere un mix di variabili di testo statiche e di stringhe dinamiche. È necessario terminare ciascuna riga di un elemento <text_x> con una barra inversa ( \), fatta eccezione per l’ultima istanza, quando l’assenza della barra inversa indica la fine della variabile della 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 allora payload.path.open sarà simile a /bin/wcmcommand?cmd=open&path=….; senza il nome del server, motivo per cui il modello ne esegue la preclusione con ${host.prefix}.

Le seguenti variabili possono essere utilizzate all’interno del 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 dell'iniziatore

  • ${item.id}, l'id dell'elemento di lavoro

  • ${item.node.id}, id del nodo nel modello di flusso di lavoro 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 flusso di lavoro

  • ${model.id}, l’id del modello di flusso di lavoro

  • ${model.version}, la versione del modello di flusso di lavoro

  • ${payload.data}, il payload

  • ${payload.type}, il tipo di payload

  • ${payload.path}, percorso del payload

  • ${host.prefix}, prefisso 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, aggiungi un file <language-code>.txt qui sotto:

    • /libs/settings/notification-templates/com.day.cq.wcm.core.page : per le notifiche di pagina
    • /etc/notification/email/default/com.day.cq.collab.forum : per le notifiche sul forum
    • /libs/settings/workflow/notification/email/default : per le notifiche del flusso di lavoro
  2. Adatta il file alla lingua.

  3. Salva le modifiche.

NOTA

Il <language-code> utilizzato come nome del file per il modello e-mail deve essere un codice della lingua minuscola a due lettere riconosciuto da AEM. Per i codici di lingua, AEM si basa su ISO-639-1.

Configurazione delle notifiche e-mail di 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, segui questi passaggi.

  1. Configura il servizio e-mail come descritto sopra in Configurazione del servizio e-mail.
  2. Accedi a AEM come amministratore. Fare clic su Strumenti > Operazioni > Console web per aprire Configurazione console Web.
  3. Modifica Day CQ DAM Resource Collection Servlet. Seleziona Invia e-mail. Fai clic su Salva.

In questa pagina