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