1.1 版本

1.2 功能簡(jiǎn)介

FineReport 支持郵件的接收和發(fā)送。不論是郵件的接收還是發(fā)送，都需要郵箱賬戶信息。

1）支持設(shè)置多個(gè)系統(tǒng)發(fā)件人郵箱。支持設(shè)置默認(rèn)發(fā)件人郵箱。

2）支持查看歷史郵件發(fā)送記錄。支持根據(jù)發(fā)件人、收件人郵箱、模板名稱等條件查詢發(fā)送記錄。

設(shè)置發(fā)件人賬戶分為兩步：

1）添加發(fā)件人

2）從已添加的發(fā)件人中選擇系統(tǒng)默認(rèn)發(fā)件人

注：若未配置「系統(tǒng)默認(rèn)發(fā)件人」，則認(rèn)為郵箱未配置。

2.1 添加發(fā)件人

管理員登錄數(shù)據(jù)決策系統(tǒng)，點(diǎn)擊「管理系統(tǒng)>系統(tǒng)管理>郵箱」，點(diǎn)擊「添加發(fā)件人」，可以設(shè)置發(fā)件人賬戶，如下圖所示：

「發(fā)件人賬戶設(shè)置」各設(shè)置項(xiàng)說(shuō)明如下表所示：

配置完「發(fā)件人賬戶設(shè)置」后，點(diǎn)擊「發(fā)送測(cè)試郵件」，填寫(xiě)一個(gè)收件人郵箱，點(diǎn)擊「確定」。

收件人郵箱中收到測(cè)試郵件，內(nèi)容為「恭喜您！您的郵件服務(wù)器已經(jīng)配置成功」，代表郵件服務(wù)器已配置成功。

點(diǎn)擊「確定」，該收件人添加成功，如下圖所示：

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

         不支持字體的具體特征為：字體名稱中間含有空格、「-」等特殊符號(hào)，例如「Windding 3」。

一個(gè)數(shù)據(jù)決策系統(tǒng)支持配置多個(gè)發(fā)件人地址，支持編輯/刪除發(fā)件人地址。如下圖所示：

2.2 設(shè)置默認(rèn)發(fā)件人

添加完發(fā)件人后，管理員可在已添加的發(fā)件人中選擇一個(gè)作為系統(tǒng)默認(rèn)發(fā)件人，點(diǎn)擊「保存」生效，如下圖所示：

注：若系統(tǒng)默認(rèn)發(fā)件人對(duì)應(yīng)的發(fā)件人地址被刪除了，那么系統(tǒng)默認(rèn)發(fā)件人為空，郵箱配置未完成。

POP3/SMTP 服務(wù)開(kāi)啟可以用客戶端收發(fā)郵件，若沒(méi)有開(kāi)啟可能導(dǎo)致郵箱配置失敗。

目前配置發(fā)件人賬號(hào)，若是 QQ 個(gè)人郵箱和 163 郵箱需要通過(guò)授權(quán)碼來(lái)驗(yàn)證。

3.1 QQ 個(gè)人郵箱

登錄 QQ 郵箱，點(diǎn)擊「設(shè)置>賬戶」，找到「POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服務(wù)>開(kāi)啟服務(wù)>POP3/SMTP服務(wù)」，如下圖所示：

點(diǎn)擊「開(kāi)啟」，提示「驗(yàn)證密?！梗凑仗崾景l(fā)送短信，點(diǎn)擊「我已發(fā)送」，驗(yàn)證成功即可。如下圖所示：

驗(yàn)證完成后，提示「成功開(kāi)啟 POP3/SMTP服務(wù)」，「數(shù)據(jù)決策系統(tǒng)>郵箱>密碼」一欄需填入「授權(quán)碼」，而不是郵箱密碼。如下圖所示：

3.2 163 郵箱

登錄 163 郵箱，點(diǎn)擊「設(shè)置>POP3/SMTP/IMAP」，開(kāi)啟「POP3/SMTP服務(wù)」，如下圖所示：

注：網(wǎng)易郵箱客戶端無(wú)法進(jìn)行該設(shè)置，請(qǐng)?jiān)诰W(wǎng)頁(yè)端登錄進(jìn)行配置。

點(diǎn)擊「開(kāi)啟」，提示「賬號(hào)安全驗(yàn)證」，按照提示發(fā)送短信，點(diǎn)擊「我已發(fā)送」，驗(yàn)證成功即可。如下圖所示：

驗(yàn)證完成后，提示「成功開(kāi)啟 POP3/SMTP服務(wù)」，「數(shù)據(jù)決策系統(tǒng)>郵箱>密碼」一欄需填入「授權(quán)碼」，而不是郵箱密碼。如下圖所示：

注：該授權(quán)碼僅顯示一次，請(qǐng)牢記，以防日后需要。

3.3 QQ 企業(yè)郵箱

