排程管理任務設定

1

版本。

2

功能簡介。

1. 排程管理任務設定時有四個操作步驟，如下圖所示。本文將詳細介紹這四個操作步驟中的設定項。

1. 管理者登入數據決策系統，點選【管理系統】→【排程管理】→【任務管理】，點選【新增任務】，即可建立一個排程管理任務。如下圖所示。

1. 【基本設定】介面如下圖所示。

1

任務名稱。

1. 填寫排程管理任務的名稱。

2. 任務名稱不可為空。

3. 任務名稱不可與其他排程管理任務重複，否則提示【任務名稱已經存在】。

4. 任務名稱只允許包含字母、漢字、數字、底線、減號、點和括號。

2

預設使用者組。

1. 用途：設定預設使用者組的目的是為了在第四步【檔案處理】時根據使用者組成員傳送通知。預設使用者組可為空。

2. 設定：點選【編輯】按鈕，支援根據【使用者、部門、角色】來新增預設使用者組成員，點選【確定】即可成功新增，最終的使用者組取三者的並集且去掉重複項。

3. 其中，使用者的新增方式有兩種：

   平台：使用者來源於數據決策系統。

   自訂使用者：使用者來源於伺服器資料集。但是選擇的資料集列資料需要是平台中的帳號，否則任務執行無法成功。

1

調度物件。

1. 調度物件有三種型別：報表範本、多選報表範本、無調度物件。

2. 無調度物件：當調度物件選擇【無調度物件】時，僅支援設定【調度結果】，一般用於企業傳送公告。

3. 報表範本：當調度物件選擇【報表範本】時，可用於派送、儲存、查看報表執行結果。支援以下設定：

4. 多選報表範本：當調度物件選擇【多選報表範本】時，可選擇多張範本，但僅可使用郵件派送報表執行結果。支援以下設定：

        多選報表範本和單個報表範本的設定基本相同，可為每張範本單獨配置參數設定、檔案名稱稱和附件存檔。支援拖拽調整範本的先後順序。

        執行條件處若使用【公式判斷】或【自訂類判斷】，涉及到和範本內容相關的，只支援取第一個選中的範本。

        檔案處理處僅支援【郵件通知】一種處理方式，標題或正文中若使用公式，只支援取第一個選中的範本。

2

選擇範本。

1. 從報表工程【%FR_HOME%\webapps\webroot\WEB-INF\reportlets】目錄中選擇報表，不能為空。

3

型別。

1. 選擇報表的執行方式。

2. 如果範本選擇了普通報表，那麼有三種型別，分別為：【預覽、填報、分析】，預設為【預覽】。

3. 如果範本選擇了決策報表，那麼只有【預覽】這一種型別。

4

參數設定。

1. 參數設定可以影響排程管理生成的結果報表。

2. 參數設定可以和調度結果聯合使用，可以為預設使用者組裏面的成員生成獨立的報表結果。

3. 參數設定的【輸入方式】有兩種，分別為：

        預設：支援選擇值的資料型別，值可手動填寫。支援字串、整數型態、雙精度型、日期、布林型、公式。

        資料集：值的資料型別為【自動匹配】，值可選擇伺服器資料集中的資料列。

注1：【參數設定】中有關參數的注意事項請參見：排程管理支援的公式 。

注2：點選【重新整理】按鈕，可一鍵獲取範本中的參數和參數預設值，但是會使得手動新增的參數消失。

5

調度結果。

注：若【排程管理】→【基本設定】→【預設使用者組】為空，則【調度結果】這個功能置灰不可用。

1. 若勾選了【除通用結果外，根據預設使用者組內的使用者單獨生成結果】設定項，那麼會為【預設使用者組】裏面的所有成員生成獨立的報表結果。

2. 獨立報表結果的資料夾以預設使用者組成員的帳號命名，同時也會生成通用報表結果。

           帳號相關的參數會生效，具體效果請參見：排程任務郵件傳送實現不同的人傳送不同內容。

           如果不勾選這個設定項，則只生成通用報表結果。

3. 詳細內容可參見文檔：B03-06 權限管理-排程管理，生成的結果檔案也會差別開來。

6

檔案名稱。

1. 生成結果檔案的名稱，包括了結果報表、附件（excel、word、pdf），支援公式輸入，比如【${now()}】。

2. 如果不填寫的話生成的結果報表和附件名稱就使用範本名稱（去後綴）。

7

附件存檔。

1. 可選擇生成的附件型別，包括：結果報表(.cpr檔案 )，excel03、excel07、word、pdf。

2. 若勾選附件存檔後的選項，排程管理任務結束後，會生成不同格式的附件。

3. 附件內容為本文 第四章第2節所選擇的範本內容，儲存在【%FR_HOME%\webapps\webroot\WEB-INF\schedule】資料夾下。如下圖所示。

注：資料夾具體介紹請參見：B03-06 權限管理-排程管理 。

1. 需要注意以下幾點：

2. Word 附件中，不支援 FRM 報表中的圖表組件，只支援儲存格元素圖表。

