1. 概述
1.1 版本
| BI 伺服器版本 | 功能變更 |
|---|---|
| 5.1 | - |
| 5.1.15 | 發件人賬戶的「加密方式」中，推薦使用者選擇TLS協定 |
| 5.1.20 | 支援配置多個發件人，支援設定預設發件人 |
1.2 功能簡介
FineBI 支援郵件的接收和傳送。不論是郵件的接收還是傳送，都需要郵箱賬戶資訊。
1）支援設定多個系統發件人郵箱。支援設定預設發件人郵箱。
2）支援查看歷史郵件傳送記錄。支援根據發件人、收件人郵箱、範本名稱等條件查詢傳送記錄。
2. 設定發件人賬戶
設定發件人賬戶分為兩步：
1）新增發件人
2）從已新增的發件人中選擇系統預設發件人
注：若未配置「系統預設發件人」，則認為郵箱未配置。
2.1 新增發件人
管理者登入數據決策系統，點選「管理系統>系統管理>郵箱」，點選「新增發件人」，可以設定發件人賬戶，如下圖所示：
「發件人賬戶設定」各設定項說明如下表所示：
| 郵箱設定項 | 簡介 |
|---|---|
| 郵件伺服器 | 選擇郵件伺服器
注：如果 QQ 郵箱伺服器 SMTP.qq.com 不可用，請手動修改為 SMTP.exmail.qq.com |
| 埠和加密方式 | 設定郵件服務的埠和加密方式
注1：建議使用者使用更安全的 TLS 協定。 注2：此處若設定加密方式，請確定加密的憑證已加入 Java 憑證受信任列表中，否則將導致使用者端無法讀取加密後的響應 |
| 發件人位址 | 填寫發件人郵箱位址
|
| 密碼 | 大部分郵箱輸入郵箱密碼即可 QQ 郵箱和 163 郵箱需要填寫「授權碼」，詳情請參見本文第三章 |
| 顯示姓名 | 郵箱發件人的名稱，可手動編輯填寫 |
| 傳送測試郵件 | 測試郵件伺服器是否配置成功 |
配置完「發件人賬戶設定」後，點選「傳送測試郵件」，填寫一個收件人郵箱，點選「確定」。
收件人郵箱中收到測試郵件，內容為「恭喜您！您的郵件伺服器已經配置成功」，代表郵件伺服器已配置成功。
點選「確定」，該收件人新增成功，如下圖所示：
注：「郵件正文」以 HTML 格式顯示，部分字體不支援會顯示為 SimSun 字體
不支援字體的具體特徵為：字體名稱中間含有空格、「-」等特殊符號，例如「Windding 3」。
一個數據決策系統支援配置多個發件人位址，支援編輯/刪除發件人位址。如下圖所示：
2.2 設定預設發件人
新增完發件人後，管理者可在已新增的發件人中選擇一個作為系統預設發件人，點選「儲存」生效，如下圖所示：
注：若系統預設發件人對應的發件人位址被刪除了，那麼系統預設發件人為空，郵箱配置未完成。
3. 開啓 POP3/SMTP 服務與生成授權碼
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 設定中的伺服器名稱，埠，加密方式等。如下圖所示：
數據決策系統配置發件人賬戶時，郵件伺服器輸入下圖的伺服器名稱，埠和加密方式按照下文的埠和加密方式配置。
4. 傳送記錄
使用者可根據發件人、收件人郵箱、範本名稱、郵件傳送日期等條件，查詢系統傳送出的歷史郵件傳送記錄。
傳送記錄顯示發件人、IP位址、收件人位址、範本名稱、被存取資源、傳送事件、傳送結果等資訊。如下圖所示：
5. 注意事項
5.1 網路配置
使用郵箱需要確定 BI 工程和郵箱伺服器之間可以連通。
1）使用外網的郵箱伺服器，如 QQ 郵箱，163 郵箱等，需要保證工程能正常存取到外網。
2）使用使用者自己的內網郵箱伺服器，則無需連結到外網，保證 BI 工程和郵箱伺服器之間連通即可。
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 獲取檢驗碼出錯
若在一分鐘之內頻繁傳送郵件，會報錯「獲取檢驗碼出錯」，如下圖所示：
一分鐘之後繼續傳送即可。