E-mailmelding configureren

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:

  • Voor de gebruiker(s) moet(en) een geldig e-mailadres zijn gedefinieerd in dit profiel.
  • De Day CQ Mail Service moet correct zijn geconfigureerd.

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.

OPMERKING

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 Mail Service configureren

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:

chlimage_1-276

Het kanaal voor e-mailmeldingen configureren

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:

  1. Voeg in CRXDE Lite een map met de naam config onder de toepassingsmap toe.

  2. Voeg in de configuratiemap een knooppunt met de naam:

    com.day.cq.wcm.notification.email.impl.EmailChannel van het type sling:OsgiConfig

  3. Voeg een String bezit aan de knoop toe genoemd email.from. Geef voor de waarde het e-mailadres op dat u wilt gebruiken.

  4. Klik Alles opslaan.

Gebruik de volgende procedure om het knooppunt in de bronmappen van het inhoudspakket te definiëren:

  1. Maak in uw jcr_root/apps/*app_name*/config folder een bestand met de naam com.day.cq.wcm.notification.email.impl.EmailChannel.xml

  2. 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"/>

  3. Vervang de waarde van het kenmerk email.from ( name@server.com) door uw e-mailadres.

  4. Sla het bestand op.

De Workflow Email Notification Service configureren

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:

chlimage_1-277

E-mailsjablonen voor paginamelding

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.

E-mailsjablonen aanpassen voor paginamelding

U kunt als volgt de Engelse e-mailsjabloon voor paginabeldingen aanpassen:

  1. Open het bestand in CRXDE:

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

  2. Wijzig het bestand naar wens.

  3. 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 forumkennisgeving

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.

E-mailsjablonen aanpassen voor forummelding

U kunt als volgt de Engelse e-mailsjabloon voor forumkennisgeving aanpassen:

  1. Open het bestand in CRXDE:

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

  2. Wijzig het bestand naar wens.

  3. 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.

E-mailsjablonen voor workflowmelding

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.

E-mailsjablonen aanpassen voor workflowmelding

U kunt als volgt de Engelse e-mailsjabloon voor workflowgebeurtenismeldingen aanpassen:

  1. Open het bestand in CRXDE:

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

  2. Wijzig het bestand naar wens.

  3. Sla de wijzigingen op.

De sjabloon moet de volgende indeling hebben:

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

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 e-mailsjabloon toevoegen voor een nieuwe taal

Een sjabloon toevoegen voor een nieuwe taal:

  1. 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 workflowmeldingen
  2. Pas het bestand aan de taal aan.

  3. Sla de wijzigingen op.

OPMERKING

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.

E-mailberichten voor AEM Assets configureren

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.

  1. Configuring the email service, as described above in Configuring the Mail Service.
  2. Meld u aan bij AEM als beheerder. Klik Gereedschappen > Bewerkingen > Webconsole om de Configuratie van de Console van het Web te openen.
  3. Bewerk Day CQ DAM Resource Collection Servlet. Selecteer E-mail verzenden. Klik Opslaan.

Op deze pagina