1. 概述
1.1 版本
| 報表伺服器版本 |
|---|
| 11.0 |
1.2 應用場景
1）需要按照部門職位、角色選擇收件人。
2）當使用者安全性要求比較高，希望不能手寫輸入非系統內的使用者；當使用者靈活性要求比較高，希望郵件的收件人可以手寫輸入非系統內的使用者郵件位址。
3）需要多種格式的郵件附件。
1.3 功能簡介
透過工具欄中的郵件傳送按鈕來實現：
1）按照部門職位、角色選擇收件人。
2）控制收件人、副本、密送是否允許自訂值。
3）郵件的附件格式允許多選，且增加 Excel03 格式。
2. 功能簡介
2.1 前提條件
發郵件，需要有一個發件人，否則傳送動作無法完成。
管理者登入數據決策系統，點選「管理系統>系統管理>郵箱」，新增發件人，配置系統預設發件人，點選「儲存」，如下圖所示：
注1：發件人郵箱型別不同，配置步驟可能不完全相同，具體請參見：郵箱。
注2：配置完成後，請點選「傳送測試郵件」，確定郵箱可使用。
2.2 設定單張報表郵件按鈕
如果希望使用者在預覽查看範本時，可以將範本內容透過郵件傳送給使用者，那麼工具欄必須有郵件按鈕。
開啟對應範本，點選「範本>範本Web屬性」，按照範本預覽方式，選擇「分頁預覽設定/填報頁面設定/資料分析設定」。
切換為「為該範本單獨設定」，勾選「使用工具欄」，雙擊新增郵件按鈕（一般預設已新增），雙擊編輯郵件按鈕。可設定項如下圖所示：
2.3 設定伺服器郵件按鈕
如果希望系統中所有範本都使用預設郵件按鈕設定，可採用本節設定。
點選「伺服器>伺服器配置」，按照範本預覽方式，選擇「分頁預覽設定/填報頁面設定/資料分析設定」。
勾選「使用工具欄」，點選「編輯」按鈕，雙擊新增郵件按鈕（一般預設已新增），雙擊編輯郵件按鈕。可設定項如下圖所示：
2.4 設定項簡介
郵件按鈕設定項如下表所示：
| 設定項 | 簡介 |
|---|---|
顯示按鈕圖示 元件圖示 | 控制是否顯示按鈕的圖示 可自訂圖示樣式：選擇內建圖示/自訂上傳圖片，建議使用16 × 16規格的PNG圖片 |
| 顯示按鈕名稱 | 控制是否顯示按鈕的名稱 |
| 元件別名 | 可設定元件別名，主要用於參數呼叫 |
| 收件人允許自訂值 | 若勾選該選項，傳送郵件時，允許手動輸入收件人郵箱位址 若不勾選該選項，傳送郵件時，僅允許選擇數據決策系統中的使用者，傳送給使用者的郵箱 |
| 按部門選擇收件人 | 若勾選該選項，傳送郵件時，允許按照數據決策系統中的部門選擇，傳送給該部門中的使用者的郵箱 若不勾選該選項，則無法按照部門選擇，僅允許按照使用者選擇 |
| 按角色選擇收件人 | 若勾選該選項，傳送郵件時，允許按照數據決策系統中的角色選擇，傳送給該角色下的使用者的郵箱 若不勾選該選項，則無法按照部門選擇，僅允許按照使用者選擇 |
預覽範本時，點選「郵件」按鈕，傳送郵件設定如下 表所示：
| 設定項 | 簡介 |
|---|---|
| 發件人 | 發件人就是2.1節配置的發件人賬戶 |
| 收件人 | 收件人分為3種。 1）使用者： 可選擇數據決策系統中的使用者 若勾選了「收件人允許自訂值」，可手動輸入郵箱位址，使用「,」間隔 2）部門： 勾選了「按部門選擇收件人」，方顯示該設定項 可選擇數據決策系統中的部門 3）角色： 勾選了「按角色選擇收件人」，方顯示該設定項 可選擇數據決策系統中的角色 |
副本 密送 | 可選擇數據決策系統中有權限的使用者 若勾選了「收件人允許自訂值」，可手動輸入郵箱位址，使用「,」間隔 |
| 格式 | 選擇郵件中附件的格式，附件內容為報表內容 可選擇的附件格式為：pdf、excel07、excel03、word、svg |
| 主題 | 郵件的標題 |
| 內容 | 郵件的正文 |
| 正文預覽報表內容 | 在郵件正文預覽報表的內容 |
3. 範例
本文範例：
文檔系統中存在範本「GettingStarted.cpt」，掛載到數據決策系統中。銷售部saleLeader Lisa 可查看該範本。
某天 Lisa 覺得銷售情況非常優秀，將範本內容透過郵件傳送給銷售部全體成員進行表揚，並副本給領導郵箱。
3.1 設定郵件按鈕
如果希望使用者在預覽查看範本時，可以將範本內容透過郵件傳送給使用者，那麼工具欄必須有郵件按鈕。
開啟%FR_HOME%\webapps\webroot\WEB-INF\reportlets\GettingStartedTW.cpt，點選「範本>範本Web屬性」，按照範本預覽方式，選擇「分頁預覽設定」。
切換為「為該範本單獨設定」，勾選「使用工具欄」，雙擊新增郵件按鈕（一般預設已新增），雙擊編輯郵件按鈕。
由於領導的郵箱是數據決策系統中沒有的，因此要勾選「收件人允許自訂值」。
由於需要給部門「銷售部」傳送郵件，因此要勾選「按部門選擇收件人」。
設定項如下圖所示，設定完成後點選儲存，並儲存範本。
3.2 設定發件人
發郵件，需要有一個發件人，否則傳送動作無法完成。
管理者登入數據決策系統，點選「管理系統>系統管理>郵箱」，新增發件人，配置系統預設發件人，點選「儲存」，如下圖所示：
注1：發件人郵箱型別不同，配置步驟可能不完全相同，具體請參見：郵箱。
注2：配置完成後，請點選「傳送測試郵件」，確定郵箱可使用。
3.3 設定收件人
由於需要給銷售部的同事傳送郵件，因此需要確定使用者配置了郵箱，否則選擇了使用者也無法投遞。
管理者登入數據決策系統，點選「管理系統>使用者管理>所有使用者」，編輯 Lisa 的使用者資訊，填入郵箱資訊，點選「確定」。如下圖所示：
注：本範例僅示範如何對使用者Lisa 配置郵箱，管理者也可在同步/手動新增使用者時配置好郵箱，詳情請參見：新增使用者、匯入使用者、同步使用者。
郵箱完全配置好後，如下圖所示：
3.4 掛載目錄
管理者登入數據決策系統，點選「管理系統>目錄管理>管理目錄」，點選「新增範本」，如下圖所示：
新增範本對話框中勾選範本「GettingStartedTW.cpt」，點選下一步。
設定好目錄名稱、展示終端，點選「確定」，範本「GettingStartedTW.cpt」就被掛載到了數據決策系統主目錄下。
3.5 分配目錄查看權限
如果希望 Lisa 可以查看這張範本，可以使用這個範本傳送郵件，必須要賦予 Lisa 目錄查看權限。
管理者登入數據決策系統，點選「管理系統>權限管理>普通權限配置」,選擇權限載體「部門/角色/使用者」，本範例選擇使用者 Lisa.
選擇「目錄權限」Tab，為 Lisa 配置目錄「GettingStartedTW」的「查看」權限，如下圖所示：
3.6 效果預覽
使用者 Lisa（Lisa，123456）登入數據決策系統，查看目錄「GettingStartedTW」，輸入參數並查詢範本。
點選「郵件」，設定收件人部門為銷售部所有職務，副本給領導郵箱，格式選擇PDF，主題和內容如下圖所示：
點選「確定」後，等待郵件傳送成功，提示「郵件已傳送」，如下圖所示：
領導和銷售部使用者的郵箱收到一封郵件，如下圖所示：
4. 注意事項
問題描述：
傳送郵件時提示「郵件傳送失敗。請檢查郵件伺服器配置，確認SMTP郵件伺服器以及帳號密碼和收件人位址填寫正確，並確定網路暢通。」。如下圖所示：
排查步驟1：
數據決策系統未正確設定發件人，請參考本文 2.1 節配置郵箱伺服器。
排查步驟2：
郵件按鈕設定中未勾選「收件人允許自訂值」，但仍手動輸入郵箱位址，且該郵箱位址非數據決策系統中使用者綁定的郵箱位址。
請檢查是否存在手動輸入郵箱位址，或參考 3.1 節修改郵件按鈕設定，並勾選「收件人允許自訂值」。
排查步驟3：
沒有選擇收件人，或選擇的收件人使用者，全部都未綁定郵箱。
請檢查傳送郵件時是否配置收件人，請參考 3.3 節設定發件人郵箱。
注：若存在部分使用者郵箱位址為空情況，不影響其他擁有郵箱位址的使用者收到郵件。
