填報成功發送郵件通知

1.1 應用場景

在大多數企業當中，郵件溝通是一個非常常見並且重要的溝通工具，經常性，某個員工完成了某一件事件需要用郵件通知各個相關人員，那麼在 FineReport 該怎麼實現這種，比如說填報一筆資料進資料庫的時候就用郵件通知相關人員呢？

1.2 功能簡介

使用者可使用「傳送郵件」事件，在填報成功後給範本負責人傳送郵件。

1.3 注意事項

1、排程管理自動填報後，不支援自動執行「傳送郵件」事件。

2、傳送郵件設定中使用到儲存格值或者元件值時，不支援動態獲取填報值，只能獲取到初始化的值。

本文範例：

系統中存在範本：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Form\LineForm\行式填報表.cpt

填報人填報成功後，會自動傳送郵件通知範本責任人 Lisa，副本填報人，副本供應商郵箱 。

2.1 設定發件人

發郵件，需要有一個發件人，否則傳送動作無法完成。每個數據決策系統的發件人只需要設定一次即可。

管理者登入數據決策系統，點選「管理系統>系統管理>郵箱」，新增發件人，配置系統預設發件人，點選「儲存」，如下圖所示：

注1：發件人郵箱型別不同，配置步驟可能不完全相同，具體請參見：郵箱。

注2：配置完成後，請點選「傳送測試郵件」，確定郵箱可使用。

注3：若不配置系統預設發件人，2.3節設定傳送郵件事件時，無法進行設定，並提示「您尚未配置發件郵箱，請登入平台進行配置或聯絡管理者」。

2.2 設定收件人

在事件中，需要給 Lisa 和 填報人的郵箱傳送郵件，因此需要給這些人綁定郵箱

管理者登入數據決策系統，點選「管理系統>使用者管理>所有使用者」，編輯銷售部主管 Lisa 的使用者資訊，填入郵箱資訊，點選「確定」。如下圖所示：

注：本範例僅示範如何對系統內的使用者配置郵箱，管理者也可在同步/手動新增使用者時配置好郵箱，詳情請參見：新增使用者、匯入使用者、同步使用者。

郵箱完全配置好後，如下圖所示：

2.3 設定傳送郵件事件

開啟範本：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doctw\Form\LineForm\行式填報表.cpt

1）點選菜單欄「範本>範本Web屬性」，按照範本預覽方式，選擇「填報頁面設定」，切換為「為該範本單獨設定」。

2）點選「 」，新增「填報成功」事件，事件型別選擇「傳送郵件」。

3）JS設定如下圖所示，儲存設定，儲存範本。

「傳送郵件」事件JS設定如下表所示：

2.4 掛載目錄

管理者登入數據決策系統，點選「管理系統>目錄管理>管理目錄」，點選「新增範本」，如下圖所示：

新增範本對話框中勾選 2.3 節制作的範本，點選下一步。

設定目錄名稱為「行式填報表」、掛載型別為「填報」，點選「確定」，範本就被掛載到了數據決策系統主目錄下。

2.5 分配目錄查看權限

管理者登入數據決策系統，點選「管理系統>權限管理>普通權限配置」,選擇權限載體「部門/角色/使用者」，本範例選擇部門「銷售部」。

選擇「目錄權限」Tab，為「銷售部」配置目錄「行式填報表」的「查看」權限，如下圖所示：

2.6 效果預覽

銷售部使用者hanwen（hanwen，123456）登入數據決策系統，開啟目錄「行式填報表」。

填報庫存資訊後，點選「提交」按鈕。

1）彈出「成功」彈窗，代表填報成功。

2）彈出「郵件已傳送」彈窗，代表郵件傳送成功。

此時 hanwen、Lisa、供應商的郵箱收到郵件，如下圖所示：

問題描述：

傳送郵件時提示「郵件傳送失敗。請檢查郵件伺服器配置，確認SMTP郵件伺服器以及帳號密碼和收件人位址填寫正確，並確定網路暢通。」。如下圖所示：

排查步驟1：

數據決策系統未正確設定發件人，請參考本文 2.1 節配置郵箱伺服器。

排查步驟2：

手動輸入帳號，非數據決策系統中的使用者。

請檢查是否存在手動輸入非數據決策系統中的使用者。

排查步驟3：

沒有選擇收件人，或選擇的收件人使用者，全部都未綁定郵箱。

請檢查是否配置收件人，請參考 2.2 節設定收件人郵箱。

注：若存在部分使用者郵箱位址為空情況，不影響其他擁有郵箱位址的使用者收到郵件。