排程管理任務設定

1.1 版本

1.2 功能簡介

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

管理者登入數據決策系統，點選「管理系統>排程管理>任務管理」，點選「新增任務」，即可建立一個排程管理任務。如下圖所示：

「基本設定」介面如下圖所示：

3.1 任務名稱

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

• 任務名稱不可為空。

• 任務名稱不可與其他排程管理任務重複，否則提示「任務名稱已經存在」。
  

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

• 進行中的任務名稱禁止修改。

3.2 預設使用者組

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

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

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

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

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

4.1 排程物件

排程物件有三種類型：報表範本、多選報表範本、無排程物件。

注：FVS V2.3.1 之前的版本中，僅支援選擇「無調度物件」，再在第 6 章「檔案處理」中，將範本預覽連結填入內容進行通知。

V2.3.1 及之後版本，在安裝  FVS排程管理匯出 插件後，「報表範本」類型支援選擇FVS範本，11.0.25 及之後版本支援多選 FVS 範本。

1）無排程物件

當排程物件選擇「無排程物件」時，僅支援設定「排程結果」，一般用於企業傳送公告。

2）報表範本

當排程物件選擇「報表範本」時，可用於推播、儲存、查看報表執行結果。支援以下設定：

3）多選報表範本

當排程物件選擇「多選報表範本」時，可選擇多張範本，但僅可使用郵件推播報表執行結果。支援以下設定：

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

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

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

4.2 選擇範本

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

注1：排程管理不支援觸發範本web屬性中設定的事件。

注2：多選報表範本時，單個任務最多支援選擇 35 張範本。

4.3 類型

選擇報表的執行方式。

• 如果範本選擇了普通報表，那麼有三種類型，分別為：「預覽、填報、分析」，預設為「預覽」。

• 如果範本選擇了決策報表，那麼只有「預覽」這一種類型。

注1：此處的類型，與範本正常存取一致。例如建議在大數據量下選擇預覽而非分析模式，則在排程管理中也遵循該建議。

注2：安裝 word 報表插件後，在普通報表下會新增「word」類型，詳情請參見：word報表設定排程管理任務 。

4.4 參數設定

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

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

參數設定的「輸入方式」有兩種，分別為：

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

• 資料集：值的資料類型為「自動匹配」，值可選擇伺服器資料集中的資料列。

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

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

注3：FVS 看板資料集參數有多個值時，隨機取一個值進行展示。

4.5 排程結果

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

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

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

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

詳細內容可參見文檔：排程管理生成的附件，生成的結果檔案也會差別開來：

4.6 檔案名稱

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

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

4.7 附件存檔

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

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

附件內容為本文 4.2 節所選擇的範本內容，儲存在%FR_HOME%\webapps\webroot\WEB-INF\schedule資料夾下。如下圖所示：

注：資料夾具體介紹請參見：排程管理生成的附件 。

需要注意以下幾點：

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

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

• FVS 範本生成的附件過大時（一般是複雜的三維範本），可能導致郵件傳送失敗。

4.8 檔案處理

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

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

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

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

「調度週期」的介面如下圖所示：

5.1 開始時間

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

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

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

5.2 執行頻率

1）只執行一次

任務只會執行一次。

2）簡單重複執行

可按分鐘、小時、天、週設定執行間隔的時間段。

3）明細頻率設定

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

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

注2：11.0.5 及之後版本的工程，明細頻率下方的刪除按鈕預設不顯示。僅當勾選了一條/多條明細頻率之後，方出現刪除按鈕。

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

如下圖所示：

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

4）運算式設定

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

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

若運算式設定的執行頻率任務執行中並不觸發，彈窗提示：

以下執行頻率無法觸發，請檢查頻率設定，並確定和任務開始時間、結束時間無衝突。如下圖所示：

注：若運算式設定錯誤，則直接提示：格式錯誤

5.3 結束時間

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

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

5.4 執行條件

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

詳情請參見文檔：定時任務之執行條件判斷

5.5 任務重啟

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

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

定時任務執行重啟遵循以下規則：

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

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

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

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

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

7.1 附件語言

在「排程物件」步驟中若勾選「附件存檔」，排程管理任務結束後生成的附件可修改語言。

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

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