系統管理-郵箱

1.1 版本

1.2 功能簡介

FineReport 支援郵件的接收和傳送。不論是郵件的接收還是傳送，都需要郵箱帳號資訊。

1）支援設定多個系統發件人郵箱。支援設定默認發件人郵箱。

2）支援查看歷史郵件傳送記錄。支援根據發件人、收件人郵箱、範本名稱等條件查詢傳送記錄。

設定發件人帳戶分為兩步：

1）新增發件人

2）從已新增的發件人中選擇系統預設發件人

注：若未配置「系統預設發件人」，則認為郵箱未配置。

2.1 新增發件人

管理員登入數據決策系統，點擊「管理系統>系統管理>郵箱」，點擊「新增發件人」，可以設定發件人帳戶，如下圖所示：

「發件人帳戶設定」各設定項說明如下表所示：

配置完「發件人帳戶設定」後，點擊「傳送測試郵件」，填寫一個收件人郵箱，點擊「確定」。

收件人郵箱中收到測試郵件，內容為「恭喜您！您的郵件伺服器已經配置成功」，代表郵件伺服器已配置成功。

點擊「確定」，該收件人新增成功，如下圖所示：

注：「郵件正文」以 HTML 格式顯示，部分字體不支援會顯示為 SimSun 字體

         不支援字體的具體特徵為：字體名稱中間含有空格、「-」等特殊符號，例如「Windding 3」。

一個數據決策系統支援配置多個發件人位址，支援編輯/刪除發件人位址。如下圖所示：

2.2 設定預設發件人

新增完發件人後，管理員可在已新增的發件人中選擇一個作為系統預設發件人，點擊「保存」生效，如下圖所示：

注：若系統預設發件人對應的發件人位址被刪除了，那麼系統預設發件人為空，郵箱配置未完成。

POP3/SMTP 服務開啟可以用用戶端收發郵件，若沒有開啟可能導致郵箱配置失敗。

目前配置發件人帳號，若是 QQ 個人郵箱和 163 郵箱需要通過授權碼來驗證。

注：如果使用者郵箱系統是使用帳號登入而非郵箱位址，可以在「顯示姓名」屬性中配置帳號名實現帳號名認證。

3.1 QQ 個人郵箱

登入 QQ 郵箱，點擊「設定>帳戶」，找到「POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服務>開啟服務>POP3/SMTP服務」，如下圖所示：

點擊「開啟服務」，提示「簡訊驗證」，按照提示傳送簡訊，點擊「我已傳送」，驗證成功即可。如下圖所示：

驗證完成後，提示「成功開啟 POP3/SMTP服務」，「數據決策系統>郵箱>密碼」一欄需填入「授權碼」，而不是郵箱密碼。如下圖所示：

3.2 163 郵箱

登入 163 郵箱，點擊「設定>POP3/SMTP/IMAP」，開啟「POP3/SMTP服務」，如下圖所示：

注：網易郵箱用戶端無法進行該設定，請在網頁端登入進行配置。

點擊「開啟」，提示「帳號安全驗證」，按照提示傳送簡訊，點擊「我已傳送」，驗證成功即可。如下圖所示：

驗證完成後，提示「成功開啟 POP3/SMTP服務」，「數據決策系統>郵箱>密碼」一欄需填入「授權碼」，而不是郵箱密碼。如下圖所示：

注：該授權碼僅顯示一次，請牢記，以防日後需要。

3.3 QQ 企業郵箱

1）獲取埠和加密方式

開啟 QQ 企業郵箱，點擊「設定>用戶端設定」，找到「設定方法>傳送伺服器」。如下圖所示：

數據決策系統配置發件人帳戶時，加密方式和埠需要傳送伺服器一致（例如下圖，埠為465，加密方式為SSL）。

2）獲取用戶端密碼

點擊「微信綁定」，綁定微信。如下圖所示：

成功綁定微信後，需要「開啟安全登入」。如下圖所示：

開啟後，須重新登入郵箱，無法使用原密碼登入。網頁版請使用微信掃碼，用戶端請使用「用戶端專用密碼」登入。

之後，點擊「設定>微信綁定」，首先綁定微信。開啟安全登入後，點擊「用戶端專用密碼>生成新密碼」，如下圖所示：

數據決策系統配置發件人帳戶時，密碼輸入下圖的用戶端密碼，而非郵箱密碼。

3.4 Outlook 郵箱

用戶登入 Outlook 郵箱，點擊「設定>郵件>同步電子郵件」，開啟 POP 服務，如下圖所示：

開啟後可看到伺服器資訊，記錄 SMTP 設定中的伺服器名稱，埠，加密方式等。如下圖所示：

數據決策系統配置發件人帳戶時，郵件伺服器輸入下圖的伺服器名稱，埠和加密方式按照下文的埠和加密方式配置。

3.5 Exchange 郵箱

在新增「發件人帳戶」前，請收集以下資訊：

• 郵件伺服器 (SMTP) ：郵件伺服器所在 IP 地址

• 發件人地址：Exchange 郵箱地址

• 密碼：Exchange 郵箱位址的登入密碼

管理員登入數據決策系統，點擊「管理系統>系統管理>郵箱」，點擊「新增發件人」，設定發件人帳戶。填入提前收集的資訊，加密方式選擇「不加密」，如下圖所示：

配置完「發件人帳戶設定」後，點擊「傳送測試郵件」，填寫一個收件人郵箱，點擊「確定」。

收件人郵箱中收到測試郵件，內容為「恭喜您！您的郵件伺服器已經配置成功」，代表郵件伺服器已配置成功。

點擊「確定」，該收件人新增成功，如下圖所示：

使用者可根據發件人、收件人郵箱、範本名稱、郵件傳送日期等條件，查詢系統傳送出的歷史郵件傳送記錄。

傳送記錄顯示發件人、IP位址、收件人位址、範本名稱、被存取資源、傳送事件、傳送結果等資訊。如下圖所示：

5.1 網路配置

使用郵箱需要確保報表工程和郵箱伺服器之間可以連通。

1）使用外網的郵箱伺服器，如 QQ 郵箱，163 郵箱等，需要保證工程能正常存取到外網。

2）使用用戶自己的內網郵箱伺服器，則無需連結到外網，保證報表工程和郵箱伺服器之間連通即可。

5.2 未加入java受信任清單導致測試郵件傳送失敗

問題描述：

內網伺服器上，使用 foxmail 傳送 SSL 加密過的郵件沒問題，使用 finereport 有問題。改成不加密25埠是可以傳送出來的。

報錯 "Could not connect to SMTP host: SMTP.fanruan.cn, port: 465, response: -1" 。

原因分析：

使用者在內網自行搭建的郵箱伺服器需要加入java憑證信任清單，對於沒有加入到java受信任清單中的證書是無法傳送郵件的。其他的一些用戶端例如 firefox 有自己的證書信任體系就可以正常傳送。

解決方案：

將證書導入到 java 證書受信任清單即可。

5.3 反垃圾機制

日誌報錯：com.sun.mail.smtp.SMTPSendFailedException: 554 DT:SPM 163

原因分析：這個報錯是 163 郵箱伺服器的反垃圾機制，把標題為test的測試郵件當作垃圾郵件了，導致傳送失敗。

解決方案：測試郵件不要寫測試、test之類的字眼，可以傳送成功，說明本身配置沒有問題，只是伺服器自身限制。

5.4 獲取驗證碼出錯

若在一分鐘之內頻繁傳送郵件，會報錯「獲取驗證碼出錯」，如下圖所示：

一分鐘之後繼續傳送即可。