配置電子郵件通知

AEM會傳送電子郵件通知給下列使用者：

• 已訂閱頁面事件，例如修改或復寫。 通知收件匣區段說明如何訂閱這類事件。

• 已訂閱論壇活動。

• 必須在工作流程中執行步驟。 參與者步驟部分介紹如何在工作流中觸發電子郵件通知。

先決條件：

• 使用者的設定檔中必須定義有效的電子郵件地址。
• Day CQ Mail Service​需要正確配置。

收到通知時，使用者會收到其設定檔中定義的語言電子郵件。 每種語言都有各自的範本，可供自訂。 可針對新語言新增新的電子郵件範本。

配置郵件服務

若要讓AEM能夠傳送電子郵件，Day CQ Mail Service​必須正確設定。 您可以在Web主控台中檢視設定。 使用AEM時，有數種方法可管理這類服務的組態設定；如需詳細資訊和建議實務，請參閱設定OSGi 。

下列限制適用：

• SMTP伺服器埠​必須是25或更高。

• SMTP伺服器主機名​不得空白。

• "From"地址​不得空白。

若要協助您對​Day CQ Mail Service​的問題進行偵錯，您可以監看服務的記錄檔：

com.day.cq.mailer.DefaultMailService

在Web控制台中，配置如下所示：

配置電子郵件通知通道

當您訂閱頁面或論壇事件通知時，預設會將寄件者電子郵件地址設為no-reply@acme.com。 您可以在Web主控台中設定​通知電子郵件通道​服務，以變更此值。

若要設定寄件者電子郵件地址，請新增sling:OsgiConfig節點至存放庫。 使用以下過程直接使用CRXDE Lite添加節點：

1. 在「CRXDE Lite」中，在應用程式資料夾下添加名為config的資料夾。

2. 在設定資料夾中，新增節點：

   com.day.cq.wcm.notification.email.impl.EmailChannel 類型 sling:OsgiConfig

3. 將String屬性新增至名為email.from的節點。 對於值，指定您要使用的電子郵件地址。

4. 按一下「全部保存」。

使用以下過程來定義內容包源資料夾中的節點：

1. 在jcr_root/apps/*app_name*/config folder中，建立名為com.day.cq.wcm.notification.email.impl.EmailChannel.xml的檔案

2. 添加以下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"/>

3. 將email.from屬性(name@server.com)的值取代為您的電子郵件地址。

4. 儲存檔案。

配置工作流電子郵件通知服務

當您收到工作流程電子郵件通知時，寄件者電子郵件地址和主機URL首碼都會設為預設值。 您可以在Web主控台中設定​Day CQ Workflow Email Notification Service​以變更這些值。 若您這麼做，建議您將變更保留在存放庫中。

預設配置在Web控制台中如下所示：

頁面通知的電子郵件範本

頁面通知的電子郵件範本位於下方：

/etc/notification/email/default/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.

自訂頁面通知的電子郵件範本

若要自訂頁面通知的英文電子郵件範本：

1. 在CRXDE中，開啟檔案：

   /etc/notification/email/default/com.day.cq.wcm.core.page/en.txt

2. 根據您的需求修改檔案。

3. 儲存變更。

範本必須具備下列格式：

 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

論壇通知的電子郵件模板

論壇通知的電子郵件範本位於：

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

自訂論壇通知的電子郵件範本

若要自訂論壇通知的英文電子郵件範本：

1. 在CRXDE中，開啟檔案：

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

2. 根據您的需求修改檔案。

3. 儲存變更。

範本必須具備下列格式：

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

其中<text_x>可以是靜態文字和動態字串變數的混合。

下列變數可在電子郵件範本中用於論壇通知：

• ${time}，事件日期和時間。

• ${forum.path}，即論壇頁面的路徑。

工作流通知的電子郵件模板

工作流程通知的電子郵件範本（英文）位於：

/etc/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.

自定義工作流通知的電子郵件模板

若要自訂工作流程事件通知的英文電子郵件範本：

1. 在CRXDE中，開啟檔案：

   /etc/workflow/notification/email/default/en.txt

2. 根據您的需求修改檔案。

3. 儲存變更。

範本必須具備下列格式：

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

方法${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

為新語言添加電子郵件模板

為新語言添加模板：

1. 在CRXDE中，新增下方的檔案<language-code>.txt:

   • /etc/notification/email/default/com.day.cq.wcm.core.page :頁面通知
   • /etc/notification/email/default/com.day.cq.collab.forum :論壇通知
   • /etc/workflow/notification/email/default :工作流通知

2. 使檔案適應語言。

3. 儲存變更。

設定AEM Assets電子郵件通知

AEM Assets中的集合為共用或非共用時，使用者會收到AEM的電子郵件通知。 若要設定電子郵件通知，請遵循下列步驟。

1. 如上文設定郵件服務中所述，配置電子郵件服務。
2. 以管理員身分登入AEM。 按一下​工具 > 操作 > Web控制台​以開啟Web控制台配置。
3. 編輯​Day CQ DAM資源收集Servlet。 選取​傳送電子郵件。 按一下「儲存」。