FineBI 支援郵件的接收和傳送。不論是郵件的接收還是傳送,都需要郵箱賬戶資訊。
1)支援設定多個系統發件人郵箱。支援設定預設發件人郵箱。
2)支援查看歷史郵件傳送記錄。支援根據發件人、收件人郵箱、範本名稱等條件查詢傳送記錄。
設定發件人賬戶分為兩步:
1)新增發件人
2)從已新增的發件人中選擇系統預設發件人
注:若未配置「系統預設發件人」,則認為郵箱未配置。
管理者登入數據決策系統,點選「管理系統>系統管理>郵箱」,點選「新增發件人」,可以設定發件人賬戶,如下圖所示:
「發件人賬戶設定」各設定項說明如下表所示:
選擇郵件伺服器
支援下拉選擇適合的郵件伺服器
可手動輸入郵件伺服器,格式為SMTP.郵箱後綴
注:如果 QQ 郵箱伺服器 SMTP.qq.com 不可用,請手動修改為 SMTP.exmail.qq.com
設定郵件服務的埠和加密方式
預設使用25埠,加密方式為TLS加密。一般無需修改。
在設定郵件伺服器的時候,如果伺服器埠不支援預設 25 埠,或者 SMTP 伺服器不支援 SSL 加密(例如新浪郵箱),那麼就必須修改埠號,並設定加密方式。
加密方式包括三種:SSL 加密、TLS 加密、不加密。
注1:建議使用者使用更安全的 TLS 協定。
注2:此處若設定加密方式,請確定加密的憑證已加入 Java 憑證受信任列表中,否則將導致使用者端無法讀取加密後的響應
填寫發件人郵箱位址
每次只能新增一個發件人賬戶
發件人位址郵箱名中支援包含符號‘#’和‘&’
大部分郵箱輸入郵箱密碼即可
QQ 郵箱和 163 郵箱需要填寫「授權碼」,詳情請參見本文第三章
配置完「發件人賬戶設定」後,點選「傳送測試郵件」,填寫一個收件人郵箱,點選「確定」。
收件人郵箱中收到測試郵件,內容為「恭喜您!您的郵件伺服器已經配置成功」,代表郵件伺服器已配置成功。
點選「確定」,該收件人新增成功,如下圖所示:
注:「郵件正文」以 HTML 格式顯示,部分字體不支援會顯示為 SimSun 字體
不支援字體的具體特徵為:字體名稱中間含有空格、「-」等特殊符號,例如「Windding 3」。
一個數據決策系統支援配置多個發件人位址,支援編輯/刪除發件人位址。如下圖所示:
新增完發件人後,管理者可在已新增的發件人中選擇一個作為系統預設發件人,點選「儲存」生效,如下圖所示:
注:若系統預設發件人對應的發件人位址被刪除了,那麼系統預設發件人為空,郵箱配置未完成。
POP3/SMTP 服務開啓可以用使用者端收發郵件,若沒有開啓可能導致郵箱配置失敗。
目前配置發件人帳號,若是 QQ 個人郵箱和 163 郵箱需要透過授權碼來驗證。
登入 QQ 郵箱,點選「設定>賬戶」,找到「POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服務>開啓服務>POP3/SMTP服務」,如下圖所示:
點選「開啓」,提示「驗證密保」,按照提示傳送簡訊,點選「我已傳送」,驗證成功即可。如下圖所示:
驗證完成後,提示「成功開啓 POP3/SMTP服務」,「數據決策系統>郵箱>密碼」一欄需填入「授權碼」,而不是郵箱密碼。如下圖所示:
登入 163 郵箱,點選「設定>POP3/SMTP/IMAP」,開啓「POP3/SMTP服務」,如下圖所示:
點選「開啓」,提示「帳號安全驗證」,按照提示傳送簡訊,點選「我已傳送」,驗證成功即可。如下圖所示:
注:該授權碼僅顯示一次,請牢記,以防日後需要。
1)獲取埠和加密方式
開啟 QQ 企業郵箱,點選「設定>使用者端設定」,找到「設定方法>傳送伺服器」。如下圖所示:
數據決策系統配置發件人賬戶時,加密方式和埠需要傳送伺服器一致(例如下圖,埠為465,加密方式為SSL)。
2)獲取使用者端密碼
點選「微信綁定」,綁定微信。如下圖所示:
成功綁定微信後,需要「開啓安全登入」。如下圖所示:
開啓後,須重新登入郵箱,無法使用原密碼登入。網頁版請使用微信掃碼,使用者端請使用「使用者端專用密碼」登入。
之後,點選「設定>微信綁定」,首先綁定微信。開啓安全登入後,點選「使用者端專用密碼>生成新密碼」,如下圖所示:
數據決策系統配置發件人賬戶時,密碼輸入下圖的使用者端密碼,而非郵箱密碼。
使用者登入 Outlook 郵箱,點選「設定>郵件>同步電子郵件」,開啓 POP 服務,如下圖所示:
開啓後可看到伺服器資訊,記錄 SMTP 設定中的伺服器名稱,埠,加密方式等。如下圖所示:
數據決策系統配置發件人賬戶時,郵件伺服器輸入下圖的伺服器名稱,埠和加密方式按照下文的埠和加密方式配置。
使用者可根據發件人、收件人郵箱、範本名稱、郵件傳送日期等條件,查詢系統傳送出的歷史郵件傳送記錄。
傳送記錄顯示發件人、IP位址、收件人位址、範本名稱、被存取資源、傳送事件、傳送結果等資訊。如下圖所示:
使用郵箱需要確定 BI 工程和郵箱伺服器之間可以連通。
1)使用外網的郵箱伺服器,如 QQ 郵箱,163 郵箱等,需要保證工程能正常存取到外網。
2)使用使用者自己的內網郵箱伺服器,則無需連結到外網,保證 BI 工程和郵箱伺服器之間連通即可。
問題描述:
內網伺服器上,使用 foxmail 傳送 SSL 加密過的郵件沒問題,使用 finereport 有問題。改成不加密25埠是可以傳送出來的。
報錯 "Could not connect to SMTP host: SMTP.fanruan.cn, port: 465, response: -1" 。
原因分析:
使用者在內網自行搭建的郵箱伺服器需要加入java憑證信任列表,對於沒有加入到java受信任列表中的憑證是無法傳送郵件的。其他的一些使用者端例如 firefox 有自己的憑證信任體系就可以正常傳送。
解決方案:
將憑證匯入到 java 憑證受信任列表即可。
日誌報錯:com.sun.mail.smtp.SMTPSendFailedException: 554 DT:SPM 163
原因分析:這個報錯是 163 郵箱伺服器的反垃圾機制,把標題為test的測試郵件當作垃圾郵件了,導致傳送失敗。
解決方案:測試郵件不要寫測試、test之類的字眼,可以傳送成功,說明本身配置沒有問題,只是伺服器自身限制。
若在一分鐘之內頻繁傳送郵件,會報錯「獲取檢驗碼出錯」,如下圖所示:
一分鐘之後繼續傳送即可。