AEM stuurt e-mailmeldingen naar gebruikers die:
Hebt u zich op paginagebeurtenissen geabonneerd, bijvoorbeeld aanpassing of replicatie. De Melding in vak in deze sectie wordt beschreven hoe u zich op dergelijke gebeurtenissen kunt abonneren.
Hebt u zich geabonneerd op forumgebeurtenissen.
Een stap in een werkstroom uitvoeren. De Stap deelnemer in deze sectie 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 OSGi configureren voor meer details en de aanbevolen werkwijzen.
Als AEM e-mailberichten wilt kunnen verzenden, CQ-mailservice op dag moet correct worden 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 OSGi configureren voor meer details en de aanbevolen werkwijzen.
De volgende beperkingen zijn van toepassing:
De SMTP-serverpoort moet 25 of hoger zijn.
De hostnaam SMTP-server mag niet leeg zijn.
De Adres "Van" mag niet leeg zijn.
Om u te helpen een probleem met CQ-mailservice op dag kunt u de logbestanden 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 ingesteld op no-reply@acme.com
standaard. U kunt deze waarde wijzigen door het dialoogvenster E-mailkanaal voor meldingen in de webconsole.
Als u het e-mailadres wilt configureren, voegt u een sling:OsgiConfig
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.
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
eigenschap voor de benoemde node email.from
. Geef voor de waarde het e-mailadres op dat u wilt gebruiken.
Klikken Alles opslaan.
Gebruik de volgende procedure om het knooppunt in de bronmappen van het inhoudspakket te definiëren:
In uw jcr_root/apps/*app_name*/config folder
, maakt u 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 de optie email.from
attribute ( name@server.com
) met 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 het dialoogvenster Day CQ Workflow Email Notification Service in de webconsole. 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>
Wanneer <text_x> Dit kan een combinatie zijn 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>
Wanneer <text_x>
Dit kan een combinatie zijn van statische tekst en dynamische tekenreeksvariabelen.
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>
Wanneer <text_x>
Dit kan een combinatie zijn van statische tekst en dynamische tekenreeksvariabelen. Elke regel van een <text_x>
item moet worden beëindigd met een backslash ( \
), behalve in de laatste instantie, wanneer de afwezigheid van de backslash het einde van de <text_x>
tekenreeksvariabele.
Meer informatie over de sjabloonindeling vindt u in de javadocs van the Properties.load() methode.
De methode ${payload.path.open}
onthult de weg aan de lading van het werkpunt. Voor bijvoorbeeld een pagina in Sites, dan payload.path.open
zou vergelijkbaar zijn met /bin/wcmcommand?cmd=open&path=…
.; dit is zonder de servernaam, die is waarom het malplaatje dit met presteert ${host.prefix}
.
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 in CRXDE een bestand toe <language-code>.txt
hieronder:
/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>
gebruikt als de bestandsnaam van de e-mailsjabloon moet een taalcode van twee letters in kleine letters zijn die door AEM wordt herkend. 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.
AEM biedt OAuth2 ondersteuning voor zijn geïntegreerde Dienst van de Aannemer, om organisaties toe te staan om e-mailvereisten te beveiligen.
U kunt OAuth configureren voor meerdere e-mailproviders, zoals hieronder wordt beschreven.
Deze procedure is een voorbeeld voor een instantie Publish. Als u e-mailmeldingen wilt inschakelen voor een auteur, moet u dezelfde stappen uitvoeren voor de auteur.
https://console.developers.google.com/projectcreate
https://mail.google.com/
https://www.googleapis.com//auth/gmail.send
AEM zijconfiguraties
Adobe Managed Service-klanten kunnen met hun Customer Service Engineer samenwerken om deze wijzigingen aan te brengen in productieomgevingen.
Eerst, vorm de Dienst van de Post:
http://serveraddress:serverport/system/console/configMgr
smtp.gmail.com
25
of 587
, afhankelijk van de vereistenDaarna, vorm uw leverancier SMTP OAuth door de hieronder procedure te volgen:
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
en https://mail.google.com/
. U kunt meer dan één bereik toevoegen door op de knop + knoop aan de rechterkant van elk gevormd werkingsgebied.https://accounts.google.com/o/oauth2/token
Zodra gevormd, zouden de montages als dit moeten kijken:
Activeer nu de OAuth-componenten. U kunt dit doen door:
Ga naar de componentenconsole door deze URL te bezoeken: http://serveraddress:serverport/system/console/components
De volgende componenten zoeken
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
Druk het pictogram van het Spel links van de componenten
Bevestig ten slotte de configuratie door:
http://serveraddress:serverport/services/mailer/oauth2/authorize
. Dit zal u aan de pagina van uw leverancier SMTP, in dit geval Gmail opnieuw richten.accessToken
door deze URL rechtstreeks te openen op uw publicatieexemplaar: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth
Ga naar https://portal.azure.com/ en aanmelden.
Zoeken naar Azure Active Directory in de zoekbalk en klik op het resultaat. U kunt ook rechtstreeks bladeren naar https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Overview
Klikken op Toepassingsregistratie - Nieuwe registratie
Vul de gegevens naar wens in en klik op Registreren
Ga naar de nieuwe app en selecteer API-machtigingen
Ga naar Machtiging toevoegen - Grafiekmachtigingen - Gedelegeerde machtigingen
Selecteer de onderstaande machtigingen voor uw app en klik op Machtiging toevoegen:
SMTP.Send
Mail.Read
Mail.Send
openid
offline_access
Ga naar Verificatie - Een platform toevoegen - Web en in de URL omleiden , voegt u de volgende URL toe voor het omleiden van de OAuth-code en drukt u vervolgens op Configureren:
http://localhost:4503/services/mailer/oauth2/token
Het bovenstaande voor elke publicatie-instantie herhalen
Configureer de instellingen volgens uw vereisten
Ga vervolgens naar Certificaten en geheimen, klikt u op Nieuw clientgeheim en volg de stappen op het scherm om een geheim te maken. Let op dit geheim voor later gebruik
Druk Overzicht in het linkerdeelvenster en kopieer de waarden voor Toepassings-id (client) en Directory (huurder)-id voor later gebruik
Om opnieuw te verpakken, zult u aan de volgende informatie nodig hebben om OAuth2 voor de dienst van de Aannemer op de AEM te vormen:
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 zijconfiguraties
Vervolgens integreert u uw OAuth2-instellingen met AEM:
http://serveraddress:serverport/system/console/configMgr
smtp.office365.com
25
of 587
afhankelijk van de vereistenhttps://outlook.office365.com/Mail.Send
https://outlook.office365.com/Mail.Read
https://outlook.office365.com/SMTP.Send
http://localhost:4503/services/mailer/oauth2/token
Zodra gevormd, zouden de montages als dit moeten kijken:
Activeer nu de OAuth-componenten. U kunt dit doen door:
http://serveraddress:serverport/system/console/components
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
Bevestig ten slotte de configuratie door:
http://serveraddress:serverport/services/mailer/oauth2/authorize
. Dit zal u aan de pagina van uw leverancier SMTP, in dit geval Gmail opnieuw richten.accessToken
door deze URL rechtstreeks te openen op uw publicatieexemplaar: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth