AEM invia notifiche e-mail agli utenti che:
Si sono abbonati a eventi di pagina, ad esempio modifiche o repliche. Il Casella in entrata notifica descrive come abbonarsi a tali eventi.
Ti sei iscritto agli eventi del forum.
Devi eseguire un passaggio in un flusso di lavoro. Il Passaggio partecipante In questa sezione viene descritto come attivare le notifiche e-mail in un flusso di lavoro.
Prerequisiti:
Quando un utente riceve una notifica, 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.
Quando si lavora con l’AEM, esistono diversi metodi per gestire le impostazioni di configurazione per tali servizi; vedi Configurazione di OSGi per ulteriori dettagli e le pratiche consigliate.
Affinché l’AEM possa inviare e-mail, il Day CQ Mail Service deve essere configurato correttamente. Puoi visualizzare la configurazione nella console Web. Quando si lavora con l’AEM, esistono diversi metodi per gestire le impostazioni di configurazione per tali servizi; vedi Configurazione di OSGi per ulteriori dettagli e le pratiche consigliate.
Si applicano i seguenti vincoli:
Il Porta del server SMTP deve essere uguale o superiore a 25.
Il Nome host del server SMTP non può essere vuoto.
Il Indirizzo "Da" non può essere vuoto.
Per aiutarti a risolvere un problema relativo al Day CQ Mail Service, puoi visualizzare i registri del servizio:
com.day.cq.mailer.DefaultMailService
Nella console Web la configurazione si presenta come segue:
Quando ti abboni alle notifiche degli eventi di pagina o forum, l’indirizzo e-mail da è impostato su no-reply@acme.com
per impostazione predefinita. È possibile modificare questo valore configurando Canale e-mail di notifica nella console Web.
Per configurare l’indirizzo e-mail del mittente, aggiungi un sling:OsgiConfig
all'archivio. Per aggiungere il nodo direttamente utilizzando CRXDE Liti, attenersi alla procedura descritta di seguito.
In CRXDE Liti, aggiungi una cartella denominata config
nella cartella dell’applicazione.
Nella cartella di configurazione, aggiungi un nodo denominato:
com.day.cq.wcm.notification.email.impl.EmailChannel
di tipo sling:OsgiConfig
Aggiungi un String
al nodo denominato email.from
. Per il valore, specifica l’indirizzo e-mail che desideri utilizzare.
Clic Salva tutto.
Per definire il nodo nelle cartelle di origine dei pacchetti di contenuti, attenersi alla procedura descritta di seguito.
Nel tuo jcr_root/apps/*app_name*/config folder
, crea un file denominato com.day.cq.wcm.notification.email.impl.EmailChannel.xml
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"/>
Sostituisci il valore di email.from
attributo ( name@server.com
) con il tuo indirizzo e-mail.
Salva il file.
Quando ricevi le notifiche e-mail del flusso di lavoro, sia l’indirizzo e-mail da che il prefisso dell’URL host vengono impostati sui valori predefiniti. È possibile modificare questi valori configurando Servizio di notifica e-mail flusso di lavoro Day CQ nella console Web. In tal caso, si consiglia di mantenere la modifica nell’archivio.
Nella console Web la configurazione predefinita è la seguente:
I modelli e-mail per le notifiche di pagina si trovano qui sotto:
/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.
Per personalizzare il modello e-mail inglese per la notifica della pagina:
In CRXDE, apri il file:
/libs/settings/notification-templates/com.day.cq.wcm.core.page/en.txt
Modifica il file in base alle tue esigenze.
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 una combinazione di testo statico e variabili di stringa 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}
, nome completo dell'utente che ha attivato l'evento.
${userId}
, ID dell’utente che ha attivato l’evento.
${modifications}
, descrive il tipo di evento di pagina e il percorso della pagina nel formato:
<page event="" type=""> => <page path="">
Ad esempio:
PageModified => /content/geometrixx/en/products
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.
Per personalizzare il modello e-mail inglese per la notifica degli eventi del flusso di lavoro:
In CRXDE, apri il file:
/libs/settings/workflow/notification/email/default/en.txt
Modifica il file in base alle tue esigenze.
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 una combinazione di testo statico e variabili di stringa dinamiche. Ogni riga di un <text_x>
l'elemento deve terminare con una barra rovesciata ( \
), ad eccezione dell'ultima istanza, quando l'assenza della barra rovesciata indica la fine del <text_x>
variabile stringa.
Ulteriori informazioni sul formato del modello sono disponibili nella sezione JavaScript di Properties.load() metodo.
Il metodo ${payload.path.open}
mostra il percorso del payload dell’elemento di lavoro. Ad esempio, per una pagina in Sites: payload.path.open
sarebbe simile a /bin/wcmcommand?cmd=open&path=…
.; senza il nome del server, che è il motivo per cui il modello lo precede con ${host.prefix}
.
Le seguenti variabili possono essere utilizzate all’interno del modello e-mail:
${event.EventType}
, tipo di 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}
, ID del modello di flusso di lavoro
${model.version}
, 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
Per aggiungere un modello per una nuova lingua:
In CRXDE, aggiungi un file <language-code>.txt
di seguito:
/libs/settings/notification-templates/com.day.cq.wcm.core.page
: per notifiche pagina/libs/settings/workflow/notification/email/default
: per le notifiche del 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 di lingua minuscolo di due lettere riconosciuto dall’AEM. Per i codici di lingua, l'AEM si basa sullo standard ISO-639-1.
Quando le raccolte in AEM Assets sono condivise o non condivise, gli utenti possono ricevere notifiche e-mail dall’AEM. Per configurare le notifiche e-mail, segui la procedura riportata di seguito.
AEM offre il supporto OAuth2 per il suo servizio Mailer integrato, per consentire alle organizzazioni di rispettare i requisiti e-mail sicuri.
Puoi configurare OAuth per più provider di posta elettronica, come descritto di seguito.
Questa procedura è un esempio per un'istanza Publish. Se desideri abilitare le notifiche e-mail su un’istanza Autore, segui gli stessi passaggi anche sull’Autore.
https://console.developers.google.com/projectcreate
https://mail.google.com/
https://www.googleapis.com//auth/gmail.send
Configurazioni lato AEM
I clienti Adobe Managed Service possono collaborare con il proprio tecnico dell’assistenza clienti per apportare queste modifiche agli ambienti di produzione.
Innanzitutto, configura il servizio di posta:
http://serveraddress:serverport/system/console/configMgr
smtp.gmail.com
25
o 587
, a seconda dei requisitiQuindi, configura il provider OAuth SMTP seguendo la procedura seguente:
http://serveraddress:serverport/system/console/configMgr
https://accounts.google.com/o/oauth2/auth
https://accounts.google.com/o/oauth2/token
https://www.googleapis.com/auth/gmail.send
e https://mail.google.com/
. È possibile aggiungere più ambiti premendo + sul lato destro di ogni ambito configurato.https://accounts.google.com/o/oauth2/token
Una volta configurate, le impostazioni avranno un aspetto simile a questo:
Ora, attiva i componenti OAuth. Per farlo, segui questi passaggi:
Vai alla console Componenti visitando questo URL: http://serveraddress:serverport/system/console/components
Cerca i seguenti componenti
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
Premi l’icona Play a sinistra dei componenti
Infine, conferma la configurazione:
http://serveraddress:serverport/services/mailer/oauth2/authorize
. Questo ti reindirizzerà alla pagina del tuo provider SMTP, in questo caso Gmail.accessToken
accedendo direttamente a questo URL nell’istanza di pubblicazione: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth
Vai a https://portal.azure.com/ e accedi.
Cerca Azure Active Directory nella barra di ricerca e fai clic sul risultato. In alternativa, è possibile navigare direttamente in https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Overview
Fai clic su Registrazione app - Nuova registrazione
Compila le informazioni in base alle tue esigenze, quindi fai clic su Registra
Vai alla nuova app creata e seleziona Autorizzazioni API
Vai a Aggiungi autorizzazione - Autorizzazione grafico - Autorizzazioni delegate
Seleziona le seguenti autorizzazioni per la tua app, quindi fai clic su Aggiungi autorizzazione:
SMTP.Send
Mail.Read
Mail.Send
openid
offline_access
Vai a Autenticazione - Aggiungi una piattaforma - Web, e nella Url di reindirizzamento , aggiungi il seguente URL per reindirizzare il codice OAuth, quindi premi Configura:
http://localhost:4503/services/mailer/oauth2/token
Ripeti quanto sopra per ogni istanza di pubblicazione
Configura le impostazioni in base alle tue esigenze
Quindi, vai a Certificati e segreti, fai clic su Nuovo segreto client e segui i passaggi sullo schermo per creare un segreto. Assicurati di prendere nota di questo segreto per un uso successivo
Premi Panoramica nel riquadro a sinistra e copia i valori per ID applicazione (client) e ID directory (tenant) per un uso successivo
Per ricapitolare, è necessario disporre delle seguenti informazioni per configurare OAuth2 per il servizio Mailer sul lato AEM:
https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/authorize
https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/token
https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/token
Configurazioni lato AEM
Quindi, integra le impostazioni OAuth2 con AEM:
http://serveraddress:serverport/system/console/configMgr
smtp.office365.com
25
o 587
a seconda dei requisitihttps://outlook.office365.com/Mail.Send
https://outlook.office365.com/Mail.Read
https://outlook.office365.com/SMTP.Send
http://localhost:4503/services/mailer/oauth2/token
Una volta configurate, le impostazioni avranno un aspetto simile a questo:
Ora, attiva i componenti OAuth. Per farlo, segui questi passaggi:
http://serveraddress:serverport/system/console/components
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
Infine, conferma la configurazione:
http://serveraddress:serverport/services/mailer/oauth2/authorize
. In questo caso verrà reindirizzato alla pagina del provider SMTP, in questo caso Outlook.accessToken
accedendo direttamente a questo URL nell’istanza di pubblicazione: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth