AEM envía notificaciones por correo electrónico a los usuarios que:
Se han suscrito a eventos de página como, por ejemplo, una modificación o replicación. El Bandeja de entrada de notificaciones En esta sección se describe cómo suscribirse a estos eventos.
Se ha suscrito a eventos de foro.
Deben realizar un paso en un flujo de trabajo. El Etapa de participante Esta sección describe cómo almacenar en déclencheur las notificaciones por correo electrónico en un flujo de trabajo.
Requisitos previos:
Cuando se notifica a un usuario, este recibe un correo electrónico en el idioma definido en su perfil. Cada idioma tiene su propia plantilla que se puede personalizar. Se pueden añadir nuevas plantillas de correo electrónico para los nuevos idiomas.
AEM Al trabajar con los servicios de correo electrónico, existen varios métodos para administrar los parámetros de configuración de dichos servicios; consulte Configurar OSGi para obtener más información y las prácticas recomendadas.
AEM Para poder enviar correos electrónicos, la función de envío de correo electrónico de la dirección Day CQ Mail Service debe estar correctamente configurado. Puede ver la configuración en la consola web. AEM Al trabajar con los servicios de correo electrónico, existen varios métodos para administrar los parámetros de configuración de dichos servicios; consulte Configurar OSGi para obtener más información y las prácticas recomendadas.
Se aplican las siguientes restricciones:
El Puerto del servidor SMTP debe tener 25 años o más.
El Nombre de host del servidor SMTP no debe estar en blanco.
El Dirección "De" no debe estar en blanco.
Para ayudarle a depurar un problema con Day CQ Mail Service, puede ver los registros del servicio:
com.day.cq.mailer.DefaultMailService
La configuración tiene el siguiente aspecto en la consola web:
Al suscribirse a las notificaciones de eventos de páginas o foros, la dirección de correo electrónico de origen se establece en no-reply@acme.com
de forma predeterminada. Puede cambiar este valor configurando la variable Canal de correo electrónico de notificación en la consola web.
Para configurar la dirección de correo electrónico de origen, agregue un sling:OsgiConfig
al repositorio. Utilice el siguiente procedimiento para añadir el nodo directamente mediante el CRXDE Lite:
En CRXDE Lite, agregue una carpeta denominada config
debajo de la carpeta de la aplicación.
En la carpeta de configuración, añada un nodo denominado:
com.day.cq.wcm.notification.email.impl.EmailChannel
de tipo sling:OsgiConfig
Añadir un String
al nodo denominado. email.from
. Para el valor, especifique la dirección de correo electrónico que desea utilizar.
Haga clic en Guardar todo.
Utilice el siguiente procedimiento para definir el nodo en las carpetas de origen del paquete de contenido:
En su jcr_root/apps/*app_name*/config folder
, cree un archivo llamado com.day.cq.wcm.notification.email.impl.EmailChannel.xml
Agregue el siguiente XML para representar el 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"/>
Reemplace el valor del email.from
atributo ( name@server.com
) con su correo electrónico.
Guarde el archivo.
Cuando recibe notificaciones por correo electrónico del flujo de trabajo, tanto la dirección de correo electrónico de origen como el prefijo de URL del host se establecen en valores predeterminados. Puede cambiar estos valores configurando la variable Servicio de notificación por correo electrónico del flujo de trabajo CQ diario en la consola web. Si lo hace, se recomienda mantener el cambio en el repositorio.
La configuración predeterminada tiene el siguiente aspecto en la consola web:
Las plantillas de correo electrónico para las notificaciones de página se encuentran a continuación:
/libs/settings/notification-templates/com.day.cq.wcm.core.page
La plantilla predeterminada en inglés ( en.txt
) se define de la siguiente manera:
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.
Para personalizar la plantilla de correo electrónico en inglés para la notificación de página:
En CRXDE, abra el archivo:
/libs/settings/notification-templates/com.day.cq.wcm.core.page/en.txt
Modifique el archivo según sus necesidades.
Guarde los cambios.
La plantilla debe tener el siguiente formato:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
Donde <text_x> puede ser una combinación de texto estático y variables de cadena dinámicas. Se pueden utilizar las siguientes variables dentro de la plantilla de correo electrónico para las notificaciones de página:
${time}
, la fecha y hora del evento.
${userFullName}
, el nombre completo del usuario que activó el evento.
${userId}
, el ID del usuario que activó el evento.
${modifications}
, describe el tipo del evento de página y la ruta de página con el formato:
<page event="" type=""> => <page path="">
Por ejemplo:
PageModified => /content/geometrixx/en/products
La plantilla de correo electrónico para las notificaciones del flujo de trabajo (inglés) se encuentra en:
/libs/settings/workflow/notification/email/default/en.txt
Se define de la siguiente manera:
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.
Para personalizar la plantilla de correo electrónico en inglés para la notificación de eventos de flujo de trabajo:
En CRXDE, abra el archivo:
/libs/settings/workflow/notification/email/default/en.txt
Modifique el archivo según sus necesidades.
Guarde los cambios.
La plantilla debe tener el siguiente formato:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
Donde <text_x>
puede ser una combinación de texto estático y variables de cadena dinámicas. Cada línea de un <text_x>
el artículo debe finalizar con una barra invertida ( \
), excepto en la última instancia, cuando la ausencia de la barra invertida indica el final de la <text_x>
variable de cadena.
Encontrará más información sobre el formato de plantilla en la javadocs de Properties.load() método.
El método ${payload.path.open}
revela la ruta a la carga útil del elemento de trabajo. Por ejemplo, para una página de Sites, haga lo siguiente payload.path.open
sería similar a /bin/wcmcommand?cmd=open&path=…
.; esto sucede sin el nombre del servidor, por lo que la plantilla antepone este nombre con ${host.prefix}
.
Se pueden utilizar las siguientes variables dentro de la plantilla de correo electrónico:
${event.EventType}
, tipo de evento
${event.TimeStamp}
, fecha y hora del evento
${event.User}
, el usuario que activó el evento
${initiator.home}
, la ruta del nodo iniciador
${initiator.name}
, el nombre del iniciador
${initiator.email}
, dirección de correo electrónico del iniciador
${item.id}
, el id del elemento de trabajo
${item.node.id}
, id del nodo en el modelo de flujo de trabajo asociado a este elemento de trabajo
${item.node.title}
, título del elemento de trabajo
${participant.email}
, la dirección de correo electrónico del participante
${participant.name}
, nombre del participante
${participant.familyName}
, apellido del participante
${participant.id}
, id del participante
${participant.language}
, el idioma del participante
${instance.id}
, el ID del flujo de trabajo
${instance.state}
, el estado del flujo de trabajo
${model.title}
, título del modelo de flujo de trabajo
${model.id}
, el id del modelo de flujo de trabajo
${model.version}
, la versión del modelo de flujo de trabajo
${payload.data}
, la carga útil
${payload.type}
, el tipo de carga útil
${payload.path}
, ruta de la carga útil
${host.prefix}
, prefijo de host, p. ej.: http://localhost:4502
Para añadir una plantilla para un nuevo idioma:
En CRXDE, agregue un archivo <language-code>.txt
a continuación:
/libs/settings/notification-templates/com.day.cq.wcm.core.page
: para notificaciones de página/libs/settings/workflow/notification/email/default
: para notificaciones de flujo de trabajoAdapte el archivo al idioma.
Guarde los cambios.
El <language-code>
AEM El nombre de archivo utilizado para la plantilla de correo electrónico debe ser un código de idioma en minúsculas de dos letras que reconozca el usuario de correo electrónico de la plantilla de correo electrónico de la plantilla de correo electrónico de la siguiente manera: AEM Para los códigos de idioma, la aplicación se basa en la norma ISO-639-1.
Cuando las colecciones de AEM Assets AEM se comparten o dejan de compartirse, los usuarios pueden recibir notificaciones por correo electrónico de los usuarios de la aplicación de correo electrónico de los que se puede acceder a las notificaciones de correo electrónico. Para configurar las notificaciones por correo electrónico, siga estos pasos.
AEM ofrece compatibilidad con OAuth2 para su servicio de correo integrado, con el fin de permitir que las organizaciones se adhieran a los requisitos de correo electrónico seguros.
Puede configurar OAuth para varios proveedores de correo electrónico, como se describe a continuación.
Este procedimiento es un ejemplo para una instancia de publicación. Si desea habilitar las notificaciones por correo electrónico en una instancia de autor, debe seguir los mismos pasos en la instancia de autor.
https://console.developers.google.com/projectcreate
https://mail.google.com/
https://www.googleapis.com//auth/gmail.send
AEM Configuraciones de lado
Los clientes del servicio administrado de Adobe pueden trabajar con su ingeniero de servicio al cliente para realizar estos cambios en los entornos de producción.
En primer lugar, configure el Servicio de correo:
http://serveraddress:serverport/system/console/configMgr
smtp.gmail.com
25
o 587
, según los requisitosA continuación, configure su proveedor de OAuth SMTP siguiendo el procedimiento a continuación:
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
y https://mail.google.com/
. Puede agregar más de un ámbito presionando la tecla + a la derecha de cada ámbito configurado.https://accounts.google.com/o/oauth2/token
Una vez configurada, la configuración debería ser similar a la siguiente:
Ahora, active los componentes de OAuth. Para ello:
Vaya a la consola Componentes accediendo a esta dirección URL: http://serveraddress:serverport/system/console/components
Busque los siguientes componentes
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
Pulse el icono Reproducir a la izquierda de los componentes
Finalmente, confirme la configuración mediante lo siguiente:
http://serveraddress:serverport/services/mailer/oauth2/authorize
. Esto lo redireccionará a la página de su proveedor SMTP, en este caso Gmail.accessToken
al acceder directamente a esta URL en la instancia de publicación: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth
Vaya a https://portal.azure.com/ e inicie sesión.
Busque Azure Active Directory en la barra de búsqueda y haga clic en el resultado. También puede navegar directamente a https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Overview
Haga clic en Registro de aplicaciones - Nuevo registro
Rellene la información según sus necesidades y haga clic en Registro
Vaya a la aplicación recién creada y seleccione Permisos de API
Vaya a Añadir permiso - Permiso de gráfico - Permisos delegados
Seleccione los siguientes permisos para su aplicación y haga clic en Añadir permiso:
SMTP.Send
Mail.Read
Mail.Send
openid
offline_access
Ir a Autenticación - Añadir una plataforma - Web, y en el Redirigir direcciones Url , añada la siguiente URL para redirigir el código de OAuth y pulse Configurar:
http://localhost:4503/services/mailer/oauth2/token
Repita lo anterior para cada instancia de publicación
Configure los ajustes según sus necesidades
A continuación, vaya a Certificados y secretos, haga clic en Nuevo secreto de cliente y siga los pasos que aparecen en la pantalla para crear un secreto. Asegúrese de tomar nota de este secreto para utilizarlo posteriormente
Pulse Información general en el panel izquierdo y copie los valores de ID de aplicación (cliente) y ID de directorio (inquilino) para su posterior uso
AEM Para recapitular, necesitará la siguiente información para configurar OAuth2 para el servicio Mailer en el lado del:
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
AEM Configuraciones de lado
AEM A continuación, integre la configuración de OAuth2 con las siguientes opciones de configuración:
http://serveraddress:serverport/system/console/configMgr
smtp.office365.com
25
o 587
según los requisitoshttps://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 vez configurada, la configuración debería ser similar a la siguiente:
Ahora, active los componentes de OAuth. Para ello:
http://serveraddress:serverport/system/console/components
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
Finalmente, confirme la configuración mediante lo siguiente:
http://serveraddress:serverport/services/mailer/oauth2/authorize
. Esto lo redirigirá a la página de su proveedor SMTP, en este caso Outlook.accessToken
al acceder directamente a esta URL en la instancia de publicación: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth