排程管理支援的公式- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 版本

報表伺服器版本	功能變更
11.0	-
11.0.4	檔案處理-郵件通知-收件人-自訂信箱支援輸入公式檔案處理-郵件通知-複本人-自訂信箱支援輸入公式檔案處理-郵件通知-密送人-自訂信箱支援輸入公式檔案處理-使用者端通知-自訂連結支援輸入公式

報表伺服器版本

功能變更

11.0

11.0.4

檔案處理-郵件通知-收件人-自訂信箱支援輸入公式

檔案處理-郵件通知-複本人-自訂信箱支援輸入公式

檔案處理-郵件通知-密送人-自訂信箱支援輸入公式

檔案處理-使用者端通知-自訂連結支援輸入公式

1.2 功能簡介

本文將詳細介紹設定排程管理任務程式中，可以使用的公式及其用法。

注1：排程管理任務中，無法觸發報表的 JS 事件。

注2：排程管理任務中，「調度週期-執行條件-公式判斷」處支援將儲存格作為參數傳給其他公式使用；除此之外的其他地方，都不支援將儲存格作為參數傳給其他公式使用。

注3：排程管理任務中，公式的長度過長、公式解析後的收件人長度過長、公式解析後的主題過長等情況，都有可能導致排程管理任務執行失敗。

2. FineReport 範本

類型	公式/參數/函式	使用位置	備注
參數	使用者全局參數： ${fine_username}${fine_position}${fine_role}${fr_username}${fr_userposition}${fr_authority}	排程物件-參數設定排程物件-檔案名稱調度週期-執行條件-公式判斷檔案處理-平台通知-主題和內容檔案處理-郵件通知-主題和內容檔案處理-使用者端通知-主題和內容檔案處理-簡訊通知-簡訊參數檔案處理-郵件通知-收件人-自訂信箱檔案處理-郵件通知-複本人-自訂信箱檔案處理-郵件通知-密送人-自訂信箱檔案處理-使用者端通知-自訂連結	1）作為參數時，在【排程物件-參數設定】和【調度週期-執行條件-公式判斷】中不要加【{}】，例如：【$fine_role】；其他情況要加【{}】，例如【${fine_role}】。 2）使用使用者全局參數，需要勾選【除通用結果外，根據預設使用者組內的使用者單獨生成結果】。 3）【掛載平台】、【FTP 上傳附件】、【列印檔案】使用通用結果資料夾下的檔案，無法使用【使用者全局參數】。
	資料集參數範本參數全局參數		1）作為參數時，在【排程物件-參數設定】和【調度週期-執行條件-公式判斷】中不要加【{}】，例如：【$p】；其他情況要加【{}】，例如：【${p}】。 2）在【排程物件-參數設定】右側，點選【設定參數預設值】，參數列表載入後，才能在排程管理的其他地方引用資料集參數/範本參數/全局參數。 3）對於資料集參數，只能獲取到【範本資料集】的參數，不能得到【伺服器資料集】的參數和【報表函式】。
	自訂參數		作為參數時，在【排程物件-參數設定】和【調度週期-執行條件-公式判斷】中不要加【{}】，例如：【$p】；其他情況要加【{}】，例如【${p}】。
結果報表儲存格值	範例： sum(B8,C8)>1000	排程物件-參數設定排程物件-檔案名稱調度週期-執行條件-公式判斷檔案處理-平台通知-主題和內容檔案處理-郵件通知-主題和內容檔案處理-使用者端通知-主題和內容檔案處理-簡訊通知-簡訊參數檔案處理-郵件通知-收件人-自訂信箱檔案處理-郵件通知-複本人-自訂信箱檔案處理-郵件通知-密送人-自訂信箱檔案處理-使用者端通知-自訂連結	1）作為參數時，在【調度週期-執行條件-公式判斷】中，直接使用【A2】，其他情況下不能作為函式參數，只能使用【${A2}】的格式。 2）只取預設 sheet 頁的儲存格值，不能跨 sheet 取數。 3）若 A1 儲存格的值可拓展為 1，2，3三個值：【調度週期-執行條件-公式判斷】功能：2018-12-27 之前的 JAR 中，使用【${A1}】公式取到的是 1 ；2018-12-27 之後的 JAR 中，使用【${A1}】公式取到的是包含 1，2，3 三個元素的陣列。其他功能：使用【${A1}】公式取到的都是 1。
表單公式	決策報表的組件，可以引用該決策報表的【報表塊】中儲存格的資料公式格式為：【報表塊名稱～儲存格】範例：${report0~A1}	排程物件-參數設定排程物件-檔案名稱調度週期-執行條件-公式判斷檔案處理-平台通知-主題和內容檔案處理-郵件通知-主題和內容檔案處理-使用者端通知-主題和內容檔案處理-簡訊通知-簡訊參數檔案處理-郵件通知-收件人-自訂信箱檔案處理-郵件通知-複本人-自訂信箱檔案處理-郵件通知-密送人-自訂信箱檔案處理-使用者端通知-自訂連結	作為參數時，在【調度週期-執行條件-公式判斷】中，直接使用【report0~A1】。其他情況下使用【${report0~A1}】。注：2019-11-08 之後的 JAR 支援表單公式的使用，但不支援自訂報表塊名稱。
報表塊公式	範例： ${block1~A4}		作為參數時，在【調度週期-執行條件-公式判斷】中，直接使用參數名【block1~A4】就能取數。其他情況下使用【${block1~A4}】才能取數。注：2020-04-26 及之後的 JAR 支援複合式報表報表塊公式的使用。
跨sheet公式	範例： 'sheet1'!A1	調度週期-執行條件-公式判斷	僅支援在排程管理的調度週期-執行條件-公式判斷中，對非複合式報表使用跨sheet公式不支援對複合式報表使用不支援在排程管理其他位置使用
常用函式	SUM、COUNT、 AVERAGE、CHAR、DATE、MAX、 MIN、TIME、 RANGE	排程物件-參數設定排程物件-檔案名稱調度週期-執行條件-公式判斷檔案處理-平台通知-主題和內容檔案處理-郵件通知-主題和內容檔案處理-使用者端通知-主題和內容檔案處理-簡訊通知-簡訊參數檔案處理-郵件通知-收件人-自訂信箱檔案處理-郵件通知-複本人-自訂信箱檔案處理-郵件通知-密送人-自訂信箱檔案處理-使用者端通知-自訂連結	1）作為參數時，在【排程物件-參數設定】和【調度週期-執行條件-公式判斷】中不要加【${}】，其他情況要加【${}】。例如【AND(1+7=8,5+7=12)】，在排程管理中應該寫為【${AND(1+7=8,5+7=12)}】，不要加【=】號。注：請不要手動給公式前面新增=號，寫成=${AND(1+7=8,5+7=12)} 2）【WEIGHTEDAVERAGE的】參數只能是常數陣列，不能是【A1:A4】這種形式。 3）【FORMAT】函式，不支援引用範本中的儲存格。 4）【COL】和【ROW】寫在儲存格中，在排程管理中雖然不會報錯，但是沒有意義，回傳值為常數 0 。【COL()】傳回當前儲存格的列號。例如，若當前儲存格是 A5 ，在 A5 中寫入：【=col()】，傳回 1 ；若當前儲存格是 C6 ，在 A5 中寫入：【=col()】，傳回 3。 5）【COLCOUNT】、【COLNAME】、【MAP】、【ROWCOUNT】、【TABLEDATAFIELDS】、【VALUE】這些函式的參數中包括有資料集，在排程管理中，只能使用全局資料集，無法獲取範本資料集。 6）【WEBIMAGE】用來顯示網頁上的圖片，在排程管理中傳回【com.fr.file.WebImage@23dd10da】類似格式。 7）REPORTCHECK雖不會報錯，但是不生效。 8）CELLSUM雖有回傳值，但是無意義。
數學和三角函式	ABS、ACOS、ACOSH、ASIN、ASINH、ATAN、ATAN2、AVERAGE、CEILING、COMBIN、COS、SOSH、COUNT、DECIMAL、DEGREES、EVEN、EXP、FACT、FLOOR、INT、LN、LOG、LOG10、MAX、MIN、MOS、ODD、PI、POWER、PRODUCT、PROMOTION、RADIANS、RAND、RANDBETWEEN、ROUND、ROUND5、ROUNDDOWN、ROUNDUP、SIGN、SIN、SINH、SQRT、SUM、SUMPRECISE、SUMSQ、TAN、TANH、TOBINARY、TOHEX、TOOCTAL、TRUNC、WEIGHTEDAVERAGE
正文函式	CHAR、CNMONEY、CODE、CONCATENATE、ENDWITH、ENMONEY、ENNUMBER、EXACT、FIND、FORMAT、INDEXOF、LEFT、LEN、LOWER、MIN、NUMTO、PROPER、REGEXP、REPEAT、REPLACE、RIGHT、SPLIT、STARTWITH、SUBSTITUTE、TODOUBLE、TOINTEGER、TRIM、UPPER
日期和時間函式	DATE、DATEDELTA、DATEDIF、DATEINMONTH、DATEINQUARTER、DATEINWEEK、DATEINYEAR、DATESUBDATE、DATETONUMBER、DAY、DAYS360、DAYSOFMONTH、DAYSOFQUARTER、DAYSOFYEAR、DAYVALUE、HOUR、LUNAR、MINUTE、MONTH、MONTHDELTA、NOW、SECOND、TIME、TODATE、TODAY、WEEK、WEEKDATE、WEEKDAY、YEAR、YEARDELTA
邏輯函式	AND、BITNOT、BITOPERATION、IF、OR、REVERSE、SWITCH
陣列函式	ADD2ARRAY、ARRAY、GREPARRAY、INARRAY、INDEXOFARRAY、JOINARRAY、MAPARRAY、RANGE、REMOVEARRAY、REVERSEARRAY、SLICEARRAY、SORTARRAY、UNIQUEARRAY
報表函式	COL、DECODE、ENCODE、I18N、ROW、COLCOUNT、COLNAME、FIELDS、MAP、RECORDS、ROWCOUNT、SQL、TABLEDATAFIELDS、TABLEDATAS、TABLES、VALUE
其他函式	WEBIMAGE、CLASS、CORREL、EVAL、INDEX、ISNULL、LET、MEDIAN、NVL、QUERY、RANK、SEQ、UUID、LUNAR
層次座標函式	CIRCULAR、CROSSLAYERTOTAL、LAYERTOTAL、MOM、PROPORTION、SORT
自訂函式	REPORTCHECK、UBM、SUBSECTION、CELLSUM

