AEM stuurt e-mailmeldingen naar gebruikers die:
Hebt u zich op paginagebeurtenissen geabonneerd, bijvoorbeeld aanpassing of replicatie. In de sectie Notification Inbox wordt beschreven hoe u zich op dergelijke gebeurtenissen kunt abonneren.
Hebt u zich geabonneerd op forumgebeurtenissen.
Een stap in een werkstroom uitvoeren. In de sectie Deelnemerstap wordt beschreven hoe u e-mailmeldingen in een workflow kunt activeren.
Voorwaarden:
Wanneer een gebruiker op de hoogte wordt gesteld, ontvangt hij een e-mail in de taal die in zijn profiel wordt bepaald. Elke taal heeft zijn eigen malplaatje dat kan worden aangepast. U kunt nieuwe e-mailsjablonen toevoegen voor nieuwe talen.
Wanneer het werken met AEM zijn er verscheidene methodes om de configuratiemontages voor dergelijke diensten te beheren; zie Het vormen OSGi voor meer details en de geadviseerde praktijken.
AEM kan alleen e-mailberichten verzenden als de Day CQ Mail Service correct is geconfigureerd. U kunt de configuratie in de console van het Web bekijken. Wanneer het werken met AEM zijn er verscheidene methodes om de configuratiemontages voor dergelijke diensten te beheren; zie Het vormen OSGi voor meer details en de geadviseerde praktijken.
De volgende beperkingen zijn van toepassing:
De SMTP serverhaven moet 25 of hoger zijn.
De SMTP naam van de servergastheer moet niet leeg zijn.
Het "Van"adres moet niet leeg zijn.
Om u te helpen een probleem met de Day CQ Mail Service oplossen, kunt u de logboeken van de service bekijken:
com.day.cq.mailer.DefaultMailService
De configuratie kijkt als volgt in de console van het Web:
Wanneer u zich abonneert op berichten voor pagina- of forumgebeurtenissen, wordt het e-mailadres standaard ingesteld op no-reply@acme.com
. U kunt deze waarde wijzigen door de service E-mailkanaal voor meldingen in de webconsole te configureren.
Als u het e-mailadres wilt configureren, voegt u een sling:OsgiConfig
-knooppunt toe aan de gegevensopslagruimte. Gebruik de volgende procedure om de knoop direct toe te voegen gebruikend CRXDE Lite:
Voeg in CRXDE Lite een map met de naam config
onder de toepassingsmap toe.
Voeg in de configuratiemap een knooppunt met de naam:
com.day.cq.wcm.notification.email.impl.EmailChannel
van het type sling:OsgiConfig
Voeg een String
bezit aan de knoop toe genoemd email.from
. Geef voor de waarde het e-mailadres op dat u wilt gebruiken.
Klik Alles opslaan.
Gebruik de volgende procedure om het knooppunt in de bronmappen van het inhoudspakket te definiëren:
Maak in uw jcr_root/apps/*app_name*/config folder
een bestand met de naam com.day.cq.wcm.notification.email.impl.EmailChannel.xml
Voeg de volgende XML toe om het knooppunt te vertegenwoordigen:
<?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"/>
Vervang de waarde van het kenmerk email.from
( name@server.com
) door uw e-mailadres.
Sla het bestand op.
Wanneer u e-mailmeldingen over de workflow ontvangt, worden zowel het adres van de e-mail als het URL-voorvoegsel van de host ingesteld op standaardwaarden. U kunt deze waarden wijzigen door de Day CQ Workflow Email Notification Service in de webconsole te configureren. Als u dat doet, wordt aanbevolen de wijziging in de opslagplaats voort te zetten.
De standaardconfiguratie kijkt als volgt in de Console van het Web:
De e-mailsjablonen voor paginaberichten staan hieronder:
/libs/settings/notification-templates/com.day.cq.wcm.core.page
De standaardsjabloon Engels ( en.txt
) wordt als volgt gedefinieerd:
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.
U kunt als volgt de Engelse e-mailsjabloon voor paginabeldingen aanpassen:
Open het bestand in CRXDE:
/libs/settings/notification-templates/com.day.cq.wcm.core.page/en.txt
Wijzig het bestand naar wens.
Sla de wijzigingen op.
De sjabloon moet de volgende indeling hebben:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
Hierbij kan <text_x> bestaan uit een combinatie van statische tekst en dynamische tekenreeksvariabelen. De volgende variabelen kunnen in de e-mailsjabloon voor paginaberichten worden gebruikt:
${time}
, de datum en het tijdstip van de gebeurtenis.
${userFullName}
, de volledige naam van de gebruiker die de gebeurtenis heeft geactiveerd.
${userId}
, de id van de gebruiker die de gebeurtenis heeft geactiveerd.
${modifications}
beschrijft het type paginagebeurtenis en het paginapad in de notatie:
<page event="" type=""> => <page path="">
Bijvoorbeeld:
PageModified => /content/geometrixx/nl/products
E-mailsjablonen voor forummeldingen vindt u onder:
/etc/notification/email/default/com.day.cq.collab.forum
De standaardsjabloon Engels ( en.txt
) wordt als volgt gedefinieerd:
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.
U kunt als volgt de Engelse e-mailsjabloon voor forumkennisgeving aanpassen:
Open het bestand in CRXDE:
/etc/notification/email/default/com.day.cq.collab.forum/en.txt
Wijzig het bestand naar wens.
Sla de wijzigingen op.
De sjabloon moet de volgende indeling hebben:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
Waarbij <text_x>
een combinatie van statische tekst en dynamische tekenreeksvariabelen kan zijn.
De volgende variabelen kunnen binnen het e-mailmalplaatje voor forumberichten worden gebruikt:
${time}
, de datum en het tijdstip van de gebeurtenis.
${forum.path}
, het pad naar de forumpagina.
Het e-mailsjabloon voor workflowmeldingen (Engels) bevindt zich op:
/libs/settings/workflow/notification/email/default/en.txt
Het wordt als volgt gedefinieerd:
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.
U kunt als volgt de Engelse e-mailsjabloon voor workflowgebeurtenismeldingen aanpassen:
Open het bestand in CRXDE:
/libs/settings/workflow/notification/email/default/en.txt
Wijzig het bestand naar wens.
Sla de wijzigingen op.
De sjabloon moet de volgende indeling hebben:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
Waarbij <text_x>
een combinatie van statische tekst en dynamische tekenreeksvariabelen kan zijn. Elke regel van een <text_x>
punt moet met backslash ( \
) worden gebeëindigd, behalve voor de laatste instantie, wanneer de afwezigheid van backslash op het eind van <text_x>
koordvariabele wijst.
Meer informatie over het sjabloonformaat vindt u in de javadocs van de methode Properties.load().
De methode ${payload.path.open}
openbaart de weg aan de lading van het werkpunt. Voor een pagina in Sites zou payload.path.open
bijvoorbeeld ongeveer gelijk zijn aan /bin/wcmcommand?cmd=open&path=…
.; dit is zonder de servernaam, daarom vult het malplaatje dit met ${host.prefix}
voor.
De volgende variabelen kunnen binnen het e-mailmalplaatje worden gebruikt:
${event.EventType}
, type gebeurtenis
${event.TimeStamp}
, datum en tijdstip van de gebeurtenis
${event.User}
, de gebruiker die de gebeurtenis heeft geactiveerd
${initiator.home}
, het pad naar het initiatorknooppunt
${initiator.name}
, de naam van de aanvrager
${initiator.email}
, e-mailadres van de aanvrager
${item.id}
, de id van het werkitem
${item.node.id}
, id van het knooppunt in het workflowmodel dat aan dit werkitem is gekoppeld
${item.node.title}
, titel van het werkitem
${participant.email}
, e-mailadres van de deelnemer
${participant.name}
, naam van de deelnemer
${participant.familyName}
, familienaam van de deelnemer
${participant.id}
, id van de deelnemer
${participant.language}
, de taal van de deelnemer
${instance.id}
, de workflow-id
${instance.state}
, de workflowstatus
${model.title}
, titel van het workflowmodel
${model.id}
, de id van het workflowmodel
${model.version}
, de versie van het workflowmodel
${payload.data}
, de lading
${payload.type}
, het ladingstype
${payload.path}
, pad van de lading
${host.prefix}
, hostvoorvoegsel, bijvoorbeeld: http://localhost:4502
Een sjabloon toevoegen voor een nieuwe taal:
Voeg hieronder een bestand <language-code>.txt
toe in CRXDE:
/libs/settings/notification-templates/com.day.cq.wcm.core.page
: voor paginameldingen/etc/notification/email/default/com.day.cq.collab.forum
: voor forummeldingen/libs/settings/workflow/notification/email/default
: voor workflowmeldingenPas het bestand aan de taal aan.
Sla de wijzigingen op.
De <language-code>
die als filename voor het e-mailmalplaatje wordt gebruikt moet een twee-hoofdtaalcode zijn die door AEM wordt erkend. Voor taalcodes is AEM gebaseerd op ISO-639-1.
Wanneer Verzamelingen in AEM Assets worden gedeeld of niet gedeeld, kunnen gebruikers e-mailmeldingen ontvangen van AEM. Voer de volgende stappen uit om e-mailmeldingen te configureren.