1）獲取端口和加密方式

打開(kāi) QQ 企業(yè)郵箱，點(diǎn)擊「設(shè)置>客戶端設(shè)置」，找到「設(shè)置方法>發(fā)送服務(wù)器」。如下圖所示：

數(shù)據(jù)決策系統(tǒng)配置發(fā)件人賬戶時(shí)，加密方式和端口需要發(fā)送服務(wù)器一致（例如下圖，端口為465，加密方式為SSL）。

2）獲取客戶端密碼

點(diǎn)擊「微信綁定」，綁定微信。如下圖所示：

成功綁定微信后，需要「開(kāi)啟安全登錄」。如下圖所示：

開(kāi)啟后，須重新登錄郵箱，無(wú)法使用原密碼登錄。網(wǎng)頁(yè)版請(qǐng)使用微信掃碼，客戶端請(qǐng)使用「客戶端專用密碼」登錄。

之后，點(diǎn)擊「設(shè)置>微信綁定」，首先綁定微信。開(kāi)啟安全登錄后，點(diǎn)擊「客戶端專用密碼>生成新密碼」，如下圖所示：

數(shù)據(jù)決策系統(tǒng)配置發(fā)件人賬戶時(shí)，密碼輸入下圖的客戶端密碼，而非郵箱密碼。

3.4 Outlook郵箱

用戶登錄 Outlook 郵箱，點(diǎn)擊「設(shè)置>郵件>同步電子郵件」，開(kāi)啟 POP 服務(wù)，如下圖所示：

開(kāi)啟后可看到服務(wù)器信息，記錄 SMTP 設(shè)置中的服務(wù)器名稱，端口，加密方式等。如下圖所示：

數(shù)據(jù)決策系統(tǒng)配置發(fā)件人賬戶時(shí)，郵件服務(wù)器輸入下圖的服務(wù)器名稱，端口和加密方式按照下文的端口和加密方式配置。

用戶可根據(jù)發(fā)件人、收件人郵箱、模板名稱、郵件發(fā)送日期等條件，查詢系統(tǒng)發(fā)送出的歷史郵件發(fā)送記錄。

發(fā)送記錄顯示發(fā)件人、IP地址、收件人地址、模板名稱、被訪問(wèn)資源、發(fā)送事件、發(fā)送結(jié)果等信息。如下圖所示：

5.1 網(wǎng)絡(luò)配置

使用郵箱需要確保報(bào)表工程和郵箱服務(wù)器之間可以連通。

1）使用外網(wǎng)的郵箱服務(wù)器，如 QQ 郵箱，163 郵箱等，需要保證工程能正常訪問(wèn)到外網(wǎng)。

2）使用用戶自己的內(nèi)網(wǎng)郵箱服務(wù)器，則無(wú)需連接到外網(wǎng)，保證報(bào)表工程和郵箱服務(wù)器之間連通即可。

5.2 未加入java受信任列表導(dǎo)致測(cè)試郵件發(fā)送失敗

問(wèn)題描述：

內(nèi)網(wǎng)服務(wù)器上，使用 foxmail 發(fā)送 SSL 加密過(guò)的郵件沒(méi)問(wèn)題，使用 finereport 有問(wèn)題。改成不加密25端口是可以發(fā)送出來(lái)的。

報(bào)錯(cuò) 'Could not connect to SMTP host: SMTP.fanruan.cn, port: 465, response: -1' 。

原因分析：

用戶在內(nèi)網(wǎng)自行搭建的郵箱服務(wù)器需要加入java證書(shū)信任列表，對(duì)于沒(méi)有加入到j(luò)ava受信任列表中的證書(shū)是無(wú)法發(fā)送郵件的。其他的一些客戶端例如 firefox 有自己的證書(shū)信任體系就可以正常發(fā)送。

解決方案：

將證書(shū)導(dǎo)入到 java 證書(shū)受信任列表即可。

5.3 反垃圾機(jī)制

日志報(bào)錯(cuò)：com.sun.mail.smtp.SMTPSendFailedException: 554 DT:SPM 163

原因分析：這個(gè)報(bào)錯(cuò)是 163 郵箱服務(wù)器的反垃圾機(jī)制，把標(biāo)題為test的測(cè)試郵件當(dāng)作垃圾郵件了，導(dǎo)致發(fā)送失敗。

解決方案：測(cè)試郵件不要寫(xiě)測(cè)試、test之類的字眼，可以發(fā)送成功，說(shuō)明本身配置沒(méi)有問(wèn)題，只是服務(wù)器自身限制。

5.4 獲取驗(yàn)證碼出錯(cuò)

若在一分鐘之內(nèi)頻繁發(fā)送郵件，會(huì)報(bào)錯(cuò)「獲取驗(yàn)證碼出錯(cuò)」，如下圖所示：

一分鐘之后繼續(xù)發(fā)送即可。