設定電子郵件通知 configuring-email-notification
AEM會傳送電子郵件通知給下列使用者:
先決條件:
- 使用者的設定檔中必須定義有效的電子郵件地址。
- 此 Day CQ Mail Service 必須正確設定。
收到通知時,使用者會收到其設定檔中定義的語言電子郵件。 每種語言都有各自的範本,可供自訂。 可針對新語言新增新的電子郵件範本。
設定郵件服務 configuring-the-mail-service
若要讓AEM能夠傳送電子郵件, Day CQ Mail Service 必須正確設定。 您可以在Web主控台中檢視設定。 使用AEM時,有數種方法可管理這類服務的組態設定;請參閱 配置OSGi 以取得詳細資訊和建議的實務。
下列限制適用:
-
此 SMTP伺服器埠 必須是25或更高。
-
此 SMTP伺服器主機名 不得空白。
-
此 「寄件者」地址 不得空白。
協助您對 Day CQ Mail Service,您可以觀看服務記錄:
com.day.cq.mailer.DefaultMailService
在Web控制台中,配置如下所示:
設定電子郵件通知通道 configuring-the-email-notification-channel
當您訂閱頁面或論壇事件通知時,寄件者電子郵件地址會設為 no-reply@acme.com
預設值。 您可以借由設定 通知電子郵件通道 服務。
若要設定寄件者電子郵件地址,請新增 sling:OsgiConfig
節點到儲存庫。 使用以下過程直接使用CRXDE Lite添加節點:
-
在CRXDE Lite中,新增名為
config
應用程式資料夾下方。 -
在設定資料夾中,新增節點:
com.day.cq.wcm.notification.email.impl.EmailChannel
類型sling:OsgiConfig
-
新增
String
屬性至名為的節點email.from
. 對於值,指定您要使用的電子郵件地址。 -
按一下 全部儲存.
使用以下過程來定義內容包源資料夾中的節點:
-
在
jcr_root/apps/*app_name*/config folder
,建立名為的檔案com.day.cq.wcm.notification.email.impl.EmailChannel.xml
-
添加以下XML以表示節點:
<?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"/>
-
取代
email.from
屬性(name@server.com
)和您的電子郵件地址。 -
儲存檔案。
設定工作流程電子郵件通知服務 configuring-the-workflow-email-notification-service
當您收到工作流程電子郵件通知時,寄件者電子郵件地址和主機URL首碼都會設為預設值。 您可以透過設定 Day CQ工作流程電子郵件通知服務 中。 若您這麼做,建議您將變更保留在存放庫中。
預設配置在Web控制台中如下所示:
頁面通知的電子郵件範本 email-templates-for-page-notification
頁面通知的電子郵件範本位於下方:
/libs/settings/notification-templates/com.day.cq.wcm.core.page
預設英文範本( en.txt
)的定義如下:
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.
自訂頁面通知的電子郵件範本 customizing-email-templates-for-page-notification
若要自訂頁面通知的英文電子郵件範本:
-
在CRXDE中,開啟檔案:
/libs/settings/notification-templates/com.day.cq.wcm.core.page/en.txt
-
根據您的需求修改檔案。
-
儲存變更。
範本必須具備下列格式:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
其中 <text_x> 可以是靜態文字和動態字串變數的混合。 可在電子郵件範本內使用下列變數以取得頁面通知:
-
${time}
,事件日期和時間。 -
${userFullName}
,觸發事件的使用者完整名稱。 -
${userId}
,即觸發事件的使用者ID。 -
${modifications}
,以下列格式說明頁面事件類型和頁面路徑:<page event="" type=""> => <page path="">
例如:
PageModified => /content/geometrixx/en/products
論壇通知的電子郵件範本 email-templates-for-forum-notification
論壇通知的電子郵件範本位於:
/etc/notification/email/default/com.day.cq.collab.forum
預設英文範本( en.txt
)的定義如下:
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.
為論壇通知自訂電子郵件範本 customizing-email-templates-for-forum-notification
若要自訂論壇通知的英文電子郵件範本:
-
在CRXDE中,開啟檔案:
/etc/notification/email/default/com.day.cq.collab.forum/en.txt
-
根據您的需求修改檔案。
-
儲存變更。
範本必須具備下列格式:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
其中 <text_x>
可以是靜態文字和動態字串變數的混合。
下列變數可在電子郵件範本中用於論壇通知:
-
${time}
,事件日期和時間。 -
${forum.path}
,即論壇頁面的路徑。
工作流通知的電子郵件範本 email-templates-for-workflow-notification
工作流程通知的電子郵件範本(英文)位於:
/libs/settings/workflow/notification/email/default/en.txt
定義如下:
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.
自訂工作流程通知的電子郵件範本 customizing-email-templates-for-workflow-notification
若要自訂工作流程事件通知的英文電子郵件範本:
-
在CRXDE中,開啟檔案:
/libs/settings/workflow/notification/email/default/en.txt
-
根據您的需求修改檔案。
-
儲存變更。
範本必須具備下列格式:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
<text_x>
可以是靜態文字和動態字串變數的混合。 每行 <text_x>
項目需要以反斜線( \
),但最後一個例項除外,因為沒有反斜線表示結尾 <text_x>
字串變數。方法 ${payload.path.open}
會顯示工作項目裝載的路徑。 例如,接著,針對Sites中的頁面 payload.path.open
會類似於 /bin/wcmcommand?cmd=open&path=…
.;這沒有伺服器名稱,因此範本會在前置加上 ${host.prefix}
.
可在電子郵件範本內使用下列變數:
-
${event.EventType}
,事件類型 -
${event.TimeStamp}
、事件的日期和時間 -
${event.User}
,觸發事件的使用者 -
${initiator.home}
,啟動器節點路徑 -
${initiator.name}
,啟動器名稱 -
${initiator.email}
,發起人的電子郵件地址 -
${item.id}
,工作項的id -
${item.node.id}
,此工作項目關聯的工作流模型中節點的id -
${item.node.title}
,工作項的標題 -
${participant.email}
,參與者的電子郵件地址 -
${participant.name}
,參與者姓名 -
${participant.familyName}
,參與者的姓氏 -
${participant.id}
,參與者的id -
${participant.language}
,參與者語言 -
${instance.id}
,工作流程id -
${instance.state}
,工作流程狀態 -
${model.title}
,工作流程模型的標題 -
${model.id}
,工作流程模型的id -
${model.version}
,工作流程模型的版本 -
${payload.data}
,裝載 -
${payload.type}
,裝載類型 -
${payload.path}
,裝載的路徑 -
${host.prefix}
,主機前置詞,例如:http://localhost:4502
新增新語言的電子郵件範本 adding-an-email-template-for-a-new-language
為新語言添加模板:
-
在CRXDE中,新增檔案
<language-code>.txt
如下:/libs/settings/notification-templates/com.day.cq.wcm.core.page
:頁面通知/etc/notification/email/default/com.day.cq.collab.forum
:論壇通知/libs/settings/workflow/notification/email/default
:工作流通知
-
使檔案適應語言。
-
儲存變更。
<language-code>
作為電子郵件範本的檔案名稱必須是AEM可辨識的小寫字母語言代碼。 對於語言代碼,AEM需依賴ISO-639-1。設定AEM Assets電子郵件通知 assetsconfig
AEM Assets中的集合為共用或非共用時,使用者會收到AEM的電子郵件通知。 若要設定電子郵件通知,請遵循下列步驟。
- 依照上文所述,設定電子郵件服務 設定郵件服務.
- 以管理員身分登入AEM。 按一下 工具 > 操作 > Web主控台 開啟Web控制台配置。
- 編輯 日CQ DAM資源收集Servlet. 選擇 傳送電子郵件. 按一下「儲存」。