3. 設定定時任務時，若在【調度物件】步驟中選擇範本的型別為決策報表，並勾選附件存檔excel03、excel07、word、pdf，則生成的附件不支援 body 背景色。

8

檔案處理。

1. 可配置檔案處理的邏輯，預設選中【僅保留最近1次】。

2. 若選擇【任務結束即清理】，任務結束後會將 所有結果檔案 都清理掉（包括 cpr 和附件）。

3. 所以當所設定的排程管理任務需要使用排程管理附件時，例如在 檔案處理 步驟中勾選【使用附件】的【郵件通知、FTP上傳附件、自訂附件處理】等，會出現結果檔案被清理，無法找到的問題。同時存取【定時結果連結】時也會報錯：【非常抱歉，您無法查看該頁面，Index: 0, Size: 0，如需存取請聯系管理者】。

注：當生成的結果報表超過 10 個時，在點選下一步時會彈出提示資訊：【預計産生N套結果檔案，可能導緻計算量過大，是否繼續】，如果點選繼續，則跳到下一步調度週期的設定。

1. 【調度週期】的介面如下圖所示。

1

開始時間。

1. 設定該排程管理任務的開始執行時間。支援兩種配置。

2. 配置結束立即執行：排程管理任務設定完成後立馬執行。

3. 設定開始時間：在指定的開始時間後執行任務，支援精確到秒。

2

執行頻率。

1. 只執行一次：任務只會執行一次。

2. 簡單重複執行：可按分鍾、小時、天、週設定執行間隔的時間段。

3. 明細頻率設定：按月、日、時、分的格式設定執行頻率。可自由組合。

   若不觸發所設定的明細頻率，彈窗提示：【以下執行頻率無法觸發，請檢查頻率設定，並確定和任務開始時間、結束時間無沖突】。如下圖1所示。

4. 表式設定：透過表式的形式設定執行頻率。

   表式設定的正文框可自己手動填寫 cronExpression，也可透過點選旁邊的表式設定按鈕來直接選擇相應的表式，點選【預設表式】按鈕時，展開預設表式視窗，點選其中的文字說明，則其上的正文框顯示並儲存相應的 cronExpression，再次點選收起預設表式按鈕時收起預設表式視窗，詳細內容參見文檔：B06-04 運算式設定。

   若表式設定的執行頻率任務執行中並不觸發，彈窗提示：【以下執行頻率無法觸發，請檢查頻率設定，並確定和任務開始時間、結束時間無沖突】。

注1：設定明細頻率後，無需勾選該頻率前面的方框，所有的頻率都會生效。

注2：若一個調度任務設定了多條明細頻率，任務管理頁面顯示的下次運作時間。會根據第一條明細來顯示，但真正的執行時間仍為所有的明細值。如下圖所示。

注3：若表式設定錯誤，則直接提示：格式錯誤。

3

結束時間。

1. 結束時間包括【任務執行一次後結束、無限期、設定結束時間、額外重複執行次數】四個設定項。

2. 根據執行頻率的不同，結束時間的設定項也會有所不同，詳情請參見下表。

4

執行條件。

1. 執行條件是指在執行定時任務之前進行判斷，滿足條件才執行定時任務，不滿足則不執行或者延遲一段時間後再校驗執行。

2. 詳情請參見文檔：排程管理之條件判斷。

5

任務重啓。

1. 任務重啓設定是一項防範措施，用於定時任務執行可能中斷（例如網路原因導緻郵件傳送失敗，不滿足執行條件中斷等）時的自動重啓。

2. 如果定時任務執行中斷且設定了自動重啓，那麼該定時任務就會按照自動重啓項的設定重新執行直至成功或者達到所設定重啓次數的最大值，任務重啓設定預設不啟用。

3. 定時任務執行重啓遵循以下規則：

         如果【快照生成】失敗，那麼對應的附件傳送不會執行。

         重啓策略適用於【條件判斷、快照生成、附件傳送】三個方面的判斷，逐一進行判斷，如果不成功則進行確定是否採用了重啓策略。

         重啓時遵循任務最小化原則：如果快照生成正常、附件傳送有問題，那麼只需要重新傳送附件，並且只需要重新傳送之前傳送失敗的專案（郵件、FTP、自訂附件處理，哪個失敗傳送哪個即可）。

1. 【檔案處理】介面，支援多種處理方式，如下圖所示。

注1：調度物件為無調度物件時，僅支援平台通知、郵件通知、簡訊通知、使用者端通知四種處理方式。

注2：調度物件為多選報表範本時，僅支援郵件通知處理方式。

1

附件語言。

1. 在【調度物件】步驟中若勾選【附件存檔】，排程管理任務結束後生成的附件可修改語言。

2. 超級管理者可透過【fine_conf_entity視覺化配置插件】改變排程管理生成附件的語言。重啓伺服器後設定生效。

注：修改 FineDB 資料庫表欄位值的方法請參考 FineDB 常用表字段修改 。