1. 概述
1.1 版本
| 報表伺服器版本 |
|---|
| 11.0 |
1.2 功能簡介
使用者在排程管理中，透過伺服器資料集可以在一次定時任務中實現以下場景：
透過伺服器資料集多值傳參，針對傳入的所有參數生成對應的結果。
使用伺服器資料集中的參數值命名生成的結果附件，並儲存在本地。
使用伺服器資料集定義預設使用者組，將生成的結果透過郵件傳送給組內使用者。
本文將透過具體的範例來示範排程管理中伺服器資料集的使用方法。
2. 範例
2.1 準備使用者資訊
管理者點選「伺服器>伺服器資料集」，建立內建資料集「排程管理使用者資訊」，資料集內容如下圖所示：
這個資料集既是平台使用者資訊表，也是範本參數取數表，需要保證選擇的「name」列資料與平台中的帳號一致，否則任務執行無法成功。
2.2 準備範本
本文範例所用範本為%FR_HOME%\webapps\webroot\WEB-INF\reportlets\GettingStarted.cpt
範本設計步驟請參考：第一張普通報表。
範本樣式如下圖所示：
2.3 匯入使用者
管理者登入數據決策系統，點選「管理系統>使用者管理>所有使用者>匯入使用者」，使用上文的伺服器資料集匯入使用者，如下圖所示：
匯入的資訊中包含了使用者的信箱，即收件人信箱。如不包含信箱資訊，請手動為使用者配置信箱，詳情請參見：新增使用者、匯入使用者、同步使用者。
2.4 設定寄件人
發郵件，需要有一個寄件人，否則傳送動作無法完成。
管理者登入數據決策系統，點選「管理系統>系統管理>信箱」，新增寄件人，點選「確定」，如下圖所示：
注1：寄件人信箱類型不同，配置步驟可能不完全相同，具體請參見：系統管理-郵箱。
注2：配置完成後，請點選「傳送測試郵件」，確定信箱可使用。
2.5 設定定時任務
2.5.1 新增任務
管理者登入數據決策系統，點選「管理系統>排程管理>任務管理」，點選「新增任務」，新增一個排程管理任務。如下圖所示：
2.5.2 基本設定
1）「任務名稱」設定為「地區銷售概況通知」。
2）點選「預設使用者組」的「編輯」按鈕。
選擇使用者為「自訂使用者>排程管理使用者資訊>name」,選取「name」列中的使用者作為預設使用者組。
點選確定。如下圖所示：
注：本步驟僅用於示範如何使用伺服器資料集定義預設使用者組，將生成的結果透過郵件傳送給組內使用者。
並不與範本參數產生聯動效果，不會給指定使用者推播指定參數值的範本內容
確認預設使用者組已選定「資料集：排程管理使用者資訊」、「接收人：name」。點選「確定」，預設使用者組設定完成。點選「下一步」，如下圖所示：
2.2.3 調度物件
1）物件類型選擇：報表範本
2）選擇範本：GettingStarted.cpt
3）點選「設定參數預設值」，系統會自動獲取 GettingStarted 範本中的「地區」參數。
選擇輸入方式為：資料集
值為：排程管理使用者資訊中的「area」列
在執行定時任務時，會根據參數值「area」進行資料過濾，在 schedule 資料夾中的使用者資料夾下生成對應結果的 cpr 檔案。
4）附件存檔勾選：pdf
注：本步驟中勾選了什麼類型的「附件存檔」，傳送郵件時便可以選擇什麼類型的郵件附件。
5）檔案名稱設定：${地區}地區銷售概況
點選「下一步」，如下圖所示：
2.2.4 調度週期
執行頻率選擇「明細頻率設定」，點選「新增」。
設定執行時間為「18時0分」，執行日為「每日」，執行月為「全選」，點選「確定」，即可成功新增明細頻率。
勾選上一步新增的明細頻率。
2.2.5 檔案處理
1）處理方式勾選「郵件通知」。
2）在「郵件通知」設定中：
寄件人為：系統預設寄件人，可下拉選擇其他寄件人
收件人為：「預設使用者組」
主題為：${today()}的銷售情況
郵件內容為：今天銷售情況請查收。
勾選：使用附件 pdf
點選「儲存」，如下圖所示：
2.6 效果預覽
由於該任務的執行頻率是每天晚上 18 時執行一次，無法立刻看到任務效果。
為了立刻看到任務效果，可在「管理系統>排程管理>任務管理」介面找到該任務，選擇「執行一次」。
執行一次後，在「排程管理>運作監視」中，可以查看到定時任務已經成功執行。如下圖所示：
郵件通知成功，已經將生成的結果透過郵件傳送給預設使用者組內所有使用者。
對傳入的參數值，進行範本計算得出不同的結果，如華東地區和華北地區。
在本地 schedule 資料夾中的使用者資料夾下可查看到定時任務生成的結果。如下圖所示：
使用伺服器資料集「area」列作為「地區」參數的值，執行一次後，該定時任務針對傳入的所有參數值均生成了對應的結果檔案。
並使用伺服器資料集中的參數值命名生成的 cpr 檔案和附件。
