Show Menu
ARGOMENTI×

Configurazione delle notifiche e-mail

AEM invia notifiche e-mail agli utenti che:
  • Hanno effettuato la sottoscrizione a eventi di pagina, ad esempio modifiche o replica. La sezione Inbox Iscrizione alle notifiche 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 Passaggio Passaggio partecipante 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 servizio di posta Day CQ 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.
When working with AEM there are several methods of managing the configuration settings for such services; see Configuring OSGi for more details and the recommended practices.

Configurazione di Mail Service

Affinché AEM possa inviare e-mail, è necessario configurare correttamente il servizio di posta Day CQ Mail. Potete visualizzare la configurazione nella console Web. When working with AEM there are several methods of managing the configuration settings for such services; see Configuring OSGi for more details and the recommended practices.
Si applicano i seguenti vincoli:
  • La porta del server SMTP deve essere 25 o superiore.
  • Il nome host del server SMTP non deve essere vuoto.
  • L'indirizzo ​"Da" non deve essere vuoto.
Per risolvere un problema con il servizio ​Day CQ Mail, è 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. Potete modificare questo valore configurando il servizio Canale e-mail di notifica nella console Web.
Per configurare l’indirizzo e-mail, aggiungete un sling:OsgiConfig nodo 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. Aggiungi una String proprietà al nodo] denominato email.from . Per il valore, specificate l'indirizzo e-mail che desiderate utilizzare.
  4. Fate clic su Salva tutto .
Utilizzate la procedura seguente per definire il nodo nelle cartelle di origine del pacchetto di contenuto:
  1. Create un file jcr_root/apps/*app_name*/config folder 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’ email.from attributo ( 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 servizio ​di notifica e-mail giorno CQ Workflow 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 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:
    <tipo evento pagina> => <percorso pagina>
    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> possono essere combinati testo statico e variabili di 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>

Dove <text_x> possono essere combinati testo statico e variabili di stringa dinamiche. Ogni riga di un <text_x> elemento deve essere terminata con una barra rovesciata ( \ ), fatta eccezione per l'ultima istanza, quando l'assenza della barra rovesciata indica la fine della variabile della <text_x> stringa.
Ulteriori informazioni sul formato del modello sono reperibili nei 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 precede 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 di seguito:
    • /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.
Il nome <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.

Configurazione delle notifiche e-mail di AEM Assets

Quando le raccolte in Risorse AEM 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. Accedi ad AEM come amministratore. Fate clic su Strumenti > Operazioni > Console ​Web per aprire Configurazione console Web.
  3. Modifica servlet raccolta risorse CQ DAM Day. Selezionate Invia e-mail . Fai clic su Salva .