3. 無調度物件

類型	公式/參數/函式	使用位置	備注
參數	使用者全局參數： ${fine_username} ${fine_position} ${fine_role}	不能使用	不能使用
常用函式	SUM、COUNT、AVERAGE、CHAR、DATE、MAX、MIN、TIME、RANGE	調度週期-執行條件-公式判斷檔案處理-平台通知-主題和內容檔案處理-郵件通知-主題和內容檔案處理-使用者端通知-主題和內容檔案處理-簡訊通知-簡訊參數檔案處理-郵件通知-收件人-自訂信箱檔案處理-郵件通知-複本人-自訂信箱檔案處理-郵件通知-密送人-自訂信箱檔案處理-使用者端通知-自訂連結	1）作為參數時，在「調度週期-執行條件-公式判斷」中不要加${}，其他情況要加${} 例如AND(1+7=8,5+7=12)，在排程管理中應該寫為${AND(1+7=8,5+7=12)}，不要加=號
數學和三角函式	ABS、ACOS、ACOSH、ASIN、ASINH、ATAN、ATAN2、AVERAGE、CEILING、COMBIN、COS、SOSH、COUNT、DECIMAL、DEGREES、EVEN、EXP、FACT、FLOOR、INT、LN、LOG、LOG10、MAX、MIN、MOS、ODD、PI、POWER、PRODUCT、PROMOTION、RADIANS、RAND、RANDBETWEEN、ROUND、ROUND5、ROUNDDOWN、ROUNDUP、SIGN、SIN、SINH、SQRT、SUM、SUMPRECISE、SUMSQ、TAN、TANH、TOBINARY、TOHEX、TOOCTAL、TRUNC、WEIGHTEDAVERAGE
正文函式	CHAR、CNMONEY、CODE、CONCATENATE、ENDWITH、ENMONEY、ENNUMBER、EXACT、FIND、FORMAT、INDEXOF、LEFT、LEN、LOWER、MIN、NUMTO、PROPER、REGEXP、REPEAT、REPLACE、RIGHT、SPLIT、STARTWITH、SUBSTITUTE、TODOUBLE、TOINTEGER、TRIM、UPPER
日期和時間函式	DATE、DATEDELTA、DATEDIF、DATEINMONTH、DATEINQUARTER、DATEINWEEK、DATEINYEAR、DATESUBDATE、DATETONUMBER、DAY、DAYS360、DAYSOFMONTH、DAYSOFQUARTER、DAYSOFYEAR、DAYVALUE、HOUR、LUNAR、MINUTE、MONTH、MONTHDELTA、NOW、SECOND、TIME、TODATE、TODAY、WEEK、WEEKDATE、WEEKDAY、YEAR、YEARDELTA
邏輯函式	AND、BITNOT、BITOPERATION、IF、OR、REVERSE、SWITCH
陣列函式	ADD2ARRAY、ARRAY、GREPARRAY、INARRAY、INDEXOFARRAY、JOINARRAY、MAPARRAY、RANGE、REMOVEARRAY、REVERSEARRAY、SLICEARRAY、SORTARRAY、UNIQUEARRAY
報表函式	COL、DECODE、ENCODE、I18N、ROW、COLCOUNT、COLNAME、FIELDS、MAP、RECORDS、ROWCOUNT、SQL、TABLEDATAFIELDS、TABLEDATAS、TABLES、VALUE		1）COL和ROW寫在 FineReport 範本的儲存格中，在排程管理中雖然不會報錯，但沒有意義，回傳值為常數 0 2）COLCOUNT、COLNAME、MAP、ROWCOUNT、TABLEDATAFIELDS、VALUE這些函式的參數中包括有資料集，在 BI 工程就會獲取 BI 的伺服器資料集，在 FR 工程就會獲取 FR 的伺服器資料集
其他函式	WEBIMAGE、CLASS、CORREL、EVAL、INDEX、ISNULL、LET、MEDIAN、NVL、QUERY、RANK、SEQ、UUID、LUNAR		1）SEQ雖被執行，但永遠只有一次，所以值一直為 1 ，沒什麼意義 2）WEBIMAGE用來顯示網頁上的圖片，在排程管理中傳回com.fr.file.WebImage@23dd10da類似格式
自訂函式	UBM、SUBSECTION		取儲存格值的函式在無排程物件中都不能使用。

已經是第一篇

已經是最後一篇

有幫助
沒幫助
只是瀏覽
圖片不清晰
用語看不懂
功能說明看不懂
操作說明太簡單
內容有錯誤

中文（简体） English 日本語

中文（繁體）

排程管理支援的公式

1. 概述

1.1 版本

1.2 功能簡介

2. FineReport 範本

3. 無調度物件

附件列表